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:
R 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
R BinHex :
An alternative format for ASCII file transfer. Both forks of the Macintosh
file are preserved.
R Text :
Performs end-of-line translation. Only the data fork of the Macintosh file is
R Raw Data :
Performs no translation. Only the data fork of the Macintosh file is copied.
R Automatic :
A mode will be chosen automatically for each file based on a set of predefined
If no mode is specified, -a is assumed.
If a UNIX source pathname is specified as a single dash (-),
will copy from standard input to the HFS destination. Likewise, a single dash
used as a UNIX destination pathname will cause
to copy the HFS source to standard output.
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 (./).