Open System Services Shell and Utilities Reference Manual (G06.29+, H06.08+, J06.03+)

gname(1) OSS Shell and Utilities Reference Manual
NAME
gname - Displays the Guardian environment filename for an OSS file
SYNOPSIS
gname [-s] pathname ...
FLAGS
-s Supresses formatting and displays only the Guardian filename.
DESCRIPTION
The gname command displays the Guardian filename for the file specified by pathname.
Operands
pathname
Specifies the OSS pathname for the file whose Guardian filename is to
be displayed.
EXAMPLES
1. The command:
gname /bin/gname
results in output such as the following:
gname: /bin/gname ---> \KT22.$XPG.ZYQ00000.Z00005LS
2. The command:
gname -s /bin/pname
results in output such as the following:
\KT22.$XPG.ZYQ00000.Z00005LN
DIAGNOSTICS
The following error messages can be returned:
A prefix within the pathname refers to a file other than the dir
The value specified for pathname specifies a file where a direc-
tory name is required.
Failed with Guardian error: 4002
The value specified for pathname does not correspond to a
known file.
Invalid pathname specified: pathname
The value specified for pathname contains a character that is not
permitted in a pathname.
Pathname or name component too long.
Either a component of the value specified for pathname exceeds
the maximum number of characters allowed in that component,
or symbolic links in the specified pathname expand until the
maximum length for a valid pathname is exceeded.
4−24 Hewlett-Packard Company 527188-021