<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

    <!-- Inserted as a reminder to do this. The mention of a test suite
         is usually right before the root user installation commands. Please
         delete these 12 (including one blank) lines after you are done.-->

    <!-- Use one of the two mentions below about a test suite,
         delete the line that is not applicable. Of course, if the
         test suite uses syntax other than "make check", revise the
         line to reflect the actual syntax to run the test suite -->

    <!-- <para>This package does not come with a test suite.</para> -->
    <!-- <para>To test the results, issue: <command>make check</command>.</para> -->

  <!ENTITY udftools-download-http "&sourceforge-repo;/linux-udf/udftools-&udftools-version;.tar.gz">
  <!ENTITY udftools-download-ftp  " ">
  <!ENTITY udftools-md5sum        "2f491ddd63f31040797236fe18db9e60">
  <!ENTITY udftools-size          "287 KB">
  <!ENTITY udftools-buildsize     "3.5 MB">
  <!ENTITY udftools-time          "0.1 SBU">
]>

<sect1 id="udftools" xreflabel="UDFtools-&udftools-version;">
  <?dbhtml filename="udftools.html"?>

  <sect1info>
    <othername>$LastChangedBy: bdubbs $</othername>
    <date>$Date: 2012-05-12 19:05:19 -0400 (Sat, 12 May 2012) $</date>
  </sect1info>

  <title>UDFtools-&udftools-version;</title>

  <indexterm zone="udftools">
    <primary sortas="a-UDFTools">UDFtools</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to UDFtools</title>

    <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>

    &lfs65_built;

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Download (HTTP): <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>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing='compact'>
      <listitem>
        <para>Required patch: <ulink
        url="http://w1.894.telia.com/~u89404340/patches/packet/udftools-&udftools-version;.patch.bz2"/>
        </para>
        <para>Required patch: <ulink
        url="&patch-root;/udftools-&udftools-version;-fixes-1.patch"/></para>
      </listitem>
    </itemizedlist>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/udftools"/></para>

  </sect2>

  <sect2 id="udftools-kernel">
    <title>Kernel Configuration</title>

    <indexterm zone="udftools udftools-kernel">
      <primary sortas="d-UDF-File-System">UDF File System</primary>
    </indexterm>

    <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
CD-ROM/DVD Filesystems
    UDF file system support               Y or M</literal></screen>

    <para>Recompile and install the new kernel.</para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of UDFtools</title>

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

<screen><userinput>bzcat ../udftools-&udftools-version;.patch.bz2 | patch -Np1 &amp;&amp;
patch -Np1 -i ../udftools-&udftools-version;-fixes-1.patch &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

  <!-- <sect2 role="commands">
     <title>Command Explanations</title>

     <para><command>sed -i -e 's/(char\*)spm +=/spm = (char\*)spm +/'
     wrudf/wrudf.c</command>: This change is required to compile with
     recent compilers.</para>

  </sect2> -->

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Library</segtitle>
      <segtitle>Installed Directories</segtitle>

      <seglistitem>
        <seg>cdrwtool, mkudffs, pktsetup, udffsck, and wrudf</seg>
        <seg>libudffs.a</seg>
        <seg>None</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="cdrwtool">
        <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>

          <para>Example:</para>

<screen><userinput>cdrwtool -d /dev/scd0 -q</userinput></screen>

          <para>prepares a new CD-RW for use and
          formats it with a UDF file system.</para>
          <indexterm zone="udftools cdrwtool">
            <primary sortas="b-cdrwtool">cdrwtool</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="mkudffs">
        <term><command>mkudffs</command></term>
        <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>

      <varlistentry id="pktsetup">
        <term><command>pktsetup</command></term>
        <listitem>
          <para>is used to establish and break down associations between the
          kernel packet driver and a physical drive.</para>

          <para>Example:</para>

<screen><userinput>pktsetup /dev/pktcdvd0 /dev/scd0
mount /dev/pktcdvd0 /mnt/cdrom -t udf -o rw,noatime</userinput></screen>

          <para>associates the physical device <filename>/dev/scd0</filename>
          with the kernel packet driver <filename>/dev/pktcdvd0</filename>, then
          mounts a UDF formatted CD-RW for read/write access.</para>
          <indexterm zone="udftools pktsetup">
            <primary sortas="b-pktsetup">pktsetup</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <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>
