1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * attribute_container.h - a generic container for all classes
4  *
5  * Copyright (c) 2005 - James Bottomley <James.Bottomley@steeleye.com>
6  */
7 
8 #ifndef _ATTRIBUTE_CONTAINER_H_
9 #define _ATTRIBUTE_CONTAINER_H_
10 
11 #include <linux/list.h>
12 #include <linux/klist.h>
13 
14 struct device;
15 
16 struct attribute_container {
17 	struct list_head	node;
18 	struct klist		containers;
19 	struct class		*class;
20 	const struct attribute_group *grp;
21 	struct device_attribute **attrs;
22 	int (*match)(struct attribute_container *, struct device *);
23 #define	ATTRIBUTE_CONTAINER_NO_CLASSDEVS	0x01
24 	unsigned long		flags;
25 };
26 
27 static inline int
attribute_container_no_classdevs(struct attribute_container * atc)28 attribute_container_no_classdevs(struct attribute_container *atc)
29 {
30 	return atc->flags & ATTRIBUTE_CONTAINER_NO_CLASSDEVS;
31 }
32 
33 static inline void
attribute_container_set_no_classdevs(struct attribute_container * atc)34 attribute_container_set_no_classdevs(struct attribute_container *atc)
35 {
36 	atc->flags |= ATTRIBUTE_CONTAINER_NO_CLASSDEVS;
37 }
38 
39 int attribute_container_register(struct attribute_container *cont);
40 int __must_check attribute_container_unregister(struct attribute_container *cont);
41 void attribute_container_create_device(struct device *dev,
42 				       int (*fn)(struct attribute_container *,
43 						 struct device *,
44 						 struct device *));
45 void attribute_container_add_device(struct device *dev,
46 				    int (*fn)(struct attribute_container *,
47 					      struct device *,
48 					      struct device *));
49 void attribute_container_remove_device(struct device *dev,
50 				       void (*fn)(struct attribute_container *,
51 						  struct device *,
52 						  struct device *));
53 void attribute_container_device_trigger(struct device *dev,
54 					int (*fn)(struct attribute_container *,
55 						  struct device *,
56 						  struct device *));
57 int attribute_container_device_trigger_safe(struct device *dev,
58 					    int (*fn)(struct attribute_container *,
59 						      struct device *,
60 						      struct device *),
61 					    int (*undo)(struct attribute_container *,
62 							struct device *,
63 							struct device *));
64 void attribute_container_trigger(struct device *dev,
65 				 int (*fn)(struct attribute_container *,
66 					   struct device *));
67 int attribute_container_add_attrs(struct device *classdev);
68 int attribute_container_add_class_device(struct device *classdev);
69 int attribute_container_add_class_device_adapter(struct attribute_container *cont,
70 						 struct device *dev,
71 						 struct device *classdev);
72 void attribute_container_remove_attrs(struct device *classdev);
73 void attribute_container_class_device_del(struct device *classdev);
74 struct attribute_container *attribute_container_classdev_to_container(struct device *);
75 struct device *attribute_container_find_class_device(struct attribute_container *, struct device *);
76 struct device_attribute **attribute_container_classdev_to_attrs(const struct device *classdev);
77 
78 #endif
79