1 /*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21 /*
22 * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
23 * Use is subject to license terms.
24 */
25 /*
26 * Copyright (c) 2013 RackTop Systems.
27 */
28 /*
29 * Copyright 2014 Joyent, Inc.
30 */
31
32 /*
33 * Declarations for the functions in libcmdutils.
34 */
35
36 #ifndef _LIBCMDUTILS_H
37 #define _LIBCMDUTILS_H
38
39 /*
40 * This is a private header file. Applications should not directly include
41 * this file.
42 */
43
44 #include <stdio.h>
45 #include <unistd.h>
46 #include <stdlib.h>
47 #include <errno.h>
48 #include <fcntl.h>
49 #include <limits.h>
50 #include <libintl.h>
51 #include <string.h>
52 #include <dirent.h>
53 #include <attr.h>
54 #include <sys/avl.h>
55 #include <sys/types.h>
56 #include <sys/stat.h>
57 #include <sys/mman.h>
58 #include <libnvpair.h>
59
60 #ifdef __cplusplus
61 extern "C" {
62 #endif
63
64 /* extended system attribute support */
65 #define _NOT_SATTR 0
66 #define _RO_SATTR 1
67 #define _RW_SATTR 2
68
69 #define MAXMAPSIZE (1024*1024*8) /* map at most 8MB */
70 #define SMALLFILESIZE (32*1024) /* don't use mmap on little file */
71 #define ISREG(A) (((A).st_mode & S_IFMT) == S_IFREG)
72
73 /* avltree */
74 #define OFFSETOF(s, m) ((size_t)(&(((s *)0)->m)))
75
76 /* Type used for a node containing a device id and inode number */
77 typedef struct tree_node {
78 dev_t node_dev;
79 ino_t node_ino;
80 avl_node_t avl_link;
81 } tree_node_t;
82
83
84 /* extended system attribute support */
85
86 /* Determine if a file is the name of an extended system attribute file */
87 extern int sysattr_type(char *);
88
89 /* Determine if the underlying file system supports system attributes */
90 extern int sysattr_support(char *, int);
91
92 /* Copies the content of the source file to the target file */
93 extern int writefile(int, int, char *, char *, char *, char *,
94 struct stat *, struct stat *);
95
96 /* Gets file descriptors of the source and target attribute files */
97 extern int get_attrdirs(int, int, char *, int *, int *);
98
99 /* Move extended attribute and extended system attribute */
100 extern int mv_xattrs(char *, char *, char *, int, int);
101
102 /* Returns non default extended system attribute list */
103 extern nvlist_t *sysattr_list(char *, int, char *);
104
105
106
107 /* avltree */
108
109 /*
110 * Used to compare two nodes. We are attempting to match the 1st
111 * argument (node) against the 2nd argument (a node which
112 * is already in the search tree).
113 */
114
115 extern int tnode_compare(const void *, const void *);
116
117 /*
118 * Used to add a single node (containing the input device id and
119 * inode number) to the specified search tree. The calling
120 * application must set the tree pointer to NULL before calling
121 * add_tnode() for the first time.
122 */
123 extern int add_tnode(avl_tree_t **, dev_t, ino_t);
124
125 /*
126 * Used to destroy a whole tree (all nodes) without rebalancing.
127 * The calling application is responsible for setting the tree
128 * pointer to NULL upon return.
129 */
130 extern void destroy_tree(avl_tree_t *);
131
132
133
134 /* user/group id helpers */
135
136 /*
137 * Used to get the next available user id in given range.
138 */
139 extern int findnextuid(uid_t, uid_t, uid_t *);
140
141 /*
142 * Used to get the next available group id in given range.
143 */
144 extern int findnextgid(gid_t, gid_t, gid_t *);
145
146
147
148 /* dynamic string utilities */
149
150 typedef struct custr custr_t;
151
152 /*
153 * Allocate and free a "custr_t" dynamic string object. Returns 0 on success
154 * and -1 otherwise.
155 */
156 extern int custr_alloc(custr_t **);
157 extern void custr_free(custr_t *);
158
159 /*
160 * Append a single character, or a NUL-terminated string of characters, to a
161 * dynamic string. Returns 0 on success and -1 otherwise. The dynamic string
162 * will be unmodified if the function returns -1.
163 */
164 extern int custr_appendc(custr_t *, char);
165 extern int custr_append(custr_t *, const char *);
166
167 /*
168 * Determine the length in bytes, not including the NUL terminator, of the
169 * dynamic string.
170 */
171 extern size_t custr_len(custr_t *);
172
173 /*
174 * Clear the contents of a dynamic string. Does not free the underlying
175 * memory.
176 */
177 extern void custr_reset(custr_t *);
178
179 /*
180 * Retrieve a const pointer to a NUL-terminated string version of the contents
181 * of the dynamic string. Storage for this string should not be freed, and
182 * the pointer will be invalidated by any mutations to the dynamic string.
183 */
184 extern const char *custr_cstr(custr_t *str);
185
186 #ifdef __cplusplus
187 }
188 #endif
189
190 #endif /* _LIBCMDUTILS_H */