CVTNAME(1) Domain/OS BSD CVTNAME(1)
NAME
cvtname - convert pathnames between upper and lowercase and preserve
colons
SYNOPSIS
cvtname [options]
DESCRIPTION
Prior to SR10, the colon (:) was used as an escape character for the
purpose of storing mixed-case names. For example, the filename "Readme"
was stored as ":readme". Domain/OS programs mapped ":r" and interpreted
it as "R". In pre-SR10 Aegis-only environments, colons used in pathnames
were treated as literal characters, since Aegis was not case sensitive.
Colon-character constructs in pathnames from pre-SR10 file systems are
converted to the appropriate uppercase letter (or special character)
automatically when they are copied to SR10 systems. The cvtname command
allows you to selectively undo that process and thereby restore literal
colons to pathnames. cvtname also allows you to convert pathnames to all
uppercase or all lowercase. The tool operates on entire pathnames. That
is, you cannot convert one capital letter in an SR10 pathname back to a
"colon-character" sequence without converting them all.
Regardless of the mode specified, cvtname queries you before converting
each pathname, unless you specify -nq, in which case the changes are
applied to all objects subordinate to the pathname specified.
OPTIONS
Without options, cvtname converts capital letters back to colon-character
sequences.
-m pathname Convert capital letters in the names of all objects in
pathname back to colon-character sequences. If -li is
also specified, potential changes are listed but no
changes are made. If -nq is present, the changes are done
automatically and all modified names are listed. (The
default is -m without -nq)
-l pathname Convert pathname and subordinate object names to all
lowercase. If -li is also specified, potential changes
are listed but no changes are made. If -nq is present,
the changes are done automatically and all modified names
are listed.
-u pathname Convert pathname and subordinate object names to all
uppercase. If -li is also specified, potential changes
are listed but no changes are made. If -nq is present,
the changes are done automatically and all modified names
are listed.
EXAMPLES
The following example allows you to convert the capital letters or
colon-character constructs in pathnames in the directory leduc, querying
you before making any changes. Output is shown under the command line.
The left-hand column shows unconverted name; right shows converted. Type
y to convert, n to keep old name.
$ cvtname /leduc
/leduc/:C /leduc/:::c n
/leduc/CAT /leduc/:c:a:t y
/leduc/CAT converted to /leduc/:c:a:t
The following example allows you to selectively convert pathnames in
leduc to uppercase.
$ cvtname -upper /leduc
/leduc /LEDUC n
/leduc/:c /leduc/:C n
/leduc/:c:a:t /leduc/:C:A:T n
/leduc/acl_from_whoville /leduc/ACL_FROM_WHOVILLE y
/leduc/acl_from_whoville converted to /leduc/ACL_FROM_WHOVILLE
/leduc/backup.pas /leduc/BACKUP.PAS n
/leduc/ff1 /leduc/FF1 y
/leduc/ff1 converted to /leduc/FF1
/leduc/TD/backup_history /leduc/TD/BACKUP_HISTORY n