NAME

       hfs - shell for manipulating HFS volumes

SYNOPSIS

       hfs [hfs-path [partition-no]]

DESCRIPTION

       hfs is an interactive command-oriented tool for manipulating HFS volumes.  hfs is based on
       the Tcl interpreter, so basic Tcl constructs can be used  in  addition  to  the  following
       commands:

       mount path [partition-no]
              The  specified  UNIX  path  is  opened as an HFS volume. If a partition number n is
              specified and the volume source  is  located  on  a  partitioned  medium,  the  nth
              discovered HFS partition will be mounted. The default partition-no is 1.

       umount [path]
              The  volume  previously  mounted from the specified path (or the current volume, if
              none specified) is unmounted.

       vol path
              The volume previously mounted from the specified path is made current.

       info   General  information  about  the  currently  mounted  volume  is  displayed.   This
              information is also displayed automatically when the volume is mounted.

       pwd    The full path to the current working HFS directory is displayed.

       cd [hfs-path]
              The  current  working  directory  is  changed  to the given HFS path. If no path is
              given, the working directory is changed to the root of the volume.

       dir [hfs-path]
              A directory listing of the specified HFS directory is  displayed.  If  no  path  is
              given, the contents of the current working directory are shown.

       mkdir hfs-path
              A new, empty directory is created with the specified path.

       rmdir hfs-path
              The specified directory is removed. It must be empty.

       create hfs-path [type [creator]]
              An  empty  file  is created with the specified path. The Macintosh type and creator
              may be specified, or they will default to TEXT and UNIX, respectively.

       del hfs-path
              Both forks of the specified file are deleted.

       stat hfs-path
              Status information about the specified HFS path-identified entity is displayed.

       cat hfs-path
              The data fork of the specified HFS file is displayed.

       copyin unix-path [hfs-path [mode]]
              The specified UNIX file is  copied  to  the  named  HFS  destination  path.  Unless
              specified otherwise, the file will be copied into the current HFS working directory
              using a heuristically chosen mode. The mode may be one  of:  macb  (MacBinary  II),
              binh (BinHex), text, or raw.

       copyout hfs-path [unix-path [mode]]
              The  specified  HFS  file  is  copied  into the named UNIX destination path. Unless
              specified otherwise, the  file  will  be  copied  into  the  current  UNIX  working
              directory using a heuristically chosen mode. The modes are the same as for copyin.

       format path [partition-no [volume-name]]
              The  specified UNIX path is initialized as an empty HFS volume with the given name,
              and this volume is subsequently mounted. The default volume name is Untitled.

       The shell is scriptable, however it should be  understood  that  the  above  commands  are
       actually  implemented by Tcl procedures prefixed with the character "h", e.g. hmount, hcd,
       etc., in order to avoid name collisions with other Tcl utilities. The "h" may  be  omitted
       in interactive use for convenience.

SEE ALSO

       hfsutils(1), xhfs(1)

BUGS

       cat  can  only  display  the  data  fork  of  a  file.  Text  translations  are  performed
       unconditionally on the output. Furthermore, binary data cannot be  handled  properly  from
       within  Tcl scripts since the character with value 0 cannot be represented in Tcl strings.
       Use copyout to copy files without these limitations.

AUTHOR

       Robert Leslie <rob@mars.org>