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

User Commands (g - j) gname(1)
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 directory 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.
Root fileset not mounted.
The value specified for pathname uses a root fileset that is not currently
mounted. If the specified value is valid, contact your site administrator to have
that root fileset mounted.
527188-003 Hewlett-Packard Company 4−19