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/mount.h>
15 #include <linux/module.h>
16 #include <linux/kobject.h>
17 #include <linux/namei.h>
18 #include <linux/mutex.h>
19 #include <linux/security.h>
23 static int sysfs_do_create_link(struct kobject
*kobj
, struct kobject
*target
,
24 const char *name
, int warn
)
26 struct sysfs_dirent
*parent_sd
= NULL
;
27 struct sysfs_dirent
*target_sd
= NULL
;
28 struct sysfs_dirent
*sd
= NULL
;
29 struct sysfs_addrm_cxt acxt
;
35 parent_sd
= &sysfs_root
;
43 /* target->sd can go away beneath us but is protected with
44 * sysfs_assoc_lock. Fetch target_sd from it.
46 spin_lock(&sysfs_assoc_lock
);
48 target_sd
= sysfs_get(target
->sd
);
49 spin_unlock(&sysfs_assoc_lock
);
56 sd
= sysfs_new_dirent(name
, S_IFLNK
|S_IRWXUGO
, SYSFS_KOBJ_LINK
);
60 sd
->s_symlink
.target_sd
= target_sd
;
61 target_sd
= NULL
; /* reference is now owned by the symlink */
63 sysfs_addrm_start(&acxt
, parent_sd
);
65 error
= sysfs_add_one(&acxt
, sd
);
67 error
= __sysfs_add_one(&acxt
, sd
);
68 sysfs_addrm_finish(&acxt
);
82 * sysfs_create_link - create symlink between two objects.
83 * @kobj: object whose directory we're creating the link in.
84 * @target: object we're pointing to.
85 * @name: name of the symlink.
87 int sysfs_create_link(struct kobject
*kobj
, struct kobject
*target
,
90 return sysfs_do_create_link(kobj
, target
, name
, 1);
94 * sysfs_create_link_nowarn - create symlink between two objects.
95 * @kobj: object whose directory we're creating the link in.
96 * @target: object we're pointing to.
97 * @name: name of the symlink.
99 * This function does the same as sysf_create_link(), but it
100 * doesn't warn if the link already exists.
102 int sysfs_create_link_nowarn(struct kobject
*kobj
, struct kobject
*target
,
105 return sysfs_do_create_link(kobj
, target
, name
, 0);
109 * sysfs_remove_link - remove symlink in object's directory.
110 * @kobj: object we're acting for.
111 * @name: name of the symlink to remove.
114 void sysfs_remove_link(struct kobject
* kobj
, const char * name
)
116 struct sysfs_dirent
*parent_sd
= NULL
;
119 parent_sd
= &sysfs_root
;
121 parent_sd
= kobj
->sd
;
123 sysfs_hash_and_remove(parent_sd
, name
);
127 * sysfs_rename_link - rename symlink in object's directory.
128 * @kobj: object we're acting for.
129 * @targ: object we're pointing to.
130 * @old: previous name of the symlink.
131 * @new: new name of the symlink.
133 * A helper function for the common rename symlink idiom.
135 int sysfs_rename_link(struct kobject
*kobj
, struct kobject
*targ
,
136 const char *old
, const char *new)
138 struct sysfs_dirent
*parent_sd
, *sd
= NULL
;
142 parent_sd
= &sysfs_root
;
144 parent_sd
= kobj
->sd
;
147 sd
= sysfs_get_dirent(parent_sd
, old
);
152 if (sysfs_type(sd
) != SYSFS_KOBJ_LINK
)
154 if (sd
->s_symlink
.target_sd
->s_dir
.kobj
!= targ
)
157 result
= sysfs_rename(sd
, parent_sd
, new);
164 static int sysfs_get_target_path(struct sysfs_dirent
*parent_sd
,
165 struct sysfs_dirent
*target_sd
, char *path
)
167 struct sysfs_dirent
*base
, *sd
;
171 /* go up to the root, stop at the base */
173 while (base
->s_parent
) {
174 sd
= target_sd
->s_parent
;
175 while (sd
->s_parent
&& base
!= sd
)
183 base
= base
->s_parent
;
186 /* determine end of target string for reverse fillup */
188 while (sd
->s_parent
&& sd
!= base
) {
189 len
+= strlen(sd
->s_name
) + 1;
197 if ((s
- path
) + len
> PATH_MAX
)
198 return -ENAMETOOLONG
;
200 /* reverse fillup of target string from target to base */
202 while (sd
->s_parent
&& sd
!= base
) {
203 int slen
= strlen(sd
->s_name
);
206 strncpy(s
+ len
, sd
->s_name
, slen
);
216 static int sysfs_getlink(struct dentry
*dentry
, char * path
)
218 struct sysfs_dirent
*sd
= dentry
->d_fsdata
;
219 struct sysfs_dirent
*parent_sd
= sd
->s_parent
;
220 struct sysfs_dirent
*target_sd
= sd
->s_symlink
.target_sd
;
223 mutex_lock(&sysfs_mutex
);
224 error
= sysfs_get_target_path(parent_sd
, target_sd
, path
);
225 mutex_unlock(&sysfs_mutex
);
230 static void *sysfs_follow_link(struct dentry
*dentry
, struct nameidata
*nd
)
233 unsigned long page
= get_zeroed_page(GFP_KERNEL
);
235 error
= sysfs_getlink(dentry
, (char *) page
);
237 free_page((unsigned long)page
);
239 nd_set_link(nd
, error
? ERR_PTR(error
) : (char *)page
);
243 static void sysfs_put_link(struct dentry
*dentry
, struct nameidata
*nd
, void *cookie
)
245 char *page
= nd_get_link(nd
);
247 free_page((unsigned long)page
);
250 const struct inode_operations sysfs_symlink_inode_operations
= {
251 .setxattr
= sysfs_setxattr
,
252 .readlink
= generic_readlink
,
253 .follow_link
= sysfs_follow_link
,
254 .put_link
= sysfs_put_link
,
255 .setattr
= sysfs_setattr
,
256 .getattr
= sysfs_getattr
,
257 .permission
= sysfs_permission
,
261 EXPORT_SYMBOL_GPL(sysfs_create_link
);
262 EXPORT_SYMBOL_GPL(sysfs_remove_link
);