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/filelock.h>
13 #include <linux/slab.h>
14 #include <linux/file.h>
15 #include <linux/xattr.h>
16 #include <linux/mount.h>
17 #include <linux/namei.h>
18 #include <linux/security.h>
19 #include <linux/evm.h>
20 #include <linux/syscalls.h>
21 #include <linux/export.h>
22 #include <linux/fsnotify.h>
23 #include <linux/audit.h>
24 #include <linux/vmalloc.h>
25 #include <linux/posix_acl_xattr.h>
26
27 #include <linux/uaccess.h>
28
29 #include "internal.h"
30
31 static const char *
strcmp_prefix(const char * a,const char * a_prefix)32 strcmp_prefix(const char *a, const char *a_prefix)
33 {
34 while (*a_prefix && *a == *a_prefix) {
35 a++;
36 a_prefix++;
37 }
38 return *a_prefix ? NULL : a;
39 }
40
41 /*
42 * In order to implement different sets of xattr operations for each xattr
43 * prefix, a filesystem should create a null-terminated array of struct
44 * xattr_handler (one for each prefix) and hang a pointer to it off of the
45 * s_xattr field of the superblock.
46 */
47 #define for_each_xattr_handler(handlers, handler) \
48 if (handlers) \
49 for ((handler) = *(handlers)++; \
50 (handler) != NULL; \
51 (handler) = *(handlers)++)
52
53 /*
54 * Find the xattr_handler with the matching prefix.
55 */
56 static const struct xattr_handler *
xattr_resolve_name(struct inode * inode,const char ** name)57 xattr_resolve_name(struct inode *inode, const char **name)
58 {
59 const struct xattr_handler **handlers = inode->i_sb->s_xattr;
60 const struct xattr_handler *handler;
61
62 if (!(inode->i_opflags & IOP_XATTR)) {
63 if (unlikely(is_bad_inode(inode)))
64 return ERR_PTR(-EIO);
65 return ERR_PTR(-EOPNOTSUPP);
66 }
67 for_each_xattr_handler(handlers, handler) {
68 const char *n;
69
70 n = strcmp_prefix(*name, xattr_prefix(handler));
71 if (n) {
72 if (!handler->prefix ^ !*n) {
73 if (*n)
74 continue;
75 return ERR_PTR(-EINVAL);
76 }
77 *name = n;
78 return handler;
79 }
80 }
81 return ERR_PTR(-EOPNOTSUPP);
82 }
83
84 /**
85 * may_write_xattr - check whether inode allows writing xattr
86 * @idmap: idmap of the mount the inode was found from
87 * @inode: the inode on which to set an xattr
88 *
89 * Check whether the inode allows writing xattrs. Specifically, we can never
90 * set or remove an extended attribute on a read-only filesystem or on an
91 * immutable / append-only inode.
92 *
93 * We also need to ensure that the inode has a mapping in the mount to
94 * not risk writing back invalid i_{g,u}id values.
95 *
96 * Return: On success zero is returned. On error a negative errno is returned.
97 */
may_write_xattr(struct mnt_idmap * idmap,struct inode * inode)98 int may_write_xattr(struct mnt_idmap *idmap, struct inode *inode)
99 {
100 if (IS_IMMUTABLE(inode))
101 return -EPERM;
102 if (IS_APPEND(inode))
103 return -EPERM;
104 if (HAS_UNMAPPED_ID(idmap, inode))
105 return -EPERM;
106 return 0;
107 }
108
109 /*
110 * Check permissions for extended attribute access. This is a bit complicated
111 * because different namespaces have very different rules.
112 */
113 static int
xattr_permission(struct mnt_idmap * idmap,struct inode * inode,const char * name,int mask)114 xattr_permission(struct mnt_idmap *idmap, struct inode *inode,
115 const char *name, int mask)
116 {
117 if (mask & MAY_WRITE) {
118 int ret;
119
120 ret = may_write_xattr(idmap, inode);
121 if (ret)
122 return ret;
123 }
124
125 /*
126 * No restriction for security.* and system.* from the VFS. Decision
127 * on these is left to the underlying filesystem / security module.
128 */
129 if (!strncmp(name, XATTR_SECURITY_PREFIX, XATTR_SECURITY_PREFIX_LEN) ||
130 !strncmp(name, XATTR_SYSTEM_PREFIX, XATTR_SYSTEM_PREFIX_LEN))
131 return 0;
132
133 /*
134 * The trusted.* namespace can only be accessed by privileged users.
135 */
136 if (!strncmp(name, XATTR_TRUSTED_PREFIX, XATTR_TRUSTED_PREFIX_LEN)) {
137 if (!capable(CAP_SYS_ADMIN))
138 return (mask & MAY_WRITE) ? -EPERM : -ENODATA;
139 return 0;
140 }
141
142 /*
143 * In the user.* namespace, only regular files and directories can have
144 * extended attributes. For sticky directories, only the owner and
145 * privileged users can write attributes.
146 */
147 if (!strncmp(name, XATTR_USER_PREFIX, XATTR_USER_PREFIX_LEN)) {
148 if (!S_ISREG(inode->i_mode) && !S_ISDIR(inode->i_mode))
149 return (mask & MAY_WRITE) ? -EPERM : -ENODATA;
150 if (S_ISDIR(inode->i_mode) && (inode->i_mode & S_ISVTX) &&
151 (mask & MAY_WRITE) &&
152 !inode_owner_or_capable(idmap, inode))
153 return -EPERM;
154 }
155
156 return inode_permission(idmap, inode, mask);
157 }
158
159 /*
160 * Look for any handler that deals with the specified namespace.
161 */
162 int
xattr_supported_namespace(struct inode * inode,const char * prefix)163 xattr_supported_namespace(struct inode *inode, const char *prefix)
164 {
165 const struct xattr_handler **handlers = inode->i_sb->s_xattr;
166 const struct xattr_handler *handler;
167 size_t preflen;
168
169 if (!(inode->i_opflags & IOP_XATTR)) {
170 if (unlikely(is_bad_inode(inode)))
171 return -EIO;
172 return -EOPNOTSUPP;
173 }
174
175 preflen = strlen(prefix);
176
177 for_each_xattr_handler(handlers, handler) {
178 if (!strncmp(xattr_prefix(handler), prefix, preflen))
179 return 0;
180 }
181
182 return -EOPNOTSUPP;
183 }
184 EXPORT_SYMBOL(xattr_supported_namespace);
185
186 int
__vfs_setxattr(struct mnt_idmap * idmap,struct dentry * dentry,struct inode * inode,const char * name,const void * value,size_t size,int flags)187 __vfs_setxattr(struct mnt_idmap *idmap, struct dentry *dentry,
188 struct inode *inode, const char *name, const void *value,
189 size_t size, int flags)
190 {
191 const struct xattr_handler *handler;
192
193 if (is_posix_acl_xattr(name))
194 return -EOPNOTSUPP;
195
196 handler = xattr_resolve_name(inode, &name);
197 if (IS_ERR(handler))
198 return PTR_ERR(handler);
199 if (!handler->set)
200 return -EOPNOTSUPP;
201 if (size == 0)
202 value = ""; /* empty EA, do not remove */
203 return handler->set(handler, idmap, dentry, inode, name, value,
204 size, flags);
205 }
206 EXPORT_SYMBOL(__vfs_setxattr);
207
208 /**
209 * __vfs_setxattr_noperm - perform setxattr operation without performing
210 * permission checks.
211 *
212 * @idmap: idmap of the mount the inode was found from
213 * @dentry: object to perform setxattr on
214 * @name: xattr name to set
215 * @value: value to set @name to
216 * @size: size of @value
217 * @flags: flags to pass into filesystem operations
218 *
219 * returns the result of the internal setxattr or setsecurity operations.
220 *
221 * This function requires the caller to lock the inode's i_mutex before it
222 * is executed. It also assumes that the caller will make the appropriate
223 * permission checks.
224 */
__vfs_setxattr_noperm(struct mnt_idmap * idmap,struct dentry * dentry,const char * name,const void * value,size_t size,int flags)225 int __vfs_setxattr_noperm(struct mnt_idmap *idmap,
226 struct dentry *dentry, const char *name,
227 const void *value, size_t size, int flags)
228 {
229 struct inode *inode = dentry->d_inode;
230 int error = -EAGAIN;
231 int issec = !strncmp(name, XATTR_SECURITY_PREFIX,
232 XATTR_SECURITY_PREFIX_LEN);
233
234 if (issec)
235 inode->i_flags &= ~S_NOSEC;
236 if (inode->i_opflags & IOP_XATTR) {
237 error = __vfs_setxattr(idmap, dentry, inode, name, value,
238 size, flags);
239 if (!error) {
240 fsnotify_xattr(dentry);
241 security_inode_post_setxattr(dentry, name, value,
242 size, flags);
243 }
244 } else {
245 if (unlikely(is_bad_inode(inode)))
246 return -EIO;
247 }
248 if (error == -EAGAIN) {
249 error = -EOPNOTSUPP;
250
251 if (issec) {
252 const char *suffix = name + XATTR_SECURITY_PREFIX_LEN;
253
254 error = security_inode_setsecurity(inode, suffix, value,
255 size, flags);
256 if (!error)
257 fsnotify_xattr(dentry);
258 }
259 }
260
261 return error;
262 }
263
264 /**
265 * __vfs_setxattr_locked - set an extended attribute while holding the inode
266 * lock
267 *
268 * @idmap: idmap of the mount of the target inode
269 * @dentry: object to perform setxattr on
270 * @name: xattr name to set
271 * @value: value to set @name to
272 * @size: size of @value
273 * @flags: flags to pass into filesystem operations
274 * @delegated_inode: on return, will contain an inode pointer that
275 * a delegation was broken on, NULL if none.
276 */
277 int
__vfs_setxattr_locked(struct mnt_idmap * idmap,struct dentry * dentry,const char * name,const void * value,size_t size,int flags,struct inode ** delegated_inode)278 __vfs_setxattr_locked(struct mnt_idmap *idmap, struct dentry *dentry,
279 const char *name, const void *value, size_t size,
280 int flags, struct inode **delegated_inode)
281 {
282 struct inode *inode = dentry->d_inode;
283 int error;
284
285 error = xattr_permission(idmap, inode, name, MAY_WRITE);
286 if (error)
287 return error;
288
289 error = security_inode_setxattr(idmap, dentry, name, value, size,
290 flags);
291 if (error)
292 goto out;
293
294 error = try_break_deleg(inode, delegated_inode);
295 if (error)
296 goto out;
297
298 error = __vfs_setxattr_noperm(idmap, dentry, name, value,
299 size, flags);
300
301 out:
302 return error;
303 }
304 EXPORT_SYMBOL_GPL(__vfs_setxattr_locked);
305
306 int
vfs_setxattr(struct mnt_idmap * idmap,struct dentry * dentry,const char * name,const void * value,size_t size,int flags)307 vfs_setxattr(struct mnt_idmap *idmap, struct dentry *dentry,
308 const char *name, const void *value, size_t size, int flags)
309 {
310 struct inode *inode = dentry->d_inode;
311 struct inode *delegated_inode = NULL;
312 const void *orig_value = value;
313 int error;
314
315 if (size && strcmp(name, XATTR_NAME_CAPS) == 0) {
316 error = cap_convert_nscap(idmap, dentry, &value, size);
317 if (error < 0)
318 return error;
319 size = error;
320 }
321
322 retry_deleg:
323 inode_lock(inode);
324 error = __vfs_setxattr_locked(idmap, dentry, name, value, size,
325 flags, &delegated_inode);
326 inode_unlock(inode);
327
328 if (delegated_inode) {
329 error = break_deleg_wait(&delegated_inode);
330 if (!error)
331 goto retry_deleg;
332 }
333 if (value != orig_value)
334 kfree(value);
335
336 return error;
337 }
338 EXPORT_SYMBOL_GPL(vfs_setxattr);
339
340 static ssize_t
xattr_getsecurity(struct mnt_idmap * idmap,struct inode * inode,const char * name,void * value,size_t size)341 xattr_getsecurity(struct mnt_idmap *idmap, struct inode *inode,
342 const char *name, void *value, size_t size)
343 {
344 void *buffer = NULL;
345 ssize_t len;
346
347 if (!value || !size) {
348 len = security_inode_getsecurity(idmap, inode, name,
349 &buffer, false);
350 goto out_noalloc;
351 }
352
353 len = security_inode_getsecurity(idmap, inode, name, &buffer,
354 true);
355 if (len < 0)
356 return len;
357 if (size < len) {
358 len = -ERANGE;
359 goto out;
360 }
361 memcpy(value, buffer, len);
362 out:
363 kfree(buffer);
364 out_noalloc:
365 return len;
366 }
367
368 /*
369 * vfs_getxattr_alloc - allocate memory, if necessary, before calling getxattr
370 *
371 * Allocate memory, if not already allocated, or re-allocate correct size,
372 * before retrieving the extended attribute. The xattr value buffer should
373 * always be freed by the caller, even on error.
374 *
375 * Returns the result of alloc, if failed, or the getxattr operation.
376 */
377 int
vfs_getxattr_alloc(struct mnt_idmap * idmap,struct dentry * dentry,const char * name,char ** xattr_value,size_t xattr_size,gfp_t flags)378 vfs_getxattr_alloc(struct mnt_idmap *idmap, struct dentry *dentry,
379 const char *name, char **xattr_value, size_t xattr_size,
380 gfp_t flags)
381 {
382 const struct xattr_handler *handler;
383 struct inode *inode = dentry->d_inode;
384 char *value = *xattr_value;
385 int error;
386
387 error = xattr_permission(idmap, inode, name, MAY_READ);
388 if (error)
389 return error;
390
391 handler = xattr_resolve_name(inode, &name);
392 if (IS_ERR(handler))
393 return PTR_ERR(handler);
394 if (!handler->get)
395 return -EOPNOTSUPP;
396 error = handler->get(handler, dentry, inode, name, NULL, 0);
397 if (error < 0)
398 return error;
399
400 if (!value || (error > xattr_size)) {
401 value = krealloc(*xattr_value, error + 1, flags);
402 if (!value)
403 return -ENOMEM;
404 memset(value, 0, error + 1);
405 }
406
407 error = handler->get(handler, dentry, inode, name, value, error);
408 *xattr_value = value;
409 return error;
410 }
411
412 ssize_t
__vfs_getxattr(struct dentry * dentry,struct inode * inode,const char * name,void * value,size_t size)413 __vfs_getxattr(struct dentry *dentry, struct inode *inode, const char *name,
414 void *value, size_t size)
415 {
416 const struct xattr_handler *handler;
417
418 if (is_posix_acl_xattr(name))
419 return -EOPNOTSUPP;
420
421 handler = xattr_resolve_name(inode, &name);
422 if (IS_ERR(handler))
423 return PTR_ERR(handler);
424 if (!handler->get)
425 return -EOPNOTSUPP;
426 return handler->get(handler, dentry, inode, name, value, size);
427 }
428 EXPORT_SYMBOL(__vfs_getxattr);
429
430 ssize_t
vfs_getxattr(struct mnt_idmap * idmap,struct dentry * dentry,const char * name,void * value,size_t size)431 vfs_getxattr(struct mnt_idmap *idmap, struct dentry *dentry,
432 const char *name, void *value, size_t size)
433 {
434 struct inode *inode = dentry->d_inode;
435 int error;
436
437 error = xattr_permission(idmap, inode, name, MAY_READ);
438 if (error)
439 return error;
440
441 error = security_inode_getxattr(dentry, name);
442 if (error)
443 return error;
444
445 if (!strncmp(name, XATTR_SECURITY_PREFIX,
446 XATTR_SECURITY_PREFIX_LEN)) {
447 const char *suffix = name + XATTR_SECURITY_PREFIX_LEN;
448 int ret = xattr_getsecurity(idmap, inode, suffix, value,
449 size);
450 /*
451 * Only overwrite the return value if a security module
452 * is actually active.
453 */
454 if (ret == -EOPNOTSUPP)
455 goto nolsm;
456 return ret;
457 }
458 nolsm:
459 return __vfs_getxattr(dentry, inode, name, value, size);
460 }
461 EXPORT_SYMBOL_GPL(vfs_getxattr);
462
463 ssize_t
vfs_listxattr(struct dentry * dentry,char * list,size_t size)464 vfs_listxattr(struct dentry *dentry, char *list, size_t size)
465 {
466 struct inode *inode = d_inode(dentry);
467 ssize_t error;
468
469 error = security_inode_listxattr(dentry);
470 if (error)
471 return error;
472 if (inode->i_op->listxattr && (inode->i_opflags & IOP_XATTR)) {
473 error = inode->i_op->listxattr(dentry, list, size);
474 } else {
475 error = security_inode_listsecurity(inode, list, size);
476 if (size && error > size)
477 error = -ERANGE;
478 }
479 return error;
480 }
481 EXPORT_SYMBOL_GPL(vfs_listxattr);
482
483 int
__vfs_removexattr(struct mnt_idmap * idmap,struct dentry * dentry,const char * name)484 __vfs_removexattr(struct mnt_idmap *idmap, struct dentry *dentry,
485 const char *name)
486 {
487 struct inode *inode = d_inode(dentry);
488 const struct xattr_handler *handler;
489
490 if (is_posix_acl_xattr(name))
491 return -EOPNOTSUPP;
492
493 handler = xattr_resolve_name(inode, &name);
494 if (IS_ERR(handler))
495 return PTR_ERR(handler);
496 if (!handler->set)
497 return -EOPNOTSUPP;
498 return handler->set(handler, idmap, dentry, inode, name, NULL, 0,
499 XATTR_REPLACE);
500 }
501 EXPORT_SYMBOL(__vfs_removexattr);
502
503 /**
504 * __vfs_removexattr_locked - set an extended attribute while holding the inode
505 * lock
506 *
507 * @idmap: idmap of the mount of the target inode
508 * @dentry: object to perform setxattr on
509 * @name: name of xattr to remove
510 * @delegated_inode: on return, will contain an inode pointer that
511 * a delegation was broken on, NULL if none.
512 */
513 int
__vfs_removexattr_locked(struct mnt_idmap * idmap,struct dentry * dentry,const char * name,struct inode ** delegated_inode)514 __vfs_removexattr_locked(struct mnt_idmap *idmap,
515 struct dentry *dentry, const char *name,
516 struct inode **delegated_inode)
517 {
518 struct inode *inode = dentry->d_inode;
519 int error;
520
521 error = xattr_permission(idmap, inode, name, MAY_WRITE);
522 if (error)
523 return error;
524
525 error = security_inode_removexattr(idmap, dentry, name);
526 if (error)
527 goto out;
528
529 error = try_break_deleg(inode, delegated_inode);
530 if (error)
531 goto out;
532
533 error = __vfs_removexattr(idmap, dentry, name);
534
535 if (!error) {
536 fsnotify_xattr(dentry);
537 evm_inode_post_removexattr(dentry, name);
538 }
539
540 out:
541 return error;
542 }
543 EXPORT_SYMBOL_GPL(__vfs_removexattr_locked);
544
545 int
vfs_removexattr(struct mnt_idmap * idmap,struct dentry * dentry,const char * name)546 vfs_removexattr(struct mnt_idmap *idmap, struct dentry *dentry,
547 const char *name)
548 {
549 struct inode *inode = dentry->d_inode;
550 struct inode *delegated_inode = NULL;
551 int error;
552
553 retry_deleg:
554 inode_lock(inode);
555 error = __vfs_removexattr_locked(idmap, dentry,
556 name, &delegated_inode);
557 inode_unlock(inode);
558
559 if (delegated_inode) {
560 error = break_deleg_wait(&delegated_inode);
561 if (!error)
562 goto retry_deleg;
563 }
564
565 return error;
566 }
567 EXPORT_SYMBOL_GPL(vfs_removexattr);
568
569 /*
570 * Extended attribute SET operations
571 */
572
setxattr_copy(const char __user * name,struct xattr_ctx * ctx)573 int setxattr_copy(const char __user *name, struct xattr_ctx *ctx)
574 {
575 int error;
576
577 if (ctx->flags & ~(XATTR_CREATE|XATTR_REPLACE))
578 return -EINVAL;
579
580 error = strncpy_from_user(ctx->kname->name, name,
581 sizeof(ctx->kname->name));
582 if (error == 0 || error == sizeof(ctx->kname->name))
583 return -ERANGE;
584 if (error < 0)
585 return error;
586
587 error = 0;
588 if (ctx->size) {
589 if (ctx->size > XATTR_SIZE_MAX)
590 return -E2BIG;
591
592 ctx->kvalue = vmemdup_user(ctx->cvalue, ctx->size);
593 if (IS_ERR(ctx->kvalue)) {
594 error = PTR_ERR(ctx->kvalue);
595 ctx->kvalue = NULL;
596 }
597 }
598
599 return error;
600 }
601
do_setxattr(struct mnt_idmap * idmap,struct dentry * dentry,struct xattr_ctx * ctx)602 int do_setxattr(struct mnt_idmap *idmap, struct dentry *dentry,
603 struct xattr_ctx *ctx)
604 {
605 if (is_posix_acl_xattr(ctx->kname->name))
606 return do_set_acl(idmap, dentry, ctx->kname->name,
607 ctx->kvalue, ctx->size);
608
609 return vfs_setxattr(idmap, dentry, ctx->kname->name,
610 ctx->kvalue, ctx->size, ctx->flags);
611 }
612
613 static long
setxattr(struct mnt_idmap * idmap,struct dentry * d,const char __user * name,const void __user * value,size_t size,int flags)614 setxattr(struct mnt_idmap *idmap, struct dentry *d,
615 const char __user *name, const void __user *value, size_t size,
616 int flags)
617 {
618 struct xattr_name kname;
619 struct xattr_ctx ctx = {
620 .cvalue = value,
621 .kvalue = NULL,
622 .size = size,
623 .kname = &kname,
624 .flags = flags,
625 };
626 int error;
627
628 error = setxattr_copy(name, &ctx);
629 if (error)
630 return error;
631
632 error = do_setxattr(idmap, d, &ctx);
633
634 kvfree(ctx.kvalue);
635 return error;
636 }
637
path_setxattr(const char __user * pathname,const char __user * name,const void __user * value,size_t size,int flags,unsigned int lookup_flags)638 static int path_setxattr(const char __user *pathname,
639 const char __user *name, const void __user *value,
640 size_t size, int flags, unsigned int lookup_flags)
641 {
642 struct path path;
643 int error;
644
645 retry:
646 error = user_path_at(AT_FDCWD, pathname, lookup_flags, &path);
647 if (error)
648 return error;
649 error = mnt_want_write(path.mnt);
650 if (!error) {
651 error = setxattr(mnt_idmap(path.mnt), path.dentry, name,
652 value, size, flags);
653 mnt_drop_write(path.mnt);
654 }
655 path_put(&path);
656 if (retry_estale(error, lookup_flags)) {
657 lookup_flags |= LOOKUP_REVAL;
658 goto retry;
659 }
660 return error;
661 }
662
SYSCALL_DEFINE5(setxattr,const char __user *,pathname,const char __user *,name,const void __user *,value,size_t,size,int,flags)663 SYSCALL_DEFINE5(setxattr, const char __user *, pathname,
664 const char __user *, name, const void __user *, value,
665 size_t, size, int, flags)
666 {
667 return path_setxattr(pathname, name, value, size, flags, LOOKUP_FOLLOW);
668 }
669
SYSCALL_DEFINE5(lsetxattr,const char __user *,pathname,const char __user *,name,const void __user *,value,size_t,size,int,flags)670 SYSCALL_DEFINE5(lsetxattr, const char __user *, pathname,
671 const char __user *, name, const void __user *, value,
672 size_t, size, int, flags)
673 {
674 return path_setxattr(pathname, name, value, size, flags, 0);
675 }
676
SYSCALL_DEFINE5(fsetxattr,int,fd,const char __user *,name,const void __user *,value,size_t,size,int,flags)677 SYSCALL_DEFINE5(fsetxattr, int, fd, const char __user *, name,
678 const void __user *,value, size_t, size, int, flags)
679 {
680 struct fd f = fdget(fd);
681 int error = -EBADF;
682
683 if (!f.file)
684 return error;
685 audit_file(f.file);
686 error = mnt_want_write_file(f.file);
687 if (!error) {
688 error = setxattr(file_mnt_idmap(f.file),
689 f.file->f_path.dentry, name,
690 value, size, flags);
691 mnt_drop_write_file(f.file);
692 }
693 fdput(f);
694 return error;
695 }
696
697 /*
698 * Extended attribute GET operations
699 */
700 ssize_t
do_getxattr(struct mnt_idmap * idmap,struct dentry * d,struct xattr_ctx * ctx)701 do_getxattr(struct mnt_idmap *idmap, struct dentry *d,
702 struct xattr_ctx *ctx)
703 {
704 ssize_t error;
705 char *kname = ctx->kname->name;
706
707 if (ctx->size) {
708 if (ctx->size > XATTR_SIZE_MAX)
709 ctx->size = XATTR_SIZE_MAX;
710 ctx->kvalue = kvzalloc(ctx->size, GFP_KERNEL);
711 if (!ctx->kvalue)
712 return -ENOMEM;
713 }
714
715 if (is_posix_acl_xattr(ctx->kname->name))
716 error = do_get_acl(idmap, d, kname, ctx->kvalue, ctx->size);
717 else
718 error = vfs_getxattr(idmap, d, kname, 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
731 static ssize_t
getxattr(struct mnt_idmap * idmap,struct dentry * d,const char __user * name,void __user * value,size_t size)732 getxattr(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
path_getxattr(const char __user * pathname,const char __user * name,void __user * value,size_t size,unsigned int lookup_flags)757 static 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;
763 retry:
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
SYSCALL_DEFINE4(getxattr,const char __user *,pathname,const char __user *,name,void __user *,value,size_t,size)776 SYSCALL_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
SYSCALL_DEFINE4(lgetxattr,const char __user *,pathname,const char __user *,name,void __user *,value,size_t,size)782 SYSCALL_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
SYSCALL_DEFINE4(fgetxattr,int,fd,const char __user *,name,void __user *,value,size_t,size)788 SYSCALL_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 */
806 static ssize_t
listxattr(struct dentry * d,char __user * list,size_t size)807 listxattr(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
path_listxattr(const char __user * pathname,char __user * list,size_t size,unsigned int lookup_flags)835 static 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;
840 retry:
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
SYSCALL_DEFINE3(listxattr,const char __user *,pathname,char __user *,list,size_t,size)853 SYSCALL_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
SYSCALL_DEFINE3(llistxattr,const char __user *,pathname,char __user *,list,size_t,size)859 SYSCALL_DEFINE3(llistxattr, const char __user *, pathname, char __user *, list,
860 size_t, size)
861 {
862 return path_listxattr(pathname, list, size, 0);
863 }
864
SYSCALL_DEFINE3(flistxattr,int,fd,char __user *,list,size_t,size)865 SYSCALL_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 */
881 static long
removexattr(struct mnt_idmap * idmap,struct dentry * d,const char __user * name)882 removexattr(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(idmap, d, kname);
896
897 return vfs_removexattr(idmap, d, kname);
898 }
899
path_removexattr(const char __user * pathname,const char __user * name,unsigned int lookup_flags)900 static int path_removexattr(const char __user *pathname,
901 const char __user *name, unsigned int lookup_flags)
902 {
903 struct path path;
904 int error;
905 retry:
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
SYSCALL_DEFINE2(removexattr,const char __user *,pathname,const char __user *,name)922 SYSCALL_DEFINE2(removexattr, const char __user *, pathname,
923 const char __user *, name)
924 {
925 return path_removexattr(pathname, name, LOOKUP_FOLLOW);
926 }
927
SYSCALL_DEFINE2(lremovexattr,const char __user *,pathname,const char __user *,name)928 SYSCALL_DEFINE2(lremovexattr, const char __user *, pathname,
929 const char __user *, name)
930 {
931 return path_removexattr(pathname, name, 0);
932 }
933
SYSCALL_DEFINE2(fremovexattr,int,fd,const char __user *,name)934 SYSCALL_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 */
956 ssize_t
generic_listxattr(struct dentry * dentry,char * buffer,size_t buffer_size)957 generic_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 }
988 EXPORT_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 */
xattr_full_name(const struct xattr_handler * handler,const char * name)1005 const 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 }
1012 EXPORT_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 */
free_simple_xattr(struct simple_xattr * xattr)1020 static 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 */
simple_xattr_alloc(const void * value,size_t size)1038 struct 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 */
rbtree_simple_xattr_cmp(const void * key,const struct rb_node * node)1067 static 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 */
rbtree_simple_xattr_node_cmp(struct rb_node * new_node,const struct rb_node * node)1086 static 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 */
simple_xattr_get(struct simple_xattrs * xattrs,const char * name,void * buffer,size_t size)1109 int 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 */
simple_xattr_set(struct simple_xattrs * xattrs,const char * name,const void * value,size_t size,int flags,ssize_t * removed_size)1158 int 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
1233 out_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
xattr_is_trusted(const char * name)1243 static bool xattr_is_trusted(const char *name)
1244 {
1245 return !strncmp(name, XATTR_TRUSTED_PREFIX, XATTR_TRUSTED_PREFIX_LEN);
1246 }
1247
xattr_list_one(char ** buffer,ssize_t * remaining_size,const char * name)1248 static 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 */
simple_xattr_list(struct inode * inode,struct simple_xattrs * xattrs,char * buffer,size_t size)1281 ssize_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 */
rbtree_simple_xattr_less(struct rb_node * new_node,const struct rb_node * node)1334 static 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 */
simple_xattr_add(struct simple_xattrs * xattrs,struct simple_xattr * new_xattr)1349 void 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 */
simple_xattrs_init(struct simple_xattrs * xattrs)1363 void 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 */
simple_xattrs_free(struct simple_xattrs * xattrs)1376 void 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 }
1392