HFS(1)                                                        General Commands Manual                                                       HFS(1)

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  par-
              titioned 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 vol-
              ume 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  interac-
       tive 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 can-
       not 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>

HFSUTILS                                                            15-Jan-1997                                                             HFS(1)