symlink.c 4.85 KB
Newer Older
Linus Torvalds's avatar
Linus Torvalds committed
1
/*
Tejun Heo's avatar
Tejun Heo committed
2 3 4 5 6 7 8 9 10
 * fs/sysfs/symlink.c - sysfs symlink implementation
 *
 * Copyright (c) 2001-3 Patrick Mochel
 * Copyright (c) 2007 SUSE Linux Products GmbH
 * Copyright (c) 2007 Tejun Heo <teheo@suse.de>
 *
 * This file is released under the GPLv2.
 *
 * Please see Documentation/filesystems/sysfs.txt for more information.
Linus Torvalds's avatar
Linus Torvalds committed
11 12 13 14 15
 */

#include <linux/fs.h>
#include <linux/module.h>
#include <linux/kobject.h>
Dave Young's avatar
Dave Young committed
16
#include <linux/mutex.h>
17
#include <linux/security.h>
Linus Torvalds's avatar
Linus Torvalds committed
18 19 20

#include "sysfs.h"

21 22 23
static int sysfs_do_create_link_sd(struct sysfs_dirent *parent_sd,
				   struct kobject *target,
				   const char *name, int warn)
Linus Torvalds's avatar
Linus Torvalds committed
24
{
25
	struct sysfs_dirent *sd, *target_sd = NULL;
Linus Torvalds's avatar
Linus Torvalds committed
26

27
	BUG_ON(!name || !parent_sd);
28

29 30 31 32
	/*
	 * We don't own @target and it may be removed at any time.
	 * Synchronize using sysfs_symlink_target_lock.  See
	 * sysfs_remove_dir() for details.
33
	 */
34
	spin_lock(&sysfs_symlink_target_lock);
35 36 37 38
	if (target->sd) {
		target_sd = target->sd;
		kernfs_get(target_sd);
	}
39
	spin_unlock(&sysfs_symlink_target_lock);
40 41

	if (!target_sd)
42
		return -ENOENT;
43

44
	sd = kernfs_create_link(parent_sd, name, target_sd);
45
	kernfs_put(target_sd);
46

47 48
	if (!IS_ERR(sd))
		return 0;
49

50 51 52
	if (warn && PTR_ERR(sd) == -EEXIST)
		sysfs_warn_dup(parent_sd, name);
	return PTR_ERR(sd);
Linus Torvalds's avatar
Linus Torvalds committed
53 54
}

55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72
/**
 *	sysfs_create_link_sd - create symlink to a given object.
 *	@sd:		directory we're creating the link in.
 *	@target:	object we're pointing to.
 *	@name:		name of the symlink.
 */
int sysfs_create_link_sd(struct sysfs_dirent *sd, struct kobject *target,
			 const char *name)
{
	return sysfs_do_create_link_sd(sd, target, name, 1);
}

static int sysfs_do_create_link(struct kobject *kobj, struct kobject *target,
				const char *name, int warn)
{
	struct sysfs_dirent *parent_sd = NULL;

	if (!kobj)
73
		parent_sd = sysfs_root_sd;
74 75 76 77 78 79 80 81 82
	else
		parent_sd = kobj->sd;

	if (!parent_sd)
		return -EFAULT;

	return sysfs_do_create_link_sd(parent_sd, target, name, warn);
}

83 84 85 86 87 88 89 90 91 92 93
/**
 *	sysfs_create_link - create symlink between two objects.
 *	@kobj:	object whose directory we're creating the link in.
 *	@target:	object we're pointing to.
 *	@name:		name of the symlink.
 */
int sysfs_create_link(struct kobject *kobj, struct kobject *target,
		      const char *name)
{
	return sysfs_do_create_link(kobj, target, name, 1);
}
94
EXPORT_SYMBOL_GPL(sysfs_create_link);
95 96 97 98 99 100 101

