NAME
hfsutils - tools for reading and writing Macintosh HFS volumes
SYNOPSIS
hattrib - change HFS file or directory attributes
hcd - change working HFS directory
hcopy - copy files from or to an HFS volume
hdel - delete both forks of an HFS file
hdir - display an HFS directory in long format
hformat - create a new HFS filesystem and make it current
hls - list files in an HFS directory
hmkdir - create a new HFS directory
hmount - introduce a new HFS volume and make it current
hpwd - print the full path to the current HFS working directory
hrename - rename or move an HFS file or directory
hrmdir - remove an empty HFS directory
humount - remove an HFS volume from the list of known volumes
hvol - display or change the current HFS volume
hfssh - Tcl interpreter with HFS extensions
hfs - shell for manipulating HFS volumes
xhfs - graphical interface for manipulating HFS volumes
DESCRIPTION
hfsutils is a collection of tools and programs for accessing Macintosh
HFS-formatted volumes. See the accompanying man page for each program
above for more information.
NOTES
These utilities can manipulate HFS volumes on nearly any medium. A UNIX
path is initially specified to hmount or hformat which gives the
location of the volume. This path can be a block device --
corresponding to, for example, a floppy disk, CD-ROM, SCSI disk, or
other device -- or it can be a regular file containing an image of any
of the above.
The medium specified by the UNIX path may or may not contain an Apple
partition map. If partitioned, it is possible for more than one HFS
volume to be present on the medium. In this case, a partition number
must also be given which selects the desired partition. This number
refers to the nth ordinal HFS partition on the volume. (Other, non-HFS
partitions are ignored.) Partition number 0 refers to the entire
medium, disregarding the partition map, if any.
HFS pathnames consist of colon-separated components. Unlike UNIX
pathnames, an HFS path which begins with a colon (e.g. :Foo:Bar) is a
relative path, and one which does not (e.g. Foo:Bar) is an absolute
path. As sole exception to this rule, a path not containing any colons
is assumed to be relative.
Absolute pathnames always begin with the name of the volume itself. Any
occurrence of two or more consecutive colons in a path causes
resolution of the path to ascend into parent directories.
Most of the command-line programs support HFS filename globbing. The
following forms of globbing are supported:
* matches zero or more characters.
? matches exactly one character.
[...] matches any single character enclosed within the brackets. A
character range may be specified by using a hypen (-). Note that
matches are not case sensitive.
{...,...}
expands into the Cartesian product of each specified substring.
\ causes the following character to be matched literally.
Note that since globbing is performed by each HFS command rather than
by the UNIX shell (which knows nothing about HFS volumes), care should
always be taken to protect pathnames from the shell by using an
appropriate quoting technique. Typically it is best to surround HFS
pathnames containing glob characters with single quotes (’).
Time stamps on HFS volumes are interpreted as being relative to the
current time zone. This means that modification dates on HFS volumes
written in another time zone may appear to be off by some number of
hours.
Hardware limitations prevent some systems from reading or writing
native Macintosh 800K floppy disks; only high-density 1440K disks can
be used on these systems.
The obsolete MFS volume format is not supported by this software.
SEE ALSO
hattrib(1), hcd(1), hcopy(1), hdel(1), hdir(1), hformat(1), hls(1),
hmkdir(1), hmount(1), hpwd(1), hrename(1), hrmdir(1), hvol(1), hfs(1),
xhfs(1)
AUTHOR
Robert Leslie <rob@mars.org>