1 058b0118 2005-01-03 devnull .TH MK9660 8
3 058b0118 2005-01-03 devnull dump9660, mk9660 \- create an ISO-9660 CD image
4 058b0118 2005-01-03 devnull .SH SYNOPSIS
5 058b0118 2005-01-03 devnull .B disk/mk9660
14 058b0118 2005-01-03 devnull .I bootfile
30 058b0118 2005-01-03 devnull .B disk/dump9660
51 058b0118 2005-01-03 devnull .I maxsize
58 058b0118 2005-01-03 devnull .SH DESCRIPTION
59 058b0118 2005-01-03 devnull .I Mk9660
60 058b0118 2005-01-03 devnull writes to the random access file
62 058b0118 2005-01-03 devnull an ISO-9660 CD image containing the
63 058b0118 2005-01-03 devnull files named in
65 058b0118 2005-01-03 devnull (by default,
66 058b0118 2005-01-03 devnull .BR /sys/lib/sysconfig/proto/allproto )
67 058b0118 2005-01-03 devnull from the file tree
69 058b0118 2005-01-03 devnull (by default,
70 058b0118 2005-01-03 devnull the current directory).
73 058b0118 2005-01-03 devnull file is formatted as described in
74 058b0118 2005-01-03 devnull .IR proto (3).
76 058b0118 2005-01-03 devnull The created CD image will be in ISO-9660
77 058b0118 2005-01-03 devnull format, but by default the file names will
78 058b0118 2005-01-03 devnull be stored in UTF-8 with no imposed length
79 058b0118 2005-01-03 devnull or character restrictions.
82 058b0118 2005-01-03 devnull flag causes
83 058b0118 2005-01-03 devnull .I mk9660
84 058b0118 2005-01-03 devnull to use only file names in ``8.3'' form
85 058b0118 2005-01-03 devnull that use digits, letters, and underscore.
86 058b0118 2005-01-03 devnull File names that do not conform are changed
88 058b0118 2005-01-03 devnull .BI D nnnnnn
89 058b0118 2005-01-03 devnull (for directories)
91 058b0118 2005-01-03 devnull .BI F nnnnnn
92 058b0118 2005-01-03 devnull (for files);
93 058b0118 2005-01-03 devnull a key file
94 058b0118 2005-01-03 devnull .B _CONFORM.MAP
95 058b0118 2005-01-03 devnull is created in the root
96 058b0118 2005-01-03 devnull directory to ease the reverse process.
100 058b0118 2005-01-03 devnull flag is given, the system use fields at the end of
101 058b0118 2005-01-03 devnull each directory entry will be populated with
102 058b0118 2005-01-03 devnull Plan directory information (owner, group, mode,
103 058b0118 2005-01-03 devnull full name); this is interpreted by
104 058b0118 2005-01-03 devnull .IR 9660srv .
108 058b0118 2005-01-03 devnull flag is given, the usual directory tree is written,
109 058b0118 2005-01-03 devnull but an additional tree in Microsoft Joliet format is
110 058b0118 2005-01-03 devnull also added.
111 058b0118 2005-01-03 devnull This second tree can contain long Unicode file names,
112 058b0118 2005-01-03 devnull and can be read by
113 058b0118 2005-01-03 devnull .I 9660srv
114 058b0118 2005-01-03 devnull as well as most versions of Windows
115 058b0118 2005-01-03 devnull and many Unix clones.
116 058b0118 2005-01-03 devnull The characters
123 058b0118 2005-01-03 devnull are allowed in Plan 9 file names but not in Joliet file names;
124 058b0118 2005-01-03 devnull non-conforming file names are translated
126 058b0118 2005-01-03 devnull .B _CONFORM.MAP
127 058b0118 2005-01-03 devnull file written
128 058b0118 2005-01-03 devnull as in the case of the
134 058b0118 2005-01-03 devnull flag is given, Rock Ridge extensions are written in the
135 058b0118 2005-01-03 devnull format of the system use sharing protocol;
136 058b0118 2005-01-03 devnull this format provides Posix-style file metadata and is
137 058b0118 2005-01-03 devnull common on Unix platforms.
139 058b0118 2005-01-03 devnull The options
140 058b0118 2005-01-03 devnull .BR -c ,
141 058b0118 2005-01-03 devnull .BR -9 ,
142 058b0118 2005-01-03 devnull .BR -j ,
145 058b0118 2005-01-03 devnull may be mixed freely with the exception that
149 058b0118 2005-01-03 devnull are mutually exclusive.
153 058b0118 2005-01-03 devnull flag sets the volume title;
154 058b0118 2005-01-03 devnull if unspecified, the base name of
155 058b0118 2005-01-03 devnull .I proto
156 058b0118 2005-01-03 devnull is used.
160 058b0118 2005-01-03 devnull flag causes
161 058b0118 2005-01-03 devnull .B mk9660
162 058b0118 2005-01-03 devnull to replace colons in scanned file names with spaces;
163 058b0118 2005-01-03 devnull this is the inverse of the map applied by Plan 9's
164 058b0118 2005-01-03 devnull \fIdossrv\fR(4)
165 058b0118 2005-01-03 devnull and is useful for writing Joliet CDs containing data
166 058b0118 2005-01-03 devnull from FAT file systems.
170 058b0118 2005-01-03 devnull option creates a bootable CD.
171 058b0118 2005-01-03 devnull Bootable CDs contain pointers to floppy images which are
172 058b0118 2005-01-03 devnull loaded and booted by the BIOS.
173 058b0118 2005-01-03 devnull .I Bootfile
174 058b0118 2005-01-03 devnull should be the name of the floppy image to use;
175 058b0118 2005-01-03 devnull it is a path relative to the root of the created CD.
176 058b0118 2005-01-03 devnull That is, the boot floppy image must be listed in the
177 058b0118 2005-01-03 devnull .I proto
178 058b0118 2005-01-03 devnull file already:
181 058b0118 2005-01-03 devnull flag just creates a pointer to it.
185 058b0118 2005-01-03 devnull flag creates immense amounts of debugging output
186 058b0118 2005-01-03 devnull on standard error.
188 058b0118 2005-01-03 devnull .I Dump9660
189 058b0118 2005-01-03 devnull is similar in specification to
190 058b0118 2005-01-03 devnull .I mk9660
191 058b0118 2005-01-03 devnull but creates and updates backup CD images in the style of
194 058b0118 2005-01-03 devnull file system
195 058b0118 2005-01-03 devnull (see Plan 9's \fIfs\fR(4)).
196 058b0118 2005-01-03 devnull The dump is file-based rather than block-based:
197 058b0118 2005-01-03 devnull if a file's contents have not changed since the last
198 058b0118 2005-01-03 devnull backup, only its directory entry will be rewritten.
202 058b0118 2005-01-03 devnull option specifies a time (in seconds since January 1, 1970)
203 058b0118 2005-01-03 devnull to be used for naming the dump directory.
207 058b0118 2005-01-03 devnull option specifies a maximum size for the image;
208 058b0118 2005-01-03 devnull if a backup would cause the image to grow larger than
209 058b0118 2005-01-03 devnull .IR maxsize ,
210 058b0118 2005-01-03 devnull it will not be written, and
211 058b0118 2005-01-03 devnull .I dump9660
212 058b0118 2005-01-03 devnull will exit with a non-empty status.
213 058b0118 2005-01-03 devnull .SH EXAMPLE
215 058b0118 2005-01-03 devnull Create an image of the Plan 9 source tree,
216 058b0118 2005-01-03 devnull including a conformant ISO-9660 directory tree,
217 058b0118 2005-01-03 devnull Plan 9 extensions in the system use fields, and
218 058b0118 2005-01-03 devnull a Joliet directory tree.
221 058b0118 2005-01-03 devnull disk/mk9660 -9cj -s /n/bootes \e
222 058b0118 2005-01-03 devnull -p /sys/lib/sysconfig/srcproto cdimage
224 058b0118 2005-01-03 devnull .SH SOURCE
225 058b0118 2005-01-03 devnull /usr/local/plan9/src/cmd/9660
226 058b0118 2005-01-03 devnull .SH "SEE ALSO
227 058b0118 2005-01-03 devnull .IR proto (3)
228 058b0118 2005-01-03 devnull .\" .SH "SEE ALSO"
229 058b0118 2005-01-03 devnull .\" .I 9660srv
231 058b0118 2005-01-03 devnull .\" .IR dossrv (4)),
232 058b0118 2005-01-03 devnull .\" .IR cdfs (4),
233 058b0118 2005-01-03 devnull .\" .IR proto (3)