2 * sysfs.h - definitions for the device driver filesystem
4 * Copyright (c) 2001,2002 Patrick Mochel
5 * Copyright (c) 2004 Silicon Graphics, Inc.
6 * Copyright (c) 2007 SUSE Linux Products GmbH
7 * Copyright (c) 2007 Tejun Heo <teheo@suse.de>
9 * Please see Documentation/filesystems/sysfs.txt for more information.
15 #include <linux/compiler.h>
16 #include <linux/errno.h>
17 #include <linux/list.h>
18 #include <linux/lockdep.h>
19 #include <linux/kobject_ns.h>
20 #include <linux/atomic.h>
29 #ifdef CONFIG_DEBUG_LOCK_ALLOC
30 struct lock_class_key
*key
;
31 struct lock_class_key skey
;
36 * sysfs_attr_init - initialize a dynamically allocated sysfs attribute
37 * @attr: struct attribute to initialize
39 * Initialize a dynamically allocated struct attribute so we can
40 * make lockdep happy. This is a new requirement for attributes
41 * and initially this is only needed when lockdep is enabled.
42 * Lockdep gives a nice error when your attribute is added to
43 * sysfs if you don't have this.
45 #ifdef CONFIG_DEBUG_LOCK_ALLOC
46 #define sysfs_attr_init(attr) \
48 static struct lock_class_key __key; \
50 (attr)->key = &__key; \
53 #define sysfs_attr_init(attr) do {} while(0)
56 struct attribute_group
{
58 mode_t (*is_visible
)(struct kobject
*,
59 struct attribute
*, int);
60 struct attribute
**attrs
;
66 * Use these macros to make defining attributes easier. See include/linux/device.h
70 #define __ATTR(_name,_mode,_show,_store) { \
71 .attr = {.name = __stringify(_name), .mode = _mode }, \
76 #define __ATTR_RO(_name) { \
77 .attr = { .name = __stringify(_name), .mode = 0444 }, \
78 .show = _name##_show, \
81 #define __ATTR_NULL { .attr = { .name = NULL } }
83 #define attr_name(_attr) (_attr).attr.name
86 struct vm_area_struct
;
88 struct bin_attribute
{
89 struct attribute attr
;
92 ssize_t (*read
)(struct file
*, struct kobject
*, struct bin_attribute
*,
93 char *, loff_t
, size_t);
94 ssize_t (*write
)(struct file
*,struct kobject
*, struct bin_attribute
*,
95 char *, loff_t
, size_t);
96 int (*mmap
)(struct file
*, struct kobject
*, struct bin_attribute
*attr
,
97 struct vm_area_struct
*vma
);
101 * sysfs_bin_attr_init - initialize a dynamically allocated bin_attribute
102 * @attr: struct bin_attribute to initialize
104 * Initialize a dynamically allocated struct bin_attribute so we
105 * can make lockdep happy. This is a new requirement for
106 * attributes and initially this is only needed when lockdep is
107 * enabled. Lockdep gives a nice error when your attribute is
108 * added to sysfs if you don't have this.
110 #define sysfs_bin_attr_init(bin_attr) sysfs_attr_init(&(bin_attr)->attr)
113 ssize_t (*show
)(struct kobject
*, struct attribute
*,char *);
114 ssize_t (*store
)(struct kobject
*,struct attribute
*,const char *, size_t);
115 const void *(*namespace)(struct kobject
*, const struct attribute
*);
122 int sysfs_schedule_callback(struct kobject
*kobj
, void (*func
)(void *),
123 void *data
, struct module
*owner
);
125 int __must_check
sysfs_create_dir(struct kobject
*kobj
);
126 void sysfs_remove_dir(struct kobject
*kobj
);
127 int __must_check
sysfs_rename_dir(struct kobject
*kobj
, const char *new_name
);
128 int __must_check
sysfs_move_dir(struct kobject
*kobj
,
129 struct kobject
*new_parent_kobj
);
131 int __must_check
sysfs_create_file(struct kobject
*kobj
,
132 const struct attribute
*attr
);
133 int __must_check
sysfs_create_files(struct kobject
*kobj
,
134 const struct attribute
**attr
);
135 int __must_check
sysfs_chmod_file(struct kobject
*kobj
,
136 const struct attribute
*attr
, mode_t mode
);
137 void sysfs_remove_file(struct kobject
*kobj
, const struct attribute
*attr
);
138 void sysfs_remove_files(struct kobject
*kobj
, const struct attribute
**attr
);
140 int __must_check
sysfs_create_bin_file(struct kobject
*kobj
,
141 const struct bin_attribute
*attr
);
142 void sysfs_remove_bin_file(struct kobject
*kobj
,
143 const struct bin_attribute
*attr
);
145 int __must_check
sysfs_create_link(struct kobject
*kobj
, struct kobject
*target
,
147 int __must_check
sysfs_create_link_nowarn(struct kobject
*kobj
,
148 struct kobject
*target
,
150 void sysfs_remove_link(struct kobject
*kobj
, const char *name
);
152 int sysfs_rename_link(struct kobject
*kobj
, struct kobject
*target
,
153 const char *old_name
, const char *new_name
);
155 void sysfs_delete_link(struct kobject
*dir
, struct kobject
*targ
,
158 int __must_check
sysfs_create_group(struct kobject
*kobj
,
159 const struct attribute_group
*grp
);
160 int sysfs_update_group(struct kobject
*kobj
,
161 const struct attribute_group
*grp
);
162 void sysfs_remove_group(struct kobject
*kobj
,
163 const struct attribute_group
*grp
);
164 int sysfs_add_file_to_group(struct kobject
*kobj
,
165 const struct attribute
*attr
, const char *group
);
166 void sysfs_remove_file_from_group(struct kobject
*kobj
,
167 const struct attribute
*attr
, const char *group
);
168 int sysfs_merge_group(struct kobject
*kobj
,
169 const struct attribute_group
*grp
);
170 void sysfs_unmerge_group(struct kobject
*kobj
,
171 const struct attribute_group
*grp
);
173 void sysfs_notify(struct kobject
*kobj
, const char *dir
, const char *attr
);
174 void sysfs_notify_dirent(struct sysfs_dirent
*sd
);
175 struct sysfs_dirent
*sysfs_get_dirent(struct sysfs_dirent
*parent_sd
,
177 const unsigned char *name
);
178 struct sysfs_dirent
*sysfs_get(struct sysfs_dirent
*sd
);
179 void sysfs_put(struct sysfs_dirent
*sd
);
181 int __must_check
sysfs_init(void);
183 #else /* CONFIG_SYSFS */
185 static inline int sysfs_schedule_callback(struct kobject
*kobj
,
186 void (*func
)(void *), void *data
, struct module
*owner
)
191 static inline int sysfs_create_dir(struct kobject
*kobj
)
196 static inline void sysfs_remove_dir(struct kobject
*kobj
)
200 static inline int sysfs_rename_dir(struct kobject
*kobj
, const char *new_name
)
205 static inline int sysfs_move_dir(struct kobject
*kobj
,
206 struct kobject
*new_parent_kobj
)
211 static inline int sysfs_create_file(struct kobject
*kobj
,
212 const struct attribute
*attr
)
217 static inline int sysfs_create_files(struct kobject
*kobj
,
218 const struct attribute
**attr
)
223 static inline int sysfs_chmod_file(struct kobject
*kobj
,
224 const struct attribute
*attr
, mode_t mode
)
229 static inline void sysfs_remove_file(struct kobject
*kobj
,
230 const struct attribute
*attr
)
234 static inline void sysfs_remove_files(struct kobject
*kobj
,
235 const struct attribute
**attr
)
239 static inline int sysfs_create_bin_file(struct kobject
*kobj
,
240 const struct bin_attribute
*attr
)
245 static inline void sysfs_remove_bin_file(struct kobject
*kobj
,
246 const struct bin_attribute
*attr
)
250 static inline int sysfs_create_link(struct kobject
*kobj
,
251 struct kobject
*target
, const char *name
)
256 static inline int sysfs_create_link_nowarn(struct kobject
*kobj
,
257 struct kobject
*target
,
263 static inline void sysfs_remove_link(struct kobject
*kobj
, const char *name
)
267 static inline int sysfs_rename_link(struct kobject
*k
, struct kobject
*t
,
268 const char *old_name
, const char *new_name
)
273 static inline void sysfs_delete_link(struct kobject
*k
, struct kobject
*t
,
278 static inline int sysfs_create_group(struct kobject
*kobj
,
279 const struct attribute_group
*grp
)
284 static inline int sysfs_update_group(struct kobject
*kobj
,
285 const struct attribute_group
*grp
)
290 static inline void sysfs_remove_group(struct kobject
*kobj
,
291 const struct attribute_group
*grp
)
295 static inline int sysfs_add_file_to_group(struct kobject
*kobj
,
296 const struct attribute
*attr
, const char *group
)
301 static inline void sysfs_remove_file_from_group(struct kobject
*kobj
,
302 const struct attribute
*attr
, const char *group
)
306 static inline int sysfs_merge_group(struct kobject
*kobj
,
307 const struct attribute_group
*grp
)
312 static inline void sysfs_unmerge_group(struct kobject
*kobj
,
313 const struct attribute_group
*grp
)
317 static inline void sysfs_notify(struct kobject
*kobj
, const char *dir
,
321 static inline void sysfs_notify_dirent(struct sysfs_dirent
*sd
)
325 struct sysfs_dirent
*sysfs_get_dirent(struct sysfs_dirent
*parent_sd
,
327 const unsigned char *name
)
331 static inline struct sysfs_dirent
*sysfs_get(struct sysfs_dirent
*sd
)
335 static inline void sysfs_put(struct sysfs_dirent
*sd
)
339 static inline int __must_check
sysfs_init(void)
344 #endif /* CONFIG_SYSFS */
346 #endif /* _SYSFS_H_ */
This page took 0.036366 seconds and 5 git commands to generate.