]>
Commit | Line | Data |
---|---|---|
7063fbf2 JB |
1 | /* -*- mode: c; c-basic-offset: 8; -*- |
2 | * vim: noexpandtab sw=8 ts=8 sts=0: | |
3 | * | |
4 | * item.c - library routines for handling generic config items | |
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 kobject: | |
f6b1fe7c | 22 | * kobject is Copyright (c) 2002-2003 Patrick Mochel |
7063fbf2 JB |
23 | * |
24 | * configfs Copyright (C) 2005 Oracle. All rights reserved. | |
25 | * | |
395cf969 | 26 | * Please see the file Documentation/filesystems/configfs/configfs.txt for |
7063fbf2 JB |
27 | * critical information about using the config_item interface. |
28 | */ | |
29 | ||
30 | #include <linux/string.h> | |
31 | #include <linux/module.h> | |
32 | #include <linux/stat.h> | |
33 | #include <linux/slab.h> | |
34 | ||
35 | #include <linux/configfs.h> | |
36 | ||
37 | ||
f6b1fe7c | 38 | static inline struct config_item *to_item(struct list_head *entry) |
7063fbf2 | 39 | { |
f6b1fe7c | 40 | return container_of(entry, struct config_item, ci_entry); |
7063fbf2 JB |
41 | } |
42 | ||
43 | /* Evil kernel */ | |
44 | static void config_item_release(struct kref *kref); | |
45 | ||
46 | /** | |
47 | * config_item_init - initialize item. | |
48 | * @item: item in question. | |
49 | */ | |
5286d20c | 50 | static void config_item_init(struct config_item *item) |
7063fbf2 JB |
51 | { |
52 | kref_init(&item->ci_kref); | |
53 | INIT_LIST_HEAD(&item->ci_entry); | |
54 | } | |
55 | ||
56 | /** | |
57 | * config_item_set_name - Set the name of an item | |
58 | * @item: item. | |
f6b1fe7c | 59 | * @fmt: The vsnprintf()'s format string. |
7063fbf2 JB |
60 | * |
61 | * If strlen(name) >= CONFIGFS_ITEM_NAME_LEN, then use a | |
62 | * dynamically allocated string that @item->ci_name points to. | |
63 | * Otherwise, use the static @item->ci_namebuf array. | |
64 | */ | |
f6b1fe7c | 65 | int config_item_set_name(struct config_item *item, const char *fmt, ...) |
7063fbf2 JB |
66 | { |
67 | int error = 0; | |
68 | int limit = CONFIGFS_ITEM_NAME_LEN; | |
69 | int need; | |
70 | va_list args; | |
f6b1fe7c | 71 | char *name; |
7063fbf2 JB |
72 | |
73 | /* | |
74 | * First, try the static array | |
75 | */ | |
f6b1fe7c FF |
76 | va_start(args, fmt); |
77 | need = vsnprintf(item->ci_namebuf, limit, fmt, args); | |
7063fbf2 JB |
78 | va_end(args); |
79 | if (need < limit) | |
80 | name = item->ci_namebuf; | |
81 | else { | |
82 | /* | |
83 | * Need more space? Allocate it and try again | |
84 | */ | |
85 | limit = need + 1; | |
f6b1fe7c | 86 | name = kmalloc(limit, GFP_KERNEL); |
7063fbf2 JB |
87 | if (!name) { |
88 | error = -ENOMEM; | |
89 | goto Done; | |
90 | } | |
f6b1fe7c FF |
91 | va_start(args, fmt); |
92 | need = vsnprintf(name, limit, fmt, args); | |
7063fbf2 JB |
93 | va_end(args); |
94 | ||
95 | /* Still? Give up. */ | |
96 | if (need >= limit) { | |
97 | kfree(name); | |
98 | error = -EFAULT; | |
99 | goto Done; | |
100 | } | |
101 | } | |
102 | ||
103 | /* Free the old name, if necessary. */ | |
104 | if (item->ci_name && item->ci_name != item->ci_namebuf) | |
105 | kfree(item->ci_name); | |
106 | ||
107 | /* Now, set the new name */ | |
108 | item->ci_name = name; | |
109 | Done: | |
110 | return error; | |
111 | } | |
7063fbf2 JB |
112 | EXPORT_SYMBOL(config_item_set_name); |
113 | ||
114 | void config_item_init_type_name(struct config_item *item, | |
115 | const char *name, | |
116 | struct config_item_type *type) | |
117 | { | |
3958b792 | 118 | config_item_set_name(item, "%s", name); |
7063fbf2 JB |
119 | item->ci_type = type; |
120 | config_item_init(item); | |
121 | } | |
122 | EXPORT_SYMBOL(config_item_init_type_name); | |
123 | ||
124 | void config_group_init_type_name(struct config_group *group, const char *name, | |
125 | struct config_item_type *type) | |
126 | { | |
3958b792 | 127 | config_item_set_name(&group->cg_item, "%s", name); |
7063fbf2 JB |
128 | group->cg_item.ci_type = type; |
129 | config_group_init(group); | |
130 | } | |
131 | EXPORT_SYMBOL(config_group_init_type_name); | |
132 | ||
f6b1fe7c | 133 | struct config_item *config_item_get(struct config_item *item) |
7063fbf2 JB |
134 | { |
135 | if (item) | |
136 | kref_get(&item->ci_kref); | |
137 | return item; | |
138 | } | |
f6b1fe7c | 139 | EXPORT_SYMBOL(config_item_get); |
7063fbf2 | 140 | |
f6b1fe7c | 141 | static void config_item_cleanup(struct config_item *item) |
7063fbf2 | 142 | { |
f6b1fe7c FF |
143 | struct config_item_type *t = item->ci_type; |
144 | struct config_group *s = item->ci_group; | |
145 | struct config_item *parent = item->ci_parent; | |
7063fbf2 | 146 | |
f6b1fe7c | 147 | pr_debug("config_item %s: cleaning up\n", config_item_name(item)); |
7063fbf2 JB |
148 | if (item->ci_name != item->ci_namebuf) |
149 | kfree(item->ci_name); | |
150 | item->ci_name = NULL; | |
151 | if (t && t->ct_item_ops && t->ct_item_ops->release) | |
152 | t->ct_item_ops->release(item); | |
153 | if (s) | |
154 | config_group_put(s); | |
155 | if (parent) | |
156 | config_item_put(parent); | |
157 | } | |
158 | ||
159 | static void config_item_release(struct kref *kref) | |
160 | { | |
161 | config_item_cleanup(container_of(kref, struct config_item, ci_kref)); | |
162 | } | |
163 | ||
164 | /** | |
165 | * config_item_put - decrement refcount for item. | |
166 | * @item: item. | |
167 | * | |
168 | * Decrement the refcount, and if 0, call config_item_cleanup(). | |
169 | */ | |
f6b1fe7c | 170 | void config_item_put(struct config_item *item) |
7063fbf2 JB |
171 | { |
172 | if (item) | |
173 | kref_put(&item->ci_kref, config_item_release); | |
174 | } | |
f6b1fe7c | 175 | EXPORT_SYMBOL(config_item_put); |
7063fbf2 | 176 | |
7063fbf2 JB |
177 | /** |
178 | * config_group_init - initialize a group for use | |
f6b1fe7c | 179 | * @group: config_group |
7063fbf2 | 180 | */ |
7063fbf2 JB |
181 | void config_group_init(struct config_group *group) |
182 | { | |
183 | config_item_init(&group->cg_item); | |
184 | INIT_LIST_HEAD(&group->cg_children); | |
185 | } | |
f6b1fe7c | 186 | EXPORT_SYMBOL(config_group_init); |
7063fbf2 | 187 | |
7063fbf2 | 188 | /** |
3fe6c5ce | 189 | * config_group_find_item - search for item in group. |
7063fbf2 JB |
190 | * @group: group we're looking in. |
191 | * @name: item's name. | |
192 | * | |
3fe6c5ce SS |
193 | * Iterate over @group->cg_list, looking for a matching config_item. |
194 | * If matching item is found take a reference and return the item. | |
195 | * Caller must have locked group via @group->cg_subsys->su_mtx. | |
7063fbf2 | 196 | */ |
3fe6c5ce SS |
197 | struct config_item *config_group_find_item(struct config_group *group, |
198 | const char *name) | |
7063fbf2 | 199 | { |
f6b1fe7c FF |
200 | struct list_head *entry; |
201 | struct config_item *ret = NULL; | |
7063fbf2 | 202 | |
f6b1fe7c FF |
203 | list_for_each(entry, &group->cg_children) { |
204 | struct config_item *item = to_item(entry); | |
7063fbf2 | 205 | if (config_item_name(item) && |
3fe6c5ce | 206 | !strcmp(config_item_name(item), name)) { |
7063fbf2 JB |
207 | ret = config_item_get(item); |
208 | break; | |
209 | } | |
210 | } | |
211 | return ret; | |
212 | } | |
3fe6c5ce | 213 | EXPORT_SYMBOL(config_group_find_item); |