xref: /linux/fs/configfs/configfs_internal.h (revision 60e13231561b3a4c5269bfa1ef6c0569ad6f28ec)
1 /* -*- mode: c; c-basic-offset:8; -*-
2  * vim: noexpandtab sw=8 ts=8 sts=0:
3  *
4  * configfs_internal.h - Internal stuff for configfs
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public
8  * License as published by the Free Software Foundation; either
9  * version 2 of the License, or (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14  * General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public
17  * License along with this program; if not, write to the
18  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19  * Boston, MA 021110-1307, USA.
20  *
21  * Based on sysfs:
22  * 	sysfs is Copyright (C) 2001, 2002, 2003 Patrick Mochel
23  *
24  * configfs Copyright (C) 2005 Oracle.  All rights reserved.
25  */
26 
27 #include <linux/slab.h>
28 #include <linux/list.h>
29 #include <linux/spinlock.h>
30 
31 struct configfs_dirent {
32 	atomic_t		s_count;
33 	int			s_dependent_count;
34 	struct list_head	s_sibling;
35 	struct list_head	s_children;
36 	struct list_head	s_links;
37 	void			* s_element;
38 	int			s_type;
39 	umode_t			s_mode;
40 	struct dentry		* s_dentry;
41 	struct iattr		* s_iattr;
42 #ifdef CONFIG_LOCKDEP
43 	int			s_depth;
44 #endif
45 };
46 
47 #define CONFIGFS_ROOT		0x0001
48 #define CONFIGFS_DIR		0x0002
49 #define CONFIGFS_ITEM_ATTR	0x0004
50 #define CONFIGFS_ITEM_LINK	0x0020
51 #define CONFIGFS_USET_DIR	0x0040
52 #define CONFIGFS_USET_DEFAULT	0x0080
53 #define CONFIGFS_USET_DROPPING	0x0100
54 #define CONFIGFS_USET_IN_MKDIR	0x0200
55 #define CONFIGFS_USET_CREATING	0x0400
56 #define CONFIGFS_NOT_PINNED	(CONFIGFS_ITEM_ATTR)
57 
58 extern struct mutex configfs_symlink_mutex;
59 extern spinlock_t configfs_dirent_lock;
60 
61 extern struct vfsmount * configfs_mount;
62 extern struct kmem_cache *configfs_dir_cachep;
63 
64 extern int configfs_is_root(struct config_item *item);
65 
66 extern struct inode * configfs_new_inode(mode_t mode, struct configfs_dirent *);
67 extern int configfs_create(struct dentry *, int mode, int (*init)(struct inode *));
68 extern int configfs_inode_init(void);
69 extern void configfs_inode_exit(void);
70 
71 extern int configfs_create_file(struct config_item *, const struct configfs_attribute *);
72 extern int configfs_make_dirent(struct configfs_dirent *,
73 				struct dentry *, void *, umode_t, int);
74 extern int configfs_dirent_is_ready(struct configfs_dirent *);
75 
76 extern int configfs_add_file(struct dentry *, const struct configfs_attribute *, int);
77 extern void configfs_hash_and_remove(struct dentry * dir, const char * name);
78 
79 extern const unsigned char * configfs_get_name(struct configfs_dirent *sd);
80 extern void configfs_drop_dentry(struct configfs_dirent *sd, struct dentry *parent);
81 extern int configfs_setattr(struct dentry *dentry, struct iattr *iattr);
82 
83 extern int configfs_pin_fs(void);
84 extern void configfs_release_fs(void);
85 
86 extern struct rw_semaphore configfs_rename_sem;
87 extern struct super_block * configfs_sb;
88 extern const struct file_operations configfs_dir_operations;
89 extern const struct file_operations configfs_file_operations;
90 extern const struct file_operations bin_fops;
91 extern const struct inode_operations configfs_dir_inode_operations;
92 extern const struct inode_operations configfs_symlink_inode_operations;
93 extern const struct dentry_operations configfs_dentry_ops;
94 
95 extern int configfs_symlink(struct inode *dir, struct dentry *dentry,
96 			    const char *symname);
97 extern int configfs_unlink(struct inode *dir, struct dentry *dentry);
98 
99 struct configfs_symlink {
100 	struct list_head sl_list;
101 	struct config_item *sl_target;
102 };
103 
104 extern int configfs_create_link(struct configfs_symlink *sl,
105 				struct dentry *parent,
106 				struct dentry *dentry);
107 
108 static inline struct config_item * to_item(struct dentry * dentry)
109 {
110 	struct configfs_dirent * sd = dentry->d_fsdata;
111 	return ((struct config_item *) sd->s_element);
112 }
113 
114 static inline struct configfs_attribute * to_attr(struct dentry * dentry)
115 {
116 	struct configfs_dirent * sd = dentry->d_fsdata;
117 	return ((struct configfs_attribute *) sd->s_element);
118 }
119 
120 static inline struct config_item *configfs_get_config_item(struct dentry *dentry)
121 {
122 	struct config_item * item = NULL;
123 
124 	spin_lock(&dentry->d_lock);
125 	if (!d_unhashed(dentry)) {
126 		struct configfs_dirent * sd = dentry->d_fsdata;
127 		if (sd->s_type & CONFIGFS_ITEM_LINK) {
128 			struct configfs_symlink * sl = sd->s_element;
129 			item = config_item_get(sl->sl_target);
130 		} else
131 			item = config_item_get(sd->s_element);
132 	}
133 	spin_unlock(&dentry->d_lock);
134 
135 	return item;
136 }
137 
138 static inline void release_configfs_dirent(struct configfs_dirent * sd)
139 {
140 	if (!(sd->s_type & CONFIGFS_ROOT)) {
141 		kfree(sd->s_iattr);
142 		kmem_cache_free(configfs_dir_cachep, sd);
143 	}
144 }
145 
146 static inline struct configfs_dirent * configfs_get(struct configfs_dirent * sd)
147 {
148 	if (sd) {
149 		WARN_ON(!atomic_read(&sd->s_count));
150 		atomic_inc(&sd->s_count);
151 	}
152 	return sd;
153 }
154 
155 static inline void configfs_put(struct configfs_dirent * sd)
156 {
157 	WARN_ON(!atomic_read(&sd->s_count));
158 	if (atomic_dec_and_test(&sd->s_count))
159 		release_configfs_dirent(sd);
160 }
161 
162