NAME

cvtumap − convert name trees between SR8 and SR9 mapping

USAGE

/etc/cvtumap [-l] [-8] [-9] name

DESCRIPTION

Cvtumap converts a Software Release 8 (SR8) naming tree to an SR9 equivalent.  This command is meaningful only to those users who are upgrading from SR8 software. 

At SR8, a limited set of non-alphanumeric characters were available for use in filenames.  These characters were ‘mapped’ into an internal representation for storage in the naming system; reverse mapping took place when the names were read from the naming system to be reported, via the read(2) kernel function, to the calling program.  An example of such a mapping is the character ‘-’ (dash), which was mapped for internal storage into ‘:5’ (colon, five). 

At SR9, DOMAIN/IX supports the full set of ASCII characters as valid components of a UNIX filename, with the exception of slash and null.  In order to preserve coexistence with other Apollo system software and customer software, a user-settable switch is provided in the form of an environment variable.  Setting the UNIXNAMES environment variable to ‘SR8’ causes to SR8 mapping scheme to be applied; any other value (or absence of the environment variable) causes the SR9 scheme to be used.  When upgrading from an SR8 system to SR9, the following steps are suggested as a means for changing the naming system to the SR9 scheme:

1.Set the UNIXNAMES environment variable to ‘SR8’ in the Display Manager startup files for each node on the network.  Comments in the startup files shipped with SR9 describe how to do this. 

2.When all nodes have been upgraded to SR9, use the cvtumap utility to map all SR8 naming trees with non-alphanumeric characters to the SR9 format. 

3.Following this, delete the definition of the UNIXNAMES environment variable from the Display Manager startup file. 

NOTES

Certain name characters, such as tilde (~) and accent grave (‘), had special significance at SR8.  By default, these characters are mapped and stored as normal component characters in the SR9 naming scheme.  The NAMECHARS environment variable may be used to retain the special significance of these characters.  Set NAMECHARS to the set of characters for which you desire to retain the special (SR8/non-UNIX style) semantics of these characters. 

Should it be necessary to return to the SR8 naming scheme, use the cvtumap utility with the -8 option. 

OPTIONS

−9 converts from SR8 to SR9 mapping. 

−8 converts SR9 to SR8 mapping. 

−l lists filenames and subdirectory names affected, as they are converted. 

RELATED INFORMATION

Administering Your DOMAIN System, DOMAIN System Command Reference.