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

filename(5) OSS System Calls Reference Manual
qualifier A character string of two to eight valid characters, specifying a unique identifier
significant to the device. The first character must be a number sign (#). Valid
characters for the rest of the string are the letters A through Z and the digits 0
through 9. The second character must be a letter.
For a named process, Guardian filename rules are complex. Guardian named processes are not
accessible through the OSS file system, so the rules are not discussed here.
Guardian unnamed processes are not accessible through the OSS file system, so identification of
them is not discussed here.
Refer to the Guardian Procedure Calls Reference Manual for more information about Guardian
filenames.
Translating Guardian Filenames to OSS Filenames/Pathnames
Each portion of a Guardian filename is separately translated to a valid OSS filename. The result-
ing pathname is prefixed by /G/ for the local NonStop server node and by /E/node_name/G/ for a
remote NonStop server node.
The OSS pathname for the Guardian filename of a disk file therefore becomes
/E/node_name/G/volume_name/subvolume_name /file_id. The /E/ prefix and node name is omit-
ted from the translation for the /G directory on the local node.
The following character translations also occur:
• Any dollar sign is deleted.
• Periods are translated to slashes.
• All uppercase letters are translated to lowercase as a normalizing convention. This trans-
lation allows filename pattern matching; pattern matching is case-sensitive in the OSS
file system.
Translating OSS Filenames/Pathnames to Guardian Filenames
Each OSS filename within a pathname that includes the /G directory is translated to the appropri-
ate part of a fully qualified Guardian filename. The OSS pathname for a file in the /G directory
cannot contain more OSS filename components than the corresponding Guardian filename per-
mits. Extra components cause an operation to fail; an errno value (described under ERRORS
later in this reference page) is returned for function calls.
For a file on the local NonStop server node, the prefix /G/ is translated to the local node name.
For a file on a remote NonStop server node, the prefix /E/node_name/G/ is translated to the
remote node name.
The OSS filenames . (dot) and ..(dot-dot) translate to the corresponding portions of an appropri-
ately resolved OSS pathname when the current working directory is within a /G directory.
The following character translations also occur:
• A dollar sign is prefixed to an OSS filename that corresponds to a Guardian volume name
or to a Guardian process device name.
• Periods, hyphens (-), and underscores (_) within OSS filenames are deleted.
• OSS filenames longer than eight characters are truncated to seven or eight characters, as
appropriate under Guardian filename rules.
12−48 Hewlett-Packard Company 527186-023