source: BOOK/final-system/ppc/hfsutils.xml@ 8633cac

<?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;
]>

<sect1 id="ch-system-hfsutils" role="wrap">
  <?dbhtml filename="hfsutils.html"?>

  <title>Hfsutils-&hfsutils-version;</title>

  <indexterm zone="ch-system-hfsutils">
    <primary sortas="a-Hfsutils">Hfsutils</primary>
  </indexterm>

  <sect2 role="package">
    <title/>

    <para>The Hfsutils package contains a number of utilities for accessing
    files on <systemitem class="filesystem">hfs</systemitem> filesystems.
    It is needed to run <command>ybin</command>.</para>

  </sect2>

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

    <para os="p1">Apply the following patch to add a missing
    <filename>errno.h</filename> include and allow HFSutils to recognize
    devices larger than 2GB:</para>

<screen os="p2"><userinput>patch -Np1 -i ../&hfsutils-fixes-patch;</userinput></screen>

    <para os="a">Prepare Hfsutils for compilation:</para>

<screen><userinput>./configure \
    --prefix=/usr \
    --mandir=/usr/share/man</userinput></screen>

    <para os="c">Compile the package:</para>

<screen os="d"><userinput>make</userinput></screen>

    <para os="e">Install the package:</para>

<screen os="f"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 id="contents-hfsutils" role="content">
    <title>Contents of Hfsutils</title>

    <segmentedlist>
      <segtitle>Installed programs</segtitle>

      <seglistitem>
        <seg>hattrib, hcd, hcopy, hdel, hdir, hfsutils, hformat, hls, hmkdir,
        hmount, hpwd, hrename, hrmdir, humount, hvol (these are all hardlinks
        to hfsutils).</seg>
      </seglistitem>
    </segmentedlist>

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

      <varlistentry id="hattrib">
        <term><command>hattrib</command></term>
        <listitem>
          <para>Change FS file or directory attributes.</para>
          <indexterm zone="ch-system-hfsutils hattrib">
            <primary sortas="b-hattrib">hattrib</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hcd">
        <term><command>hcd</command></term>
        <listitem>
          <para>Change working HFS directory.</para>
          <indexterm zone="ch-system-hfsutils hcd">
            <primary sortas="b-hcd">hcd</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hcopy">
        <term><command>hcopy</command></term>
        <listitem>
          <para>Copy files to or from an HFS volume.</para>
          <indexterm zone="ch-system-hfsutils hcopy">
            <primary sortas="b-hcopy">hcopy</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hdel">
        <term><command>hdel</command></term>
        <listitem>
          <para>Delete both forks of an HFS file.</para>
          <indexterm zone="ch-system-hfsutils hdel">
            <primary sortas="b-hdel">hdel</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hdir">
        <term><command>hdir</command></term>
        <listitem>
          <para>Display an HFS directory in long format.</para>
          <indexterm zone="ch-system-hfsutils hdir">
            <primary sortas="b-hdir">hdir</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hformat">
        <term><command>hformat</command></term>
        <listitem>
          <para>Create a new HFS filesystem and make it current.</para>
          <indexterm zone="ch-system-hfsutils hformat">
            <primary sortas="b-hformat">hformat</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hfsutils">
        <term><command>hfsutils</command></term>
        <listitem>
          <para>Tools for accessing Macintosh HFS-formatted volumes.</para>
          <indexterm zone="ch-system-hfsutils hfsutils">
            <primary sortas="b-hfsutils">hfsutils</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hls">
        <term><command>hls</command></term>
        <listitem>
          <para>List files in an HFS directory.</para>
          <indexterm zone="ch-system-hfsutils hls">
            <primary sortas="b-hls">hls</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hmkdir">
        <term><command>hmkdir</command></term>
        <listitem>
          <para>Create a new HFS directory.</para>
          <indexterm zone="ch-system-hfsutils hmkdir">
            <primary sortas="b-hmkdir">hmkdir</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hmount">
        <term><command>hmount</command></term>
        <listitem>
          <para>Introduce a new HFS volume and make it current.</para>
          <indexterm zone="ch-system-hfsutils hmount">
            <primary sortas="b-hmount">hmount</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hpwd">
        <term><command>hpwd</command></term>
        <listitem>
          <para>Print the full path to the current HFS working directory.</para>
          <indexterm zone="ch-system-hfsutils hpwd">
            <primary sortas="b-hpwd">hpwd</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hrename">
        <term><command>hrename</command></term>
        <listitem>
          <para>Rename or move an HFS file or directory.</para>
          <indexterm zone="ch-system-hfsutils hrename">
            <primary sortas="b-hrename">hrename</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hrmdir">
        <term><command>hrmdir</command></term>
        <listitem>
          <para>Remaove an empty HFS directory.</para>
          <indexterm zone="ch-system-hfsutils hrmdir">
            <primary sortas="b-hrmdir">hrmdir</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="humount">
        <term><command>humount</command></term>
        <listitem>
          <para>Remove an HFS volume from the list of known volumes.</para>
          <indexterm zone="ch-system-hfsutils humount">
            <primary sortas="b-humount">humount</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="hvol">
        <term><command>hvol</command></term>
        <listitem>
          <para>Display or change the current HFS volume.</para>
          <indexterm zone="ch-system-hfsutils hvol">
            <primary sortas="b-hvol">hvol</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>