hfs



HFS(1)                                                                  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 vol-
       umes.  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 parti-
              tion 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  dis-
              played.  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  direc-
              tory 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 (Bin-
              Hex), 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 colli-
       sions 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  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)

Man(1) output converted with man2html