makefs.h revision 1.26 1 /* $NetBSD: makefs.h,v 1.26 2012/04/19 17:09:53 christos Exp $ */
2
3 /*
4 * Copyright (c) 2001 Wasabi Systems, Inc.
5 * All rights reserved.
6 *
7 * Written by Luke Mewburn for Wasabi Systems, Inc.
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 * 3. All advertising materials mentioning features or use of this software
18 * must display the following acknowledgement:
19 * This product includes software developed for the NetBSD Project by
20 * Wasabi Systems, Inc.
21 * 4. The name of Wasabi Systems, Inc. may not be used to endorse
22 * or promote products derived from this software without specific prior
23 * written permission.
24 *
25 * THIS SOFTWARE IS PROVIDED BY WASABI SYSTEMS, INC. ``AS IS'' AND
26 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL WASABI SYSTEMS, INC
29 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35 * POSSIBILITY OF SUCH DAMAGE.
36 */
37
38 #ifndef _MAKEFS_H
39 #define _MAKEFS_H
40
41 #if HAVE_NBTOOL_CONFIG_H
42 #include "nbtool_config.h"
43 #else
44 #define HAVE_STRUCT_STAT_ST_FLAGS 1
45 #define HAVE_STRUCT_STAT_ST_GEN 1
46 #define HAVE_STRUCT_STAT_ST_MTIMENSEC 1
47 #define HAVE_STRUCT_STATVFS_F_IOSIZE 1
48 #define HAVE_STRUCT_STAT_BIRTHTIME 1
49 #define HAVE_FSTATVFS 1
50 #endif
51
52 #include <sys/stat.h>
53 #include <err.h>
54
55 /*
56 * fsnode -
57 * a component of the tree; contains a filename, a pointer to
58 * fsinode, optional symlink name, and tree pointers
59 *
60 * fsinode -
61 * equivalent to an inode, containing target file system inode number,
62 * refcount (nlink), and stat buffer
63 *
64 * A tree of fsnodes looks like this:
65 *
66 * name "." "bin" "netbsd"
67 * type S_IFDIR S_IFDIR S_IFREG
68 * next > > NULL
69 * parent NULL NULL NULL
70 * child NULL v
71 *
72 * name "." "ls"
73 * type S_IFDIR S_IFREG
74 * next > NULL
75 * parent ^ ^ (to "bin")
76 * child NULL NULL
77 *
78 * Notes:
79 * - first always points to first entry, at current level, which
80 * must be "." when the tree has been built; during build it may
81 * not be if "." hasn't yet been found by readdir(2).
82 */
83
84 enum fi_flags {
85 FI_SIZED = 1<<0, /* inode sized */
86 FI_ALLOCATED = 1<<1, /* fsinode->ino allocated */
87 FI_WRITTEN = 1<<2, /* inode written */
88 };
89
90 typedef struct {
91 uint32_t ino; /* inode number used on target fs */
92 uint32_t nlink; /* number of links to this entry */
93 enum fi_flags flags; /* flags used by fs specific code */
94 struct stat st; /* stat entry */
95 } fsinode;
96
97 typedef struct _fsnode {
98 struct _fsnode *parent; /* parent (NULL if root) */
99 struct _fsnode *child; /* child (if type == S_IFDIR) */
100 struct _fsnode *next; /* next */
101 struct _fsnode *first; /* first node of current level (".") */
102 uint32_t type; /* type of entry */
103 fsinode *inode; /* actual inode data */
104 char *symlink; /* symlink target */
105 const char *root; /* root path */
106 char *path; /* directory name */
107 char *name; /* file name */
108 int flags; /* misc flags */
109 } fsnode;
110
111 #define FSNODE_F_HASSPEC 0x01 /* fsnode has a spec entry */
112
113 /*
114 * fsinfo_t - contains various settings and parameters pertaining to
115 * the image, including current settings, global options, and fs
116 * specific options
117 */
118 typedef struct {
119 /* current settings */
120 off_t size; /* total size */
121 off_t inodes; /* number of inodes */
122 uint32_t curinode; /* current inode */
123
124 /* image settings */
125 int fd; /* file descriptor of image */
126 void *superblock; /* superblock */
127 int onlyspec; /* only add entries in specfile */
128
129
130 /* global options */
131 off_t minsize; /* minimum size image should be */
132 off_t maxsize; /* maximum size image can be */
133 off_t freefiles; /* free file entries to leave */
134 int freefilepc; /* free file % */
135 off_t freeblocks; /* free blocks to leave */
136 int freeblockpc; /* free block % */
137 int needswap; /* non-zero if byte swapping needed */
138 int sectorsize; /* sector size */
139
140 void *fs_specific; /* File system specific additions. */
141 } fsinfo_t;
142
143
144 /*
145 * option_t - contains option name, description, pointer to location to store
146 * result, and range checks for the result. Used to simplify fs specific
147 * option setting
148 */
149 typedef struct {
150 const char *name; /* option name */
151 int *value; /* where to stuff the value */
152 int minimum; /* minimum for value */
153 int maximum; /* maximum for value */
154 const char *desc; /* option description */
155 } option_t;
156
157
158 void apply_specfile(const char *, const char *, fsnode *, int);
159 void dump_fsnodes(fsnode *);
160 const char * inode_type(mode_t);
161 int set_option(const option_t *, const char *, const char *);
162 fsnode * walk_dir(const char *, const char *, fsnode *, fsnode *);
163 void free_fsnodes(fsnode *);
164
165 void ffs_prep_opts(fsinfo_t *);
166 int ffs_parse_opts(const char *, fsinfo_t *);
167 void ffs_cleanup_opts(fsinfo_t *);
168 void ffs_makefs(const char *, const char *, fsnode *, fsinfo_t *);
169
170 void cd9660_prep_opts(fsinfo_t *);
171 int cd9660_parse_opts(const char *, fsinfo_t *);
172 void cd9660_cleanup_opts(fsinfo_t *);
173 void cd9660_makefs(const char *, const char *, fsnode *, fsinfo_t *);
174
175 void chfs_prep_opts(fsinfo_t *);
176 int chfs_parse_opts(const char *, fsinfo_t *);
177 void chfs_cleanup_opts(fsinfo_t *);
178 void chfs_makefs(const char *, const char *, fsnode *, fsinfo_t *);
179
180 void v7fs_prep_opts(fsinfo_t *);
181 int v7fs_parse_opts(const char *, fsinfo_t *);
182 void v7fs_cleanup_opts(fsinfo_t *);
183 void v7fs_makefs(const char *, const char *, fsnode *, fsinfo_t *);
184
185 extern u_int debug;
186 extern struct timespec start_time;
187
188 /*
189 * If -x is specified, we want to exclude nodes which do not appear
190 * in the spec file.
191 */
192 #define FSNODE_EXCLUDE_P(opts, fsnode) \
193 ((opts)->onlyspec != 0 && ((fsnode)->flags & FSNODE_F_HASSPEC) == 0)
194
195 #define DEBUG_TIME 0x00000001
196 /* debug bits 1..3 unused at this time */
197 #define DEBUG_WALK_DIR 0x00000010
198 #define DEBUG_WALK_DIR_NODE 0x00000020
199 #define DEBUG_WALK_DIR_LINKCHECK 0x00000040
200 #define DEBUG_DUMP_FSNODES 0x00000080
201 #define DEBUG_DUMP_FSNODES_VERBOSE 0x00000100
202 #define DEBUG_FS_PARSE_OPTS 0x00000200
203 #define DEBUG_FS_MAKEFS 0x00000400
204 #define DEBUG_FS_VALIDATE 0x00000800
205 #define DEBUG_FS_CREATE_IMAGE 0x00001000
206 #define DEBUG_FS_SIZE_DIR 0x00002000
207 #define DEBUG_FS_SIZE_DIR_NODE 0x00004000
208 #define DEBUG_FS_SIZE_DIR_ADD_DIRENT 0x00008000
209 #define DEBUG_FS_POPULATE 0x00010000
210 #define DEBUG_FS_POPULATE_DIRBUF 0x00020000
211 #define DEBUG_FS_POPULATE_NODE 0x00040000
212 #define DEBUG_FS_WRITE_FILE 0x00080000
213 #define DEBUG_FS_WRITE_FILE_BLOCK 0x00100000
214 #define DEBUG_FS_MAKE_DIRBUF 0x00200000
215 #define DEBUG_FS_WRITE_INODE 0x00400000
216 #define DEBUG_BUF_BREAD 0x00800000
217 #define DEBUG_BUF_BWRITE 0x01000000
218 #define DEBUG_BUF_GETBLK 0x02000000
219 #define DEBUG_APPLY_SPECFILE 0x04000000
220 #define DEBUG_APPLY_SPECENTRY 0x08000000
221 #define DEBUG_APPLY_SPECONLY 0x10000000
222
223
224 #define TIMER_START(x) \
225 if (debug & DEBUG_TIME) \
226 gettimeofday(&(x), NULL)
227
228 #define TIMER_RESULTS(x,d) \
229 if (debug & DEBUG_TIME) { \
230 struct timeval end, td; \
231 gettimeofday(&end, NULL); \
232 timersub(&end, &(x), &td); \
233 printf("%s took %lld.%06ld seconds\n", \
234 (d), (long long)td.tv_sec, \
235 (long)td.tv_usec); \
236 }
237
238
239 #ifndef DEFAULT_FSTYPE
240 #define DEFAULT_FSTYPE "ffs"
241 #endif
242
243
244 /*
245 * ffs specific settings
246 * ---------------------
247 */
248
249 #define FFS_EI /* for opposite endian support in ffs headers */
250
251
252 #endif /* _MAKEFS_H */
253