1 /* $NetBSD: makefs.h,v 1.20 2008/12/28 21:51:46 christos Exp $ */
4 * SPDX-License-Identifier: BSD-4-Clause
6 * Copyright (c) 2001 Wasabi Systems, Inc.
9 * Written by Luke Mewburn for Wasabi Systems, Inc.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
19 * 3. All advertising materials mentioning features or use of this software
20 * must display the following acknowledgement:
21 * This product includes software developed for the NetBSD Project by
22 * Wasabi Systems, Inc.
23 * 4. The name of Wasabi Systems, Inc. may not be used to endorse
24 * or promote products derived from this software without specific prior
27 * THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND
28 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
29 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
30 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL WASABI SYSTEMS, INC
31 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
32 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
33 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
34 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
35 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
36 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
37 * POSSIBILITY OF SUCH DAMAGE.
50 * a component of the tree; contains a filename, a pointer to
51 * fsinode, optional symlink name, and tree pointers
54 * equivalent to an inode, containing target file system inode number,
55 * refcount (nlink), and stat buffer
57 * A tree of fsnodes looks like this:
59 * name "." "bin" "netbsd"
60 * type S_IFDIR S_IFDIR S_IFREG
62 * parent NULL NULL NULL
66 * type S_IFDIR S_IFREG
68 * parent ^ ^ (to "bin")
72 * - first always points to first entry, at current level, which
73 * must be "." when the tree has been built; during build it may
74 * not be if "." hasn't yet been found by readdir(2).
78 FI_SIZED = 1<<0, /* inode sized */
79 FI_ALLOCATED = 1<<1, /* fsinode->ino allocated */
80 FI_WRITTEN = 1<<2, /* inode written */
81 FI_ROOT = 1<<3, /* root of a ZFS dataset */
85 uint32_t ino; /* inode number used on target fs */
86 uint32_t nlink; /* number of links to this entry */
87 enum fi_flags flags; /* flags used by fs specific code */
88 void *param; /* for use by individual fs impls */
89 struct stat st; /* stat entry */
92 typedef struct _fsnode {
93 struct _fsnode *parent; /* parent (NULL if root) */
94 struct _fsnode *child; /* child (if type == S_IFDIR) */
95 struct _fsnode *next; /* next */
96 struct _fsnode *first; /* first node of current level (".") */
97 uint32_t type; /* type of entry */
98 fsinode *inode; /* actual inode data */
99 char *symlink; /* symlink target */
100 char *contents; /* file to provide contents */
101 const char *root; /* root path */
102 char *path; /* directory name */
103 char *name; /* file name */
104 int flags; /* misc flags */
107 #define FSNODE_F_HASSPEC 0x01 /* fsnode has a spec entry */
108 #define FSNODE_F_OPTIONAL 0x02 /* fsnode is optional */
111 * option_t - contains option name, description, pointer to location to store
112 * result, and range checks for the result. Used to simplify fs specific
127 char letter; /* option letter NUL for none */
128 const char *name; /* option name */
129 void *value; /* where to stuff the value */
130 opttype_t type; /* type of entry */
131 long long minimum; /* minimum for value */
132 long long maximum; /* maximum for value */
133 const char *desc; /* option description */
137 * fsinfo_t - contains various settings and parameters pertaining to
138 * the image, including current settings, global options, and fs
141 typedef struct makefs_fsinfo {
142 /* current settings */
143 off_t size; /* total size */
144 off_t inodes; /* number of inodes */
145 uint32_t curinode; /* current inode */
148 int fd; /* file descriptor of image */
149 void *superblock; /* superblock */
150 int onlyspec; /* only add entries in specfile */
154 off_t minsize; /* minimum size image should be */
155 off_t maxsize; /* maximum size image can be */
156 off_t freefiles; /* free file entries to leave */
157 off_t freeblocks; /* free blocks to leave */
158 off_t offset; /* offset from start of file */
159 off_t roundup; /* round image size up to this value */
160 int freefilepc; /* free file % */
161 int freeblockpc; /* free block % */
162 int needswap; /* non-zero if byte swapping needed */
163 int sectorsize; /* sector size */
164 int sparse; /* sparse image, don't fill it with zeros */
166 void *fs_specific; /* File system specific additions. */
167 option_t *fs_options; /* File system specific options */
171 void apply_specfile(const char *, const char *, fsnode *, int);
172 void dump_fsnodes(fsnode *);
173 const char * inode_type(mode_t);
174 fsnode * read_mtree(const char *, fsnode *);
175 int set_option(const option_t *, const char *, char *, size_t);
176 int set_option_var(const option_t *, const char *, const char *,
178 fsnode * walk_dir(const char *, const char *, fsnode *, fsnode *);
179 void free_fsnodes(fsnode *);
180 option_t * copy_opts(const option_t *);
182 #define DECLARE_FUN(fs) \
183 void fs ## _prep_opts(fsinfo_t *); \
184 int fs ## _parse_opts(const char *, fsinfo_t *); \
185 void fs ## _cleanup_opts(fsinfo_t *); \
186 void fs ## _makefs(const char *, const char *, fsnode *, fsinfo_t *)
197 extern struct timespec start_time;
198 extern struct stat stampst;
201 * If -x is specified, we want to exclude nodes which do not appear
204 #define FSNODE_EXCLUDE_P(opts, fsnode) \
205 ((opts)->onlyspec != 0 && ((fsnode)->flags & FSNODE_F_HASSPEC) == 0)
207 #define DEBUG_TIME 0x00000001
208 /* debug bits 1..3 unused at this time */
209 #define DEBUG_WALK_DIR 0x00000010
210 #define DEBUG_WALK_DIR_NODE 0x00000020
211 #define DEBUG_WALK_DIR_LINKCHECK 0x00000040
212 #define DEBUG_DUMP_FSNODES 0x00000080
213 #define DEBUG_DUMP_FSNODES_VERBOSE 0x00000100
214 #define DEBUG_FS_PARSE_OPTS 0x00000200
215 #define DEBUG_FS_MAKEFS 0x00000400
216 #define DEBUG_FS_VALIDATE 0x00000800
217 #define DEBUG_FS_CREATE_IMAGE 0x00001000
218 #define DEBUG_FS_SIZE_DIR 0x00002000
219 #define DEBUG_FS_SIZE_DIR_NODE 0x00004000
220 #define DEBUG_FS_SIZE_DIR_ADD_DIRENT 0x00008000
221 #define DEBUG_FS_POPULATE 0x00010000
222 #define DEBUG_FS_POPULATE_DIRBUF 0x00020000
223 #define DEBUG_FS_POPULATE_NODE 0x00040000
224 #define DEBUG_FS_WRITE_FILE 0x00080000
225 #define DEBUG_FS_WRITE_FILE_BLOCK 0x00100000
226 #define DEBUG_FS_MAKE_DIRBUF 0x00200000
227 #define DEBUG_FS_WRITE_INODE 0x00400000
228 #define DEBUG_BUF_BREAD 0x00800000
229 #define DEBUG_BUF_BWRITE 0x01000000
230 #define DEBUG_BUF_GETBLK 0x02000000
231 #define DEBUG_APPLY_SPECFILE 0x04000000
232 #define DEBUG_APPLY_SPECENTRY 0x08000000
233 #define DEBUG_APPLY_SPECONLY 0x10000000
234 #define DEBUG_MSDOSFS 0x20000000
237 #define TIMER_START(x) \
238 if (debug & DEBUG_TIME) \
239 gettimeofday(&(x), NULL)
241 #define TIMER_RESULTS(x,d) \
242 if (debug & DEBUG_TIME) { \
243 struct timeval end, td; \
244 gettimeofday(&end, NULL); \
245 timersub(&end, &(x), &td); \
246 printf("%s took %lld.%06ld seconds\n", \
247 (d), (long long)td.tv_sec, \
252 #ifndef DEFAULT_FSTYPE
253 #define DEFAULT_FSTYPE "ffs"
258 * ffs specific settings
259 * ---------------------
262 #define FFS_EI /* for opposite endian support in ffs headers */
265 * Write-arounds/compat shims for endian-agnostic support.
266 * These belong in the kernel if/when it's possible to mount
267 * filesystems w/ either byte order.
271 * File system internal flags, also in fs_flags.
272 * (Pick highest number to avoid conflicts with others)
274 #define FS_SWAPPED 0x80000000 /* file system is endian swapped */
275 #define FS_INTERNAL 0x80000000 /* mask for internal flags */
279 #define DINODE1_SIZE (sizeof(struct ufs1_dinode))
280 #define DINODE2_SIZE (sizeof(struct ufs2_dinode))
282 #define UFS1_MAXSYMLINKLEN ((UFS_NDADDR + UFS_NIADDR) * sizeof(ufs1_daddr_t))
283 #define UFS2_MAXSYMLINKLEN ((UFS_NDADDR + UFS_NIADDR) * sizeof(ufs2_daddr_t))
285 #if (BYTE_ORDER == LITTLE_ENDIAN)
286 #define DIRSIZ_SWAP(oldfmt, dp, needswap) \
287 (((oldfmt) && !(needswap)) ? \
288 DIRECTSIZ((dp)->d_type) : DIRECTSIZ((dp)->d_namlen))
290 #define DIRSIZ_SWAP(oldfmt, dp, needswap) \
291 (((oldfmt) && (needswap)) ? \
292 DIRECTSIZ((dp)->d_type) : DIRECTSIZ((dp)->d_namlen))
295 #define cg_chkmagic_swap(cgp, ns) \
296 (ufs_rw32((cgp)->cg_magic, (ns)) == CG_MAGIC)
297 #define cg_inosused_swap(cgp, ns) \
298 ((u_int8_t *)((u_int8_t *)(cgp) + ufs_rw32((cgp)->cg_iusedoff, (ns))))
299 #define cg_blksfree_swap(cgp, ns) \
300 ((u_int8_t *)((u_int8_t *)(cgp) + ufs_rw32((cgp)->cg_freeoff, (ns))))
301 #define cg_clustersfree_swap(cgp, ns) \
302 ((u_int8_t *)((u_int8_t *)(cgp) + ufs_rw32((cgp)->cg_clusteroff, (ns))))
303 #define cg_clustersum_swap(cgp, ns) \
304 ((int32_t *)((uintptr_t)(cgp) + ufs_rw32((cgp)->cg_clustersumoff, ns)))
307 void ffs_fragacct_swap(struct fs *, int, uint32_t [], int, int);
309 fsinode *link_check(fsinode *);
311 #endif /* _MAKEFS_H */