Debian Codegraph @

growisofs.1

raw ◀ ▶
Source reconstructed at patch state 1 of 2 — not the installed (fully patched) source.
2 Debian patches touch this file
1 .TH GROWISOFS 1 "1 Mar 2008" "growisofs 7.1"
2 .SH NAME
3 growisofs \- combined mkisofs frontend/DVD recording program.
4 .SH SYNOPSIS
5 .B growisofs
6 [\fB\-dry\-run\fP]
7 [\fB\-dvd\-compat\fP]
8 [\fB\-overburn\fP]
9 [\fB\-speed=1\fP]
10 \-[\fBZ|M\fP]
11 .I /dev/dvd
12 .I <mkisofs-options>
13
14 .SH DESCRIPTION
15 \fBgrowisofs\fP was originally designed as a frontend to \fBmkisofs\fP
16 to facilitate appending of data to ISO9660 volumes residing on
17 random-access media such as DVD+RW, DVD\-RAM, plain files, hard disk
18 partitions. In the course of development general purpose DVD recording
19 support was implemented, and as of now \fBgrowisofs\fP supports not
20 only random-access media, but even mastering of multisession DVD media
21 such as DVD+R and DVD\-R/\-RW, as well as Blu\-ray Disc. In addition
22 \fBgrowisofs\fP supports first-/single-session recording of
23 \fIarbitrary pre-mastered image\fP (formatted as UDF, ISO9660 or any
24 other file system, if formatted at all) to all supported DVD media
25 types.
26
27 .SH OPTIONS
28 .TP
29 .BI \-Z\ /dev/dvd
30 Burn an initial session to the selected device. A special form of this
31 option is recognized to support burning of pre-mastered images. See
32 EXAMPLES section for further details.
33 .TP
34 .BI \-M\ /dev/dvd
35 Merge a new session to an existing one.
36 .TP
37 .BI \-version
38 Print version information and invoke \fBmkisofs\fP, also with \-version
39 option.
40 .TP
41 .BI \-dvd\-compat
42 Provide maximum media compatibility with DVD\-ROM/\-Video. In write-once
43 DVD+R or DVD\-R context this results in unappendable recording
44 (closed disk). In DVD+RW context it instructs the logical unit to
45 explicitly burn [otherwise optional] lead\-out.
46 .TP
47 .BI \-dry\-run
48 At dry\-run \fBgrowisofs\fP performs all the steps till, but not
49 including the first write operation. Most notably check for "overburn"
50 condition is performed, which implies that mkisofs is invoked and
51 terminated prematurely.
52 .TP
53 .BI \-overburn
54 Normally single layer DVD media can accommodate up to approximately
55 4.700.000.000 bytes (in marketing speech 4.7GB). In other words a DVD
56 can contain about 4.377 GiB or 4482 MiB. Same kind of arithmetics
57 applies to Blu\-ray Disc capacity of 25.000.000.000 bytes. Anyway,
58 growisofs won't start without this option, if "overburn" condition
59 appears to be unavoidable.
60 .TP
61 .BI \-speed=N
62 An option to control recording velocity. Most commonly you'll use
63 \fB\-speed=1\fP with "no\-name" media, if default speed setting messes
64 up the media. Keep in mind that \fBN\fP essentially denotes speed
65 \fIclosest\fP to N*1385KBps in DVD or N*4496KBps in Blu\-ray Disc case
66 among those offered by unit for currently mounted media. The list can
67 be found in \fBdvd+rw\-mediainfo\fP output. Note that Blu\-ray Disc
68 recordings are commonly performed at ~1/2 of advertised speed, because
69 of defect management being in effect.
70 .TP
71 .BI <mkisofs-options>
72 More options can be found in the manpage for \fBmkisofs\fP.
73
74 .P
75 There are several undocumented options commonly denoted with
76 \fB\-use\-the\-force\-luke\fP prefix. Some of them serve debugging
77 purposes. Some require certain knowledge about recording process or
78 even OS kernel internals and as being such can induce confusing
79 behaviour. Some are to be used in very specific situations better
80 recognized by front-ends or automated scripts. Rationale behind leaving
81 these options undocumented is that those few users who would actually
82 need to use them directly can as well consult the source code or obtain
83 specific instructions elsewhere.
84
85 .SH DIFFERENCES WITH RUNNING MKISOFS DIRECTLY
86 .P
87 When using growisofs you may not use the
88 .B \-o
89 option for an output file.
90 .B growisofs
91 dumps the image directly to the media;
92 .P
93 You don't have to specify the
94 .B \-C
95 option to create a higher level session on a multisession disk,
96 .B growisofs
97 will construct one for you;
98 .P
99 Otherwise everything that applies to
100 .I [multisession]
101 mastering with
102 .B mkisofs
103 applies to
104 .B growisofs
105 as well.
106 .B growisofs
107 needs at least
108 .B mkisofs
109 version 1.14, version 2.0 is required for multisession write-once
110 recordings.
111
112 .SH EXAMPLES
113 Actual device names vary from one operating system to another. We use
114 \fI/dev/dvd\fP as a collective name or as symbolic link to the actual
115 device if you wish. Under Linux it will most likely be an ide\-scsi
116 device such as "/dev/scd0." Under NetBSD/OpenBSD it has to be a
117 \fIcharacter\fP SCSI CD\-ROM device such as "/dev/rcd0c." Under Solaris
118 it also has to be a \fIcharacter\fP SCSI/ATAPI CD\-ROM device, e.g.
119 "/dev/rdsk/c0t1d0s2" or "/vol/dev/aliases/cdrom0." And likewise in
120 HP\-UX, IRIX and Mac OS X...
121
122 To master and burn an ISO9660 volume with Joliet and Rock\-Ridge
123 extensions on a DVD or Blu\-ray Disc:
124
125 growisofs \fB\-Z\fP /dev/dvd \fB\-R \-J\fP /some/files
126
127 To append more data to same media:
128
129 growisofs \fB\-M\fP /dev/dvd \fB\-R \-J\fP /more/files
130
131 Make sure to use \fIthe same options\fP for both initial burning and
132 when appending data.
133
134 To finalize the multisession DVD maintaining maximum compatibility:
135
136 growisofs \fB\-M\fP /dev/dvd\fB=\fP/dev/zero
137
138 To use \fBgrowisofs\fP to write a pre-mastered ISO-image to a DVD:
139
140 growisofs \-dvd\-compat \-Z /dev/dvd\fB=\fPimage.iso
141
142 where image.iso represents an arbitrary object in the filesystem, such
143 as file, named pipe or device entry. Nothing is growing here and
144 command name is not intuitive in this context.
145
146 .SH NOTES
147 If executed under sudo(8) growisofs refuses to start. This is done for
148 the following reason. Naturally growisofs has to access the data set to
149 be recorded to optical media, either indirectly by letting mkisofs
150 generate ISO9660 layout on-the-fly or directly if a pre-mastered image
151 is to be recorded. Being executed under sudo(8), growisofs effectively
152 grants sudoers read access to \fIany\fP file in the file system. The
153 situation is intensified by the fact that growisofs parses MKISOFS
154 environment variable in order to determine alternative path to mkisofs
155 executable image. This means that being executed under sudo(8),
156 growisofs effectively grants sudoers right to execute program of their
157 choice with elevated privileges. If you for any reason still find the
158 above acceptable and are willing to take the consequences, then
159 consider running following wrapper script under sudo(8) in place for
160 real growisofs binary.
161
162 .nf
163 #!/bin/ksh
164 unset SUDO_COMMAND
165 export MKISOFS=/path/to/trusted/mkisofs
166 exec growisofs "$@"
167 .fi
168
169 But note that the recommended alternative to the above "workaround" is
170 actually to install growisofs set\-root\-uid, in which case it will drop
171 privileges prior accessing data or executing mkisofs in order to
172 preclude unauthorized access to the data.
173
174 If the media already carries isofs and \fBgrowisofs\fP is invoked with
175 \fB\-Z\fP option non-interactively, e.g. through cron, it shall fail
176 with "FATAL: /dev/dvd already carries isofs!" Note that only ISO9660 is
177 recognized, you can perfectly zap e.g. an UDF filesystem
178 non-interactively. Recommendation is to prepare media for unattended
179 usage by re-formatting or nullifying first 64KB in advance.
180
181 "Overburn" protection in pre-mastered image context works only with
182 plain files and ISO9660 formatted volumes. E.g. [given that /dev/root
183 is an ext2 formatted file system larger than 4.7GB] /dev/dvd=/dev/root is
184 bound to produce corrupted recording.
185
186 Note that DVD+RW re-formatting procedure does not substitute for
187 blanking. If you want to nullify the media, e.g. for privacy reasons,
188 do it explicitly with 'growisofs \-Z /dev/dvd\fB=/dev/zero\fP'.
189
190 Playback of re-writable DVD media, both DVD+RW and DVD\-RW, might be
191 limited in legacy DVD\-ROM/\-Video units. In most cases this is due
192 to lower reflectivity of such media.
193
194 Even though growisofs supports it, playback of multisession write-once
195 DVD might be limited to the first session for two reasons:
196
197 .TP
198 \(bu
199 not all DVD\-ROM players are capable of multi-border DVD\-R playback,
200 even less are aware of DVD+R multisessioning, burner unit therefore
201 might be the only one in your vicinity capable of accessing files
202 written at different occasions;
203 .TP
204 \(bu
205 OS might fail to mount multisession DVD for various reasons;
206 .PP
207 The above is not applicable to DVD+RW, DVD\-RW Restricted Overwrite,
208 DVD\-RAM or Blu\-ray Disc, as volumes are grown within a single session.
209
210 When growisofs "runs into" blank Blu\-ray Disc media, BD\-RE or BD\-R,
211 it gets pre-formatted with minimal spare area size of 256MB.
212
213 .SH SEE ALSO
214 Most up-to-date information on dvd+rw\-tools is available at
215 http://fy.chalmers.se/~appro/linux/DVD+RW/.
216 .PP
217 The manpage for \fBmkisofs\fP.
218
219 .SH AUTHORS
220 Andy Polyakov <[email protected]> stands for programming and on-line
221 information.
222
223 This manpage is currently maintained by Huub Reuver
224 <[email protected]>.
225
226 .SH LICENSE
227 \fBgrowisofs\fP is distributed under GNU GPL.
228