2 * sysfs.h - definitions for the device driver filesystem
4 * Copyright (c) 2001,2002 Patrick Mochel
5 * Copyright (c) 2004 Silicon Graphics, Inc.
7 * Please see Documentation/filesystems/sysfs.txt for more information.
13 #include <linux/compiler.h>
14 #include <linux/errno.h>
15 #include <linux/list.h>
16 #include <asm/atomic.h>
25 * The *owner field is no longer used, but leave around
26 * until the tree gets cleaned up fully.
30 struct module
* owner
;
34 struct attribute_group
{
36 struct attribute
** attrs
;
42 * Use these macros to make defining attributes easier. See include/linux/device.h
46 #define __ATTR(_name,_mode,_show,_store) { \
47 .attr = {.name = __stringify(_name), .mode = _mode }, \
52 #define __ATTR_RO(_name) { \
53 .attr = { .name = __stringify(_name), .mode = 0444 }, \
54 .show = _name##_show, \
57 #define __ATTR_NULL { .attr = { .name = NULL } }
59 #define attr_name(_attr) (_attr).attr.name
61 struct vm_area_struct
;
63 struct bin_attribute
{
64 struct attribute attr
;
67 ssize_t (*read
)(struct kobject
*, char *, loff_t
, size_t);
68 ssize_t (*write
)(struct kobject
*, char *, loff_t
, size_t);
69 int (*mmap
)(struct kobject
*, struct bin_attribute
*attr
,
70 struct vm_area_struct
*vma
);
74 ssize_t (*show
)(struct kobject
*, struct attribute
*,char *);
75 ssize_t (*store
)(struct kobject
*,struct attribute
*,const char *, size_t);
78 #define SYSFS_TYPE_MASK 0x00ff
79 #define SYSFS_ROOT 0x0001
80 #define SYSFS_DIR 0x0002
81 #define SYSFS_KOBJ_ATTR 0x0004
82 #define SYSFS_KOBJ_BIN_ATTR 0x0008
83 #define SYSFS_KOBJ_LINK 0x0020
84 #define SYSFS_COPY_NAME (SYSFS_DIR | SYSFS_KOBJ_LINK)
86 #define SYSFS_FLAG_MASK ~SYSFS_TYPE_MASK
87 #define SYSFS_FLAG_REMOVED 0x0100
91 extern int sysfs_schedule_callback(struct kobject
*kobj
,
92 void (*func
)(void *), void *data
, struct module
*owner
);
94 extern int __must_check
95 sysfs_create_dir(struct kobject
*kobj
, struct sysfs_dirent
*shadow_parent_sd
);
98 sysfs_remove_dir(struct kobject
*);
100 extern int __must_check
101 sysfs_rename_dir(struct kobject
*kobj
, struct sysfs_dirent
*new_parent_sd
,
102 const char *new_name
);
104 extern int __must_check
105 sysfs_move_dir(struct kobject
*, struct kobject
*);
107 extern int __must_check
108 sysfs_create_file(struct kobject
*, const struct attribute
*);
110 extern int __must_check
111 sysfs_update_file(struct kobject
*, const struct attribute
*);
113 extern int __must_check
114 sysfs_chmod_file(struct kobject
*kobj
, struct attribute
*attr
, mode_t mode
);
117 sysfs_remove_file(struct kobject
*, const struct attribute
*);
119 extern int __must_check
120 sysfs_create_link(struct kobject
* kobj
, struct kobject
* target
, const char * name
);
123 sysfs_remove_link(struct kobject
*, const char * name
);
125 int __must_check
sysfs_create_bin_file(struct kobject
*kobj
,
126 struct bin_attribute
*attr
);
127 void sysfs_remove_bin_file(struct kobject
*kobj
, struct bin_attribute
*attr
);
129 int __must_check
sysfs_create_group(struct kobject
*,
130 const struct attribute_group
*);
131 void sysfs_remove_group(struct kobject
*, const struct attribute_group
*);
132 int sysfs_add_file_to_group(struct kobject
*kobj
,
133 const struct attribute
*attr
, const char *group
);
134 void sysfs_remove_file_from_group(struct kobject
*kobj
,
135 const struct attribute
*attr
, const char *group
);
137 void sysfs_notify(struct kobject
* k
, char *dir
, char *attr
);
140 extern int sysfs_make_shadowed_dir(struct kobject
*kobj
,
141 void * (*follow_link
)(struct dentry
*, struct nameidata
*));
142 extern struct sysfs_dirent
*sysfs_create_shadow_dir(struct kobject
*kobj
);
143 extern void sysfs_remove_shadow_dir(struct sysfs_dirent
*shadow_sd
);
145 extern int __must_check
sysfs_init(void);
147 #else /* CONFIG_SYSFS */
149 static inline int sysfs_schedule_callback(struct kobject
*kobj
,
150 void (*func
)(void *), void *data
, struct module
*owner
)
155 static inline int sysfs_create_dir(struct kobject
*kobj
,
156 struct sysfs_dirent
*shadow_parent_sd
)
161 static inline void sysfs_remove_dir(struct kobject
* k
)
166 static inline int sysfs_rename_dir(struct kobject
*kobj
,
167 struct sysfs_dirent
*new_parent_sd
,
168 const char *new_name
)
173 static inline int sysfs_move_dir(struct kobject
* k
, struct kobject
* new_parent
)
178 static inline int sysfs_create_file(struct kobject
* k
, const struct attribute
* a
)
183 static inline int sysfs_update_file(struct kobject
* k
, const struct attribute
* a
)
187 static inline int sysfs_chmod_file(struct kobject
*kobj
, struct attribute
*attr
, mode_t mode
)
192 static inline void sysfs_remove_file(struct kobject
* k
, const struct attribute
* a
)
197 static inline int sysfs_create_link(struct kobject
* k
, struct kobject
* t
, const char * n
)
202 static inline void sysfs_remove_link(struct kobject
* k
, const char * name
)
208 static inline int sysfs_create_bin_file(struct kobject
* k
, struct bin_attribute
* a
)
213 static inline int sysfs_remove_bin_file(struct kobject
* k
, struct bin_attribute
* a
)
218 static inline int sysfs_create_group(struct kobject
* k
, const struct attribute_group
*g
)
223 static inline void sysfs_remove_group(struct kobject
* k
, const struct attribute_group
* g
)
228 static inline int sysfs_add_file_to_group(struct kobject
*kobj
,
229 const struct attribute
*attr
, const char *group
)
234 static inline void sysfs_remove_file_from_group(struct kobject
*kobj
,
235 const struct attribute
*attr
, const char *group
)
239 static inline void sysfs_notify(struct kobject
* k
, char *dir
, char *attr
)
243 static inline int sysfs_make_shadowed_dir(struct kobject
*kobj
,
244 void * (*follow_link
)(struct dentry
*, struct nameidata
*))
249 static inline int __must_check
sysfs_init(void)
254 #endif /* CONFIG_SYSFS */
256 #endif /* _SYSFS_H_ */