1 /* $NetBSD: makefs.h,v 1.24 2012/01/28 02:35:46 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(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 v7fs_prep_opts(fsinfo_t *); 176 int v7fs_parse_opts(const char *, fsinfo_t *); 177 void v7fs_cleanup_opts(fsinfo_t *); 178 void v7fs_makefs(const char *, const char *, fsnode *, fsinfo_t *); 179 180 extern u_int debug; 181 extern struct timespec start_time; 182 183 /* 184 * If -x is specified, we want to exclude nodes which do not appear 185 * in the spec file. 186 */ 187 #define FSNODE_EXCLUDE_P(opts, fsnode) \ 188 ((opts)->onlyspec != 0 && ((fsnode)->flags & FSNODE_F_HASSPEC) == 0) 189 190 #define DEBUG_TIME 0x00000001 191 /* debug bits 1..3 unused at this time */ 192 #define DEBUG_WALK_DIR 0x00000010 193 #define DEBUG_WALK_DIR_NODE 0x00000020 194 #define DEBUG_WALK_DIR_LINKCHECK 0x00000040 195 #define DEBUG_DUMP_FSNODES 0x00000080 196 #define DEBUG_DUMP_FSNODES_VERBOSE 0x00000100 197 #define DEBUG_FS_PARSE_OPTS 0x00000200 198 #define DEBUG_FS_MAKEFS 0x00000400 199 #define DEBUG_FS_VALIDATE 0x00000800 200 #define DEBUG_FS_CREATE_IMAGE 0x00001000 201 #define DEBUG_FS_SIZE_DIR 0x00002000 202 #define DEBUG_FS_SIZE_DIR_NODE 0x00004000 203 #define DEBUG_FS_SIZE_DIR_ADD_DIRENT 0x00008000 204 #define DEBUG_FS_POPULATE 0x00010000 205 #define DEBUG_FS_POPULATE_DIRBUF 0x00020000 206 #define DEBUG_FS_POPULATE_NODE 0x00040000 207 #define DEBUG_FS_WRITE_FILE 0x00080000 208 #define DEBUG_FS_WRITE_FILE_BLOCK 0x00100000 209 #define DEBUG_FS_MAKE_DIRBUF 0x00200000 210 #define DEBUG_FS_WRITE_INODE 0x00400000 211 #define DEBUG_BUF_BREAD 0x00800000 212 #define DEBUG_BUF_BWRITE 0x01000000 213 #define DEBUG_BUF_GETBLK 0x02000000 214 #define DEBUG_APPLY_SPECFILE 0x04000000 215 #define DEBUG_APPLY_SPECENTRY 0x08000000 216 #define DEBUG_APPLY_SPECONLY 0x10000000 217 218 219 #define TIMER_START(x) \ 220 if (debug & DEBUG_TIME) \ 221 gettimeofday(&(x), NULL) 222 223 #define TIMER_RESULTS(x,d) \ 224 if (debug & DEBUG_TIME) { \ 225 struct timeval end, td; \ 226 gettimeofday(&end, NULL); \ 227 timersub(&end, &(x), &td); \ 228 printf("%s took %lld.%06ld seconds\n", \ 229 (d), (long long)td.tv_sec, \ 230 (long)td.tv_usec); \ 231 } 232 233 234 #ifndef DEFAULT_FSTYPE 235 #define DEFAULT_FSTYPE "ffs" 236 #endif 237 238 239 /* 240 * ffs specific settings 241 * --------------------- 242 */ 243 244 #define FFS_EI /* for opposite endian support in ffs headers */ 245 246 247 #endif /* _MAKEFS_H */ 248