mk9660.1 (3942B)
1 .TH MK9660 1 2 .SH NAME 3 dump9660, mk9660 \- create an ISO-9660 CD image 4 .SH SYNOPSIS 5 .B mk9660 6 [ 7 .B -:D 8 ] 9 [ 10 .B -9cjr 11 ] 12 [ 13 .B -b 14 .I bootfile 15 ] 16 [ 17 .B -p 18 .I proto 19 ] 20 [ 21 .B -s 22 src 23 ] 24 [ 25 .B -v 26 volume 27 ] 28 .I image 29 .PP 30 .B dump9660 31 [ 32 .B -:D 33 ] 34 [ 35 .B -9cjr 36 ] 37 [ 38 .B -p 39 .I proto 40 ] 41 [ 42 .B -s 43 src 44 ] 45 [ 46 .B -v 47 volume 48 ] 49 [ 50 .B -m 51 .I maxsize 52 ] 53 [ 54 .B -n 55 .I now 56 ] 57 .I image 58 .SH DESCRIPTION 59 .I Mk9660 60 writes to the random access file 61 .I image 62 an ISO-9660 CD image containing the 63 files named in 64 .I proto 65 (by default, 66 .BR \*9/proto/allproto ) 67 from the file tree 68 .I src 69 (by default, 70 the current directory). 71 The 72 .I proto 73 file is formatted as described in 74 .MR proto (3) . 75 .PP 76 The created CD image will be in ISO-9660 77 format, but by default the file names will 78 be stored in UTF-8 with no imposed length 79 or character restrictions. 80 The 81 .B -c 82 flag causes 83 .I mk9660 84 to use only file names in ``8.3'' form 85 that use digits, letters, and underscore. 86 File names that do not conform are changed 87 to 88 .BI D nnnnnn 89 (for directories) 90 or 91 .BI F nnnnnn 92 (for files); 93 a key file 94 .B _CONFORM.MAP 95 is created in the root 96 directory to ease the reverse process. 97 .PP 98 If the 99 .B -9 100 flag is given, the system use fields at the end of 101 each directory entry will be populated with 102 Plan directory information (owner, group, mode, 103 full name); this is interpreted by 104 .IR 9660srv . 105 .PP 106 If the 107 .B -j 108 flag is given, the usual directory tree is written, 109 but an additional tree in Microsoft Joliet format is 110 also added. 111 This second tree can contain long Unicode file names, 112 and can be read by 113 .I 9660srv 114 as well as most versions of Windows 115 and many Unix clones. 116 The characters 117 .BR * , 118 .BR : , 119 .BR ; , 120 .BR ? , 121 and 122 .B \e 123 are allowed in Plan 9 file names but not in Joliet file names; 124 non-conforming file names are translated 125 and a 126 .B _CONFORM.MAP 127 file written 128 as in the case of the 129 .B -c 130 option. 131 .PP 132 If the 133 .B -r 134 flag is given, Rock Ridge extensions are written in the 135 format of the system use sharing protocol; 136 this format provides Posix-style file metadata and is 137 common on Unix platforms. 138 .PP 139 The options 140 .BR -c , 141 .BR -9 , 142 .BR -j , 143 and 144 .B -r 145 may be mixed freely with the exception that 146 .B -9 147 and 148 .B -r 149 are mutually exclusive. 150 .PP 151 The 152 .B -v 153 flag sets the volume title; 154 if unspecified, the base name of 155 .I proto 156 is used. 157 .PP 158 The 159 .B -: 160 flag causes 161 .B mk9660 162 to replace colons in scanned file names with spaces; 163 this is the inverse of the map applied by Plan 9's 164 .IR dossrv (4) 165 and is useful for writing Joliet CDs containing data 166 from FAT file systems. 167 .PP 168 The 169 .B -b 170 option creates a bootable CD. 171 Bootable CDs contain pointers to floppy images which are 172 loaded and booted by the BIOS. 173 .I Bootfile 174 should be the name of the floppy image to use; 175 it is a path relative to the root of the created CD. 176 That is, the boot floppy image must be listed in the 177 .I proto 178 file already: 179 the 180 .B -b 181 flag just creates a pointer to it. 182 .PP 183 The 184 .B -D 185 flag creates immense amounts of debugging output 186 on standard error. 187 .PP 188 .I Dump9660 189 is similar in specification to 190 .I mk9660 191 but creates and updates backup CD images in the style of 192 the 193 .I dump 194 file system 195 (see Plan 9's 196 .IR fs (4)). 197 The dump is file-based rather than block-based: 198 if a file's contents have not changed since the last 199 backup, only its directory entry will be rewritten. 200 .PP 201 The 202 .B -n 203 option specifies a time (in seconds since January 1, 1970) 204 to be used for naming the dump directory. 205 .PP 206 The 207 .B -m 208 option specifies a maximum size for the image; 209 if a backup would cause the image to grow larger than 210 .IR maxsize , 211 it will not be written, and 212 .I dump9660 213 will exit with a non-empty status. 214 .SH EXAMPLE 215 .PP 216 Create an image of the Plan 9 source tree, 217 including a conformant ISO-9660 directory tree, 218 Plan 9 extensions in the system use fields, and 219 a Joliet directory tree. 220 .IP 221 .EX 222 mk9660 -9cj -s /n/bootes -p srcproto cdimage 223 .EE 224 .SH SOURCE 225 \*9/src/cmd/9660 226 .SH "SEE ALSO 227 .MR proto (3) 228 .\" .SH "SEE ALSO" 229 .\" .I 9660srv 230 .\" (in 231 .\" .IR dossrv (4)), 232 .\" .IR cdfs (4), 233 .\" .IR proto (3)