source: multimedia/cdwriteutils/cdrtools.xml@ 297cec1

10.0 10.1 11.0 11.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 297cec1 was 297cec1, checked in by Randy McMurchy <randy@…>, 16 years ago

Updated the Cdrtools instructions to reflect a new version of the ascii patch

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@6149 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 11.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY cdrtools-download-http "http://gd.tuwien.ac.at/utils/schilling/cdrtools/cdrtools-&cdrtools-version;.tar.bz2">
8 <!ENTITY cdrtools-download-ftp "ftp://ftp.berlios.de/pub/cdrecord/cdrtools-&cdrtools-version;.tar.bz2">
9 <!ENTITY cdrtools-md5sum "d44a81460e97ae02931c31188fe8d3fd">
10 <!ENTITY cdrtools-size "1.4 MB">
11 <!ENTITY cdrtools-buildsize "21 MB">
12 <!ENTITY cdrtools-time "0.5 SBU">
13]>
14
15<sect1 id="cdrtools" xreflabel="Cdrtools-&cdrtools-version;">
16 <?dbhtml filename="cdrtools.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 <keywordset>
22 <keyword role="package">cdrtools-&cdrtools-version;.tar</keyword>
23 <keyword role="ftpdir">cdrtools</keyword>
24 </keywordset>
25 </sect1info>
26
27 <title>Cdrtools-&cdrtools-version;</title>
28
29 <indexterm zone="cdrtools">
30 <primary sortas="a-Cdrtools">Cdrtools</primary>
31 </indexterm>
32
33 <sect2 role="package">
34 <title>Introduction to Cdrtools</title>
35
36 <para>The <application>Cdrtools</application> package contains
37 CD recording utilities. These are useful for reading, creating or writing
38 (burning) Compact Discs.</para>
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>Download (HTTP): <ulink url="&cdrtools-download-http;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download (FTP): <ulink url="&cdrtools-download-ftp;"/></para>
47 </listitem>
48 <listitem>
49 <para>Download MD5 sum: &cdrtools-md5sum;</para>
50 </listitem>
51 <listitem>
52 <para>Download size: &cdrtools-size;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated disk space required: &cdrtools-buildsize;</para>
56 </listitem>
57 <listitem>
58 <para>Estimated build time: &cdrtools-time;</para>
59 </listitem>
60 </itemizedlist>
61
62 <bridgehead renderas="sect3">Additional Downloads</bridgehead>
63 <itemizedlist spacing='compact'>
64 <listitem>
65 <para>Required patch for extending the number of locales to create
66 CDs with non-ASCII filenames:
67 <ulink url="&patch-root;/cdrtools-&cdrtools-version;-mkisofs_iconv-1.patch"/></para>
68 </listitem>
69
70 <listitem>
71 <para>Recommended Patch for using <application>Cdrtools</application>
72 in locales using non-ISO-8859-1 character sets:
73 <ulink url="&patch-root;/cdrtools-&cdrtools-version;-ascii-2.patch"/></para>
74 </listitem>
75 </itemizedlist>
76
77 <para condition="html" role="usernotes">User Notes:
78 <ulink url="&blfs-wiki;/Cdrtools"/></para>
79
80 </sect2>
81
82 <sect2 role="installation">
83 <title>Installation of Cdrtools</title>
84
85 <note>
86 <para>Installation of <application>Cdrtools</application> will fail if raw
87 kernel headers are found in <filename class='directory'>/usr/src/linux</filename>
88 either as actual files or a symlink. As of the Linux 2.6 kernel series, this directory
89 should no longer exist because appropriate headers were installed in the
90 linux-libc-headers package during the base LFS installation.</para>
91 </note>
92
93 <para>When creating an ISO 9660 image with <command>mkisofs</command>,
94 the character set of the filenames used must be specified unless it is
95 ISO-8859-1, the default. If the character set is not specified correctly,
96 then non-ASCII filenames will be unreadable on other systems, such as
97 <application>Microsoft Windows</application>. This patch allows any
98 input character set supported by <application>Glibc</application>
99 (such as UTF-8) to be specified to <command>mkisofs</command>, as
100 opposed of the short list of built-in encodings. Also, the default input
101 character set is set to that of the current locale, which is the correct
102 behavior. To address this situation, apply the mkisofs_iconv patch:</para>
103
104<screen><userinput>patch -Np1 -i ../cdrtools-&cdrtools-version;-mkisofs_iconv-1.patch</userinput></screen>
105
106 <para>The <command>cdrecord</command> program has hard-coded non-ASCII
107 characters in its messages. Since these characters are part of the
108 ISO-8859-1 character set, they will not be displayed correctly in
109 locales that use a different character set, such as UTF-8. The following
110 patch converts these characters to ASCII approximations:</para>
111
112<screen><userinput>patch -Np1 -i ../cdrtools-&cdrtools-version;-ascii-2.patch</userinput></screen>
113
114 <para>Install <application>Cdrtools</application> by running the following
115 commands:</para>
116
117<screen><userinput>make INS_BASE=/usr DEFINSUSR=root DEFINSGRP=root</userinput></screen>
118
119 <para>This package does not come with a test suite.</para>
120
121 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
122
123<screen role="root"><userinput>make INS_BASE=/usr DEFINSUSR=root DEFINSGRP=root install &amp;&amp;
124install -v -m755 -d /usr/share/doc/cdrtools-2.01 &amp;&amp;
125install -v -m644 README* ABOUT doc/*.ps \
126 /usr/share/doc/cdrtools-2.01</userinput></screen>
127
128 </sect2>
129
130 <sect2 role="commands">
131 <title>Command Explanations</title>
132
133 <para><parameter>INS_BASE=/usr</parameter>: This parameter moves
134 the install directory from <filename class="directory">/opt/schily</filename>
135 to <filename class="directory">/usr</filename>.</para>
136
137 <para><parameter>DEFINSUSR=root DEFINSGRP=root</parameter>: These
138 parameters install all programs with root:root ownership instead of the default
139 bin:bin.</para>
140
141 </sect2>
142
143 <sect2 role="content">
144 <title>Contents</title>
145
146 <segmentedlist>
147 <segtitle>Installed Programs</segtitle>
148 <segtitle>Installed Libraries</segtitle>
149 <segtitle>Installed Directories</segtitle>
150
151 <seglistitem>
152 <seg>cdda2wav, cdrecord, devdump, isodebug, isodump, isoinfo, isovfy,
153 mkhybrid, mkisofs, readcd, rscsi, scgcheck, and skel</seg>
154 <seg>libdeflt.a, libedc_ecc.a, libfile.a, libhfs.a, libparanoia.a, librscg.a,
155 libscg.a, libschily.a, and libunls.a</seg>
156 <seg>None</seg>
157 </seglistitem>
158 </segmentedlist>
159
160 <variablelist>
161 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
162 <?dbfo list-presentation="list"?>
163 <?dbhtml list-presentation="table"?>
164
165 <varlistentry id="cdda2wav">
166 <term><command>cdda2wav</command></term>
167 <listitem>
168 <para>converts Compact Disc audio into WAV sound files.</para>
169 <indexterm zone="cdrtools cdda2wav">
170 <primary sortas="b-cdda2wav">cdda2wav</primary>
171 </indexterm>
172 </listitem>
173 </varlistentry>
174
175 <varlistentry id="cdrecord">
176 <term><command>cdrecord</command></term>
177 <listitem>
178 <para>records audio or data Compact Discs.</para>
179 <indexterm zone="cdrtools cdrecord">
180 <primary sortas="b-cdrecord">cdrecord</primary>
181 </indexterm>
182 </listitem>
183 </varlistentry>
184
185 <varlistentry id="devdump">
186 <term><command>devdump</command></term>
187 <listitem>
188 <para>is a diagnostic program used to dump an
189 ISO-9660 device or file in hex.</para>
190 <indexterm zone="cdrtools devdump">
191 <primary sortas="b-devdump">devdump</primary>
192 </indexterm>
193 </listitem>
194 </varlistentry>
195
196 <varlistentry id="isodebug">
197 <term><command>isodebug</command></term>
198 <listitem>
199 <para>is used to display the command-line parameters used to create
200 an ISO-9660 image.</para>
201 <indexterm zone="cdrtools isodebug">
202 <primary sortas="b-isodebug">isodebug</primary>
203 </indexterm>
204 </listitem>
205 </varlistentry>
206
207 <varlistentry id="isodump">
208 <term><command>isodump</command></term>
209 <listitem>
210 <para>is a diagnostic program used to dump a device or file based on
211 ISO-9660.</para>
212 <indexterm zone="cdrtools isodump">
213 <primary sortas="b-isodump">isodump</primary>
214 </indexterm>
215 </listitem>
216 </varlistentry>
217
218 <varlistentry id="isoinfo">
219 <term><command>isoinfo</command></term>
220 <listitem>
221 <para>is used to analyze or list an ISO-9660 image.</para>
222 <indexterm zone="cdrtools isoinfo">
223 <primary sortas="b-isoinfo">isoinfo</primary>
224 </indexterm>
225 </listitem>
226 </varlistentry>
227
228 <varlistentry id="isovfy">
229 <term><command>isovfy</command></term>
230 <listitem>
231 <para>is used to verify an ISO-9660 image.</para>
232 <indexterm zone="cdrtools isovfy">
233 <primary sortas="b-isovfy">isovfy</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 <varlistentry id="mkhybrid">
239 <term><command>mkhybrid</command></term>
240 <listitem>
241 <para>is a symbolic link to <command>mkisofs</command> used to
242 create ISO-9660/HFS hybrid filesystem images.</para>
243 <indexterm zone="cdrtools mkhybrid">
244 <primary sortas="b-mkhybrid">mkhybrid</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="mkisofs">
250 <term><command>mkisofs</command></term>
251 <listitem>
252 <para>is used to create ISO-9660/JOLIET/HFS filesystem images,
253 optionally with Rock Ridge attributes.</para>
254 <indexterm zone="cdrtools mkisofs">
255 <primary sortas="b-mkisofs">mkisofs</primary>
256 </indexterm>
257 </listitem>
258 </varlistentry>
259
260 <varlistentry id="readcd">
261 <term><command>readcd</command></term>
262 <listitem>
263 <para>reads or writes Compact Discs.</para>
264 <indexterm zone="cdrtools readcd">
265 <primary sortas="b-readcd">readcd</primary>
266 </indexterm>
267 </listitem>
268 </varlistentry>
269
270 <varlistentry id="rscsi">
271 <term><command>rscsi</command></term>
272 <listitem>
273 <para>is a remote SCSI manager.</para>
274 <indexterm zone="cdrtools rscsi">
275 <primary sortas="b-rscsi">rscsi</primary>
276 </indexterm>
277 </listitem>
278 </varlistentry>
279
280 <varlistentry id="scgcheck">
281 <term><command>scgcheck</command></term>
282 <listitem>
283 <para>is used to check and verify the Application Binary Interface
284 of <filename class="libraryfile">libscg</filename>.</para>
285 <indexterm zone="cdrtools scgcheck">
286 <primary sortas="b-scgcheck">scgcheck</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="libscg">
292 <term><filename class='libraryfile'>libscg.a</filename></term>
293 <listitem>
294 <para>is a highly portable SCSI transport library.</para>
295 <indexterm zone="cdrtools libscg">
296 <primary sortas="c-libscg">libscg.a</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 </variablelist>
302
303 </sect2>
304
305</sect1>
Note: See TracBrowser for help on using the repository browser.