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

filename(5) OSS System Calls Reference Manual
12. The following is an example of translating a Guardian filename to an OSS pathname. If
\LOCAL.$ZTNT.#PTY0001 is a nondisk device that needs to be passed to an OSS func-
tion, it can be referred to by specifying /G/ztnt/#pty0001.
NOTES
Guardian subvolume names and file identifiers beginning with the letter Z are reserved. Do not
use such names for files in the /G directory.
During resolution of OSS pathnames, the st_atime field of the stat structure is updated for each
parent directory involved in the resolution.
ERRORS
If an invalid Guardian filename results from OSS pathname or OSS filename translation for a file
in the /G directory, a function call using the OSS pathname or OSS filename fails and one of the
following values is returned for errno:
[EINVAL] The named file cannot be created.
[ENOENT] The named file cannot be opened.
Most OSS filename and pathname errors return the value [ENAMETOOLONG] for errno.
RELATED INFORMATION
Commands: ls(1), mv(1), rm(1).
Functions: creat(2), fstat(2), lstat(2), open(2), stat(2), symlink(2).
Files: limits(4).
Miscellaneous: hier(5).
STANDARDS CONFORMANCE
The following are HP extensions to the XPG4 Version 2 specification:
• Characters in addition to those of the portable character set are supported in OSS
filenames.
12−50 Hewlett-Packard Company 527186-023