NAME

cvtumap − convert name trees from SR8 to SR9 name mapping

USAGE

/etc/cvtumap [-l] [-9] pathname

DESCRIPTION

Cvtumap converts an Apollo 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 was available for use in filenames.  These characters were ‘mapped’ into an internal representation for storage in the naming system. The mapping was reversed when the names were read from the naming system to be reported, via the read(2) kernel function, to the calling program.  One example of this mapping is the character ‘-’ (dash), which was translated 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.  When upgrading from an SR8 system to SR9, use cvtumap to map all SR8 trees that have non-alphanumeric characters in their names to the SR9 format. 

EXAMPLE

/etc/cvtumap /sys will apply cvtumapto the directory sys, changing any file or directory names to the SR9 naming scheme. 

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. 

Cvtumap no longer supports a return from the SR9 naming scheme to the SR8 one. 

The UNIXNAMES environment variable is no longer supported. 

OPTIONS

−9 converts from SR8 to SR9 mapping.  (Included for compatibility only; you may run cvtumap without it.) 

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

RELATED INFORMATION

DOMAIN System Command Reference