blob: 1b9a3a1e8a17a1e3951980b3b4179d06a2b0a916 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
Tejun Heo6d66f5c2007-09-20 17:31:38 +09002 * fs/sysfs/symlink.c - sysfs symlink implementation
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 * Please see Documentation/filesystems/sysfs.txt for more information.
Linus Torvalds1da177e2005-04-16 15:20:36 -070011 */
12
13#include <linux/fs.h>
Greg Kroah-Hartmanceeee1f2002-04-09 12:14:34 -070014#include <linux/mount.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070015#include <linux/module.h>
16#include <linux/kobject.h>
17#include <linux/namei.h>
Dave Young869512a2007-07-26 14:53:53 +000018#include <linux/mutex.h>
David P. Quigleyddd29ec2009-09-09 14:25:37 -040019#include <linux/security.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070020
21#include "sysfs.h"
22
Cornelia Huck36ce6da2008-06-10 11:09:08 +020023static int sysfs_do_create_link(struct kobject *kobj, struct kobject *target,
24 const char *name, int warn)
Linus Torvalds1da177e2005-04-16 15:20:36 -070025{
Tejun Heo2b29ac22007-06-14 03:45:15 +090026 struct sysfs_dirent *parent_sd = NULL;
27 struct sysfs_dirent *target_sd = NULL;
Tejun Heo3007e992007-06-14 04:27:23 +090028 struct sysfs_dirent *sd = NULL;
Tejun Heofb6896d2007-06-14 04:27:24 +090029 struct sysfs_addrm_cxt acxt;
Tejun Heo3007e992007-06-14 04:27:23 +090030 int error;
Linus Torvalds1da177e2005-04-16 15:20:36 -070031
Greg Kroah-Hartmanceeee1f2002-04-09 12:14:34 -070032 BUG_ON(!name);
33
Eric W. Biederman7d0c7d62007-08-20 21:36:30 +090034 if (!kobj)
35 parent_sd = &sysfs_root;
36 else
Tejun Heo608e2662007-06-14 04:27:22 +090037 parent_sd = kobj->sd;
Greg Kroah-Hartmanceeee1f2002-04-09 12:14:34 -070038
Tejun Heo3007e992007-06-14 04:27:23 +090039 error = -EFAULT;
Tejun Heo608e2662007-06-14 04:27:22 +090040 if (!parent_sd)
Tejun Heo3007e992007-06-14 04:27:23 +090041 goto out_put;
Tejun Heo2b29ac22007-06-14 03:45:15 +090042
Tejun Heo608e2662007-06-14 04:27:22 +090043 /* target->sd can go away beneath us but is protected with
Tejun Heo5f995322007-06-14 04:27:23 +090044 * sysfs_assoc_lock. Fetch target_sd from it.
Tejun Heo2b29ac22007-06-14 03:45:15 +090045 */
Tejun Heo5f995322007-06-14 04:27:23 +090046 spin_lock(&sysfs_assoc_lock);
Tejun Heo608e2662007-06-14 04:27:22 +090047 if (target->sd)
48 target_sd = sysfs_get(target->sd);
Tejun Heo5f995322007-06-14 04:27:23 +090049 spin_unlock(&sysfs_assoc_lock);
Tejun Heo2b29ac22007-06-14 03:45:15 +090050
Tejun Heo3007e992007-06-14 04:27:23 +090051 error = -ENOENT;
Tejun Heo2b29ac22007-06-14 03:45:15 +090052 if (!target_sd)
Tejun Heo3007e992007-06-14 04:27:23 +090053 goto out_put;
Linus Torvalds1da177e2005-04-16 15:20:36 -070054
Tejun Heo3007e992007-06-14 04:27:23 +090055 error = -ENOMEM;
56 sd = sysfs_new_dirent(name, S_IFLNK|S_IRWXUGO, SYSFS_KOBJ_LINK);
57 if (!sd)
58 goto out_put;
Tejun Heoa1da4df2007-07-18 16:14:45 +090059
Tejun Heob1fc3d62007-09-20 16:05:11 +090060 sd->s_symlink.target_sd = target_sd;
Tejun Heoa1da4df2007-07-18 16:14:45 +090061 target_sd = NULL; /* reference is now owned by the symlink */
Tejun Heo2b29ac22007-06-14 03:45:15 +090062
Tejun Heofb6896d2007-06-14 04:27:24 +090063 sysfs_addrm_start(&acxt, parent_sd);
Cornelia Huck36ce6da2008-06-10 11:09:08 +020064 if (warn)
65 error = sysfs_add_one(&acxt, sd);
66 else
67 error = __sysfs_add_one(&acxt, sd);
Tejun Heo23dc2792007-08-02 21:38:03 +090068 sysfs_addrm_finish(&acxt);
Tejun Heofb6896d2007-06-14 04:27:24 +090069
Tejun Heo23dc2792007-08-02 21:38:03 +090070 if (error)
Tejun Heo967e35d2007-07-18 16:38:11 +090071 goto out_put;
Tejun Heofb6896d2007-06-14 04:27:24 +090072
Tejun Heo967e35d2007-07-18 16:38:11 +090073 return 0;
74
Tejun Heo3007e992007-06-14 04:27:23 +090075 out_put:
76 sysfs_put(target_sd);
77 sysfs_put(sd);
Linus Torvalds1da177e2005-04-16 15:20:36 -070078 return error;
79}
80
Linus Torvalds1da177e2005-04-16 15:20:36 -070081/**
Cornelia Huck36ce6da2008-06-10 11:09:08 +020082 * 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.
86 */
87int sysfs_create_link(struct kobject *kobj, struct kobject *target,
88 const char *name)
89{
90 return sysfs_do_create_link(kobj, target, name, 1);
91}
92
93/**
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.
98 *
99 * This function does the same as sysf_create_link(), but it
100 * doesn't warn if the link already exists.
101 */
102int sysfs_create_link_nowarn(struct kobject *kobj, struct kobject *target,
103 const char *name)
104{
105 return sysfs_do_create_link(kobj, target, name, 0);
106}
107
108/**
Linus Torvalds1da177e2005-04-16 15:20:36 -0700109 * sysfs_remove_link - remove symlink in object's directory.
110 * @kobj: object we're acting for.
111 * @name: name of the symlink to remove.
112 */
113
Dmitry Torokhove3a15db2005-04-26 02:31:08 -0500114void sysfs_remove_link(struct kobject * kobj, const char * name)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700115{
Mark Fasheha839c5a2008-01-29 14:35:18 -0800116 struct sysfs_dirent *parent_sd = NULL;
117
118 if (!kobj)
119 parent_sd = &sysfs_root;
120 else
121 parent_sd = kobj->sd;
122
123 sysfs_hash_and_remove(parent_sd, name);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700124}
125
Eric W. Biederman7cb32942010-02-12 19:22:25 -0800126/**
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.
132 *
133 * A helper function for the common rename symlink idiom.
134 */
135int sysfs_rename_link(struct kobject *kobj, struct kobject *targ,
136 const char *old, const char *new)
137{
138 struct sysfs_dirent *parent_sd, *sd = NULL;
139 int result;
140
141 if (!kobj)
142 parent_sd = &sysfs_root;
143 else
144 parent_sd = kobj->sd;
145
146 result = -ENOENT;
147 sd = sysfs_get_dirent(parent_sd, old);
148 if (!sd)
149 goto out;
150
151 result = -EINVAL;
152 if (sysfs_type(sd) != SYSFS_KOBJ_LINK)
153 goto out;
154 if (sd->s_symlink.target_sd->s_dir.kobj != targ)
155 goto out;
156
157 result = sysfs_rename(sd, parent_sd, new);
158
159out:
160 sysfs_put(sd);
161 return result;
162}
163
Kay Sievers2f90a852007-11-01 20:20:52 +0100164static int sysfs_get_target_path(struct sysfs_dirent *parent_sd,
165 struct sysfs_dirent *target_sd, char *path)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700166{
Kay Sievers2f90a852007-11-01 20:20:52 +0100167 struct sysfs_dirent *base, *sd;
168 char *s = path;
169 int len = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700170
Kay Sievers2f90a852007-11-01 20:20:52 +0100171 /* go up to the root, stop at the base */
172 base = parent_sd;
173 while (base->s_parent) {
174 sd = target_sd->s_parent;
175 while (sd->s_parent && base != sd)
176 sd = sd->s_parent;
177
178 if (base == sd)
179 break;
180
181 strcpy(s, "../");
182 s += 3;
183 base = base->s_parent;
184 }
185
186 /* determine end of target string for reverse fillup */
187 sd = target_sd;
188 while (sd->s_parent && sd != base) {
189 len += strlen(sd->s_name) + 1;
190 sd = sd->s_parent;
191 }
192
193 /* check limits */
194 if (len < 2)
195 return -EINVAL;
196 len--;
197 if ((s - path) + len > PATH_MAX)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700198 return -ENAMETOOLONG;
199
Kay Sievers2f90a852007-11-01 20:20:52 +0100200 /* reverse fillup of target string from target to base */
201 sd = target_sd;
202 while (sd->s_parent && sd != base) {
203 int slen = strlen(sd->s_name);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700204
Kay Sievers2f90a852007-11-01 20:20:52 +0100205 len -= slen;
206 strncpy(s + len, sd->s_name, slen);
207 if (len)
208 s[--len] = '/';
Linus Torvalds1da177e2005-04-16 15:20:36 -0700209
Kay Sievers2f90a852007-11-01 20:20:52 +0100210 sd = sd->s_parent;
211 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700212
213 return 0;
214}
215
216static int sysfs_getlink(struct dentry *dentry, char * path)
217{
Tejun Heo2b29ac22007-06-14 03:45:15 +0900218 struct sysfs_dirent *sd = dentry->d_fsdata;
219 struct sysfs_dirent *parent_sd = sd->s_parent;
Tejun Heob1fc3d62007-09-20 16:05:11 +0900220 struct sysfs_dirent *target_sd = sd->s_symlink.target_sd;
Tejun Heo2b29ac22007-06-14 03:45:15 +0900221 int error;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700222
Tejun Heo3007e992007-06-14 04:27:23 +0900223 mutex_lock(&sysfs_mutex);
Tejun Heo2b29ac22007-06-14 03:45:15 +0900224 error = sysfs_get_target_path(parent_sd, target_sd, path);
Tejun Heo3007e992007-06-14 04:27:23 +0900225 mutex_unlock(&sysfs_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700226
Tejun Heo2b29ac22007-06-14 03:45:15 +0900227 return error;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700228}
229
Linus Torvaldscc314ee2005-08-19 18:02:56 -0700230static void *sysfs_follow_link(struct dentry *dentry, struct nameidata *nd)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700231{
232 int error = -ENOMEM;
233 unsigned long page = get_zeroed_page(GFP_KERNEL);
Armin Kuster557411e2009-04-29 07:29:59 -1000234 if (page) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700235 error = sysfs_getlink(dentry, (char *) page);
Armin Kuster557411e2009-04-29 07:29:59 -1000236 if (error < 0)
237 free_page((unsigned long)page);
238 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700239 nd_set_link(nd, error ? ERR_PTR(error) : (char *)page);
Linus Torvaldscc314ee2005-08-19 18:02:56 -0700240 return NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700241}
242
Linus Torvaldscc314ee2005-08-19 18:02:56 -0700243static void sysfs_put_link(struct dentry *dentry, struct nameidata *nd, void *cookie)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700244{
245 char *page = nd_get_link(nd);
246 if (!IS_ERR(page))
247 free_page((unsigned long)page);
248}
249
Arjan van de Venc5ef1c42007-02-12 00:55:40 -0800250const struct inode_operations sysfs_symlink_inode_operations = {
Eric W. Biedermanc099aac2009-11-20 16:08:52 -0800251 .setxattr = sysfs_setxattr,
252 .readlink = generic_readlink,
253 .follow_link = sysfs_follow_link,
254 .put_link = sysfs_put_link,
Eric W. Biedermane61ab4a2009-11-20 16:08:53 -0800255 .setattr = sysfs_setattr,
256 .getattr = sysfs_getattr,
257 .permission = sysfs_permission,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700258};
259
260
261EXPORT_SYMBOL_GPL(sysfs_create_link);
262EXPORT_SYMBOL_GPL(sysfs_remove_link);