]>
git.proxmox.com Git - mirror_ubuntu-bionic-kernel.git/blob - include/linux/sysfs.h
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 <asm/atomic.h>
23 extern int kobject_set_name(struct kobject
*kobj
, const char *name
, ...)
24 __attribute__((format(printf
, 2, 3)));
26 * The *owner field is no longer used, but leave around
27 * until the tree gets cleaned up fully.
35 struct attribute_group
{
37 mode_t (*is_visible
)(struct kobject
*,
38 struct attribute
*, int);
39 struct attribute
**attrs
;
45 * Use these macros to make defining attributes easier. See include/linux/device.h
49 #define __ATTR(_name,_mode,_show,_store) { \
50 .attr = {.name = __stringify(_name), .mode = _mode }, \
55 #define __ATTR_RO(_name) { \
56 .attr = { .name = __stringify(_name), .mode = 0444 }, \
57 .show = _name##_show, \
60 #define __ATTR_NULL { .attr = { .name = NULL } }
62 #define attr_name(_attr) (_attr).attr.name
64 struct vm_area_struct
;
66 struct bin_attribute
{
67 struct attribute attr
;
70 ssize_t (*read
)(struct kobject
*, struct bin_attribute
*,
71 char *, loff_t
, size_t);
72 ssize_t (*write
)(struct kobject
*, struct bin_attribute
*,
73 char *, loff_t
, size_t);
74 int (*mmap
)(struct kobject
*, struct bin_attribute
*attr
,
75 struct vm_area_struct
*vma
);
79 ssize_t (*show
)(struct kobject
*, struct attribute
*,char *);
80 ssize_t (*store
)(struct kobject
*,struct attribute
*,const char *, size_t);
87 int sysfs_schedule_callback(struct kobject
*kobj
, void (*func
)(void *),
88 void *data
, struct module
*owner
);
90 int __must_check
sysfs_create_dir(struct kobject
*kobj
);
91 void sysfs_remove_dir(struct kobject
*kobj
);
92 int __must_check
sysfs_rename_dir(struct kobject
*kobj
, const char *new_name
);
93 int __must_check
sysfs_move_dir(struct kobject
*kobj
,
94 struct kobject
*new_parent_kobj
);
96 int __must_check
sysfs_create_file(struct kobject
*kobj
,
97 const struct attribute
*attr
);
98 int __must_check
sysfs_chmod_file(struct kobject
*kobj
, struct attribute
*attr
,
100 void sysfs_remove_file(struct kobject
*kobj
, const struct attribute
*attr
);
102 int __must_check
sysfs_create_bin_file(struct kobject
*kobj
,
103 struct bin_attribute
*attr
);
104 void sysfs_remove_bin_file(struct kobject
*kobj
, struct bin_attribute
*attr
);
106 int __must_check
sysfs_create_link(struct kobject
*kobj
, struct kobject
*target
,
108 int __must_check
sysfs_create_link_nowarn(struct kobject
*kobj
,
109 struct kobject
*target
,
111 void sysfs_remove_link(struct kobject
*kobj
, const char *name
);
113 int __must_check
sysfs_create_group(struct kobject
*kobj
,
114 const struct attribute_group
*grp
);
115 int sysfs_update_group(struct kobject
*kobj
,
116 const struct attribute_group
*grp
);
117 void sysfs_remove_group(struct kobject
*kobj
,
118 const struct attribute_group
*grp
);
119 int sysfs_add_file_to_group(struct kobject
*kobj
,
120 const struct attribute
*attr
, const char *group
);
121 void sysfs_remove_file_from_group(struct kobject
*kobj
,
122 const struct attribute
*attr
, const char *group
);
124 void sysfs_notify(struct kobject
*kobj
, const char *dir
, const char *attr
);
125 void sysfs_notify_dirent(struct sysfs_dirent
*sd
);
126 struct sysfs_dirent
*sysfs_get_dirent(struct sysfs_dirent
*parent_sd
,
127 const unsigned char *name
);
128 struct sysfs_dirent
*sysfs_get(struct sysfs_dirent
*sd
);
129 void sysfs_put(struct sysfs_dirent
*sd
);
130 void sysfs_printk_last_file(void);
131 int __must_check
sysfs_init(void);
133 #else /* CONFIG_SYSFS */
135 static inline int sysfs_schedule_callback(struct kobject
*kobj
,
136 void (*func
)(void *), void *data
, struct module
*owner
)
141 static inline int sysfs_create_dir(struct kobject
*kobj
)
146 static inline void sysfs_remove_dir(struct kobject
*kobj
)
150 static inline int sysfs_rename_dir(struct kobject
*kobj
, const char *new_name
)
152 return kobject_set_name(kobj
, "%s", new_name
);
155 static inline int sysfs_move_dir(struct kobject
*kobj
,
156 struct kobject
*new_parent_kobj
)
161 static inline int sysfs_create_file(struct kobject
*kobj
,
162 const struct attribute
*attr
)
167 static inline int sysfs_chmod_file(struct kobject
*kobj
,
168 struct attribute
*attr
, mode_t mode
)
173 static inline void sysfs_remove_file(struct kobject
*kobj
,
174 const struct attribute
*attr
)
178 static inline int sysfs_create_bin_file(struct kobject
*kobj
,
179 struct bin_attribute
*attr
)
184 static inline void sysfs_remove_bin_file(struct kobject
*kobj
,
185 struct bin_attribute
*attr
)
189 static inline int sysfs_create_link(struct kobject
*kobj
,
190 struct kobject
*target
, const char *name
)
195 static inline int sysfs_create_link_nowarn(struct kobject
*kobj
,
196 struct kobject
*target
,
202 static inline void sysfs_remove_link(struct kobject
*kobj
, const char *name
)
206 static inline int sysfs_create_group(struct kobject
*kobj
,
207 const struct attribute_group
*grp
)
212 static inline int sysfs_update_group(struct kobject
*kobj
,
213 const struct attribute_group
*grp
)
218 static inline void sysfs_remove_group(struct kobject
*kobj
,
219 const struct attribute_group
*grp
)
223 static inline int sysfs_add_file_to_group(struct kobject
*kobj
,
224 const struct attribute
*attr
, const char *group
)
229 static inline void sysfs_remove_file_from_group(struct kobject
*kobj
,
230 const struct attribute
*attr
, const char *group
)
234 static inline void sysfs_notify(struct kobject
*kobj
, const char *dir
,
238 static inline void sysfs_notify_dirent(struct sysfs_dirent
*sd
)
242 struct sysfs_dirent
*sysfs_get_dirent(struct sysfs_dirent
*parent_sd
,
243 const unsigned char *name
)
247 static inline struct sysfs_dirent
*sysfs_get(struct sysfs_dirent
*sd
)
251 static inline void sysfs_put(struct sysfs_dirent
*sd
)
255 static inline int __must_check
sysfs_init(void)
260 static inline void sysfs_printk_last_file(void)
264 #endif /* CONFIG_SYSFS */
266 #endif /* _SYSFS_H_ */