.. | .. |
---|
1 | | -// SPDX-License-Identifier: GPL-2.0 |
---|
| 1 | +/* SPDX-License-Identifier: GPL-2.0 */ |
---|
2 | 2 | /* |
---|
3 | 3 | * Copyright (c) 2000,2002-2003,2005 Silicon Graphics, Inc. |
---|
4 | 4 | * All Rights Reserved. |
---|
.. | .. |
---|
21 | 21 | * as possible so as to fit into the literal area of the inode. |
---|
22 | 22 | */ |
---|
23 | 23 | |
---|
24 | | -/*======================================================================== |
---|
25 | | - * External interfaces |
---|
26 | | - *========================================================================*/ |
---|
27 | | - |
---|
28 | | - |
---|
29 | | -#define ATTR_DONTFOLLOW 0x0001 /* -- unused, from IRIX -- */ |
---|
30 | | -#define ATTR_ROOT 0x0002 /* use attrs in root (trusted) namespace */ |
---|
31 | | -#define ATTR_TRUST 0x0004 /* -- unused, from IRIX -- */ |
---|
32 | | -#define ATTR_SECURE 0x0008 /* use attrs in security namespace */ |
---|
33 | | -#define ATTR_CREATE 0x0010 /* pure create: fail if attr already exists */ |
---|
34 | | -#define ATTR_REPLACE 0x0020 /* pure set: fail if attr does not exist */ |
---|
35 | | - |
---|
36 | | -#define ATTR_KERNOTIME 0x1000 /* [kernel] don't update inode timestamps */ |
---|
37 | | -#define ATTR_KERNOVAL 0x2000 /* [kernel] get attr size only, not value */ |
---|
38 | | - |
---|
39 | | -#define ATTR_INCOMPLETE 0x4000 /* [kernel] return INCOMPLETE attr keys */ |
---|
40 | | - |
---|
41 | | -#define XFS_ATTR_FLAGS \ |
---|
42 | | - { ATTR_DONTFOLLOW, "DONTFOLLOW" }, \ |
---|
43 | | - { ATTR_ROOT, "ROOT" }, \ |
---|
44 | | - { ATTR_TRUST, "TRUST" }, \ |
---|
45 | | - { ATTR_SECURE, "SECURE" }, \ |
---|
46 | | - { ATTR_CREATE, "CREATE" }, \ |
---|
47 | | - { ATTR_REPLACE, "REPLACE" }, \ |
---|
48 | | - { ATTR_KERNOTIME, "KERNOTIME" }, \ |
---|
49 | | - { ATTR_KERNOVAL, "KERNOVAL" }, \ |
---|
50 | | - { ATTR_INCOMPLETE, "INCOMPLETE" } |
---|
51 | | - |
---|
52 | 24 | /* |
---|
53 | 25 | * The maximum size (into the kernel or returned from the kernel) of an |
---|
54 | 26 | * attribute value or the buffer used for an attr_list() call. Larger |
---|
.. | .. |
---|
57 | 29 | #define ATTR_MAX_VALUELEN (64*1024) /* max length of a value */ |
---|
58 | 30 | |
---|
59 | 31 | /* |
---|
60 | | - * Define how lists of attribute names are returned to the user from |
---|
61 | | - * the attr_list() call. A large, 32bit aligned, buffer is passed in |
---|
62 | | - * along with its size. We put an array of offsets at the top that each |
---|
63 | | - * reference an attrlist_ent_t and pack the attrlist_ent_t's at the bottom. |
---|
64 | | - */ |
---|
65 | | -typedef struct attrlist { |
---|
66 | | - __s32 al_count; /* number of entries in attrlist */ |
---|
67 | | - __s32 al_more; /* T/F: more attrs (do call again) */ |
---|
68 | | - __s32 al_offset[1]; /* byte offsets of attrs [var-sized] */ |
---|
69 | | -} attrlist_t; |
---|
70 | | - |
---|
71 | | -/* |
---|
72 | | - * Show the interesting info about one attribute. This is what the |
---|
73 | | - * al_offset[i] entry points to. |
---|
74 | | - */ |
---|
75 | | -typedef struct attrlist_ent { /* data from attr_list() */ |
---|
76 | | - __u32 a_valuelen; /* number bytes in value of attr */ |
---|
77 | | - char a_name[1]; /* attr name (NULL terminated) */ |
---|
78 | | -} attrlist_ent_t; |
---|
79 | | - |
---|
80 | | -/* |
---|
81 | | - * Given a pointer to the (char*) buffer containing the attr_list() result, |
---|
82 | | - * and an index, return a pointer to the indicated attribute in the buffer. |
---|
83 | | - */ |
---|
84 | | -#define ATTR_ENTRY(buffer, index) \ |
---|
85 | | - ((attrlist_ent_t *) \ |
---|
86 | | - &((char *)buffer)[ ((attrlist_t *)(buffer))->al_offset[index] ]) |
---|
87 | | - |
---|
88 | | -/* |
---|
89 | 32 | * Kernel-internal version of the attrlist cursor. |
---|
90 | 33 | */ |
---|
91 | | -typedef struct attrlist_cursor_kern { |
---|
| 34 | +struct xfs_attrlist_cursor_kern { |
---|
92 | 35 | __u32 hashval; /* hash value of next entry to add */ |
---|
93 | 36 | __u32 blkno; /* block containing entry (suggestion) */ |
---|
94 | 37 | __u32 offset; /* offset in list of equal-hashvals */ |
---|
95 | 38 | __u16 pad1; /* padding to match user-level */ |
---|
96 | 39 | __u8 pad2; /* padding to match user-level */ |
---|
97 | 40 | __u8 initted; /* T/F: cursor has been initialized */ |
---|
98 | | -} attrlist_cursor_kern_t; |
---|
| 41 | +}; |
---|
99 | 42 | |
---|
100 | 43 | |
---|
101 | 44 | /*======================================================================== |
---|
.. | .. |
---|
107 | 50 | typedef void (*put_listent_func_t)(struct xfs_attr_list_context *, int, |
---|
108 | 51 | unsigned char *, int, int); |
---|
109 | 52 | |
---|
110 | | -typedef struct xfs_attr_list_context { |
---|
111 | | - struct xfs_trans *tp; |
---|
112 | | - struct xfs_inode *dp; /* inode */ |
---|
113 | | - struct attrlist_cursor_kern *cursor; /* position in list */ |
---|
114 | | - char *alist; /* output buffer */ |
---|
115 | | - int seen_enough; /* T/F: seen enough of list? */ |
---|
116 | | - ssize_t count; /* num used entries */ |
---|
117 | | - int dupcnt; /* count dup hashvals seen */ |
---|
118 | | - int bufsize; /* total buffer size */ |
---|
119 | | - int firstu; /* first used byte in buffer */ |
---|
120 | | - int flags; /* from VOP call */ |
---|
121 | | - int resynch; /* T/F: resynch with cursor */ |
---|
122 | | - put_listent_func_t put_listent; /* list output fmt function */ |
---|
123 | | - int index; /* index into output buffer */ |
---|
124 | | -} xfs_attr_list_context_t; |
---|
| 53 | +struct xfs_attr_list_context { |
---|
| 54 | + struct xfs_trans *tp; |
---|
| 55 | + struct xfs_inode *dp; /* inode */ |
---|
| 56 | + struct xfs_attrlist_cursor_kern cursor; /* position in list */ |
---|
| 57 | + void *buffer; /* output buffer */ |
---|
| 58 | + |
---|
| 59 | + /* |
---|
| 60 | + * Abort attribute list iteration if non-zero. Can be used to pass |
---|
| 61 | + * error values to the xfs_attr_list caller. |
---|
| 62 | + */ |
---|
| 63 | + int seen_enough; |
---|
| 64 | + bool allow_incomplete; |
---|
| 65 | + |
---|
| 66 | + ssize_t count; /* num used entries */ |
---|
| 67 | + int dupcnt; /* count dup hashvals seen */ |
---|
| 68 | + int bufsize; /* total buffer size */ |
---|
| 69 | + int firstu; /* first used byte in buffer */ |
---|
| 70 | + unsigned int attr_filter; /* XFS_ATTR_{ROOT,SECURE} */ |
---|
| 71 | + int resynch; /* T/F: resynch with cursor */ |
---|
| 72 | + put_listent_func_t put_listent; /* list output fmt function */ |
---|
| 73 | + int index; /* index into output buffer */ |
---|
| 74 | +}; |
---|
125 | 75 | |
---|
126 | 76 | |
---|
127 | 77 | /*======================================================================== |
---|
.. | .. |
---|
132 | 82 | * Overall external interface routines. |
---|
133 | 83 | */ |
---|
134 | 84 | int xfs_attr_inactive(struct xfs_inode *dp); |
---|
135 | | -int xfs_attr_list_int_ilocked(struct xfs_attr_list_context *); |
---|
136 | | -int xfs_attr_list_int(struct xfs_attr_list_context *); |
---|
| 85 | +int xfs_attr_list_ilocked(struct xfs_attr_list_context *); |
---|
| 86 | +int xfs_attr_list(struct xfs_attr_list_context *); |
---|
137 | 87 | int xfs_inode_hasattr(struct xfs_inode *ip); |
---|
138 | | -int xfs_attr_get_ilocked(struct xfs_inode *ip, struct xfs_da_args *args); |
---|
139 | | -int xfs_attr_get(struct xfs_inode *ip, const unsigned char *name, |
---|
140 | | - unsigned char *value, int *valuelenp, int flags); |
---|
141 | | -int xfs_attr_set(struct xfs_inode *dp, const unsigned char *name, |
---|
142 | | - unsigned char *value, int valuelen, int flags); |
---|
| 88 | +int xfs_attr_get_ilocked(struct xfs_da_args *args); |
---|
| 89 | +int xfs_attr_get(struct xfs_da_args *args); |
---|
| 90 | +int xfs_attr_set(struct xfs_da_args *args); |
---|
143 | 91 | int xfs_attr_set_args(struct xfs_da_args *args); |
---|
144 | | -int xfs_attr_remove(struct xfs_inode *dp, const unsigned char *name, int flags); |
---|
| 92 | +int xfs_has_attr(struct xfs_da_args *args); |
---|
145 | 93 | int xfs_attr_remove_args(struct xfs_da_args *args); |
---|
146 | | -int xfs_attr_list(struct xfs_inode *dp, char *buffer, int bufsize, |
---|
147 | | - int flags, struct attrlist_cursor_kern *cursor); |
---|
148 | | - |
---|
| 94 | +bool xfs_attr_namecheck(const void *name, size_t length); |
---|
149 | 95 | |
---|
150 | 96 | #endif /* __XFS_ATTR_H__ */ |
---|