2 * fs/sysfs/symlink.c - sysfs symlink implementation
4 * Copyright (c) 2001-3 Patrick Mochel
5 * Copyright (c) 2007 SUSE Linux Products GmbH
6 * Copyright (c) 2007 Tejun Heo <teheo@suse.de>
8 * This file is released under the GPLv2.
10 * Please see Documentation/filesystems/sysfs.txt for more information.
14 #include <linux/gfp.h>
15 #include <linux/mount.h>
16 #include <linux/module.h>
17 #include <linux/kobject.h>
18 #include <linux/namei.h>
19 #include <linux/mutex.h>
20 #include <linux/security.h>
24 static int sysfs_do_create_link(struct kobject
*kobj
, struct kobject
*target
,
25 const char *name
, int warn
)
27 struct sysfs_dirent
*parent_sd
= NULL
;
28 struct sysfs_dirent
*target_sd
= NULL
;
29 struct sysfs_dirent
*sd
= NULL
;
30 struct sysfs_addrm_cxt acxt
;
31 enum kobj_ns_type ns_type
;
37 parent_sd
= &sysfs_root
;
45 /* target->sd can go away beneath us but is protected with
46 * sysfs_assoc_lock. Fetch target_sd from it.
48 spin_lock(&sysfs_assoc_lock
);
50 target_sd
= sysfs_get(target
->sd
);
51 spin_unlock(&sysfs_assoc_lock
);
58 sd
= sysfs_new_dirent(name
, S_IFLNK
|S_IRWXUGO
, SYSFS_KOBJ_LINK
);
62 ns_type
= sysfs_ns_type(parent_sd
);
64 sd
->s_ns
= target
->ktype
->namespace(target
);
65 sd
->s_symlink
.target_sd
= target_sd
;
66 target_sd
= NULL
; /* reference is now owned by the symlink */
68 sysfs_addrm_start(&acxt
, parent_sd
);
69 /* Symlinks must be between directories with the same ns_type */
71 (ns_type
== sysfs_ns_type(sd
->s_symlink
.target_sd
->s_parent
))) {
73 error
= sysfs_add_one(&acxt
, sd
);
75 error
= __sysfs_add_one(&acxt
, sd
);
79 "sysfs: symlink across ns_types %s/%s -> %s/%s\n",
82 sd
->s_symlink
.target_sd
->s_parent
->s_name
,
83 sd
->s_symlink
.target_sd
->s_name
);
85 sysfs_addrm_finish(&acxt
);
99 * sysfs_create_link - create symlink between two objects.
100 * @kobj: object whose directory we're creating the link in.
101 * @target: object we're pointing to.
102 * @name: name of the symlink.
104 int sysfs_create_link(struct kobject
*kobj
, struct kobject
*target
,
107 return sysfs_do_create_link(kobj
, target
, name
, 1);
111 * sysfs_create_link_nowarn - create symlink between two objects.
112 * @kobj: object whose directory we're creating the link in.
113 * @target: object we're pointing to.
114 * @name: name of the symlink.
116 * This function does the same as sysf_create_link(), but it
117 * doesn't warn if the link already exists.
119 int sysfs_create_link_nowarn(struct kobject
*kobj
, struct kobject
*target
,
122 return sysfs_do_create_link(kobj
, target
, name
, 0);
126 * sysfs_delete_link - remove symlink in object's directory.
127 * @kobj: object we're acting for.
128 * @targ: object we're pointing to.
129 * @name: name of the symlink to remove.
131 * Unlike sysfs_remove_link sysfs_delete_link has enough information
132 * to successfully delete symlinks in tagged directories.
134 void sysfs_delete_link(struct kobject
*kobj
, struct kobject
*targ
,
137 const void *ns
= NULL
;
138 spin_lock(&sysfs_assoc_lock
);
139 if (targ
->sd
&& sysfs_ns_type(kobj
->sd
))
141 spin_unlock(&sysfs_assoc_lock
);
142 sysfs_hash_and_remove(kobj
->sd
, ns
, name
);
146 * sysfs_remove_link - remove symlink in object's directory.
147 * @kobj: object we're acting for.
148 * @name: name of the symlink to remove.
151 void sysfs_remove_link(struct kobject
* kobj
, const char * name
)
153 struct sysfs_dirent
*parent_sd
= NULL
;
156 parent_sd
= &sysfs_root
;
158 parent_sd
= kobj
->sd
;
160 sysfs_hash_and_remove(parent_sd
, NULL
, name
);
164 * sysfs_rename_link - rename symlink in object's directory.
165 * @kobj: object we're acting for.
166 * @targ: object we're pointing to.
167 * @old: previous name of the symlink.
168 * @new: new name of the symlink.
170 * A helper function for the common rename symlink idiom.
172 int sysfs_rename_link(struct kobject
*kobj
, struct kobject
*targ
,
173 const char *old
, const char *new)
175 struct sysfs_dirent
*parent_sd
, *sd
= NULL
;
176 const void *old_ns
= NULL
, *new_ns
= NULL
;
180 parent_sd
= &sysfs_root
;
182 parent_sd
= kobj
->sd
;
185 old_ns
= targ
->sd
->s_ns
;
188 sd
= sysfs_get_dirent(parent_sd
, old_ns
, old
);
193 if (sysfs_type(sd
) != SYSFS_KOBJ_LINK
)
195 if (sd
->s_symlink
.target_sd
->s_dir
.kobj
!= targ
)
198 if (sysfs_ns_type(parent_sd
))
199 new_ns
= targ
->ktype
->namespace(targ
);
201 result
= sysfs_rename(sd
, parent_sd
, new_ns
, new);
208 static int sysfs_get_target_path(struct sysfs_dirent
*parent_sd
,
209 struct sysfs_dirent
*target_sd
, char *path
)
211 struct sysfs_dirent
*base
, *sd
;
215 /* go up to the root, stop at the base */
217 while (base
->s_parent
) {
218 sd
= target_sd
->s_parent
;
219 while (sd
->s_parent
&& base
!= sd
)
227 base
= base
->s_parent
;
230 /* determine end of target string for reverse fillup */
232 while (sd
->s_parent
&& sd
!= base
) {
233 len
+= strlen(sd
->s_name
) + 1;
241 if ((s
- path
) + len
> PATH_MAX
)
242 return -ENAMETOOLONG
;
244 /* reverse fillup of target string from target to base */
246 while (sd
->s_parent
&& sd
!= base
) {
247 int slen
= strlen(sd
->s_name
);
250 strncpy(s
+ len
, sd
->s_name
, slen
);
260 static int sysfs_getlink(struct dentry
*dentry
, char * path
)
262 struct sysfs_dirent
*sd
= dentry
->d_fsdata
;
263 struct sysfs_dirent
*parent_sd
= sd
->s_parent
;
264 struct sysfs_dirent
*target_sd
= sd
->s_symlink
.target_sd
;
267 mutex_lock(&sysfs_mutex
);
268 error
= sysfs_get_target_path(parent_sd
, target_sd
, path
);
269 mutex_unlock(&sysfs_mutex
);
274 static void *sysfs_follow_link(struct dentry
*dentry
, struct nameidata
*nd
)
277 unsigned long page
= get_zeroed_page(GFP_KERNEL
);
279 error
= sysfs_getlink(dentry
, (char *) page
);
281 free_page((unsigned long)page
);
283 nd_set_link(nd
, error
? ERR_PTR(error
) : (char *)page
);
287 static void sysfs_put_link(struct dentry
*dentry
, struct nameidata
*nd
, void *cookie
)
289 char *page
= nd_get_link(nd
);
291 free_page((unsigned long)page
);
294 const struct inode_operations sysfs_symlink_inode_operations
= {
295 .setxattr
= sysfs_setxattr
,
296 .readlink
= generic_readlink
,
297 .follow_link
= sysfs_follow_link
,
298 .put_link
= sysfs_put_link
,
299 .setattr
= sysfs_setattr
,
300 .getattr
= sysfs_getattr
,
301 .permission
= sysfs_permission
,
305 EXPORT_SYMBOL_GPL(sysfs_create_link
);
306 EXPORT_SYMBOL_GPL(sysfs_remove_link
);
307 EXPORT_SYMBOL_GPL(sysfs_rename_link
);