Linux Audio

Check our new training course

Loading...
v6.2
   1// SPDX-License-Identifier: GPL-2.0-only
   2/*
   3  File: fs/xattr.c
   4
   5  Extended attribute handling.
   6
   7  Copyright (C) 2001 by Andreas Gruenbacher <a.gruenbacher@computer.org>
   8  Copyright (C) 2001 SGI - Silicon Graphics, Inc <linux-xfs@oss.sgi.com>
   9  Copyright (c) 2004 Red Hat, Inc., James Morris <jmorris@redhat.com>
  10 */
  11#include <linux/fs.h>
  12#include <linux/slab.h>
  13#include <linux/file.h>
  14#include <linux/xattr.h>
  15#include <linux/mount.h>
  16#include <linux/namei.h>
  17#include <linux/security.h>
  18#include <linux/evm.h>
  19#include <linux/syscalls.h>
  20#include <linux/export.h>
  21#include <linux/fsnotify.h>
  22#include <linux/audit.h>
  23#include <linux/vmalloc.h>
  24#include <linux/posix_acl_xattr.h>
  25
  26#include <linux/uaccess.h>
  27
  28#include "internal.h"
  29
  30static const char *
  31strcmp_prefix(const char *a, const char *a_prefix)
  32{
  33	while (*a_prefix && *a == *a_prefix) {
  34		a++;
  35		a_prefix++;
  36	}
  37	return *a_prefix ? NULL : a;
  38}
  39
  40/*
  41 * In order to implement different sets of xattr operations for each xattr
  42 * prefix, a filesystem should create a null-terminated array of struct
  43 * xattr_handler (one for each prefix) and hang a pointer to it off of the
  44 * s_xattr field of the superblock.
  45 */
  46#define for_each_xattr_handler(handlers, handler)		\
  47	if (handlers)						\
  48		for ((handler) = *(handlers)++;			\
  49			(handler) != NULL;			\
  50			(handler) = *(handlers)++)
  51
  52/*
  53 * Find the xattr_handler with the matching prefix.
  54 */
  55static const struct xattr_handler *
  56xattr_resolve_name(struct inode *inode, const char **name)
  57{
  58	const struct xattr_handler **handlers = inode->i_sb->s_xattr;
  59	const struct xattr_handler *handler;
  60
  61	if (!(inode->i_opflags & IOP_XATTR)) {
  62		if (unlikely(is_bad_inode(inode)))
  63			return ERR_PTR(-EIO);
  64		return ERR_PTR(-EOPNOTSUPP);
  65	}
  66	for_each_xattr_handler(handlers, handler) {
  67		const char *n;
  68
  69		n = strcmp_prefix(*name, xattr_prefix(handler));
  70		if (n) {
  71			if (!handler->prefix ^ !*n) {
  72				if (*n)
  73					continue;
  74				return ERR_PTR(-EINVAL);
  75			}
  76			*name = n;
  77			return handler;
  78		}
  79	}
  80	return ERR_PTR(-EOPNOTSUPP);
  81}
  82
  83/**
  84 * may_write_xattr - check whether inode allows writing xattr
  85 * @mnt_userns:	User namespace of the mount the inode was found from
  86 * @inode: the inode on which to set an xattr
  87 *
  88 * Check whether the inode allows writing xattrs. Specifically, we can never
  89 * set or remove an extended attribute on a read-only filesystem  or on an
  90 * immutable / append-only inode.
  91 *
  92 * We also need to ensure that the inode has a mapping in the mount to
  93 * not risk writing back invalid i_{g,u}id values.
  94 *
  95 * Return: On success zero is returned. On error a negative errno is returned.
  96 */
  97int may_write_xattr(struct user_namespace *mnt_userns, struct inode *inode)
  98{
  99	if (IS_IMMUTABLE(inode))
 100		return -EPERM;
 101	if (IS_APPEND(inode))
 102		return -EPERM;
 103	if (HAS_UNMAPPED_ID(mnt_userns, inode))
 104		return -EPERM;
 105	return 0;
 106}
 107
 108/*
 109 * Check permissions for extended attribute access.  This is a bit complicated
 110 * because different namespaces have very different rules.
 111 */
 112static int
 113xattr_permission(struct user_namespace *mnt_userns, struct inode *inode,
 114		 const char *name, int mask)
 115{
 
 
 
 
 116	if (mask & MAY_WRITE) {
 117		int ret;
 118
 119		ret = may_write_xattr(mnt_userns, inode);
 120		if (ret)
 121			return ret;
 122	}
 123
 124	/*
 125	 * No restriction for security.* and system.* from the VFS.  Decision
 126	 * on these is left to the underlying filesystem / security module.
 127	 */
 128	if (!strncmp(name, XATTR_SECURITY_PREFIX, XATTR_SECURITY_PREFIX_LEN) ||
 129	    !strncmp(name, XATTR_SYSTEM_PREFIX, XATTR_SYSTEM_PREFIX_LEN))
 130		return 0;
 131
 132	/*
 133	 * The trusted.* namespace can only be accessed by privileged users.
 134	 */
 135	if (!strncmp(name, XATTR_TRUSTED_PREFIX, XATTR_TRUSTED_PREFIX_LEN)) {
 136		if (!capable(CAP_SYS_ADMIN))
 137			return (mask & MAY_WRITE) ? -EPERM : -ENODATA;
 138		return 0;
 139	}
 140
 141	/*
 142	 * In the user.* namespace, only regular files and directories can have
 143	 * extended attributes. For sticky directories, only the owner and
 144	 * privileged users can write attributes.
 145	 */
 146	if (!strncmp(name, XATTR_USER_PREFIX, XATTR_USER_PREFIX_LEN)) {
 147		if (!S_ISREG(inode->i_mode) && !S_ISDIR(inode->i_mode))
 148			return (mask & MAY_WRITE) ? -EPERM : -ENODATA;
 149		if (S_ISDIR(inode->i_mode) && (inode->i_mode & S_ISVTX) &&
 150		    (mask & MAY_WRITE) &&
 151		    !inode_owner_or_capable(mnt_userns, inode))
 152			return -EPERM;
 153	}
 154
 155	return inode_permission(mnt_userns, inode, mask);
 156}
 157
 158/*
 159 * Look for any handler that deals with the specified namespace.
 160 */
 161int
 162xattr_supported_namespace(struct inode *inode, const char *prefix)
 163{
 164	const struct xattr_handler **handlers = inode->i_sb->s_xattr;
 165	const struct xattr_handler *handler;
 166	size_t preflen;
 167
 168	if (!(inode->i_opflags & IOP_XATTR)) {
 169		if (unlikely(is_bad_inode(inode)))
 170			return -EIO;
 171		return -EOPNOTSUPP;
 172	}
 173
 174	preflen = strlen(prefix);
 175
 176	for_each_xattr_handler(handlers, handler) {
 177		if (!strncmp(xattr_prefix(handler), prefix, preflen))
 178			return 0;
 179	}
 180
 181	return -EOPNOTSUPP;
 182}
 183EXPORT_SYMBOL(xattr_supported_namespace);
 184
 185int
 186__vfs_setxattr(struct user_namespace *mnt_userns, struct dentry *dentry,
 187	       struct inode *inode, const char *name, const void *value,
 188	       size_t size, int flags)
 189{
 190	const struct xattr_handler *handler;
 191
 192	if (is_posix_acl_xattr(name))
 193		return -EOPNOTSUPP;
 194
 195	handler = xattr_resolve_name(inode, &name);
 196	if (IS_ERR(handler))
 197		return PTR_ERR(handler);
 198	if (!handler->set)
 199		return -EOPNOTSUPP;
 200	if (size == 0)
 201		value = "";  /* empty EA, do not remove */
 202	return handler->set(handler, mnt_userns, dentry, inode, name, value,
 203			    size, flags);
 204}
 205EXPORT_SYMBOL(__vfs_setxattr);
 206
 207/**
 208 *  __vfs_setxattr_noperm - perform setxattr operation without performing
 209 *  permission checks.
 210 *
 211 *  @mnt_userns: user namespace of the mount the inode was found from
 212 *  @dentry: object to perform setxattr on
 213 *  @name: xattr name to set
 214 *  @value: value to set @name to
 215 *  @size: size of @value
 216 *  @flags: flags to pass into filesystem operations
 217 *
 218 *  returns the result of the internal setxattr or setsecurity operations.
 219 *
 220 *  This function requires the caller to lock the inode's i_mutex before it
 221 *  is executed. It also assumes that the caller will make the appropriate
 222 *  permission checks.
 223 */
 224int __vfs_setxattr_noperm(struct user_namespace *mnt_userns,
 225			  struct dentry *dentry, const char *name,
 226			  const void *value, size_t size, int flags)
 227{
 228	struct inode *inode = dentry->d_inode;
 229	int error = -EAGAIN;
 230	int issec = !strncmp(name, XATTR_SECURITY_PREFIX,
 231				   XATTR_SECURITY_PREFIX_LEN);
 232
 233	if (issec)
 234		inode->i_flags &= ~S_NOSEC;
 235	if (inode->i_opflags & IOP_XATTR) {
 236		error = __vfs_setxattr(mnt_userns, dentry, inode, name, value,
 237				       size, flags);
 238		if (!error) {
 239			fsnotify_xattr(dentry);
 240			security_inode_post_setxattr(dentry, name, value,
 241						     size, flags);
 242		}
 243	} else {
 244		if (unlikely(is_bad_inode(inode)))
 245			return -EIO;
 246	}
 247	if (error == -EAGAIN) {
 248		error = -EOPNOTSUPP;
 249
 250		if (issec) {
 251			const char *suffix = name + XATTR_SECURITY_PREFIX_LEN;
 252
 253			error = security_inode_setsecurity(inode, suffix, value,
 254							   size, flags);
 255			if (!error)
 256				fsnotify_xattr(dentry);
 257		}
 258	}
 259
 260	return error;
 261}
 262
 263/**
 264 * __vfs_setxattr_locked - set an extended attribute while holding the inode
 265 * lock
 266 *
 267 *  @mnt_userns: user namespace of the mount of the target inode
 268 *  @dentry: object to perform setxattr on
 269 *  @name: xattr name to set
 270 *  @value: value to set @name to
 271 *  @size: size of @value
 272 *  @flags: flags to pass into filesystem operations
 273 *  @delegated_inode: on return, will contain an inode pointer that
 274 *  a delegation was broken on, NULL if none.
 275 */
 276int
 277__vfs_setxattr_locked(struct user_namespace *mnt_userns, struct dentry *dentry,
 278		      const char *name, const void *value, size_t size,
 279		      int flags, struct inode **delegated_inode)
 280{
 281	struct inode *inode = dentry->d_inode;
 282	int error;
 283
 284	error = xattr_permission(mnt_userns, inode, name, MAY_WRITE);
 285	if (error)
 286		return error;
 287
 288	error = security_inode_setxattr(mnt_userns, dentry, name, value, size,
 289					flags);
 290	if (error)
 291		goto out;
 292
 293	error = try_break_deleg(inode, delegated_inode);
 294	if (error)
 295		goto out;
 296
 297	error = __vfs_setxattr_noperm(mnt_userns, dentry, name, value,
 298				      size, flags);
 299
 300out:
 301	return error;
 302}
 303EXPORT_SYMBOL_GPL(__vfs_setxattr_locked);
 304
 305int
 306vfs_setxattr(struct user_namespace *mnt_userns, struct dentry *dentry,
 307	     const char *name, const void *value, size_t size, int flags)
 308{
 309	struct inode *inode = dentry->d_inode;
 310	struct inode *delegated_inode = NULL;
 311	const void  *orig_value = value;
 312	int error;
 313
 314	if (size && strcmp(name, XATTR_NAME_CAPS) == 0) {
 315		error = cap_convert_nscap(mnt_userns, dentry, &value, size);
 316		if (error < 0)
 317			return error;
 318		size = error;
 319	}
 320
 321retry_deleg:
 322	inode_lock(inode);
 323	error = __vfs_setxattr_locked(mnt_userns, dentry, name, value, size,
 324				      flags, &delegated_inode);
 325	inode_unlock(inode);
 326
 327	if (delegated_inode) {
 328		error = break_deleg_wait(&delegated_inode);
 329		if (!error)
 330			goto retry_deleg;
 331	}
 332	if (value != orig_value)
 333		kfree(value);
 334
 335	return error;
 336}
 337EXPORT_SYMBOL_GPL(vfs_setxattr);
 338
 339static ssize_t
 340xattr_getsecurity(struct user_namespace *mnt_userns, struct inode *inode,
 341		  const char *name, void *value, size_t size)
 342{
 343	void *buffer = NULL;
 344	ssize_t len;
 345
 346	if (!value || !size) {
 347		len = security_inode_getsecurity(mnt_userns, inode, name,
 348						 &buffer, false);
 349		goto out_noalloc;
 350	}
 351
 352	len = security_inode_getsecurity(mnt_userns, inode, name, &buffer,
 353					 true);
 354	if (len < 0)
 355		return len;
 356	if (size < len) {
 357		len = -ERANGE;
 358		goto out;
 359	}
 360	memcpy(value, buffer, len);
 361out:
 362	kfree(buffer);
 363out_noalloc:
 364	return len;
 365}
 366
 367/*
 368 * vfs_getxattr_alloc - allocate memory, if necessary, before calling getxattr
 369 *
 370 * Allocate memory, if not already allocated, or re-allocate correct size,
 371 * before retrieving the extended attribute.  The xattr value buffer should
 372 * always be freed by the caller, even on error.
 373 *
 374 * Returns the result of alloc, if failed, or the getxattr operation.
 375 */
 376int
 377vfs_getxattr_alloc(struct user_namespace *mnt_userns, struct dentry *dentry,
 378		   const char *name, char **xattr_value, size_t xattr_size,
 379		   gfp_t flags)
 380{
 381	const struct xattr_handler *handler;
 382	struct inode *inode = dentry->d_inode;
 383	char *value = *xattr_value;
 384	int error;
 385
 386	error = xattr_permission(mnt_userns, inode, name, MAY_READ);
 387	if (error)
 388		return error;
 389
 390	handler = xattr_resolve_name(inode, &name);
 391	if (IS_ERR(handler))
 392		return PTR_ERR(handler);
 393	if (!handler->get)
 394		return -EOPNOTSUPP;
 395	error = handler->get(handler, dentry, inode, name, NULL, 0);
 396	if (error < 0)
 397		return error;
 398
 399	if (!value || (error > xattr_size)) {
 400		value = krealloc(*xattr_value, error + 1, flags);
 401		if (!value)
 402			return -ENOMEM;
 403		memset(value, 0, error + 1);
 404	}
 405
 406	error = handler->get(handler, dentry, inode, name, value, error);
 407	*xattr_value = value;
 408	return error;
 409}
 410
 411ssize_t
 412__vfs_getxattr(struct dentry *dentry, struct inode *inode, const char *name,
 413	       void *value, size_t size)
 414{
 415	const struct xattr_handler *handler;
 416
 417	if (is_posix_acl_xattr(name))
 418		return -EOPNOTSUPP;
 419
 420	handler = xattr_resolve_name(inode, &name);
 421	if (IS_ERR(handler))
 422		return PTR_ERR(handler);
 423	if (!handler->get)
 424		return -EOPNOTSUPP;
 425	return handler->get(handler, dentry, inode, name, value, size);
 426}
 427EXPORT_SYMBOL(__vfs_getxattr);
 428
 429ssize_t
 430vfs_getxattr(struct user_namespace *mnt_userns, struct dentry *dentry,
 431	     const char *name, void *value, size_t size)
 432{
 433	struct inode *inode = dentry->d_inode;
 434	int error;
 435
 436	error = xattr_permission(mnt_userns, inode, name, MAY_READ);
 437	if (error)
 438		return error;
 439
 440	error = security_inode_getxattr(dentry, name);
 441	if (error)
 442		return error;
 443
 444	if (!strncmp(name, XATTR_SECURITY_PREFIX,
 445				XATTR_SECURITY_PREFIX_LEN)) {
 446		const char *suffix = name + XATTR_SECURITY_PREFIX_LEN;
 447		int ret = xattr_getsecurity(mnt_userns, inode, suffix, value,
 448					    size);
 449		/*
 450		 * Only overwrite the return value if a security module
 451		 * is actually active.
 452		 */
 453		if (ret == -EOPNOTSUPP)
 454			goto nolsm;
 455		return ret;
 456	}
 457nolsm:
 458	return __vfs_getxattr(dentry, inode, name, value, size);
 
 
 
 
 
 459}
 460EXPORT_SYMBOL_GPL(vfs_getxattr);
 461
 462ssize_t
 463vfs_listxattr(struct dentry *dentry, char *list, size_t size)
 464{
 465	struct inode *inode = d_inode(dentry);
 466	ssize_t error;
 467
 468	error = security_inode_listxattr(dentry);
 469	if (error)
 470		return error;
 471	if (inode->i_op->listxattr && (inode->i_opflags & IOP_XATTR)) {
 472		error = inode->i_op->listxattr(dentry, list, size);
 
 473	} else {
 474		error = security_inode_listsecurity(inode, list, size);
 475		if (size && error > size)
 476			error = -ERANGE;
 477	}
 478	return error;
 479}
 480EXPORT_SYMBOL_GPL(vfs_listxattr);
 481
 482int
 483__vfs_removexattr(struct user_namespace *mnt_userns, struct dentry *dentry,
 484		  const char *name)
 485{
 486	struct inode *inode = d_inode(dentry);
 487	const struct xattr_handler *handler;
 488
 489	if (is_posix_acl_xattr(name))
 490		return -EOPNOTSUPP;
 491
 492	handler = xattr_resolve_name(inode, &name);
 493	if (IS_ERR(handler))
 494		return PTR_ERR(handler);
 495	if (!handler->set)
 496		return -EOPNOTSUPP;
 497	return handler->set(handler, mnt_userns, dentry, inode, name, NULL, 0,
 498			    XATTR_REPLACE);
 499}
 500EXPORT_SYMBOL(__vfs_removexattr);
 501
 502/**
 503 * __vfs_removexattr_locked - set an extended attribute while holding the inode
 504 * lock
 505 *
 506 *  @mnt_userns: user namespace of the mount of the target inode
 507 *  @dentry: object to perform setxattr on
 508 *  @name: name of xattr to remove
 509 *  @delegated_inode: on return, will contain an inode pointer that
 510 *  a delegation was broken on, NULL if none.
 511 */
 512int
 513__vfs_removexattr_locked(struct user_namespace *mnt_userns,
 514			 struct dentry *dentry, const char *name,
 515			 struct inode **delegated_inode)
 516{
 517	struct inode *inode = dentry->d_inode;
 518	int error;
 519
 520	error = xattr_permission(mnt_userns, inode, name, MAY_WRITE);
 521	if (error)
 522		return error;
 523
 524	error = security_inode_removexattr(mnt_userns, dentry, name);
 525	if (error)
 526		goto out;
 527
 528	error = try_break_deleg(inode, delegated_inode);
 529	if (error)
 530		goto out;
 531
 532	error = __vfs_removexattr(mnt_userns, dentry, name);
 
 
 533
 534	if (!error) {
 535		fsnotify_xattr(dentry);
 536		evm_inode_post_removexattr(dentry, name);
 537	}
 538
 539out:
 540	return error;
 541}
 542EXPORT_SYMBOL_GPL(__vfs_removexattr_locked);
 543
 544int
 545vfs_removexattr(struct user_namespace *mnt_userns, struct dentry *dentry,
 546		const char *name)
 547{
 548	struct inode *inode = dentry->d_inode;
 549	struct inode *delegated_inode = NULL;
 550	int error;
 551
 552retry_deleg:
 553	inode_lock(inode);
 554	error = __vfs_removexattr_locked(mnt_userns, dentry,
 555					 name, &delegated_inode);
 556	inode_unlock(inode);
 557
 558	if (delegated_inode) {
 559		error = break_deleg_wait(&delegated_inode);
 560		if (!error)
 561			goto retry_deleg;
 562	}
 563
 564	return error;
 565}
 566EXPORT_SYMBOL_GPL(vfs_removexattr);
 567
 
 568/*
 569 * Extended attribute SET operations
 570 */
 571
 572int setxattr_copy(const char __user *name, struct xattr_ctx *ctx)
 
 573{
 574	int error;
 
 
 575
 576	if (ctx->flags & ~(XATTR_CREATE|XATTR_REPLACE))
 577		return -EINVAL;
 578
 579	error = strncpy_from_user(ctx->kname->name, name,
 580				sizeof(ctx->kname->name));
 581	if (error == 0 || error == sizeof(ctx->kname->name))
 582		return  -ERANGE;
 583	if (error < 0)
 584		return error;
 585
 586	error = 0;
 587	if (ctx->size) {
 588		if (ctx->size > XATTR_SIZE_MAX)
 589			return -E2BIG;
 590
 591		ctx->kvalue = vmemdup_user(ctx->cvalue, ctx->size);
 592		if (IS_ERR(ctx->kvalue)) {
 593			error = PTR_ERR(ctx->kvalue);
 594			ctx->kvalue = NULL;
 595		}
 596	}
 597
 
 
 598	return error;
 599}
 600
 601int do_setxattr(struct mnt_idmap *idmap, struct dentry *dentry,
 602		struct xattr_ctx *ctx)
 
 603{
 604	if (is_posix_acl_xattr(ctx->kname->name))
 605		return do_set_acl(idmap, dentry, ctx->kname->name,
 606				  ctx->kvalue, ctx->size);
 607
 608	return vfs_setxattr(mnt_idmap_owner(idmap), dentry, ctx->kname->name,
 609			ctx->kvalue, ctx->size, ctx->flags);
 610}
 611
 612static long
 613setxattr(struct mnt_idmap *idmap, struct dentry *d,
 614	const char __user *name, const void __user *value, size_t size,
 615	int flags)
 616{
 617	struct xattr_name kname;
 618	struct xattr_ctx ctx = {
 619		.cvalue   = value,
 620		.kvalue   = NULL,
 621		.size     = size,
 622		.kname    = &kname,
 623		.flags    = flags,
 624	};
 625	int error;
 626
 627	error = setxattr_copy(name, &ctx);
 628	if (error)
 629		return error;
 630
 631	error = do_setxattr(idmap, d, &ctx);
 632
 633	kvfree(ctx.kvalue);
 
 
 634	return error;
 635}
 636
 637static int path_setxattr(const char __user *pathname,
 638			 const char __user *name, const void __user *value,
 639			 size_t size, int flags, unsigned int lookup_flags)
 640{
 641	struct path path;
 642	int error;
 643
 644retry:
 645	error = user_path_at(AT_FDCWD, pathname, lookup_flags, &path);
 646	if (error)
 647		return error;
 648	error = mnt_want_write(path.mnt);
 649	if (!error) {
 650		error = setxattr(mnt_idmap(path.mnt), path.dentry, name,
 651				 value, size, flags);
 652		mnt_drop_write(path.mnt);
 653	}
 654	path_put(&path);
 655	if (retry_estale(error, lookup_flags)) {
 656		lookup_flags |= LOOKUP_REVAL;
 657		goto retry;
 658	}
 659	return error;
 660}
 661
 662SYSCALL_DEFINE5(setxattr, const char __user *, pathname,
 663		const char __user *, name, const void __user *, value,
 664		size_t, size, int, flags)
 665{
 666	return path_setxattr(pathname, name, value, size, flags, LOOKUP_FOLLOW);
 667}
 668
 669SYSCALL_DEFINE5(lsetxattr, const char __user *, pathname,
 670		const char __user *, name, const void __user *, value,
 671		size_t, size, int, flags)
 672{
 673	return path_setxattr(pathname, name, value, size, flags, 0);
 674}
 675
 676SYSCALL_DEFINE5(fsetxattr, int, fd, const char __user *, name,
 677		const void __user *,value, size_t, size, int, flags)
 678{
 679	struct fd f = fdget(fd);
 
 680	int error = -EBADF;
 681
 682	if (!f.file)
 
 683		return error;
 684	audit_file(f.file);
 685	error = mnt_want_write_file(f.file);
 
 686	if (!error) {
 687		error = setxattr(file_mnt_idmap(f.file),
 688				 f.file->f_path.dentry, name,
 689				 value, size, flags);
 690		mnt_drop_write_file(f.file);
 691	}
 692	fdput(f);
 693	return error;
 694}
 695
 696/*
 697 * Extended attribute GET operations
 698 */
 699ssize_t
 700do_getxattr(struct mnt_idmap *idmap, struct dentry *d,
 701	struct xattr_ctx *ctx)
 702{
 703	ssize_t error;
 704	char *kname = ctx->kname->name;
 
 
 
 
 
 
 
 705
 706	if (ctx->size) {
 707		if (ctx->size > XATTR_SIZE_MAX)
 708			ctx->size = XATTR_SIZE_MAX;
 709		ctx->kvalue = kvzalloc(ctx->size, GFP_KERNEL);
 710		if (!ctx->kvalue)
 711			return -ENOMEM;
 712	}
 713
 714	if (is_posix_acl_xattr(ctx->kname->name))
 715		error = do_get_acl(idmap, d, kname, ctx->kvalue, ctx->size);
 716	else
 717		error = vfs_getxattr(mnt_idmap_owner(idmap), d, kname,
 718				     ctx->kvalue, ctx->size);
 719	if (error > 0) {
 720		if (ctx->size && copy_to_user(ctx->value, ctx->kvalue, error))
 721			error = -EFAULT;
 722	} else if (error == -ERANGE && ctx->size >= XATTR_SIZE_MAX) {
 723		/* The file system tried to returned a value bigger
 724		   than XATTR_SIZE_MAX bytes. Not possible. */
 725		error = -E2BIG;
 726	}
 727
 728	return error;
 729}
 730
 731static ssize_t
 732getxattr(struct mnt_idmap *idmap, struct dentry *d,
 733	 const char __user *name, void __user *value, size_t size)
 734{
 
 735	ssize_t error;
 736	struct xattr_name kname;
 737	struct xattr_ctx ctx = {
 738		.value    = value,
 739		.kvalue   = NULL,
 740		.size     = size,
 741		.kname    = &kname,
 742		.flags    = 0,
 743	};
 744
 745	error = strncpy_from_user(kname.name, name, sizeof(kname.name));
 746	if (error == 0 || error == sizeof(kname.name))
 747		error = -ERANGE;
 748	if (error < 0)
 749		return error;
 750
 751	error =  do_getxattr(idmap, d, &ctx);
 752
 753	kvfree(ctx.kvalue);
 754	return error;
 755}
 756
 757static ssize_t path_getxattr(const char __user *pathname,
 758			     const char __user *name, void __user *value,
 759			     size_t size, unsigned int lookup_flags)
 760{
 761	struct path path;
 762	ssize_t error;
 763retry:
 764	error = user_path_at(AT_FDCWD, pathname, lookup_flags, &path);
 765	if (error)
 766		return error;
 767	error = getxattr(mnt_idmap(path.mnt), path.dentry, name, value, size);
 768	path_put(&path);
 769	if (retry_estale(error, lookup_flags)) {
 770		lookup_flags |= LOOKUP_REVAL;
 771		goto retry;
 772	}
 773	return error;
 774}
 775
 776SYSCALL_DEFINE4(getxattr, const char __user *, pathname,
 777		const char __user *, name, void __user *, value, size_t, size)
 778{
 779	return path_getxattr(pathname, name, value, size, LOOKUP_FOLLOW);
 780}
 781
 782SYSCALL_DEFINE4(lgetxattr, const char __user *, pathname,
 783		const char __user *, name, void __user *, value, size_t, size)
 784{
 785	return path_getxattr(pathname, name, value, size, 0);
 786}
 787
 788SYSCALL_DEFINE4(fgetxattr, int, fd, const char __user *, name,
 789		void __user *, value, size_t, size)
 790{
 791	struct fd f = fdget(fd);
 792	ssize_t error = -EBADF;
 793
 794	if (!f.file)
 
 795		return error;
 796	audit_file(f.file);
 797	error = getxattr(file_mnt_idmap(f.file), f.file->f_path.dentry,
 798			 name, value, size);
 799	fdput(f);
 800	return error;
 801}
 802
 803/*
 804 * Extended attribute LIST operations
 805 */
 806static ssize_t
 807listxattr(struct dentry *d, char __user *list, size_t size)
 808{
 809	ssize_t error;
 810	char *klist = NULL;
 811
 812	if (size) {
 813		if (size > XATTR_LIST_MAX)
 814			size = XATTR_LIST_MAX;
 815		klist = kvmalloc(size, GFP_KERNEL);
 816		if (!klist)
 817			return -ENOMEM;
 818	}
 819
 820	error = vfs_listxattr(d, klist, size);
 821	if (error > 0) {
 822		if (size && copy_to_user(list, klist, error))
 823			error = -EFAULT;
 824	} else if (error == -ERANGE && size >= XATTR_LIST_MAX) {
 825		/* The file system tried to returned a list bigger
 826		   than XATTR_LIST_MAX bytes. Not possible. */
 827		error = -E2BIG;
 828	}
 829
 830	kvfree(klist);
 831
 832	return error;
 833}
 834
 835static ssize_t path_listxattr(const char __user *pathname, char __user *list,
 836			      size_t size, unsigned int lookup_flags)
 837{
 838	struct path path;
 839	ssize_t error;
 840retry:
 841	error = user_path_at(AT_FDCWD, pathname, lookup_flags, &path);
 842	if (error)
 843		return error;
 844	error = listxattr(path.dentry, list, size);
 845	path_put(&path);
 846	if (retry_estale(error, lookup_flags)) {
 847		lookup_flags |= LOOKUP_REVAL;
 848		goto retry;
 849	}
 850	return error;
 851}
 852
 853SYSCALL_DEFINE3(listxattr, const char __user *, pathname, char __user *, list,
 854		size_t, size)
 855{
 856	return path_listxattr(pathname, list, size, LOOKUP_FOLLOW);
 857}
 858
 859SYSCALL_DEFINE3(llistxattr, const char __user *, pathname, char __user *, list,
 860		size_t, size)
 861{
 862	return path_listxattr(pathname, list, size, 0);
 
 
 
 
 
 
 
 
 863}
 864
 865SYSCALL_DEFINE3(flistxattr, int, fd, char __user *, list, size_t, size)
 866{
 867	struct fd f = fdget(fd);
 868	ssize_t error = -EBADF;
 869
 870	if (!f.file)
 
 871		return error;
 872	audit_file(f.file);
 873	error = listxattr(f.file->f_path.dentry, list, size);
 874	fdput(f);
 875	return error;
 876}
 877
 878/*
 879 * Extended attribute REMOVE operations
 880 */
 881static long
 882removexattr(struct mnt_idmap *idmap, struct dentry *d,
 883	    const char __user *name)
 884{
 885	int error;
 886	char kname[XATTR_NAME_MAX + 1];
 887
 888	error = strncpy_from_user(kname, name, sizeof(kname));
 889	if (error == 0 || error == sizeof(kname))
 890		error = -ERANGE;
 891	if (error < 0)
 892		return error;
 893
 894	if (is_posix_acl_xattr(kname))
 895		return vfs_remove_acl(mnt_idmap_owner(idmap), d, kname);
 896
 897	return vfs_removexattr(mnt_idmap_owner(idmap), d, kname);
 898}
 899
 900static int path_removexattr(const char __user *pathname,
 901			    const char __user *name, unsigned int lookup_flags)
 902{
 903	struct path path;
 904	int error;
 905retry:
 906	error = user_path_at(AT_FDCWD, pathname, lookup_flags, &path);
 907	if (error)
 908		return error;
 909	error = mnt_want_write(path.mnt);
 910	if (!error) {
 911		error = removexattr(mnt_idmap(path.mnt), path.dentry, name);
 912		mnt_drop_write(path.mnt);
 913	}
 914	path_put(&path);
 915	if (retry_estale(error, lookup_flags)) {
 916		lookup_flags |= LOOKUP_REVAL;
 917		goto retry;
 918	}
 919	return error;
 920}
 921
 922SYSCALL_DEFINE2(removexattr, const char __user *, pathname,
 923		const char __user *, name)
 924{
 925	return path_removexattr(pathname, name, LOOKUP_FOLLOW);
 926}
 927
 928SYSCALL_DEFINE2(lremovexattr, const char __user *, pathname,
 929		const char __user *, name)
 930{
 931	return path_removexattr(pathname, name, 0);
 
 
 
 
 
 
 
 
 
 
 
 
 932}
 933
 934SYSCALL_DEFINE2(fremovexattr, int, fd, const char __user *, name)
 935{
 936	struct fd f = fdget(fd);
 
 937	int error = -EBADF;
 938
 939	if (!f.file)
 
 940		return error;
 941	audit_file(f.file);
 942	error = mnt_want_write_file(f.file);
 
 943	if (!error) {
 944		error = removexattr(file_mnt_idmap(f.file),
 945				    f.file->f_path.dentry, name);
 946		mnt_drop_write_file(f.file);
 947	}
 948	fdput(f);
 949	return error;
 950}
 951
 952/*
 953 * Combine the results of the list() operation from every xattr_handler in the
 954 * list.
 955 */
 956ssize_t
 957generic_listxattr(struct dentry *dentry, char *buffer, size_t buffer_size)
 958{
 959	const struct xattr_handler *handler, **handlers = dentry->d_sb->s_xattr;
 960	unsigned int size = 0;
 961
 962	if (!buffer) {
 963		for_each_xattr_handler(handlers, handler) {
 964			if (!handler->name ||
 965			    (handler->list && !handler->list(dentry)))
 966				continue;
 967			size += strlen(handler->name) + 1;
 968		}
 969	} else {
 970		char *buf = buffer;
 971		size_t len;
 972
 973		for_each_xattr_handler(handlers, handler) {
 974			if (!handler->name ||
 975			    (handler->list && !handler->list(dentry)))
 976				continue;
 977			len = strlen(handler->name);
 978			if (len + 1 > buffer_size)
 979				return -ERANGE;
 980			memcpy(buf, handler->name, len + 1);
 981			buf += len + 1;
 982			buffer_size -= len + 1;
 983		}
 984		size = buf - buffer;
 985	}
 986	return size;
 987}
 988EXPORT_SYMBOL(generic_listxattr);
 989
 990/**
 991 * xattr_full_name  -  Compute full attribute name from suffix
 992 *
 993 * @handler:	handler of the xattr_handler operation
 994 * @name:	name passed to the xattr_handler operation
 995 *
 996 * The get and set xattr handler operations are called with the remainder of
 997 * the attribute name after skipping the handler's prefix: for example, "foo"
 998 * is passed to the get operation of a handler with prefix "user." to get
 999 * attribute "user.foo".  The full name is still "there" in the name though.
1000 *
1001 * Note: the list xattr handler operation when called from the vfs is passed a
1002 * NULL name; some file systems use this operation internally, with varying
1003 * semantics.
1004 */
1005const char *xattr_full_name(const struct xattr_handler *handler,
1006			    const char *name)
1007{
1008	size_t prefix_len = strlen(xattr_prefix(handler));
1009
1010	return name - prefix_len;
 
 
1011}
1012EXPORT_SYMBOL(xattr_full_name);
1013
1014/**
1015 * free_simple_xattr - free an xattr object
1016 * @xattr: the xattr object
 
 
1017 *
1018 * Free the xattr object. Can handle @xattr being NULL.
 
1019 */
1020static inline void free_simple_xattr(struct simple_xattr *xattr)
1021{
1022	if (xattr)
1023		kfree(xattr->name);
1024	kvfree(xattr);
1025}
1026
1027/**
1028 * simple_xattr_alloc - allocate new xattr object
1029 * @value: value of the xattr object
1030 * @size: size of @value
1031 *
1032 * Allocate a new xattr object and initialize respective members. The caller is
1033 * responsible for handling the name of the xattr.
1034 *
1035 * Return: On success a new xattr object is returned. On failure NULL is
1036 * returned.
1037 */
1038struct simple_xattr *simple_xattr_alloc(const void *value, size_t size)
 
