fcnvt(1) fcnvt(1)NAME fcnvt - convert a resource file to another format SYNOPSIS fcnvt [-v] [-i input-format] -s [-f] input-file output-file fcnvt [-v] [-i input-format] -d [-f] input-file output-file fcnvt [-v] [-i input-format] -t [-f] input-file output-file fcnvt [-v] [-i input-format] -p [-f] input-file output-file fcnvt [-v] [-i input-format] -b [-f] input-file output-file fcnvt [-v] [-i input-format] -m [-f] input-file output-file DESCRIPTION fcnvt converts a file (input-file) from one file format to another (output-file). The command line options and their meanings are: -i input-format Specify the file format of the file to be converted. If an input-file format is not specified, the AppleSingle format is assumed. Supported formats are: single AppleSingle (see the -s flag option) double AppleDouble (see the -d flag option) triple Plain Triple (see the -t flag option) pair Plain Pair (see the -p flag option) hex BinHex 4.0 (see the -b flag option) bin MacBinary (see the -m flag option) -v Specify verbose mode. In verbose mode, fcvnt displays information as it processes each file. -s Create an AppleSingle-format output file. This format is the default. With AppleSingle format, all contents and file information are kept in a single file. Ap- pleSingle format is best used for non-text data and ex- ecutable Macintosh(Reg.) object files. Directory list- ings look much cleaner because each Macintosh file maps to a single A/UX file with no % prefix. -d Create an AppleDouble-format output file. With Ap- pleDouble format, the contents of the data fork are stored in one file, known as the data file; resources and file attribute information are stored in a separate file, known as the header file. The header file has the April, 1990 1
fcnvt(1) fcnvt(1)same name as the data file but is prefixed with a per- cent sign (%). The AppleDouble format is best used for text data and data to be shared with UNIX utilities, because the data fork is available as an isolated file. -t Convert the input file into Plain Triple file format. This format is used by the macget and macput public- domain file-transfer programs. Three files are created with suffixes attached to help tell them apart. The files output-file.info, output-file.data, and output- file.rsrc contain identification information, the data fork, and the resource fork, respectively. -p Convert the input file into Plain Pair file format. This option is the same as the -t option except that output-file.info is not created. -b Create a BinHex 4.0-format output file. The input-file is encoded into ASCII characters, permitting ASCII transfer of a binary file. -m Create a MacBinary-format output file. This format is commonly used when transferring Macintosh files via a telecommunication link, using a protocol such as XMO- DEM, XMODEM7, Kermit, CompuServe A or CompuServe B. -f Allow fcnvt to overwrite an existing file with the same name as the new file. If you specify an output filename that is the same as an existing filename without specifying the -f flag option, fcnvt takes no action and returns an error message. If the initial transfer is made using a terminal emulator program, the file created is likely to be in a text-only format, BinHex 4.0 format, or MacBinary format, if not just a copy of the resource fork of the Macintosh file. In any of those cases, fcnvt can be used to convert the file to ei- ther AppleSingle or AppleDouble format, assuming you know their starting format. Note that file transfers made using terminal emulators are likely to strip away the Macintosh type and creator attri- butes for the file. (Each of these attributes is one four- character string.) See settc(1) to restore those attri- butes, once you know what they are supposed to be. FILES /mac/bin/fcnvt SEE ALSO settc(1). 2 April, 1990