CVTUMAP(1M) DOMAIN/IX Reference Manual (SYS5) CVTUMAP(1M)
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 system and applications 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 sug- gested as a means for changing the
naming system to the SR9 scheme:
1. Set the UNIXNAMES environment variable to `SR8' in the
Display Manager start-up files for each node on the
network. Comments in the start-up 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 start-up
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 charac-
ters. Set NAMECHARS to the set of characters for which you
Printed 5/10/85 CVTUMAP-1
CVTUMAP(1M) DOMAIN/IX Reference Manual (SYS5) CVTUMAP(1M)
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.
CVTUMAP-2 Printed 5/10/85