source: multimedia/cdwriteutils/cdrtools.xml@ ff769b8c

<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

  <!ENTITY cdrtools-download-http "http://gd.tuwien.ac.at/utils/schilling/cdrtools/cdrtools-&cdrtools-version;.tar.bz2">
  <!ENTITY cdrtools-download-ftp  "ftp://ftp.berlios.de/pub/cdrecord/cdrtools-&cdrtools-version;.tar.bz2">
  <!ENTITY cdrtools-md5sum        "d44a81460e97ae02931c31188fe8d3fd">
  <!ENTITY cdrtools-size          "1.4 MB">
  <!ENTITY cdrtools-buildsize     "21 MB">
  <!ENTITY cdrtools-time          "0.55 SBU">
]>

<sect1 id="cdrtools" xreflabel="Cdrtools-&cdrtools-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="cdrtools.html"?>
<title>Cdrtools-&cdrtools-version;</title>
<indexterm zone="cdrtools">
<primary sortas="a-Cdrtools">Cdrtools</primary></indexterm>

<sect2>
<title>Introduction to <application>Cdrtools</application></title>

<para>The <application>Cdrtools</application> package contains
<acronym>CD</acronym> recording utilities. These are
useful for reading, creating or writing (burning) Compact Discs.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): 
<ulink url="&cdrtools-download-http;"/></para></listitem>
<listitem><para>Download (FTP): 
<ulink url="&cdrtools-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum: &cdrtools-md5sum;</para></listitem>
<listitem><para>Download size: &cdrtools-size;</para></listitem>
<listitem><para>Estimated disk space required: 
&cdrtools-buildsize;</para></listitem>
<listitem><para>Estimated build time: 
&cdrtools-time;</para></listitem></itemizedlist>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>Cdrtools</application></title>

<note><para>Installation of <application>Cdrtools</application> will fail if raw kernel headers are 
found in <filename class='directory'>/usr/src/linux</filename> either as actual files or a symlink.
As of the Linux 2.6 kernel series, this directory should no longer exist because appropriate headers
were installed in the linux-libc-headers package during the base <acronym>LFS</acronym> installation.
</para></note>

<para>Install <application>Cdrtools</application> by running the following 
commands:</para>

<screen><userinput><command>make INS_BASE=/usr DEFINSUSR=root DEFINSGRP=root</command></userinput></screen>

<para>Now, as the root user:</para>

<screen><userinput role='root'><command>make INS_BASE=/usr DEFINSUSR=root DEFINSGRP=root install</command></userinput></screen>

</sect2>

<sect2>
<title>Command explanations</title>

<para><parameter>INS_BASE=/usr</parameter>: This parameter moves the install 
directory from <filename class="directory">/opt/schily</filename> to 
<filename class="directory">/usr</filename>.</para>

<para><parameter>DEFINSUSR=root DEFINSGRP=root</parameter>: These parameters 
install all programs with root:root ownership instead of the default 
bin:bin.</para>

</sect2>

<sect2>
<title>Contents</title>

<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>cdda2wav, cdrecord, devdump, isodebug, isodump, isoinfo, isovfy, 
mkhybrid, mkisofs, readcd, rscsi, scgcheck, skel</seg>
<seg>libdeflt.a, libedc_ecc.a, libfile.a, libhfs.a, libparanoia.a, librscg.a, 
libscg.a, libschily.a, libunls.a</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>

<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>

<varlistentry id="cdda2wav">
<term><command>cdda2wav</command></term>
<listitem><para>converts Compact Disc audio into <filename>WAV</filename> 
sound files.</para>
<indexterm zone="cdrtools cdda2wav">
<primary sortas="b-cdda2wav">cdda2wav</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="cdrecord">
<term><command>cdrecord</command></term>
<listitem><para>records audio or data Compact Discs.</para>
<indexterm zone="cdrtools cdrecord">
<primary sortas="b-cdrecord">cdrecord</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="devdump">
<term><command>devdump</command></term>
<listitem><para>is a diagnostic program used to dump an 
<acronym>ISO</acronym>-9660 device or file in hex.</para>
<indexterm zone="cdrtools devdump">
<primary sortas="b-devdump">devdump</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="isodebug">
<term><command>isodebug</command></term>
<listitem><para>is used to display the command-line parameters used to create 
an <acronym>ISO</acronym>-9660 image.</para>
<indexterm zone="cdrtools isodebug">
<primary sortas="b-isodebug">isodebug</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="isodump">
<term><command>isodump</command></term>
<listitem><para>is a diagnostic program used to dump a device or file based on 
<acronym>ISO</acronym>-9660.</para>
<indexterm zone="cdrtools isodump">
<primary sortas="b-isodump">isodump</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="isoinfo">
<term><command>isoinfo</command></term>
<listitem><para>is used to analyze or list an <acronym>ISO</acronym>-9660 
image.</para>
<indexterm zone="cdrtools isoinfo">
<primary sortas="b-isoinfo">isoinfo</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="isovfy">
<term><command>isovfy</command></term>
<listitem><para>is used to verify an <acronym>ISO</acronym>-9660 image.</para>
<indexterm zone="cdrtools isovfy">
<primary sortas="b-isovfy">isovfy</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="mkhybrid">
<term><command>mkhybrid</command></term>
<listitem><para>is a symbolic link to <command>mkisofs</command> used to 
create <acronym>ISO</acronym>-9660/<acronym>HFS</acronym> hybrid filesystem 
images.</para>
<indexterm zone="cdrtools mkhybrid">
<primary sortas="b-mkhybrid">mkhybrid</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="mkisofs">
<term><command>mkisofs</command></term>
<listitem><para>is used to create 
<acronym>ISO</acronym>-9660/JOLIET/HFS filesystem images, optionally with 
Rock Ridge attributes.</para>
<indexterm zone="cdrtools mkisofs">
<primary sortas="b-mkisofs">mkisofs</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="readcd">
<term><command>readcd</command></term>
<listitem><para>reads or writes Compact Discs.</para>
<indexterm zone="cdrtools readcd">
<primary sortas="b-readcd">readcd</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="rscsi">
<term><command>rscsi</command></term>
<listitem><para>is a remote <acronym>SCSI</acronym> manager.</para>
<indexterm zone="cdrtools rscsi">
<primary sortas="b-rscsi">rscsi</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="scgcheck">
<term><command>scgcheck</command></term>
<listitem><para>is used to check and verify the Application Binary Interface 
of <filename class="libraryfile">libscg</filename>.</para>
<indexterm zone="cdrtools scgcheck">
<primary sortas="b-scgcheck">scgcheck</primary></indexterm>
</listitem>
</varlistentry>

<varlistentry id="libscg">
<term><filename class='libraryfile'>libscg.a</filename></term>
<listitem><para>is a highly portable <acronym>SCSI</acronym> transport 
library.</para>
<indexterm zone="cdrtools libscg">
<primary sortas="c-libscg">libscg.a</primary></indexterm>
</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>