1039{
1040	struct simple_xattr *new_xattr;
1041	size_t len;
1042
1043	/* wrap around? */
1044	len = sizeof(*new_xattr) + size;
1045	if (len < sizeof(*new_xattr))
1046		return NULL;
1047
1048	new_xattr = kvmalloc(len, GFP_KERNEL);
1049	if (!new_xattr)
1050		return NULL;
1051
1052	new_xattr->size = size;
1053	memcpy(new_xattr->value, value, size);
1054	return new_xattr;
 
 
 
 
 
1055}
1056
1057/**
1058 * rbtree_simple_xattr_cmp - compare xattr name with current rbtree xattr entry
1059 * @key: xattr name
1060 * @node: current node
1061 *
1062 * Compare the xattr name with the xattr name attached to @node in the rbtree.
1063 *
1064 * Return: Negative value if continuing left, positive if continuing right, 0
1065 * if the xattr attached to @node matches @key.
1066 */
1067static int rbtree_simple_xattr_cmp(const void *key, const struct rb_node *node)
 
1068{
1069	const char *xattr_name = key;
1070	const struct simple_xattr *xattr;
1071
1072	xattr = rb_entry(node, struct simple_xattr, rb_node);
1073	return strcmp(xattr->name, xattr_name);
1074}
1075
1076/**
1077 * rbtree_simple_xattr_node_cmp - compare two xattr rbtree nodes
1078 * @new_node: new node
1079 * @node: current node
1080 *
1081 * Compare the xattr attached to @new_node with the xattr attached to @node.
1082 *
1083 * Return: Negative value if continuing left, positive if continuing right, 0
1084 * if the xattr attached to @new_node matches the xattr attached to @node.
1085 */
1086static int rbtree_simple_xattr_node_cmp(struct rb_node *new_node,
1087					const struct rb_node *node)
1088{
1089	struct simple_xattr *xattr;
1090	xattr = rb_entry(new_node, struct simple_xattr, rb_node);
1091	return rbtree_simple_xattr_cmp(xattr->name, node);
1092}
1093
1094/**
1095 * simple_xattr_get - get an xattr object
1096 * @xattrs: the header of the xattr object
1097 * @name: the name of the xattr to retrieve
1098 * @buffer: the buffer to store the value into
1099 * @size: the size of @buffer
1100 *
1101 * Try to find and retrieve the xattr object associated with @name.
1102 * If @buffer is provided store the value of @xattr in @buffer
1103 * otherwise just return the length. The size of @buffer is limited
1104 * to XATTR_SIZE_MAX which currently is 65536.
1105 *
1106 * Return: On success the length of the xattr value is returned. On error a
1107 * negative error code is returned.
1108 */
1109int simple_xattr_get(struct simple_xattrs *xattrs, const char *name,
1110		     void *buffer, size_t size)
1111{
1112	struct simple_xattr *xattr = NULL;
1113	struct rb_node *rbp;
1114	int ret = -ENODATA;
1115
1116	read_lock(&xattrs->lock);
1117	rbp = rb_find(name, &xattrs->rb_root, rbtree_simple_xattr_cmp);
1118	if (rbp) {
1119		xattr = rb_entry(rbp, struct simple_xattr, rb_node);
1120		ret = xattr->size;
1121		if (buffer) {
1122			if (size < xattr->size)
1123				ret = -ERANGE;
1124			else
1125				memcpy(buffer, xattr->value, xattr->size);
1126		}
1127	}
1128	read_unlock(&xattrs->lock);
1129	return ret;
1130}
1131
1132/**
1133 * simple_xattr_set - set an xattr object
1134 * @xattrs: the header of the xattr object
1135 * @name: the name of the xattr to retrieve
1136 * @value: the value to store along the xattr
1137 * @size: the size of @value
1138 * @flags: the flags determining how to set the xattr
1139 * @removed_size: the size of the removed xattr
1140 *
1141 * Set a new xattr object.
1142 * If @value is passed a new xattr object will be allocated. If XATTR_REPLACE
1143 * is specified in @flags a matching xattr object for @name must already exist.
1144 * If it does it will be replaced with the new xattr object. If it doesn't we
1145 * fail. If XATTR_CREATE is specified and a matching xattr does already exist
1146 * we fail. If it doesn't we create a new xattr. If @flags is zero we simply
1147 * insert the new xattr replacing any existing one.
1148 *
1149 * If @value is empty and a matching xattr object is found we delete it if
1150 * XATTR_REPLACE is specified in @flags or @flags is zero.
1151 *
1152 * If @value is empty and no matching xattr object for @name is found we do
1153 * nothing if XATTR_CREATE is specified in @flags or @flags is zero. For
1154 * XATTR_REPLACE we fail as mentioned above.
1155 *
1156 * Return: On success zero and on error a negative error code is returned.
1157 */
1158int simple_xattr_set(struct simple_xattrs *xattrs, const char *name,
1159		     const void *value, size_t size, int flags,
1160		     ssize_t *removed_size)
1161{
1162	struct simple_xattr *xattr = NULL, *new_xattr = NULL;
1163	struct rb_node *parent = NULL, **rbp;
1164	int err = 0, ret;
1165
1166	if (removed_size)
1167		*removed_size = -1;
1168
1169	/* value == NULL means remove */
1170	if (value) {
1171		new_xattr = simple_xattr_alloc(value, size);
1172		if (!new_xattr)
1173			return -ENOMEM;
1174
1175		new_xattr->name = kstrdup(name, GFP_KERNEL);
1176		if (!new_xattr->name) {
1177			free_simple_xattr(new_xattr);
1178			return -ENOMEM;
1179		}
1180	}
1181
1182	write_lock(&xattrs->lock);
1183	rbp = &xattrs->rb_root.rb_node;
1184	while (*rbp) {
1185		parent = *rbp;
1186		ret = rbtree_simple_xattr_cmp(name, *rbp);
1187		if (ret < 0)
1188			rbp = &(*rbp)->rb_left;
1189		else if (ret > 0)
1190			rbp = &(*rbp)->rb_right;
1191		else
1192			xattr = rb_entry(*rbp, struct simple_xattr, rb_node);
1193		if (xattr)
1194			break;
1195	}
1196
1197	if (xattr) {
1198		/* Fail if XATTR_CREATE is requested and the xattr exists. */
1199		if (flags & XATTR_CREATE) {
1200			err = -EEXIST;
1201			goto out_unlock;
1202		}
1203
1204		if (new_xattr)
1205			rb_replace_node(&xattr->rb_node, &new_xattr->rb_node,
1206					&xattrs->rb_root);
1207		else
1208			rb_erase(&xattr->rb_node, &xattrs->rb_root);
1209		if (!err && removed_size)
1210			*removed_size = xattr->size;
1211	} else {
1212		/* Fail if XATTR_REPLACE is requested but no xattr is found. */
1213		if (flags & XATTR_REPLACE) {
1214			err = -ENODATA;
1215			goto out_unlock;
1216		}
1217
1218		/*
1219		 * If XATTR_CREATE or no flags are specified together with a
1220		 * new value simply insert it.
1221		 */
1222		if (new_xattr) {
1223			rb_link_node(&new_xattr->rb_node, parent, rbp);
1224			rb_insert_color(&new_xattr->rb_node, &xattrs->rb_root);
1225		}
1226
1227		/*
1228		 * If XATTR_CREATE or no flags are specified and neither an
1229		 * old or new xattr exist then we don't need to do anything.
1230		 */
1231	}
1232
1233out_unlock:
1234	write_unlock(&xattrs->lock);
1235	if (err)
1236		free_simple_xattr(new_xattr);
1237	else
1238		free_simple_xattr(xattr);
1239	return err;
1240
1241}
1242
1243static bool xattr_is_trusted(const char *name)
1244{
1245	return !strncmp(name, XATTR_TRUSTED_PREFIX, XATTR_TRUSTED_PREFIX_LEN);
1246}
1247
1248static int xattr_list_one(char **buffer, ssize_t *remaining_size,
1249			  const char *name)
1250{
1251	size_t len = strlen(name) + 1;
1252	if (*buffer) {
1253		if (*remaining_size < len)
1254			return -ERANGE;
1255		memcpy(*buffer, name, len);
1256		*buffer += len;
1257	}
1258	*remaining_size -= len;
1259	return 0;
1260}
1261
1262/**
1263 * simple_xattr_list - list all xattr objects
1264 * @inode: inode from which to get the xattrs
1265 * @xattrs: the header of the xattr object
1266 * @buffer: the buffer to store all xattrs into
1267 * @size: the size of @buffer
1268 *
1269 * List all xattrs associated with @inode. If @buffer is NULL we returned
1270 * the required size of the buffer. If @buffer is provided we store the
1271 * xattrs value into it provided it is big enough.
1272 *
1273 * Note, the number of xattr names that can be listed with listxattr(2) is
1274 * limited to XATTR_LIST_MAX aka 65536 bytes. If a larger buffer is passed
1275 * then vfs_listxattr() caps it to XATTR_LIST_MAX and if more xattr names
1276 * are found it will return -E2BIG.
1277 *
1278 * Return: On success the required size or the size of the copied xattrs is
1279 * returned. On error a negative error code is returned.
1280 */
1281ssize_t simple_xattr_list(struct inode *inode, struct simple_xattrs *xattrs,
1282			  char *buffer, size_t size)
1283{
1284	bool trusted = ns_capable_noaudit(&init_user_ns, CAP_SYS_ADMIN);
1285	struct simple_xattr *xattr;
1286	struct rb_node *rbp;
1287	ssize_t remaining_size = size;
1288	int err = 0;
1289
1290#ifdef CONFIG_FS_POSIX_ACL
1291	if (IS_POSIXACL(inode)) {
1292		if (inode->i_acl) {
1293			err = xattr_list_one(&buffer, &remaining_size,
1294					     XATTR_NAME_POSIX_ACL_ACCESS);
1295			if (err)
1296				return err;
1297		}
1298		if (inode->i_default_acl) {
1299			err = xattr_list_one(&buffer, &remaining_size,
1300					     XATTR_NAME_POSIX_ACL_DEFAULT);
1301			if (err)
1302				return err;
1303		}
1304	}
1305#endif
1306
1307	read_lock(&xattrs->lock);
1308	for (rbp = rb_first(&xattrs->rb_root); rbp; rbp = rb_next(rbp)) {
1309		xattr = rb_entry(rbp, struct simple_xattr, rb_node);
1310
1311		/* skip "trusted." attributes for unprivileged callers */
1312		if (!trusted && xattr_is_trusted(xattr->name))
1313			continue;
1314
1315		err = xattr_list_one(&buffer, &remaining_size, xattr->name);
1316		if (err)
1317			break;
1318	}
1319	read_unlock(&xattrs->lock);
1320
1321	return err ? err : size - remaining_size;
1322}
1323
1324/**
1325 * rbtree_simple_xattr_less - compare two xattr rbtree nodes
1326 * @new_node: new node
1327 * @node: current node
1328 *
1329 * Compare the xattr attached to @new_node with the xattr attached to @node.
1330 * Note that this function technically tolerates duplicate entries.
1331 *
1332 * Return: True if insertion point in the rbtree is found.
1333 */
1334static bool rbtree_simple_xattr_less(struct rb_node *new_node,
1335				     const struct rb_node *node)
1336{
1337	return rbtree_simple_xattr_node_cmp(new_node, node) < 0;
1338}
1339
1340/**
1341 * simple_xattr_add - add xattr objects
1342 * @xattrs: the header of the xattr object
1343 * @new_xattr: the xattr object to add
1344 *
1345 * Add an xattr object to @xattrs. This assumes no replacement or removal
1346 * of matching xattrs is wanted. Should only be called during inode
1347 * initialization when a few distinct initial xattrs are supposed to be set.
1348 */
1349void simple_xattr_add(struct simple_xattrs *xattrs,
1350		      struct simple_xattr *new_xattr)
1351{
1352	write_lock(&xattrs->lock);
1353	rb_add(&new_xattr->rb_node, &xattrs->rb_root, rbtree_simple_xattr_less);
1354	write_unlock(&xattrs->lock);
1355}
1356
1357/**
1358 * simple_xattrs_init - initialize new xattr header
1359 * @xattrs: header to initialize
1360 *
1361 * Initialize relevant fields of a an xattr header.
1362 */
1363void simple_xattrs_init(struct simple_xattrs *xattrs)
1364{
1365	xattrs->rb_root = RB_ROOT;
1366	rwlock_init(&xattrs->lock);
1367}
1368
1369/**
1370 * simple_xattrs_free - free xattrs
1371 * @xattrs: xattr header whose xattrs to destroy
1372 *
1373 * Destroy all xattrs in @xattr. When this is called no one can hold a
1374 * reference to any of the xattrs anymore.
1375 */
1376void simple_xattrs_free(struct simple_xattrs *xattrs)
1377{
1378	struct rb_node *rbp;
1379
1380	rbp = rb_first(&xattrs->rb_root);
1381	while (rbp) {
1382		struct simple_xattr *xattr;
1383		struct rb_node *rbp_next;
1384
1385		rbp_next = rb_next(rbp);
1386		xattr = rb_entry(rbp, struct simple_xattr, rb_node);
1387		rb_erase(&xattr->rb_node, &xattrs->rb_root);
1388		free_simple_xattr(xattr);
1389		rbp = rbp_next;
1390	}
1391}
v3.1
 
  1/*
  2  File: fs/xattr.c
  3
  4  Extended attribute handling.
  5
  6  Copyright (C) 2001 by Andreas Gruenbacher <a.gruenbacher@computer.org>
  7  Copyright (C) 2001 SGI - Silicon Graphics, Inc <linux-xfs@oss.sgi.com>
  8  Copyright (c) 2004 Red Hat, Inc., James Morris <jmorris@redhat.com>
  9 */
 10#include <linux/fs.h>
 11#include <linux/slab.h>
 12#include <linux/file.h>
 13#include <linux/xattr.h>
 14#include <linux/mount.h>
 15#include <linux/namei.h>
 16#include <linux/security.h>
 
 17#include <linux/syscalls.h>
 18#include <linux/module.h>
 19#include <linux/fsnotify.h>
 20#include <linux/audit.h>
 21#include <asm/uaccess.h>
 
 22
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 23
 24/*
 25 * Check permissions for extended attribute access.  This is a bit complicated
 26 * because different namespaces have very different rules.
 27 */
 28static int
 29xattr_permission(struct inode *inode, const char *name, int mask)
 
 30{
 31	/*
 32	 * We can never set or remove an extended attribute on a read-only
 33	 * filesystem  or on an immutable / append-only inode.
 34	 */
 35	if (mask & MAY_WRITE) {
 36		if (IS_IMMUTABLE(inode) || IS_APPEND(inode))
 37			return -EPERM;
 
 
 
 38	}
 39
 40	/*
 41	 * No restriction for security.* and system.* from the VFS.  Decision
 42	 * on these is left to the underlying filesystem / security module.
 43	 */
 44	if (!strncmp(name, XATTR_SECURITY_PREFIX, XATTR_SECURITY_PREFIX_LEN) ||
 45	    !strncmp(name, XATTR_SYSTEM_PREFIX, XATTR_SYSTEM_PREFIX_LEN))
 46		return 0;
 47
 48	/*
 49	 * The trusted.* namespace can only be accessed by privileged users.
 50	 */
 51	if (!strncmp(name, XATTR_TRUSTED_PREFIX, XATTR_TRUSTED_PREFIX_LEN)) {
 52		if (!capable(CAP_SYS_ADMIN))
 53			return (mask & MAY_WRITE) ? -EPERM : -ENODATA;
 54		return 0;
 55	}
 56
 57	/*
 58	 * In the user.* namespace, only regular files and directories can have
 59	 * extended attributes. For sticky directories, only the owner and
 60	 * privileged users can write attributes.
 61	 */
 62	if (!strncmp(name, XATTR_USER_PREFIX, XATTR_USER_PREFIX_LEN)) {
 63		if (!S_ISREG(inode->i_mode) && !S_ISDIR(inode->i_mode))
 64			return (mask & MAY_WRITE) ? -EPERM : -ENODATA;
 65		if (S_ISDIR(inode->i_mode) && (inode->i_mode & S_ISVTX) &&
 66		    (mask & MAY_WRITE) && !inode_owner_or_capable(inode))
 
 67			return -EPERM;
 68	}
 69
 70	return inode_permission(inode, mask);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 71}
 
 72
 73/**
 74 *  __vfs_setxattr_noperm - perform setxattr operation without performing
 75 *  permission checks.
 76 *
 77 *  @dentry - object to perform setxattr on
 78 *  @name - xattr name to set
 79 *  @value - value to set @name to
 80 *  @size - size of @value
 81 *  @flags - flags to pass into filesystem operations
 
 82 *
 83 *  returns the result of the internal setxattr or setsecurity operations.
 84 *
 85 *  This function requires the caller to lock the inode's i_mutex before it
 86 *  is executed. It also assumes that the caller will make the appropriate
 87 *  permission checks.
 88 */
 89int __vfs_setxattr_noperm(struct dentry *dentry, const char *name,
 90		const void *value, size_t size, int flags)
 
 91{
 92	struct inode *inode = dentry->d_inode;
 93	int error = -EOPNOTSUPP;
 94	int issec = !strncmp(name, XATTR_SECURITY_PREFIX,
 95				   XATTR_SECURITY_PREFIX_LEN);
 96
 97	if (issec)
 98		inode->i_flags &= ~S_NOSEC;
 99	if (inode->i_op->setxattr) {
100		error = inode->i_op->setxattr(dentry, name, value, size, flags);
 
101		if (!error) {
102			fsnotify_xattr(dentry);
103			security_inode_post_setxattr(dentry, name, value,
104						     size, flags);
105		}
106	} else if (issec) {
107		const char *suffix = name + XATTR_SECURITY_PREFIX_LEN;
108		error = security_inode_setsecurity(inode, suffix, value,
109						   size, flags);
110		if (!error)
111			fsnotify_xattr(dentry);
 
 
 
 
 
 
 
 
 
112	}
113
114	return error;
115}
116
117
 
 
 
 
 
 
 
 
 
 
 
 
118int
119vfs_setxattr(struct dentry *dentry, const char *name, const void *value,
120		size_t size, int flags)
 
