test

TotalNET Advanced Server 5.2 Reference Manual

atconvert

This command converts the finder information .finderinfo and resource fork .resource formats of pre-TAS 5.0 versions of the AppleTalk realm file format, CAP 6.0, or Helios EtherShare into the TAS 5.2 shadow file structure. The default, if you select no option, converts Macintosh files in pre-TAS 5.0 format to TAS 5.2 format. The atconvert command converts Macintosh files recursively, descending through directory arguments.

CAP 6.0 stores the finder information and resource fork in the .finderinfo and .resource directories, respectively. The atconvert command converts the information from the .finderinfo and .resource directories into the new structure and stores it in new shadow files. The command then deletes the .finderinfo and .resource directories.

Helios EtherShare stores the finder information and resource fork in a single file directory under .rsrc. The atconvert command converts this information from .rsrc into the new structure and stores it in new shadow files.

The atconvert command uses character set mapping when converting files between Macintosh and TAS. With TAS installed, the server reads the host character set value from the TAS configuration file. The client character set defaults to builtin-mac-roman. The host character set defaults to builtin-iso-latin-1.

Location

TNHOME/usr/bin

Usage

atconvert [-b] [-c] [-C charset] [-d] [-H] [-k]
 	directory...

Options

-b

Convert Macintosh files in TAS 5.2 format to CAP 6.0 format. The -H option overrides this option.

-c

Convert from CAP 6.0 format to TAS 5.2 format. The -H option overrides this option.

-C charset

Specify the client character set. If you do not specify this option, the character set defaults to builtin-mac-roman. Valid character sets include:

builtin-mac-roman

builtin-iso-latin-1

builtin-unicode

builtin-codepage-437

You can use additional character sets if you install TAS. 

-d

Convert Macintosh files with CAP binary compiled and USE_MAC_DATES defined to TAS 5.2 format. The -H option overrides this option.

-H

Convert Macintosh files in Helios format to TAS 5.2 format. This option overrides the -b, -c, and -d options.

-k

Keep the source finder information and resource fork. If you do not specify this option, atconvert deletes the original finder information and the resource fork after completing the conversion. In pre-TAS 5.0 format or CAP format, atconvert deletes all files in .finderinfo and .resource. In Helios format, it deletes all files in .rsrc.

directory

Specify the directories for file conversion. 

Notes

  1. This command does not preserve the comment field in the finder information when converting from Helios format to TAS format.

  2. This command uses the UNIX creation/modification date of the files in all conversions except when converting CAP format to TAS format with CAP binary compiled with USE_MAC_DATES.

  3. The user who runs this command must have permission to read, write, and create all of the files under the directory.

  4. This command preserves the original permission and ownership of the file. The shadow files and directories it creates have the same ownership and permission as the parent directory. Back up the directory if you want to preserve the original content.

  5. Do not run the command from the root directory "/".

Examples

  1. Use the following command to convert the directory /home/totalnet and every subdirectory and file under it from pre-TAS 5.0 Macintosh file structure to TAS 5.2 structure and delete the original pre-TAS 5.0 finder information and resource fork:


    atconvert /home/totalnet

  2. Use the following command to convert CAP directory /home/macdir to a TAS directory, with USE_MAC_DATES defined when building CAP:


    atconvert -c -d /home/macdir

  3. Use the following command to convert Helios directory /home/heliodir to a TAS directory:


    atconvert -H /home/heliodir