sys/man/8/mk9660

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