blob: c5081ad77026e95689e58fda616dc0784b958044 [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
Kay Sievers2f90a852007-11-01 20:20:52 +0100126static int sysfs_get_target_path(struct sysfs_dirent *parent_sd,
127 struct sysfs_dirent *target_sd, char *path)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700128{
Kay Sievers2f90a852007-11-01 20:20:52 +0100129 struct sysfs_dirent *base, *sd;
130 char *s = path;
131 int len = 0;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700132
Kay Sievers2f90a852007-11-01 20:20:52 +0100133 /* go up to the root, stop at the base */
134 base = parent_sd;
135 while (base->s_parent) {
136 sd = target_sd->s_parent;
137 while (sd->s_parent && base != sd)
138 sd = sd->s_parent;
139
140 if (base == sd)
141 break;
142
143 strcpy(s, "../");
144 s += 3;
145 base = base->s_parent;
146 }
147
148 /* determine end of target string for reverse fillup */
149 sd = target_sd;
150 while (sd->s_parent && sd != base) {
151 len += strlen(sd->s_name) + 1;
152 sd = sd->s_parent;
153 }
154
155 /* check limits */
156 if (len < 2)
157 return -EINVAL;
158 len--;
159 if ((s - path) + len > PATH_MAX)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700160 return -ENAMETOOLONG;
161
Kay Sievers2f90a852007-11-01 20:20:52 +0100162 /* reverse fillup of target string from target to base */
163 sd = target_sd;
164 while (sd->s_parent && sd != base) {
165 int slen = strlen(sd->s_name);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700166
Kay Sievers2f90a852007-11-01 20:20:52 +0100167 len -= slen;
168 strncpy(s + len, sd->s_name, slen);
169 if (len)
170 s[--len] = '/';
Linus Torvalds1da177e2005-04-16 15:20:36 -0700171
Kay Sievers2f90a852007-11-01 20:20:52 +0100172 sd = sd->s_parent;
173 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700174
175 return 0;
176}
177
178static int sysfs_getlink(struct dentry *dentry, char * path)
179{
Tejun Heo2b29ac22007-06-14 03:45:15 +0900180 struct sysfs_dirent *sd = dentry->d_fsdata;
181 struct sysfs_dirent *parent_sd = sd->s_parent;
Tejun Heob1fc3d62007-09-20 16:05:11 +0900182 struct sysfs_dirent *target_sd = sd->s_symlink.target_sd;
Tejun Heo2b29ac22007-06-14 03:45:15 +0900183 int error;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700184
Tejun Heo3007e992007-06-14 04:27:23 +0900185 mutex_lock(&sysfs_mutex);
Tejun Heo2b29ac22007-06-14 03:45:15 +0900186 error = sysfs_get_target_path(parent_sd, target_sd, path);
Tejun Heo3007e992007-06-14 04:27:23 +0900187 mutex_unlock(&sysfs_mutex);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700188
Tejun Heo2b29ac22007-06-14 03:45:15 +0900189 return error;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700190}
191
Linus Torvaldscc314ee2005-08-19 18:02:56 -0700192static void *sysfs_follow_link(struct dentry *dentry, struct nameidata *nd)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700193{
194 int error = -ENOMEM;
195 unsigned long page = get_zeroed_page(GFP_KERNEL);
Armin Kuster557411e2009-04-29 07:29:59 -1000196 if (page) {
Linus Torvalds1da177e2005-04-16 15:20:36 -0700197 error = sysfs_getlink(dentry, (char *) page);
Armin Kuster557411e2009-04-29 07:29:59 -1000198 if (error < 0)
199 free_page((unsigned long)page);
200 }
Linus Torvalds1da177e2005-04-16 15:20:36 -0700201 nd_set_link(nd, error ? ERR_PTR(error) : (char *)page);
Linus Torvaldscc314ee2005-08-19 18:02:56 -0700202 return NULL;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700203}
204
Linus Torvaldscc314ee2005-08-19 18:02:56 -0700205static void sysfs_put_link(struct dentry *dentry, struct nameidata *nd, void *cookie)
Linus Torvalds1da177e2005-04-16 15:20:36 -0700206{
207 char *page = nd_get_link(nd);
208 if (!IS_ERR(page))
209 free_page((unsigned long)page);
210}
211
Arjan van de Venc5ef1c42007-02-12 00:55:40 -0800212const struct inode_operations sysfs_symlink_inode_operations = {
David P. Quigleyddd29ec2009-09-09 14:25:37 -0400213 .setxattr = sysfs_setxattr,
Linus Torvalds1da177e2005-04-16 15:20:36 -0700214 .readlink = generic_readlink,
215 .follow_link = sysfs_follow_link,
216 .put_link = sysfs_put_link,
217};
218
219
220EXPORT_SYMBOL_GPL(sysfs_create_link);
221EXPORT_SYMBOL_GPL(sysfs_remove_link);