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