/**
 *	sysfs_create_link_nowarn - create symlink between two objects.
 *	@kobj:	object whose directory we're creating the link in.
 *	@target:	object we're pointing to.
 *	@name:		name of the symlink.
 *
102
 *	This function does the same as sysfs_create_link(), but it
103 104 105 106 107 108 109 110
 *	doesn't warn if the link already exists.
 */
int sysfs_create_link_nowarn(struct kobject *kobj, struct kobject *target,
			     const char *name)
{
	return sysfs_do_create_link(kobj, target, name, 0);
}

111 112 113 114 115 116 117 118 119 120 121 122 123
/**
 *	sysfs_delete_link - remove symlink in object's directory.
 *	@kobj:	object we're acting for.
 *	@targ:	object we're pointing to.
 *	@name:	name of the symlink to remove.
 *
 *	Unlike sysfs_remove_link sysfs_delete_link has enough information
 *	to successfully delete symlinks in tagged directories.
 */
void sysfs_delete_link(struct kobject *kobj, struct kobject *targ,
			const char *name)
{
	const void *ns = NULL;
124 125 126 127 128 129 130

	/*
	 * We don't own @target and it may be removed at any time.
	 * Synchronize using sysfs_symlink_target_lock.  See
	 * sysfs_remove_dir() for details.
	 */
	spin_lock(&sysfs_symlink_target_lock);
131
	if (targ->sd && kernfs_ns_enabled(kobj->sd))
132
		ns = targ->sd->s_ns;
133
	spin_unlock(&sysfs_symlink_target_lock);
134
	kernfs_remove_by_name_ns(kobj->sd, name, ns);
135 136
}

Linus Torvalds's avatar
Linus Torvalds committed
137 138 139 140 141
/**
 *	sysfs_remove_link - remove symlink in object's directory.
 *	@kobj:	object we're acting for.
 *	@name:	name of the symlink to remove.
 */
142
void sysfs_remove_link(struct kobject *kobj, const char *name)
Linus Torvalds's avatar
Linus Torvalds committed
143
{
144 145 146
	struct sysfs_dirent *parent_sd = NULL;

	if (!kobj)
147
		parent_sd = sysfs_root_sd;
148 149 150
	else
		parent_sd = kobj->sd;

151
	kernfs_remove_by_name(parent_sd, name);
Linus Torvalds's avatar
Linus Torvalds committed
152
}
153
EXPORT_SYMBOL_GPL(sysfs_remove_link);
Linus Torvalds's avatar
Linus Torvalds committed
154

155
/**
156
 *	sysfs_rename_link_ns - rename symlink in object's directory.
157 158 159 160
 *	@kobj:	object we're acting for.
 *	@targ:	object we're pointing to.
 *	@old:	previous name of the symlink.
 *	@new:	new name of the symlink.
161
 *	@new_ns: new namespace of the symlink.
162 163 164
 *
 *	A helper function for the common rename symlink idiom.
 */
165 166
int sysfs_rename_link_ns(struct kobject *kobj, struct kobject *targ,
			 const char *old, const char *new, const void *new_ns)
167 168
{
	struct sysfs_dirent *parent_sd, *sd = NULL;
169
	const void *old_ns = NULL;
170 171 172
	int result;

	if (!kobj)
173
		parent_sd = sysfs_root_sd;
174 175 176
	else
		parent_sd = kobj->sd;

177 178 179
	if (targ->sd)
		old_ns = targ->sd->s_ns;

180
	result = -ENOENT;
181
	sd = kernfs_find_and_get_ns(parent_sd, old, old_ns);
182 183 184 185 186 187
	if (!sd)
		goto out;

	result = -EINVAL;
	if (sysfs_type(sd) != SYSFS_KOBJ_LINK)
		goto out;
188
	if (sd->s_symlink.target_sd->priv != targ)
189 190
		goto out;

191
	result = kernfs_rename_ns(sd, parent_sd, new, new_ns);
192 193

out:
194
	kernfs_put(sd);
195 196
	return result;
}
197
EXPORT_SYMBOL_GPL(sysfs_rename_link_ns);