forked from mirrors/linux
		
	attribute_container_device_trigger invokes callbacks that may fail for one or more classdevs, for instance, the transport_add_class_device callback, called during transport creation, does memory allocation. This information, though, is not propagated to upper layers, and any driver using the attribute_container_device_trigger API will not know whether any, some, or all callbacks succeeded. This patch implements a safe version of this dispatcher, to either succeed all the callbacks or revert to the original state. Link: https://lore.kernel.org/r/20200106185817.640331-2-krisman@collabora.com Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Signed-off-by: Gabriel Krisman Bertazi <krisman@collabora.com> Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>
		
			
				
	
	
		
			78 lines
		
	
	
	
		
			2.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			78 lines
		
	
	
	
		
			2.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/* SPDX-License-Identifier: GPL-2.0-only */
 | 
						|
/*
 | 
						|
 * attribute_container.h - a generic container for all classes
 | 
						|
 *
 | 
						|
 * Copyright (c) 2005 - James Bottomley <James.Bottomley@steeleye.com>
 | 
						|
 */
 | 
						|
 | 
						|
#ifndef _ATTRIBUTE_CONTAINER_H_
 | 
						|
#define _ATTRIBUTE_CONTAINER_H_
 | 
						|
 | 
						|
#include <linux/list.h>
 | 
						|
#include <linux/klist.h>
 | 
						|
 | 
						|
struct device;
 | 
						|
 | 
						|
struct attribute_container {
 | 
						|
	struct list_head	node;
 | 
						|
	struct klist		containers;
 | 
						|
	struct class		*class;
 | 
						|
	const struct attribute_group *grp;
 | 
						|
	struct device_attribute **attrs;
 | 
						|
	int (*match)(struct attribute_container *, struct device *);
 | 
						|
#define	ATTRIBUTE_CONTAINER_NO_CLASSDEVS	0x01
 | 
						|
	unsigned long		flags;
 | 
						|
};
 | 
						|
 | 
						|
static inline int
 | 
						|
attribute_container_no_classdevs(struct attribute_container *atc)
 | 
						|
{
 | 
						|
	return atc->flags & ATTRIBUTE_CONTAINER_NO_CLASSDEVS;
 | 
						|
}
 | 
						|
 | 
						|
static inline void
 | 
						|
attribute_container_set_no_classdevs(struct attribute_container *atc)
 | 
						|
{
 | 
						|
	atc->flags |= ATTRIBUTE_CONTAINER_NO_CLASSDEVS;
 | 
						|
}
 | 
						|
 | 
						|
int attribute_container_register(struct attribute_container *cont);
 | 
						|
int __must_check attribute_container_unregister(struct attribute_container *cont);
 | 
						|
void attribute_container_create_device(struct device *dev,
 | 
						|
				       int (*fn)(struct attribute_container *,
 | 
						|
						 struct device *,
 | 
						|
						 struct device *));
 | 
						|
void attribute_container_add_device(struct device *dev,
 | 
						|
				    int (*fn)(struct attribute_container *,
 | 
						|
					      struct device *,
 | 
						|
					      struct device *));
 | 
						|
void attribute_container_remove_device(struct device *dev,
 | 
						|
				       void (*fn)(struct attribute_container *,
 | 
						|
						  struct device *,
 | 
						|
						  struct device *));
 | 
						|
void attribute_container_device_trigger(struct device *dev, 
 | 
						|
					int (*fn)(struct attribute_container *,
 | 
						|
						  struct device *,
 | 
						|
						  struct device *));
 | 
						|
int attribute_container_device_trigger_safe(struct device *dev,
 | 
						|
					    int (*fn)(struct attribute_container *,
 | 
						|
						      struct device *,
 | 
						|
						      struct device *),
 | 
						|
					    int (*undo)(struct attribute_container *,
 | 
						|
							struct device *,
 | 
						|
							struct device *));
 | 
						|
void attribute_container_trigger(struct device *dev, 
 | 
						|
				 int (*fn)(struct attribute_container *,
 | 
						|
					   struct device *));
 | 
						|
int attribute_container_add_attrs(struct device *classdev);
 | 
						|
int attribute_container_add_class_device(struct device *classdev);
 | 
						|
int attribute_container_add_class_device_adapter(struct attribute_container *cont,
 | 
						|
						 struct device *dev,
 | 
						|
						 struct device *classdev);
 | 
						|
void attribute_container_remove_attrs(struct device *classdev);
 | 
						|
void attribute_container_class_device_del(struct device *classdev);
 | 
						|
struct attribute_container *attribute_container_classdev_to_container(struct device *);
 | 
						|
struct device *attribute_container_find_class_device(struct attribute_container *, struct device *);
 | 
						|
struct device_attribute **attribute_container_classdev_to_attrs(const struct device *classdev);
 | 
						|
 | 
						|
#endif
 |