NAME

       hmount - introduce a new HFS volume and make it current

SYNOPSIS

       hmount source-path [partition-no]

DESCRIPTION

       hmount  is used to introduce a new HFS volume. A UNIX pathname to the volume's source must
       be specified. The source may be a block device or a regular file containing an HFS  volume
       image.

       If  the  source  medium  is  partitioned, one partition must be selected to be mounted. If
       there is only one HFS partition on the medium, it will be selected by default.  Otherwise,
       the  desired  partition number must be specified (as the ordinal nth HFS partition) on the
       command-line. Partition number 0 can be specified to refer to the entire medium,  ignoring
       what  might  otherwise  be  perceived  as  a  partition  map, although in practice this is
       probably only useful if you want this command to fail when the medium is partitioned.

       The mounted volume becomes "current" so subsequent commands will refer to it.  The current
       working  directory  for  the volume is set to the root of the volume.  This information is
       kept in a file named .hcwd in the user's home directory.

       If the source medium is changed (e.g. floppy or CD-ROM disc exchanged)  after  hmount  has
       been  called, subsequent HFS commands will fail until the original medium is replaced or a
       different volume is made current. To use the same source path with the  different  medium,
       reissue the hmount command.

EXAMPLES

       % hmount /dev/fd0
              If  a Macintosh floppy disk is available as /dev/fd0, this command makes the floppy
              current for other HFS commands such as hls(1), hcd(1), hcopy(1), etc.

       % hmount /dev/sd2 1
              If a SCSI disk is available as /dev/sd2, this command finds the first HFS partition
              on the medium and makes it available for other HFS operations.

NOTES

       hmount  does  not actually mount an HFS partition over a UNIX directory in the traditional
       mount(8) sense. It is merely a "virtual" mount, as a point of convenience for  future  HFS
       operations. Each HFS command independently opens, operates on, and closes the named source
       path given to hmount.

SEE ALSO

       hfsutils(1), hformat(1), humount(1), hvol(1)

FILES

       $HOME/.hcwd

AUTHOR

       Robert Leslie <rob@mars.org>