HFS(1)

NAME
hfs - program for accessing Macintosh HFS floppy disks

SYNOPSIS
hfs ls [ -laR ] filespec
hfs dir filespec
hfs cd directory
hfs pwd
hfs read [ -tMR ] hfsspec ... native_file
hfs cat [ -txR ] filename

DESCRIPTION
hfs provides a command line interface to suite of functions for accessing Macintosh HFS floppy disks. The following functions are available:

- display a directory listing (ls, dir)

- change directories (cd)

- display the name of the current directory (pwd)

- copy an HFS file into a local file (read)

- display the contents of an HFS file (cat)

Functions may be invoked by specifiying the function name
    on the command line followed by any parameters. Alternatively, the executable can be copied or linked to an alternate name which can then be used to invoke the function directly. The alternate names recognised by hfs are hls, hdir, hcd, hpwd, hread and hcat. hfs defaults to using the device /dev/fd0H1440 to access the floppy drive. This can be overridden by setting the environment variable HFS_DEVICE to the name of an alternate file or device. The special names A: and B: are synonyms for the devices /dev/fd0H1440 and /dev/fd1H1440 respectively. All paths specified on the HFS volume assume that the colon (":") character is the directory separator character. The dot (".") character may be used to indicate the current directory, and the double-dot ("..") sequence may be used to indicate the parent directory. Filename globbing accepts the standard Unix wildcard conventions. The current version of hfstools is 0.30

OPTIONS

-a  display all files, including invisible ones

-l  display file information in long format

-t  convert Macintosh end-of-line characters (linefeeds) to the end-of-line sequence appropriate for the host operating system.

-x  display the file in hex.

-R  for the ls command, display sub directories recursively. For the read and cat commands, use the resource fork rather than the data fork.

-M  Do not attempt to mangle the filenames to be legal for the native operating system.

ENVIRONMENT

HFS_DEVICE
    Specifies the name of the device used to access the floppy drive.

BUGS
No functions for writing to the disk at the file level have yet been implemented. Wildcard expansion of HFS filenames has been implemented for the command, but not for the hls command. The usage messages need more work. There is no support for the AppleDouble format. There is no support for media other than standard 1.4 Mbyte floppy disks, although there is no reason why this could not be added. There is no support for MFS disks. There is no support for 800K disks, as this is not possible with the vast majority of floppy disk hardware.