CVTUMAP(1M) DOMAIN/IX SYS5 CVTUMAP(1M)
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 cvtumap to 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 charac-
ters 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.
Printed 12/4/86 DOMAIN System Only CVTUMAP-1
CVTUMAP(1M) DOMAIN/IX SYS5 CVTUMAP(1M)
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
CVTUMAP-2 DOMAIN System Only Printed 12/4/86