]>
Commit | Line | Data |
---|---|---|
6d66f5cd TH |
1 | /* |
2 | * fs/sysfs/sysfs.h - sysfs internal header file | |
3 | * | |
4 | * Copyright (c) 2001-3 Patrick Mochel | |
5 | * Copyright (c) 2007 SUSE Linux Products GmbH | |
6 | * Copyright (c) 2007 Tejun Heo <teheo@suse.de> | |
7 | * | |
8 | * This file is released under the GPLv2. | |
9 | */ | |
10 | ||
ddd29ec6 DQ |
11 | #include <linux/fs.h> |
12 | ||
85a4ffad TH |
13 | struct sysfs_open_dirent; |
14 | ||
59f69015 | 15 | /* type-specific structures for sysfs_dirent->s_* union members */ |
3e519038 | 16 | struct sysfs_elem_dir { |
59f69015 | 17 | struct kobject *kobj; |
bc747f37 TH |
18 | /* children list starts here and goes through sd->s_sibling */ |
19 | struct sysfs_dirent *children; | |
3e519038 TH |
20 | }; |
21 | ||
22 | struct sysfs_elem_symlink { | |
59f69015 | 23 | struct sysfs_dirent *target_sd; |
3e519038 TH |
24 | }; |
25 | ||
26 | struct sysfs_elem_attr { | |
59f69015 | 27 | struct attribute *attr; |
85a4ffad | 28 | struct sysfs_open_dirent *open; |
3e519038 TH |
29 | }; |
30 | ||
31 | struct sysfs_elem_bin_attr { | |
59f69015 | 32 | struct bin_attribute *bin_attr; |
e0edd3c6 | 33 | struct hlist_head buffers; |
3e519038 TH |
34 | }; |
35 | ||
ddd29ec6 DQ |
36 | struct sysfs_inode_attrs { |
37 | struct iattr ia_iattr; | |
38 | void *ia_secdata; | |
39 | u32 ia_secdata_len; | |
40 | }; | |
41 | ||
0ab66088 | 42 | /* |
59f69015 TH |
43 | * sysfs_dirent - the building block of sysfs hierarchy. Each and |
44 | * every sysfs node is represented by single sysfs_dirent. | |
45 | * | |
0ab66088 TH |
46 | * As long as s_count reference is held, the sysfs_dirent itself is |
47 | * accessible. Dereferencing s_elem or any other outer entity | |
48 | * requires s_active reference. | |
49 | */ | |
d56c3eae AR |
50 | struct sysfs_dirent { |
51 | atomic_t s_count; | |
8619f979 | 52 | atomic_t s_active; |
59f69015 TH |
53 | struct sysfs_dirent *s_parent; |
54 | struct sysfs_dirent *s_sibling; | |
59f69015 | 55 | const char *s_name; |
3e519038 TH |
56 | |
57 | union { | |
b1fc3d61 TH |
58 | struct sysfs_elem_dir s_dir; |
59 | struct sysfs_elem_symlink s_symlink; | |
60 | struct sysfs_elem_attr s_attr; | |
61 | struct sysfs_elem_bin_attr s_bin_attr; | |
62 | }; | |
3e519038 | 63 | |
b402d72c | 64 | unsigned int s_flags; |
dc351252 | 65 | ino_t s_ino; |
b13dc89c | 66 | umode_t s_mode; |
ddd29ec6 | 67 | struct sysfs_inode_attrs *s_iattr; |
d56c3eae | 68 | }; |
1da177e4 | 69 | |
59f69015 | 70 | #define SD_DEACTIVATED_BIAS INT_MIN |
0ab66088 | 71 | |
59f69015 | 72 | #define SYSFS_TYPE_MASK 0x00ff |
dc2f75f0 TH |
73 | #define SYSFS_DIR 0x0001 |
74 | #define SYSFS_KOBJ_ATTR 0x0002 | |
75 | #define SYSFS_KOBJ_BIN_ATTR 0x0004 | |
76 | #define SYSFS_KOBJ_LINK 0x0008 | |
59f69015 TH |
77 | #define SYSFS_COPY_NAME (SYSFS_DIR | SYSFS_KOBJ_LINK) |
78 | ||
79 | #define SYSFS_FLAG_MASK ~SYSFS_TYPE_MASK | |
80 | #define SYSFS_FLAG_REMOVED 0x0200 | |
81 | ||
82 | static inline unsigned int sysfs_type(struct sysfs_dirent *sd) | |
83 | { | |
84 | return sd->s_flags & SYSFS_TYPE_MASK; | |
85 | } | |
86 | ||
87 | /* | |
88 | * Context structure to be used while adding/removing nodes. | |
89 | */ | |
fb6896da TH |
90 | struct sysfs_addrm_cxt { |
91 | struct sysfs_dirent *parent_sd; | |
92 | struct inode *parent_inode; | |
93 | struct sysfs_dirent *removed; | |
94 | int cnt; | |
95 | }; | |
96 | ||
59f69015 TH |
97 | /* |
98 | * mount.c | |
99 | */ | |
51225039 | 100 | extern struct sysfs_dirent sysfs_root; |
59f69015 | 101 | extern struct super_block *sysfs_sb; |
e18b890b | 102 | extern struct kmem_cache *sysfs_dir_cachep; |
1da177e4 | 103 | |
59f69015 TH |
104 | /* |
105 | * dir.c | |
106 | */ | |
3007e997 | 107 | extern struct mutex sysfs_mutex; |
932ea2e3 | 108 | extern struct mutex sysfs_rename_mutex; |
59f69015 TH |
109 | extern spinlock_t sysfs_assoc_lock; |
110 | ||
4b6f5d20 | 111 | extern const struct file_operations sysfs_dir_operations; |
c5ef1c42 | 112 | extern const struct inode_operations sysfs_dir_inode_operations; |
1da177e4 | 113 | |
59f69015 | 114 | struct dentry *sysfs_get_dentry(struct sysfs_dirent *sd); |
59f69015 TH |
115 | struct sysfs_dirent *sysfs_get_active_two(struct sysfs_dirent *sd); |
116 | void sysfs_put_active_two(struct sysfs_dirent *sd); | |
117 | void sysfs_addrm_start(struct sysfs_addrm_cxt *acxt, | |
118 | struct sysfs_dirent *parent_sd); | |
36ce6dad | 119 | int __sysfs_add_one(struct sysfs_addrm_cxt *acxt, struct sysfs_dirent *sd); |
59f69015 TH |
120 | int sysfs_add_one(struct sysfs_addrm_cxt *acxt, struct sysfs_dirent *sd); |
121 | void sysfs_remove_one(struct sysfs_addrm_cxt *acxt, struct sysfs_dirent *sd); | |
122 | void sysfs_addrm_finish(struct sysfs_addrm_cxt *acxt); | |
123 | ||
124 | struct sysfs_dirent *sysfs_find_dirent(struct sysfs_dirent *parent_sd, | |
125 | const unsigned char *name); | |
126 | struct sysfs_dirent *sysfs_get_dirent(struct sysfs_dirent *parent_sd, | |
127 | const unsigned char *name); | |
128 | struct sysfs_dirent *sysfs_new_dirent(const char *name, umode_t mode, int type); | |
129 | ||
130 | void release_sysfs_dirent(struct sysfs_dirent *sd); | |
131 | ||
132 | int sysfs_create_subdir(struct kobject *kobj, const char *name, | |
133 | struct sysfs_dirent **p_sd); | |
134 | void sysfs_remove_subdir(struct sysfs_dirent *sd); | |
135 | ||
f1282c84 | 136 | static inline struct sysfs_dirent *__sysfs_get(struct sysfs_dirent *sd) |
1da177e4 | 137 | { |
0ab66088 TH |
138 | if (sd) { |
139 | WARN_ON(!atomic_read(&sd->s_count)); | |
140 | atomic_inc(&sd->s_count); | |
141 | } | |
142 | return sd; | |
1da177e4 | 143 | } |
f1282c84 | 144 | #define sysfs_get(sd) __sysfs_get(sd) |
1da177e4 | 145 | |
f1282c84 | 146 | static inline void __sysfs_put(struct sysfs_dirent *sd) |
1da177e4 | 147 | { |
0ab66088 TH |
148 | if (sd && atomic_dec_and_test(&sd->s_count)) |
149 | release_sysfs_dirent(sd); | |
150 | } | |
f1282c84 | 151 | #define sysfs_put(sd) __sysfs_put(sd) |
59f69015 TH |
152 | |
153 | /* | |
154 | * inode.c | |
155 | */ | |
156 | struct inode *sysfs_get_inode(struct sysfs_dirent *sd); | |
04256b4a | 157 | void sysfs_delete_inode(struct inode *inode); |
35df63c4 | 158 | int sysfs_sd_setattr(struct sysfs_dirent *sd, struct iattr *iattr); |
59f69015 | 159 | int sysfs_setattr(struct dentry *dentry, struct iattr *iattr); |
ddd29ec6 DQ |
160 | int sysfs_setxattr(struct dentry *dentry, const char *name, const void *value, |
161 | size_t size, int flags); | |
59f69015 | 162 | int sysfs_hash_and_remove(struct sysfs_dirent *dir_sd, const char *name); |
e0bf68dd | 163 | int sysfs_inode_init(void); |
59f69015 TH |
164 | |
165 | /* | |
166 | * file.c | |
167 | */ | |
168 | extern const struct file_operations sysfs_file_operations; | |
169 | ||
170 | int sysfs_add_file(struct sysfs_dirent *dir_sd, | |
171 | const struct attribute *attr, int type); | |
172 | ||
0f423895 JB |
173 | int sysfs_add_file_mode(struct sysfs_dirent *dir_sd, |
174 | const struct attribute *attr, int type, mode_t amode); | |
59f69015 TH |
175 | /* |
176 | * bin.c | |
177 | */ | |
178 | extern const struct file_operations bin_fops; | |
e0edd3c6 | 179 | void unmap_bin_file(struct sysfs_dirent *attr_sd); |
59f69015 TH |
180 | |
181 | /* | |
182 | * symlink.c | |
183 | */ | |
184 | extern const struct inode_operations sysfs_symlink_inode_operations; |