121{
122	struct inode *inode = dentry->d_inode;
123	int error;
124
125	error = xattr_permission(inode, name, MAY_WRITE);
126	if (error)
127		return error;
128
129	mutex_lock(&inode->i_mutex);
130	error = security_inode_setxattr(dentry, name, value, size, flags);
 
 
 
 
131	if (error)
132		goto out;
133
134	error = __vfs_setxattr_noperm(dentry, name, value, size, flags);
 
135
136out:
137	mutex_unlock(&inode->i_mutex);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
138	return error;
139}
140EXPORT_SYMBOL_GPL(vfs_setxattr);
141
142ssize_t
143xattr_getsecurity(struct inode *inode, const char *name, void *value,
144			size_t size)
145{
146	void *buffer = NULL;
147	ssize_t len;
148
149	if (!value || !size) {
150		len = security_inode_getsecurity(inode, name, &buffer, false);
 
151		goto out_noalloc;
152	}
153
154	len = security_inode_getsecurity(inode, name, &buffer, true);
 
155	if (len < 0)
156		return len;
157	if (size < len) {
158		len = -ERANGE;
159		goto out;
160	}
161	memcpy(value, buffer, len);
162out:
163	security_release_secctx(buffer, len);
164out_noalloc:
165	return len;
166}
167EXPORT_SYMBOL_GPL(xattr_getsecurity);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
168
169ssize_t
170vfs_getxattr(struct dentry *dentry, const char *name, void *value, size_t size)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
171{
172	struct inode *inode = dentry->d_inode;
173	int error;
174
175	error = xattr_permission(inode, name, MAY_READ);
176	if (error)
177		return error;
178
179	error = security_inode_getxattr(dentry, name);
180	if (error)
181		return error;
182
183	if (!strncmp(name, XATTR_SECURITY_PREFIX,
184				XATTR_SECURITY_PREFIX_LEN)) {
185		const char *suffix = name + XATTR_SECURITY_PREFIX_LEN;
186		int ret = xattr_getsecurity(inode, suffix, value, size);
 
187		/*
188		 * Only overwrite the return value if a security module
189		 * is actually active.
190		 */
191		if (ret == -EOPNOTSUPP)
192			goto nolsm;
193		return ret;
194	}
195nolsm:
196	if (inode->i_op->getxattr)
197		error = inode->i_op->getxattr(dentry, name, value, size);
198	else
199		error = -EOPNOTSUPP;
200
201	return error;
202}
203EXPORT_SYMBOL_GPL(vfs_getxattr);
204
205ssize_t
206vfs_listxattr(struct dentry *d, char *list, size_t size)
207{
 
208	ssize_t error;
209
210	error = security_inode_listxattr(d);
211	if (error)
212		return error;
213	error = -EOPNOTSUPP;
214	if (d->d_inode->i_op->listxattr) {
215		error = d->d_inode->i_op->listxattr(d, list, size);
216	} else {
217		error = security_inode_listsecurity(d->d_inode, list, size);
218		if (size && error > size)
219			error = -ERANGE;
220	}
221	return error;
222}
223EXPORT_SYMBOL_GPL(vfs_listxattr);
224
225int
226vfs_removexattr(struct dentry *dentry, const char *name)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
227{
228	struct inode *inode = dentry->d_inode;
229	int error;
230
231	if (!inode->i_op->removexattr)
232		return -EOPNOTSUPP;
 
233
234	error = xattr_permission(inode, name, MAY_WRITE);
235	if (error)
236		return error;
237
238	error = security_inode_removexattr(dentry, name);
239	if (error)
240		return error;
241
242	mutex_lock(&inode->i_mutex);
243	error = inode->i_op->removexattr(dentry, name);
244	mutex_unlock(&inode->i_mutex);
245
246	if (!error)
247		fsnotify_xattr(dentry);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
248	return error;
249}
250EXPORT_SYMBOL_GPL(vfs_removexattr);
251
252
253/*
254 * Extended attribute SET operations
255 */
256static long
257setxattr(struct dentry *d, const char __user *name, const void __user *value,
258	 size_t size, int flags)
259{
260	int error;
261	void *kvalue = NULL;
262	char kname[XATTR_NAME_MAX + 1];
263
264	if (flags & ~(XATTR_CREATE|XATTR_REPLACE))
265		return -EINVAL;
266
267	error = strncpy_from_user(kname, name, sizeof(kname));
268	if (error == 0 || error == sizeof(kname))
269		error = -ERANGE;
 
270	if (error < 0)
271		return error;
272
273	if (size) {
274		if (size > XATTR_SIZE_MAX)
 
275			return -E2BIG;
276		kvalue = memdup_user(value, size);
277		if (IS_ERR(kvalue))
278			return PTR_ERR(kvalue);
 
 
 
279	}
280
281	error = vfs_setxattr(d, kname, kvalue, size, flags);
282	kfree(kvalue);
283	return error;
284}
285
286SYSCALL_DEFINE5(setxattr, const char __user *, pathname,
287		const char __user *, name, const void __user *, value,
288		size_t, size, int, flags)
289{
290	struct path path;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
291	int error;
292
293	error = user_path(pathname, &path);
294	if (error)
295		return error;
296	error = mnt_want_write(path.mnt);
297	if (!error) {
298		error = setxattr(path.dentry, name, value, size, flags);
299		mnt_drop_write(path.mnt);
300	}
301	path_put(&path);
302	return error;
303}
304
305SYSCALL_DEFINE5(lsetxattr, const char __user *, pathname,
306		const char __user *, name, const void __user *, value,
307		size_t, size, int, flags)
308{
309	struct path path;
310	int error;
311
312	error = user_lpath(pathname, &path);
 
313	if (error)
314		return error;
315	error = mnt_want_write(path.mnt);
316	if (!error) {
317		error = setxattr(path.dentry, name, value, size, flags);
 
318		mnt_drop_write(path.mnt);
319	}
320	path_put(&path);
 
 
 
 
321	return error;
322}
323
 
 
 
 
 
 
 
 
 
 
 
 
 
 
324SYSCALL_DEFINE5(fsetxattr, int, fd, const char __user *, name,
325		const void __user *,value, size_t, size, int, flags)
326{
327	struct file *f;
328	struct dentry *dentry;
329	int error = -EBADF;
330
331	f = fget(fd);
332	if (!f)
333		return error;
334	dentry = f->f_path.dentry;
335	audit_inode(NULL, dentry);
336	error = mnt_want_write_file(f);
337	if (!error) {
338		error = setxattr(dentry, name, value, size, flags);
339		mnt_drop_write(f->f_path.mnt);
 
 
340	}
341	fput(f);
342	return error;
343}
344
345/*
346 * Extended attribute GET operations
347 */
348static ssize_t
349getxattr(struct dentry *d, const char __user *name, void __user *value,
350	 size_t size)
351{
352	ssize_t error;
353	void *kvalue = NULL;
354	char kname[XATTR_NAME_MAX + 1];
355
356	error = strncpy_from_user(kname, name, sizeof(kname));
357	if (error == 0 || error == sizeof(kname))
358		error = -ERANGE;
359	if (error < 0)
360		return error;
361
362	if (size) {
363		if (size > XATTR_SIZE_MAX)
364			size = XATTR_SIZE_MAX;
365		kvalue = kzalloc(size, GFP_KERNEL);
366		if (!kvalue)
367			return -ENOMEM;
368	}
369
370	error = vfs_getxattr(d, kname, kvalue, size);
 
 
 
 
371	if (error > 0) {
372		if (size && copy_to_user(value, kvalue, error))
373			error = -EFAULT;
374	} else if (error == -ERANGE && size >= XATTR_SIZE_MAX) {
375		/* The file system tried to returned a value bigger
376		   than XATTR_SIZE_MAX bytes. Not possible. */
377		error = -E2BIG;
378	}
379	kfree(kvalue);
380	return error;
381}
382
383SYSCALL_DEFINE4(getxattr, const char __user *, pathname,
384		const char __user *, name, void __user *, value, size_t, size)
 
