This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

APPLESINGLE(1)            BSD General Commands Manual           APPLESINGLE(1)

NAME
     applesingle, binhex, macbinary -- encode and decode files

SYNOPSIS
     <tool> probe file ...
     <tool> [decode] [-c] [-fv] [-C dir] [-o outfile] [file ...]
     <tool> -h | -V

     applesingle encode [-cfv] [-S suf] [-C dir] [-o outfile] file ...
     binhex encode [-R] [-cfv] [-S suf] [-C dir] [-o outfile] file ...
     macbinary encode [-t 1-3] [-cfv] [-S suf] [-C dir] [-o outfile] file ...

DESCRIPTION
     applesingle, binhex, macbinary are implemented as a single tool with multiple names.  All invocations
     support the three verbs encode, decode, and probe.

     If multiple files are passed to probe, the exit status will be non-zero only if all files contain data
     in the specified encoding.

OPTIONS
     -f, --force
              perform the operation even if the output file already exists

     -h, --help
              display version and usage, then quit

     -v, --verbose
              be verbose

     -V, --version
              display version, then quit

     -c, --pipe, --from-stdin, --to-stdout
              For decode, read encoded data from the standand input.  For encode, write encoded data to the
              standard output.  Currently, "plain" data must be written to and from specified filenames (see
              also mount_fdesc(8)).

     -C, --directory dir
              create output files in dir

     -o, --rename name
              Use name for output, overriding any stored or default name.  For encode, the appropriate suf-fix suffix
              fix will be added to name.  -o implies only one file to be encoded or decoded.

     -S, --suffix .suf
              override the default suffix for the given encoding

     -R, --no-runlength-encoding
              don't use BinHex runlength compression when encoding

     -t, --type 1-3
              Specify MacBinary encoding type.  Type 1 is undesirable because it has neither a checksum nor
              a signature and is thus difficult to recognize.

DIAGNOSTICS
     In general, the tool returns a non-zero exit status if it fails.

Darwin                         14 November 2005                         Darwin