gstreamer1.0-dreamsinks: update to 1.1r2
[opendreambox.git] / meta-opendreambox / recipes-multimedia / dvd+rw-tools / files / 09-cdrkit-doc.dpatch
1 #!/bin/sh /usr/share/dpatch/dpatch-run
2 ## 08-cdrkit-doc.dpatch by Daniel Baumann <daniel@debian.org>
3 ##
4 ## DP: Update any cdrtools related information in the documentation to cdrkit.
5
6 @DPATCH@
7
8 diff -Naurp dvd+rw-tools-7.1.orig/growisofs.1 dvd+rw-tools-7.1/growisofs.1
9 --- dvd+rw-tools-7.1.orig/growisofs.1   2008-04-01 09:04:48.000000000 +0000
10 +++ dvd+rw-tools-7.1/growisofs.1        2008-04-01 09:16:16.000000000 +0000
11 @@ -1,6 +1,6 @@
12  .TH GROWISOFS 1 "1 Mar 2008" "growisofs 7.1"
13  .SH NAME
14 -growisofs \- combined mkisofs frontend/DVD recording program.
15 +growisofs \- combined genisoimage frontend/DVD recording program.
16  .SH SYNOPSIS
17  .B growisofs
18  [\fB\-dry\-run\fP]
19 @@ -9,10 +9,10 @@ growisofs \- combined mkisofs frontend/D
20  [\fB\-speed=1\fP]
21  \-[\fBZ|M\fP]
22  .I /dev/dvd
23 -.I <mkisofs-options>
24 +.I <genisoimage-options>
25  
26  .SH DESCRIPTION
27 -\fBgrowisofs\fP was originally designed as a frontend to \fBmkisofs\fP
28 +\fBgrowisofs\fP was originally designed as a frontend to \fBgenisoimage\fP
29  to facilitate appending of data to ISO9660 volumes residing on
30  random-access media such as DVD+RW, DVD\-RAM, plain files, hard disk
31  partitions. In the course of development general purpose DVD recording
32 @@ -35,7 +35,7 @@ EXAMPLES section for further details.
33  Merge a new session to an existing one.
34  .TP
35  .BI \-version
36 -Print version information and invoke \fBmkisofs\fP, also with \-version
37 +Print version information and invoke \fBgenisoimage\fP, also with \-version
38  option.
39  .TP
40  .BI \-dvd\-compat
41 @@ -47,7 +47,7 @@ explicitly burn [otherwise optional] lea
42  .BI \-dry\-run
43  At dry\-run \fBgrowisofs\fP performs all the steps till, but not
44  including the first write operation. Most notably check for "overburn"
45 -condition is performed, which implies that mkisofs is invoked and
46 +condition is performed, which implies that genisoimage is invoked and
47  terminated prematurely.
48  .TP
49  .BI \-overburn
50 @@ -68,8 +68,8 @@ be found in \fBdvd+rw\-mediainfo\fP outp
51  recordings are commonly performed at ~1/2 of advertised speed, because
52  of defect management being in effect.
53  .TP
54 -.BI <mkisofs-options>
55 -More options can be found in the manpage for \fBmkisofs\fP.
56 +.BI <genisoimage-options>
57 +More options can be found in the manpage for \fBgenisoimage\fP.
58  
59  .P
60  There are several undocumented options commonly denoted with
61 @@ -82,7 +82,7 @@ these options undocumented is that those
62  need to use them directly can as well consult the source code or obtain
63  specific instructions elsewhere.
64  
65 -.SH DIFFERENCES WITH RUNNING MKISOFS DIRECTLY
66 +.SH DIFFERENCES WITH RUNNING GENISOIMAGE DIRECTLY
67  .P
68  When using growisofs you may not use the
69  .B \-o 
70 @@ -99,7 +99,7 @@ will construct one for you;
71  Otherwise everything that applies to 
72  .I [multisession] 
73  mastering with 
74 -.B mkisofs 
75 +.B genisoimage 
76  applies to 
77  .B growisofs 
78  as well. 
79 @@ -107,7 +107,8 @@ as well. 
80  needs at least 
81  .B mkisofs
82  version 1.14, version 2.0 is required for multisession write-once
83 -recordings.
84 +recordings or
85 +.B genisoimage.
86  
87  .SH EXAMPLES
88  Actual device names vary from one operating system to another. We use
89 @@ -146,12 +147,12 @@ command name is not intuitive in this co
90  .SH NOTES
91  If executed under sudo(8) growisofs refuses to start. This is done for
92  the following reason. Naturally growisofs has to access the data set to
93 -be recorded to optical media, either indirectly by letting mkisofs
94 +be recorded to optical media, either indirectly by letting genisoimage
95  generate ISO9660 layout on-the-fly or directly if a pre-mastered image
96  is to be recorded. Being executed under sudo(8), growisofs effectively
97  grants sudoers read access to \fIany\fP file in the file system. The
98 -situation is intensified by the fact that growisofs parses MKISOFS
99 -environment variable in order to determine alternative path to mkisofs
100 +situation is intensified by the fact that growisofs parses GENISOIMAGE
101 +environment variable in order to determine alternative path to genisoimage
102  executable image. This means that being executed under sudo(8),
103  growisofs effectively grants sudoers right to execute program of their
104  choice with elevated privileges. If you for any reason still find the
105 @@ -162,13 +163,13 @@ real growisofs binary.
106  .nf
107         #!/bin/ksh
108         unset SUDO_COMMAND
109 -       export MKISOFS=/path/to/trusted/mkisofs
110 +       export GENISOIMAGE=/path/to/trusted/genisoimage
111         exec growisofs "$@"
112  .fi
113  
114  But note that the recommended alternative to the above "workaround" is
115  actually to install growisofs set\-root\-uid, in which case it will drop
116 -privileges prior accessing data or executing mkisofs in order to
117 +privileges prior accessing data or executing genisoimage in order to
118  preclude unauthorized access to the data.
119  
120  If the media already carries isofs and \fBgrowisofs\fP is invoked with
121 @@ -214,7 +215,7 @@ it gets pre-formatted with minimal spare
122  Most up-to-date information on dvd+rw\-tools is available at
123  http://fy.chalmers.se/~appro/linux/DVD+RW/.
124  .PP
125 -The manpage for \fBmkisofs\fP.
126 +The manpage for \fBgenisoimage\fP.
127  
128  .SH AUTHORS
129  Andy Polyakov <appro@fy.chalmers.se> stands for programming and on-line
130 diff -Naurp dvd+rw-tools-7.1.orig/index.html dvd+rw-tools-7.1/index.html
131 --- dvd+rw-tools-7.1.orig/index.html    2008-03-04 09:03:21.000000000 +0000
132 +++ dvd+rw-tools-7.1/index.html 2008-04-01 09:20:57.000000000 +0000
133 @@ -137,7 +137,9 @@ SRC="japanese.gif" WIDTH=48 HEIGHT=19 BO
134         front-end to mkisofs,</B> i.e. invokes mkisofs to perform the
135         actual ISO9660 file system layout. Secondly, the DVD burners
136         available on the market can burn even CD-R[W] media and
137 -       cdrecord is the tool for this job.</TR>
138 +       cdrecord is the tool for this job [and this job only].
139 +       Note that mkisofs is replaced with its successor genisoimage from
140 +       <A HREF="http://www.cdrkit.org/">cdrkit</a>.</TR>
141  </TABLE>
142  
143  <!--
144 @@ -480,13 +482,13 @@ are not capable of burning DVD+R is need
145  <A NAME="growisofs"><P></A><LI><P ALIGN="JUSTIFY"><B>Burning with <A
146  HREF="tools/growisofs.c">growisofs</A>.</B> There is hardly a need for
147  manual for growisofs. In a nutshell growisofs just passes all command
148 -line arguments to mkisofs and dumps its output directly onto the media.
149 +line arguments to genisoimage and dumps its output directly onto the media.
150  The first part means that you basically can [well, <I>should</I>]
151 -consult <A HREF="mkisofs.8.html">mkisofs manual page</A> and
152 +consult <A HREF="genisoimage.8.html">genisoimage manual page</A> and
153  accompanying reference documentation (including multisession related
154  section[s]) and the second part means that you shouldn't expect an
155  ISO-image on the standard output (nor make sure you have enough free
156 -temporary storage<TT>:-)</TT>. Differences from mkisofs command line
157 +temporary storage<TT>:-)</TT>. Differences from genisoimage command line
158  are:
159  
160  <P><UL>
161 @@ -494,12 +496,12 @@ are:
162  <LI>you don't have to specify -C option, growisofs will construct one
163  for you;
164  <LI>there is internal -Z option for initial session recording, this
165 -substitutes for originally suggested 'mkisofs | dd of=/dev/scd0';
166 +substitutes for originally suggested 'genisoimage | dd of=/dev/scd0';
167  </UL>
168  
169  <P ALIGN="JUSTIFY">Otherwise <I>everything</I> that applies to
170 -[multisession] mastering with mkisofs applies to growisofs as well. For
171 -example just like with mkisofs you should make a note on which options
172 +[multisession] mastering with genisoimage applies to growisofs as well. For
173 +example just like with genisoimage you should make a note on which options
174  you used to master the initial &quot;session&quot; with and stick to
175  them, e.g.:
176  
177 @@ -508,9 +510,10 @@ growisofs -Z /dev/scd0 <FONT COLOR="red"
178  growisofs -M /dev/scd0 <FONT COLOR="red">-R -J</FONT> /more/files
179  </PRE></BLOCKQUOTE>
180  
181 -<P ALIGN="JUSTIFY">Oh! Do make sure you have at least mkisofs <FONT
182 -COLOR="red">1.14</FONT> on your $PATH (mkisofs 1.14 is part of cdrtools
183 -1.10). If you consider passing <TT>/same/files</TT> as argument, or in
184 +<P ALIGN="JUSTIFY">Oh! Do make sure you have genisoimage on your $PATH
185 +(genisoimage is part of <A HREF="http://www.cdrkit.org/">cdrkit</A>,
186 +or at least mkisofs <FONT COLOR="red">1.14</FONT> (mkisofs 1.14 is part of
187 +cdrtools 1.10). If you consider passing <TT>/same/files</TT> as argument, or in
188  other words consider deploying growisofs for <I>incremental</I>
189  multisession backups, then you shall find <A
190  HREF="mkisofs-2.01a16-root.diff">this '-old-root' extension</A> to
191 @@ -586,7 +589,8 @@ through ide-scsi, the way it was under 2
192  unsupported it actually still works in 2.6 (I for one still use it).
193  
194  <LI>If you go for BD-R/DVD&plusmn;R multisessioning, you have to use
195 -mkisofs from <A HREF="ftp://ftp.berlios.de/pub/cdrecord/">cdrtools-2.0
196 +genisoimage from <A HREF="http://www.cdrkit.org/">cdrkit-1.0 or later</A>,
197 +or mkisofs from <A HREF="ftp://ftp.berlios.de/pub/cdrecord/">cdrtools-2.0
198  or later</A> or apply <A HREF="multi.diff">this patch</A>.
199  
200  <LI>And when it comes to <B>DVD+R Double Layer and <NOBR>DVD-R</NOBR>
201 @@ -630,7 +634,7 @@ working. To see it in action, insert for
202  access it, '<TT>dd if=/dev/scd<FONT COLOR="red">N</FONT> count=0</TT>'
203  would do. Then verify that kernel logs &quot;<TT>sr<FONT
204  COLOR="red">N</FONT>: mmc-3 profile: 1Ah</TT>&quot. You should now be
205 -able to '<TT>mkisofs -pad . | dd of=/dev/scd<FONT COLOR="red">N</FONT>
206 +able to '<TT>genisoimage -pad . | dd of=/dev/scd<FONT COLOR="red">N</FONT>
207  obs=32k</TT>' or even '<TT>mke2fs -b 2048 /dev/scd<FONT
208  COLOR="red">N</FONT></TT>' and observe kernel logging &quot;<TT>sr<FONT
209  COLOR="red">N</FONT>: dirty DVD+RW media</TT>.&quot
210 @@ -802,7 +806,7 @@ huge*.void</TT>'. Otherwise you might ha
211  <TR VALIGN="TOP" ALIGN="JUSTIFY">
212  <TD><FONT SIZE="-1"><SUP>(***)</SUP></FONT>
213  <TD><FONT SIZE="-1">E.g. when mastering DVD-Video disc:-) Note that
214 -<TT>-dvd-video</TT> option [passed to mkisofs] engages
215 +<TT>-dvd-video</TT> option [passed to genisoimage] engages
216  <TT>-dvd-compat</TT> automatically.</FONT></TR>
217  </TABLE>
218  
219 @@ -908,7 +912,7 @@ Now, the problem is that isofs i-nodes<S
220  entries (light-greens), byte offsets from the beginning of media. This
221  means that no directory (green areas) may cross 4GB boundary without
222  being effectively corrupted<TT>:-(</TT> It should be noted that in
223 -reality it's a bit better than it looks on the picture, as mkisofs
224 +reality it's a bit better than it looks on the picture, as genisoimage
225  collects all the directories in the beginning of any particular session
226  (there normally are no blues between greens). The <I>first</I> session
227  is therefore never subject to i-node wrap-around, but not the