1 /*- 2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD 3 * 4 * Copyright (c) 1999-2001 Robert N. M. Watson 5 * All rights reserved. 6 * 7 * This software was developed by Robert Watson for the TrustedBSD Project. 8 * 9 * Redistribution and use in source and binary forms, with or without 10 * modification, are permitted provided that the following conditions 11 * are met: 12 * 1. Redistributions of source code must retain the above copyright 13 * notice, this list of conditions and the following disclaimer. 14 * 2. Redistributions in binary form must reproduce the above copyright 15 * notice, this list of conditions and the following disclaimer in the 16 * documentation and/or other materials provided with the distribution. 17 * 18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 19 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 22 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28 * SUCH DAMAGE. 29 * 30 * $FreeBSD$ 31 */ 32 /* 33 * Developed by the TrustedBSD Project. 34 * Support for extended filesystem attributes. 35 */ 36 37 #ifndef _SYS_EXTATTR_H_ 38 #define _SYS_EXTATTR_H_ 39 40 /* 41 * Defined name spaces for extended attributes. Numeric constants are passed 42 * via system calls, but a user-friendly string is also defined. 43 */ 44 #define EXTATTR_NAMESPACE_EMPTY 0x00000000 45 #define EXTATTR_NAMESPACE_EMPTY_STRING "empty" 46 #define EXTATTR_NAMESPACE_USER 0x00000001 47 #define EXTATTR_NAMESPACE_USER_STRING "user" 48 #define EXTATTR_NAMESPACE_SYSTEM 0x00000002 49 #define EXTATTR_NAMESPACE_SYSTEM_STRING "system" 50 51 /* 52 * The following macro is designed to initialize an array that maps 53 * extended-attribute namespace values to their names, e.g.: 54 * 55 * char *extattr_namespace_names[] = EXTATTR_NAMESPACE_NAMES; 56 */ 57 #define EXTATTR_NAMESPACE_NAMES { \ 58 EXTATTR_NAMESPACE_EMPTY_STRING, \ 59 EXTATTR_NAMESPACE_USER_STRING, \ 60 EXTATTR_NAMESPACE_SYSTEM_STRING } 61 62 #define EXTATTR_MAXNAMELEN NAME_MAX 63 64 #ifdef _KERNEL 65 #include <sys/types.h> 66 67 struct thread; 68 struct ucred; 69 struct vnode; 70 int extattr_check_cred(struct vnode *vp, int attrnamespace, 71 struct ucred *cred, struct thread *td, accmode_t accmode); 72 73 #else 74 #include <sys/cdefs.h> 75 76 struct iovec; 77 78 __BEGIN_DECLS 79 int extattrctl(const char *_path, int _cmd, const char *_filename, 80 int _attrnamespace, const char *_attrname); 81 int extattr_delete_fd(int _fd, int _attrnamespace, const char *_attrname); 82 int extattr_delete_file(const char *_path, int _attrnamespace, 83 const char *_attrname); 84 int extattr_delete_link(const char *_path, int _attrnamespace, 85 const char *_attrname); 86 ssize_t extattr_get_fd(int _fd, int _attrnamespace, const char *_attrname, 87 void *_data, size_t _nbytes); 88 ssize_t extattr_get_file(const char *_path, int _attrnamespace, 89 const char *_attrname, void *_data, size_t _nbytes); 90 ssize_t extattr_get_link(const char *_path, int _attrnamespace, 91 const char *_attrname, void *_data, size_t _nbytes); 92 ssize_t extattr_list_fd(int _fd, int _attrnamespace, void *_data, 93 size_t _nbytes); 94 ssize_t extattr_list_file(const char *_path, int _attrnamespace, void *_data, 95 size_t _nbytes); 96 ssize_t extattr_list_link(const char *_path, int _attrnamespace, void *_data, 97 size_t _nbytes); 98 ssize_t extattr_set_fd(int _fd, int _attrnamespace, const char *_attrname, 99 const void *_data, size_t _nbytes); 100 ssize_t extattr_set_file(const char *_path, int _attrnamespace, 101 const char *_attrname, const void *_data, size_t _nbytes); 102 ssize_t extattr_set_link(const char *_path, int _attrnamespace, 103 const char *_attrname, const void *_data, size_t _nbytes); 104 __END_DECLS 105 106 #endif /* !_KERNEL */ 107 #endif /* !_SYS_EXTATTR_H_ */ 108