385{
386	struct path path;
387	ssize_t error;
 
 
 
 
 
 
 
 
388
389	error = user_path(pathname, &path);
390	if (error)
 
 
391		return error;
392	error = getxattr(path.dentry, name, value, size);
393	path_put(&path);
 
 
394	return error;
395}
396
397SYSCALL_DEFINE4(lgetxattr, const char __user *, pathname,
398		const char __user *, name, void __user *, value, size_t, size)
 
399{
400	struct path path;
401	ssize_t error;
402
403	error = user_lpath(pathname, &path);
404	if (error)
405		return error;
406	error = getxattr(path.dentry, name, value, size);
407	path_put(&path);
 
 
 
 
408	return error;
409}
410
 
 
 
 
 
 
 
 
 
 
 
 
411SYSCALL_DEFINE4(fgetxattr, int, fd, const char __user *, name,
412		void __user *, value, size_t, size)
413{
414	struct file *f;
415	ssize_t error = -EBADF;
416
417	f = fget(fd);
418	if (!f)
419		return error;
420	audit_inode(NULL, f->f_path.dentry);
421	error = getxattr(f->f_path.dentry, name, value, size);
422	fput(f);
 
423	return error;
424}
425
426/*
427 * Extended attribute LIST operations
428 */
429static ssize_t
430listxattr(struct dentry *d, char __user *list, size_t size)
431{
432	ssize_t error;
433	char *klist = NULL;
434
435	if (size) {
436		if (size > XATTR_LIST_MAX)
437			size = XATTR_LIST_MAX;
438		klist = kmalloc(size, GFP_KERNEL);
439		if (!klist)
440			return -ENOMEM;
441	}
442
443	error = vfs_listxattr(d, klist, size);
444	if (error > 0) {
445		if (size && copy_to_user(list, klist, error))
446			error = -EFAULT;
447	} else if (error == -ERANGE && size >= XATTR_LIST_MAX) {
448		/* The file system tried to returned a list bigger
449		   than XATTR_LIST_MAX bytes. Not possible. */
450		error = -E2BIG;
451	}
452	kfree(klist);
 
 
453	return error;
454}
455
456SYSCALL_DEFINE3(listxattr, const char __user *, pathname, char __user *, list,
457		size_t, size)
458{
459	struct path path;
460	ssize_t error;
461
462	error = user_path(pathname, &path);
463	if (error)
464		return error;
465	error = listxattr(path.dentry, list, size);
466	path_put(&path);
 
 
 
 
467	return error;
468}
469
 
 
 
 
 
 
470SYSCALL_DEFINE3(llistxattr, const char __user *, pathname, char __user *, list,
471		size_t, size)
472{
473	struct path path;
474	ssize_t error;
475
476	error = user_lpath(pathname, &path);
477	if (error)
478		return error;
479	error = listxattr(path.dentry, list, size);
480	path_put(&path);
481	return error;
482}
483
484SYSCALL_DEFINE3(flistxattr, int, fd, char __user *, list, size_t, size)
485{
486	struct file *f;
487	ssize_t error = -EBADF;
488
489	f = fget(fd);
490	if (!f)
491		return error;
492	audit_inode(NULL, f->f_path.dentry);
493	error = listxattr(f->f_path.dentry, list, size);
494	fput(f);
495	return error;
496}
497
498/*
499 * Extended attribute REMOVE operations
500 */
501static long
502removexattr(struct dentry *d, const char __user *name)
 
