#!/bin/sh /usr/share/dpatch/dpatch-run ## 08-cdrkit-doc.dpatch by Daniel Baumann ## ## DP: Update any cdrtools related information in the documentation to cdrkit. @DPATCH@ diff -Naurp dvd+rw-tools-7.1.orig/growisofs.1 dvd+rw-tools-7.1/growisofs.1 --- dvd+rw-tools-7.1.orig/growisofs.1 2008-04-01 09:04:48.000000000 +0000 +++ dvd+rw-tools-7.1/growisofs.1 2008-04-01 09:16:16.000000000 +0000 @@ -1,6 +1,6 @@ .TH GROWISOFS 1 "1 Mar 2008" "growisofs 7.1" .SH NAME -growisofs \- combined mkisofs frontend/DVD recording program. +growisofs \- combined genisoimage frontend/DVD recording program. .SH SYNOPSIS .B growisofs [\fB\-dry\-run\fP] @@ -9,10 +9,10 @@ growisofs \- combined mkisofs frontend/D [\fB\-speed=1\fP] \-[\fBZ|M\fP] .I /dev/dvd -.I +.I .SH DESCRIPTION -\fBgrowisofs\fP was originally designed as a frontend to \fBmkisofs\fP +\fBgrowisofs\fP was originally designed as a frontend to \fBgenisoimage\fP to facilitate appending of data to ISO9660 volumes residing on random-access media such as DVD+RW, DVD\-RAM, plain files, hard disk partitions. In the course of development general purpose DVD recording @@ -35,7 +35,7 @@ EXAMPLES section for further details. Merge a new session to an existing one. .TP .BI \-version -Print version information and invoke \fBmkisofs\fP, also with \-version +Print version information and invoke \fBgenisoimage\fP, also with \-version option. .TP .BI \-dvd\-compat @@ -47,7 +47,7 @@ explicitly burn [otherwise optional] lea .BI \-dry\-run At dry\-run \fBgrowisofs\fP performs all the steps till, but not including the first write operation. Most notably check for "overburn" -condition is performed, which implies that mkisofs is invoked and +condition is performed, which implies that genisoimage is invoked and terminated prematurely. .TP .BI \-overburn @@ -68,8 +68,8 @@ be found in \fBdvd+rw\-mediainfo\fP outp recordings are commonly performed at ~1/2 of advertised speed, because of defect management being in effect. .TP -.BI -More options can be found in the manpage for \fBmkisofs\fP. +.BI +More options can be found in the manpage for \fBgenisoimage\fP. .P There are several undocumented options commonly denoted with @@ -82,7 +82,7 @@ these options undocumented is that those need to use them directly can as well consult the source code or obtain specific instructions elsewhere. -.SH DIFFERENCES WITH RUNNING MKISOFS DIRECTLY +.SH DIFFERENCES WITH RUNNING GENISOIMAGE DIRECTLY .P When using growisofs you may not use the .B \-o @@ -99,7 +99,7 @@ will construct one for you; Otherwise everything that applies to .I [multisession] mastering with -.B mkisofs +.B genisoimage applies to .B growisofs as well. @@ -107,7 +107,8 @@ as well. needs at least .B mkisofs version 1.14, version 2.0 is required for multisession write-once -recordings. +recordings or +.B genisoimage. .SH EXAMPLES Actual device names vary from one operating system to another. We use @@ -146,12 +147,12 @@ command name is not intuitive in this co .SH NOTES If executed under sudo(8) growisofs refuses to start. This is done for the following reason. Naturally growisofs has to access the data set to -be recorded to optical media, either indirectly by letting mkisofs +be recorded to optical media, either indirectly by letting genisoimage generate ISO9660 layout on-the-fly or directly if a pre-mastered image is to be recorded. Being executed under sudo(8), growisofs effectively grants sudoers read access to \fIany\fP file in the file system. The -situation is intensified by the fact that growisofs parses MKISOFS -environment variable in order to determine alternative path to mkisofs +situation is intensified by the fact that growisofs parses GENISOIMAGE +environment variable in order to determine alternative path to genisoimage executable image. This means that being executed under sudo(8), growisofs effectively grants sudoers right to execute program of their choice with elevated privileges. If you for any reason still find the @@ -162,13 +163,13 @@ real growisofs binary. .nf #!/bin/ksh unset SUDO_COMMAND - export MKISOFS=/path/to/trusted/mkisofs + export GENISOIMAGE=/path/to/trusted/genisoimage exec growisofs "$@" .fi But note that the recommended alternative to the above "workaround" is actually to install growisofs set\-root\-uid, in which case it will drop -privileges prior accessing data or executing mkisofs in order to +privileges prior accessing data or executing genisoimage in order to preclude unauthorized access to the data. If the media already carries isofs and \fBgrowisofs\fP is invoked with @@ -214,7 +215,7 @@ it gets pre-formatted with minimal spare Most up-to-date information on dvd+rw\-tools is available at http://fy.chalmers.se/~appro/linux/DVD+RW/. .PP -The manpage for \fBmkisofs\fP. +The manpage for \fBgenisoimage\fP. .SH AUTHORS Andy Polyakov stands for programming and on-line diff -Naurp dvd+rw-tools-7.1.orig/index.html dvd+rw-tools-7.1/index.html --- dvd+rw-tools-7.1.orig/index.html 2008-03-04 09:03:21.000000000 +0000 +++ dvd+rw-tools-7.1/index.html 2008-04-01 09:20:57.000000000 +0000 @@ -137,7 +137,9 @@ SRC="japanese.gif" WIDTH=48 HEIGHT=19 BO front-end to mkisofs, i.e. invokes mkisofs to perform the actual ISO9660 file system layout. Secondly, the DVD burners available on the market can burn even CD-R[W] media and - cdrecord is the tool for this job. + cdrecord is the tool for this job [and this job only]. + Note that mkisofs is replaced with its successor genisoimage from + cdrkit.