NAME

       hcopy - copy files from or to an HFS volume

SYNOPSIS

       hcopy [-m|-b|-t|-r|-a] source-path [...]  target-path

DESCRIPTION

       hcopy  transfers files from an HFS volume to UNIX or vice versa. The named source files are copied to the
       named destination target, which must be a directory if multiple files are to be copied.

       Copies are performed using a translation mode, which must be one of:

       -m     MacBinary II: A popular format for binary file transfer. Both forks  of  the  Macintosh  file  are
              preserved. This is the recommended mode for transferring arbitrary Macintosh files.

       -b     BinHex:  An  alternative  format  for  ASCII  file  transfer. Both forks of the Macintosh file are
              preserved.

       -t     Text: Performs end-of-line translation. Only the data fork of the Macintosh file is copied.

       -r     Raw Data: Performs no translation. Only the data fork of the Macintosh file is copied.

       -a     Automatic: A mode will be chosen automatically  for  each  file  based  on  a  set  of  predefined
              heuristics.

       If no mode is specified, -a is assumed.

       If  a  UNIX source pathname is specified as a single dash (-), hcopy will copy from standard input to the
       HFS destination. Likewise, a single dash used as a UNIX destination pathname will cause hcopy to copy the
       HFS source to standard output.

NOTES

       Copied  files  may  have  their  filenames  altered  during translation. For example, an appropriate file
       extension may be added or removed, and certain other characters may also be transliterated.

       The destination target must not be ambiguous; that is, it must be obvious whether the target  is  on  the
       UNIX  filesystem or on an HFS volume. As a rule, HFS targets must contain at least one colon (:), usually
       as the beginning of a relative pathname or by itself to represent the current working directory. To  make
       a  UNIX target unambiguous, either use an absolute pathname or precede a relative pathname with a dot and
       slash (./).

SEE ALSO

       hfsutils(1), hls(1), hattrib(1)

AUTHOR

       Robert Leslie <rob@mars.org>