Tagged udftools.xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4069 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Manuel Canales Esparcia 2005-05-09 17:50:50 +00:00
parent 929f6f73d9
commit 47b58ecf07

View File

@ -1,3 +1,4 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
<!ENTITY % general-entities SYSTEM "../../general.ent"> <!ENTITY % general-entities SYSTEM "../../general.ent">
@ -12,85 +13,93 @@
]> ]>
<sect1 id="udftools" xreflabel="UDFtools-&udftools-version;"> <sect1 id="udftools" xreflabel="UDFtools-&udftools-version;">
<sect1info> <?dbhtml filename="udftools.html"?>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="udftools.html"?>
<title>UDFtools-&udftools-version;</title>
<indexterm zone="udftools">
<primary sortas="a-UDFTools">UDFtools</primary></indexterm>
<sect2> <sect1info>
<title>Introduction to <othername>$LastChangedBy$</othername>
<application><acronym>UDF</acronym>tools</application></title> <date>$Date$</date>
</sect1info>
<para>The <application><acronym>UDF</acronym>tools</application> package <title>UDFtools-&udftools-version;</title>
contains utilities for creating and mounting
<acronym>CD</acronym>-<acronym>RW</acronym> disks with
<acronym>UDF</acronym> file systems for both
reading and writing. <acronym>UDF</acronym> files systems are used on
both <acronym>CD</acronym>-<acronym>RW</acronym> media and
on <acronym>DVD</acronym>. For more details of the
<acronym>UDF</acronym> file system standard see:
<ulink url="http://www.osta.org"/> and
<ulink url="http://www.ecma-international.org"/>.</para>
<sect3><title>Package information</title> <indexterm zone="udftools">
<itemizedlist spacing='compact'> <primary sortas="a-UDFTools">UDFtools</primary>
<listitem><para>Download (HTTP): </indexterm>
<ulink url="&udftools-download-http;"/></para></listitem>
<listitem><para>Download (FTP):
<ulink url="&udftools-download-ftp;"/></para></listitem>
<listitem><para>Download MD5 sum:
&udftools-md5sum;</para></listitem>
<listitem><para>Download size:
&udftools-size;</para></listitem>
<listitem><para>Estimated disk space required:
&udftools-buildsize;</para></listitem>
<listitem><para>Estimated build time:
&udftools-time;</para></listitem></itemizedlist>
</sect3>
<sect3><title>Additional downloads</title> <sect2 role="package">
<itemizedlist spacing='compact'> <title>Introduction to UDFtools</title>
<listitem><para>Required patch: <ulink
url="http://w1.894.telia.com/~u89404340/patches/packet/2.6/packet-2.6.8-2.patch.bz2"/></para>
</listitem>
<listitem><para>Required patch: <ulink
url="http://w1.894.telia.com/~u89404340/patches/packet/udftools-1.0.0b3.patch.bz2"/></para>
</listitem>
</itemizedlist></sect3>
</sect2> <para>The <application>UDFtools</application> package contains utilities
for creating and mounting CD-RW disks with UDF file systems for both
reading and writing. UDF files systems are used on both CD-RW media and
on DVD. For more details of the UDF file system standard see:
<ulink url="http://www.osta.org"/> and
<ulink url="http://www.ecma-international.org"/>.</para>
<sect2 id="udftools-kernel"> <bridgehead renderas="sect3">Package Information</bridgehead>
<title>Installation of the kernel patch</title> <itemizedlist spacing="compact">
<indexterm zone="udftools udftools-kernel"> <listitem>
<primary sortas="d-UDF-File-System">UDF File System</primary> <para>Download (HTTP): <ulink url="&udftools-download-http;"/></para>
</indexterm> </listitem>
<listitem>
<para>Download (FTP): <ulink url="&udftools-download-ftp;"/></para>
</listitem>
<listitem>
<para>Download MD5 sum: &udftools-md5sum;</para>
</listitem>
<listitem>
<para>Download size: &udftools-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &udftools-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &udftools-time;</para>
</listitem>
</itemizedlist>
<warning> <bridgehead renderas="sect3">Additional Downloads</bridgehead>
<para>Note that this patch can permanently damage your <acronym>CD</acronym> <itemizedlist spacing='compact'>
drive if it is from one of the few mentioned at <listitem>
<ulink url="http://slashdot.org/article.pl?sid=03/10/25/1737244"/>. Do <para>Required patch: <ulink
not apply the patch without first checking out the article.</para> url="http://w1.894.telia.com/~u89404340/patches/packet/2.6/packet-2.6.8-2.patch.bz2"/></para>
</warning> </listitem>
<listitem>
<para>Required patch: <ulink
url="http://w1.894.telia.com/~u89404340/patches/packet/udftools-1.0.0b3.patch.bz2"/></para>
</listitem>
</itemizedlist>
<para>Install the kernel patch by running the following commands from </sect2>
the kernel source directory:</para>
<screen><userinput><command>bzcat ../packet-2.6.8-2.patch.bz2 |patch -Np1</command></userinput></screen> <sect2 id="udftools-kernel">
<title>Installation of the Kernel Patch</title>
<para>In the kernel configuration, modify your settings to match those listed <indexterm zone="udftools udftools-kernel">
here:</para> <primary sortas="d-UDF-File-System">UDF File System</primary>
</indexterm>
<screen>Block devices <warning>
<para>Note that this patch can permanently damage your CD
drive if it is from one of the few mentioned at
<ulink url="http://slashdot.org/article.pl?sid=03/10/25/1737244"/>. Do
not apply the patch without first checking out the article.</para>
</warning>
<para>Install the kernel patch by running the following commands from
the kernel source directory:</para>
<screen><userinput>bzcat ../packet-2.6.8-2.patch.bz2 | patch -Np1</userinput></screen>
<para>In the kernel configuration, modify your settings to match those listed
here:</para>
<screen><literal>Block devices
Packet writing on CD/DVD media: Y or M Packet writing on CD/DVD media: Y or M
CD-ROM/DVD Filesystems CD-ROM/DVD Filesystems
UDF file system support Y or M</screen> UDF file system support Y or M</literal></screen>
<para>Recompile and install the new kernel.</para> <para>Recompile and install the new kernel.</para>
<!-- <!--
<para>If you built packet writer as a module, add the following to <para>If you built packet writer as a module, add the following to
@ -100,122 +109,134 @@ CD-ROM/DVD Filesystems
<para>Finally, create the packet driver device nodes in <filename <para>Finally, create the packet driver device nodes in <filename
class="directory">/dev</filename>, add one node for every class="directory">/dev</filename>, add one node for every
<acronym>CD</acronym>-<acronym>RW</acronym> drive you CD-RW drive you
want to support:</para> want to support:</para>
<screen><userinput><command>mknod /dev/pktcdvd0 b 97 0 <screen><userinput><command>mknod /dev/pktcdvd0 b 97 0
mknod /dev/pktcdvd1 b 97 1</command></userinput></screen> mknod /dev/pktcdvd1 b 97 1</command></userinput></screen>
--> -->
</sect2> </sect2>
<sect2> <sect2 role="installation">
<title>Installation of <title>Installation of UDFtools</title>
<application><acronym>UDF</acronym>tools</application></title>
<para>Install <application><acronym>UDF</acronym>tools</application> by <para>Install <application>UDFtools</application> by
running the following commands:</para> running the following commands:</para>
<screen><userinput><command>bzcat ../udftools-1.0.0b3.patch.bz2 |patch -Np1 &amp;&amp; <screen><userinput>bzcat ../udftools-1.0.0b3.patch.bz2 | patch -Np1 &amp;&amp;
./configure --prefix=/usr &amp;&amp; ./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen> make</userinput></screen>
<para>Now, as the root user:</para> <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen><userinput role='root'><command>make install</command></userinput></screen> <screen role="root"><userinput>make install</userinput></screen>
</sect2> </sect2>
<sect2> <sect2 role="content">
<title>Contents</title> <title>Contents</title>
<segmentedlist> <segmentedlist>
<segtitle>Installed Programs</segtitle> <segtitle>Installed Programs</segtitle>
<segtitle>Installed Library</segtitle> <segtitle>Installed Library</segtitle>
<segtitle>Installed Directories</segtitle> <segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>cdrwtool, mkudffs, pktsetup, udffsck and wrudf</seg>
<seg>libudffs.a</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<variablelist> <seglistitem>
<bridgehead renderas="sect3">Short Descriptions</bridgehead> <seg>cdrwtool, mkudffs, pktsetup, udffsck, and wrudf</seg>
<?dbfo list-presentation="list"?> <seg>libudffs.a</seg>
<seg>None</seg>
</seglistitem>
</segmentedlist>
<varlistentry id="cdrwtool"> <variablelist>
<term><command>cdrwtool</command></term> <bridgehead renderas="sect3">Short Descriptions</bridgehead>
<listitem><para> provides facilities to manage <?dbfo list-presentation="list"?>
<acronym>CD</acronym>-<acronym>RW</acronym> drives, including formatting <?dbhtml list-presentation="table"?>
new disks, setting the read and write speeds, etc.</para>
<para>Example: <varlistentry id="cdrwtool">
<screen><command>cdrwtool -d /dev/scd0 -q</command></screen> <term><command>cdrwtool</command></term>
<listitem>
<para> provides facilities to manage CD-RW drives, including formatting
new disks, setting the read and write speeds, etc.</para>
prepares a new <acronym>CD</acronym>-<acronym>RW</acronym> for use and <para>Example:</para>
formats it with a <acronym>UDF</acronym> file system.</para>
<indexterm zone="udftools cdrwtool">
<primary sortas="b-cdrwtool">cdrwtool</primary></indexterm>
</listitem>
</varlistentry>
<varlistentry id="mkudffs"> <screen><userinput>cdrwtool -d /dev/scd0 -q</userinput></screen>
<term><command>mkudffs</command></term>
<listitem><para>is used to create new <acronym>UDF</acronym> file systems.
It can be used on hard disks and <acronym>CD</acronym>-Rs as well as
<acronym>CD</acronym>-<acronym>RW</acronym>s.</para>
<indexterm zone="udftools mkudffs">
<primary sortas="b-mkudffs">mkudffs</primary></indexterm>
</listitem>
</varlistentry>
<varlistentry id="pktsetup"> <para>prepares a new CD-RW for use and
<term><command>pktsetup</command></term> formats it with a UDF file system.</para>
<listitem><para>is used to establish and break down associations between the <indexterm zone="udftools cdrwtool">
kernel packet driver and a physical drive.</para> <primary sortas="b-cdrwtool">cdrwtool</primary>
</indexterm>
</listitem>
</varlistentry>
<para>Example: <varlistentry id="mkudffs">
<screen><command>pktsetup /dev/pktcdvd0 /dev/scd0 <term><command>mkudffs</command></term>
mount /dev/pktcdvd0 /mnt/cdrom -t udf -o rw,noatime</command></screen> <listitem>
<para>is used to create new UDF file systems. It can be used on
hard disks and CD-Rs as well as CD-RWs.</para>
<indexterm zone="udftools mkudffs">
<primary sortas="b-mkudffs">mkudffs</primary>
</indexterm>
</listitem>
</varlistentry>
associates the physical device <filename>/dev/scd0</filename> with the <varlistentry id="pktsetup">
kernel packet driver <filename>/dev/pktcdvd0</filename>, then mounts a <term><command>pktsetup</command></term>
<acronym>UDF</acronym> formatted <acronym>CD</acronym>-<acronym>RW</acronym> <listitem>
for read/write access.</para> <para>is used to establish and break down associations between the
<indexterm zone="udftools pktsetup"> kernel packet driver and a physical drive.</para>
<primary sortas="b-pktsetup">pktsetup</primary></indexterm>
</listitem>
</varlistentry>
<varlistentry id="udffsck"> <para>Example:</para>
<term><command>udffsck</command></term>
<listitem><para>is used to check the integrity and correct errors on
<acronym>UDF</acronym> filesystems.</para>
<indexterm zone="udftools udffsck">
<primary sortas="b-udffsck">udffsck</primary></indexterm>
</listitem>
</varlistentry>
<varlistentry id="wrudf"> <screen><userinput>pktsetup /dev/pktcdvd0 /dev/scd0
<term><command>wrudf</command></term> mount /dev/pktcdvd0 /mnt/cdrom -t udf -o rw,noatime</userinput></screen>
<listitem><para>is used to maintain a <acronym>UDF</acronym> filing
system.</para>
<indexterm zone="udftools wrudf">
<primary sortas="b-wrudf">wrudf</primary></indexterm>
</listitem>
</varlistentry>
<varlistentry id="libudffs"> <para>associates the physical device <filename>/dev/scd0</filename>
<term><filename class='libraryfile'>libudffs.a</filename></term> with the kernel packet driver <filename>/dev/pktcdvd0</filename>, then
<listitem><para>contains functions used by the mounts a UDF formatted CD-RW for read/write access.</para>
<application>UDFtools</application> programs.</para> <indexterm zone="udftools pktsetup">
<indexterm zone="udftools libudffs"> <primary sortas="b-pktsetup">pktsetup</primary>
<primary sortas="c-libudffs">libudffs.a</primary></indexterm> </indexterm>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist>
</sect2> <varlistentry id="udffsck">
<term><command>udffsck</command></term>
<listitem>
<para>is used to check the integrity and correct errors on
UDF filesystems.</para>
<indexterm zone="udftools udffsck">
<primary sortas="b-udffsck">udffsck</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="wrudf">
<term><command>wrudf</command></term>
<listitem>
<para>is used to maintain a UDF filesystem.</para>
<indexterm zone="udftools wrudf">
<primary sortas="b-wrudf">wrudf</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libudffs">
<term><filename class='libraryfile'>libudffs.a</filename></term>
<listitem>
<para>contains functions used by the
<application>UDFtools</application> programs.</para>
<indexterm zone="udftools libudffs">
<primary sortas="c-libudffs">libudffs.a</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1> </sect1>