hfs

HFS(1)                       General Commands Manual                      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
       hfs part [ -a ]


DESCRIPTION
       hfs provides a command line interface to suite of functions for accessing
       Macintosh HFS floppy disks, hard drives and CD-ROMS. 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)

       - display the partition table on a Macintosh volume.

       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, hpart, hread and hcat.

       The current directory and volume name as detected by hfs are stored in a
       status file.  This allows hfs to maintain the current directory between
       invocations and to reset this directory whenever the volume is changed.

       hfs defaults to using the A: floppy drive. This can be overridden by
       specifying a filename or device via the HFS_DEVICE environment variable
       or the -d command line option. The format of device names differs
       depending upon the operating system.  Regardless of the operating system,
       the special device names A: and B: map to the two floppy drives. The
       devices used are /dev/fd0H1440 and /dev/fd1H1440 for Linux, A: and B: for
       MS-DOS, \\.\A: and \\.\B: for Windows NT, and /dev/rfd0.1440 and
       /dev/rfd1.1440 for FreeBSD.

       Note that the device used by does not have to be floppy drive. It can
       just as easily be the name of the CD-ROM device, a normal file or any
       other accessible device. For instance, to access a CD-ROM, set the device
       to /dev/sr0 (Linux) or to F: (say) for MS-DOS.

       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.37


PARTITIONS
       hfs can access standard Macintosh partitioned media. Normally the first
       HFS partition on the device will be used. If more than one HFS partition
       exists, then the first partition will still be used, but a warning
       message will be printed every time hfs is invoked. If the HFS_PARTITION
       environment variable or the -p option is used to specify the partition
       number, then this warning is supressed. If the partition specified, but
       is not an HFS partition, then a warning message will be displayed and the
       the first HFS partition following will be used.

       Use the command hfs part to display all of the HFS partitions on a
       device. The -a option can be used to display all partitions regardless of
       type.



OPTIONS
       -a     display all files, including invisible ones. For the part command,
              display all partition table entries.

       -d filename
              use filename as the HFS device. Note that this may be a real file,
              or a device.

       -l     display file information in long format

       -p number
              Use the specified partition number on the current device. This
              overrides the value (if any) of the HFS_PARTITION environment
              variable.

       -t     convert Macintosh end-of-line characters (linefeeds) to the
              end-of-line sequence appropriate for the host operating system,
              and convert Macintosh characters to the ISO Latin1 character set.

       -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.

       HFS_PARTITION  Specifies the number of the partition to use on Macintosh
                      partitioned devices.

       HFS_STATUSFILE Gives the path and name of the status file used to detect
                      volume changes and the hold the current directory between
                      invocations.

       TEMP           For MS-DOS and NT, specifies the directory to store the
                      status file


FILES
       ~/.macdir      Default status file for Unix systems

       ./macdir.sts   Default status file for MSDOS and NT systems if no TEMP
                      environment variable set.

       $(TEMP)/.macdir.sts
                      Default status file for MSDOS and NT systems if TEMP
                      environment variable is set.

       /dev/fd0H1440, /dev/fd1H1440
                      Floppy disk devices for Linux

       /dev/rfd0.1440, /dev/rfd1.1440
                      Floppy disk devices for FreeBSD

       \\.\A:, \\.\B: Floppy disk devices for Windows/NT


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 hread
       command, but not for any other commands. This would be especially useful
       when entering ISO Latin1 filenames.

       The usage messages need more work.

       There is no support for the AppleDouble format.

       There is no support for MFS disks, and there is probably no need to as
       there will never be any support for 800K disks.


CREDITS
       hfs was originally written by Craig Southeren
       (craigs@ineluki.apana.org.au).

       MS-DOS/Windows/NT code, extensive testing and debugging, and C++ coaching
       by Robert Jongbloed.

       Thanks to Jean-Marc Zucconi (jmz@cabri.obs-besancon.fr) for the code and
       help in getting partitioned drives and CD-ROMS working, and for the idea
       of ISO Latin1 conversion.

       Thanks to Rich Murphey (rich@lamprey.utmb.edu) for the FreeBSD patches.




                                  26 June 1994                            HFS(1)