503{
504	int error;
505	char kname[XATTR_NAME_MAX + 1];
506
507	error = strncpy_from_user(kname, name, sizeof(kname));
508	if (error == 0 || error == sizeof(kname))
509		error = -ERANGE;
510	if (error < 0)
511		return error;
512
513	return vfs_removexattr(d, kname);
 
 
 
514}
515
516SYSCALL_DEFINE2(removexattr, const char __user *, pathname,
517		const char __user *, name)
518{
519	struct path path;
520	int error;
521
522	error = user_path(pathname, &path);
523	if (error)
524		return error;
525	error = mnt_want_write(path.mnt);
526	if (!error) {
527		error = removexattr(path.dentry, name);
528		mnt_drop_write(path.mnt);
529	}
530	path_put(&path);
 
 
 
 
531	return error;
532}
533
 
 
 
 
 
 
534SYSCALL_DEFINE2(lremovexattr, const char __user *, pathname,
535		const char __user *, name)
536{
537	struct path path;
538	int error;
539
540	error = user_lpath(pathname, &path);
541	if (error)
542		return error;
543	error = mnt_want_write(path.mnt);
544	if (!error) {
545		error = removexattr(path.dentry, name);
546		mnt_drop_write(path.mnt);
547	}
548	path_put(&path);
549	return error;
550}
551
552SYSCALL_DEFINE2(fremovexattr, int, fd, const char __user *, name)
553{
554	struct file *f;
555	struct dentry *dentry;
556	int error = -EBADF;
557
558	f = fget(fd);
559	if (!f)
560		return error;
561	dentry = f->f_path.dentry;
562	audit_inode(NULL, dentry);
563	error = mnt_want_write_file(f);
564	if (!error) {
565		error = removexattr(dentry, name);
566		mnt_drop_write(f->f_path.mnt);
 
567	}
568	fput(f);
569	return error;
570}
571
 
 
 
 
 
 
 
 
 
