| 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 |
|