572
573static const char *
574strcmp_prefix(const char *a, const char *a_prefix)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
575{
576	while (*a_prefix && *a == *a_prefix) {
577		a++;
578		a_prefix++;
579	}
580	return *a_prefix ? NULL : a;
581}
 
582
583/*
584 * In order to implement different sets of xattr operations for each xattr
585 * prefix with the generic xattr API, a filesystem should create a
586 * null-terminated array of struct xattr_handler (one for each prefix) and
587 * hang a pointer to it off of the s_xattr field of the superblock.
588 *
589 * The generic_fooxattr() functions will use this list to dispatch xattr
590 * operations to the correct xattr_handler.
591 */
592#define for_each_xattr_handler(handlers, handler)		\
593		for ((handler) = *(handlers)++;			\
594			(handler) != NULL;			\
595			(handler) = *(handlers)++)
 
 
596
597/*
598 * Find the xattr_handler with the matching prefix.
 
 
 
 
 
 
 
 
599 */
600static const struct xattr_handler *
601xattr_resolve_name(const struct xattr_handler **handlers, const char **name)
602{
603	const struct xattr_handler *handler;
 
 
 
 
 
 
604
605	if (!*name)
 
606		return NULL;
607
608	for_each_xattr_handler(handlers, handler) {
609		const char *n = strcmp_prefix(*name, handler->prefix);
610		if (n) {
611			*name = n;
612			break;
613		}
614	}
615	return handler;
616}
617
618/*
619 * Find the handler for the prefix and dispatch its get() operation.
 
 
 
 
 
 
 
620 */
621ssize_t
622generic_getxattr(struct dentry *dentry, const char *name, void *buffer, size_t size)
623{
624	const struct xattr_handler *handler;
 
 
 
 
 
625
626	handler = xattr_resolve_name(dentry->d_sb->s_xattr, &name);
627	if (!handler)
628		return -EOPNOTSUPP;
629	return handler->get(dentry, name, buffer, size, handler->flags);
 
 
 
 
 
 
 
 
 
 
 
 
630}
631
632/*
633 * Combine the results of the list() operation from every xattr_handler in the
634 * list.
 
 
 
 
 
 
 
 
 
 
 
635 */
636ssize_t
637generic_listxattr(struct dentry *dentry, char *buffer, size_t buffer_size)
638{
639	const struct xattr_handler *handler, **handlers = dentry->d_sb->s_xattr;
640	unsigned int size = 0;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
641
642	if (!buffer) {
643		for_each_xattr_handler(handlers, handler) {
644			size += handler->list(dentry, NULL, 0, NULL, 0,
645					      handler->flags);
 
646		}
 
 
 
 
 
 
 
 
647	} else {
648		char *buf = buffer;
 
 
 
 
649
650		for_each_xattr_handler(handlers, handler) {
651			size = handler->list(dentry, buf, buffer_size,
652					     NULL, 0, handler->flags);
653			if (size > buffer_size)
654				return -ERANGE;
655			buf += size;
656			buffer_size -= size;
657		}
658		size = buf - buffer;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
659	}
660	return size;
 
661}
662
663/*
664 * Find the handler for the prefix and dispatch its set() operation.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
665 */
666int
667generic_setxattr(struct dentry *dentry, const char *name, const void *value, size_t size, int flags)
668{
669	const struct xattr_handler *handler;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
670
671	if (size == 0)
672		value = "";  /* empty EA, do not remove */
673	handler = xattr_resolve_name(dentry->d_sb->s_xattr, &name);
674	if (!handler)
675		return -EOPNOTSUPP;
676	return handler->set(dentry, name, value, size, flags, handler->flags);
 
 
 
 
 
 
 
 
677}
678
679/*
680 * Find the handler for the prefix and dispatch its set() operation to remove
681 * any associated extended attribute.
 
 
 
 
 
682 */
683int
684generic_removexattr(struct dentry *dentry, const char *name)
685{
686	const struct xattr_handler *handler;
 
 
 
687
688	handler = xattr_resolve_name(dentry->d_sb->s_xattr, &name);
689	if (!handler)
690		return -EOPNOTSUPP;
691	return handler->set(dentry, name, NULL, 0,
692			    XATTR_REPLACE, handler->flags);
 
 
 
 
 
693}
694
695EXPORT_SYMBOL(generic_getxattr);
696EXPORT_SYMBOL(generic_listxattr);
697EXPORT_SYMBOL(generic_setxattr);
698EXPORT_SYMBOL(generic_removexattr);