Open System Services Programmer's Guide

Table 8 OSS File-System Functions (continued)
Guardian NotesOSS NotesOSS Function
If called for nonseekable device,
errno is set to EINVAL, except for
lseek()
lseek64()
pipes and FIFOs, in which case
errno is set to EISPIPE.
Sets the file offset for read or write
operations.
Can return extended errors.
Can return Guardian file-system error
numbers in errno.
lseek64() can access both small
files and large files.
FDM set.For files other than regular disk files,
st_size is set to 0 (zero), and for
directories, to 4096.
lstat()
There are security and permission
mapping considerations. Refer to the
lstat64()
Provides information about a symbolic
link or any file.
The following bits are ORed into the
st_mode field of the stat structure:
reference page for detailed information
about using stat() on Guardian files.
S_IRWXU
S_IRWXG
S_IRWXO
S_IFMT
S_ISVTX
S_NONSTOP
S_ISGID
S_ISUID
Can return extended errors.
lstat64() can access both small
files and large files.
Succeeds only when creating an empty
subvolume exactly three directories
under root (/G/vol/subvol).
Can not create /lost+found or
/dev in the root directory of a fileset
or /dev/tty or /dev/null.
mkdir()
Creates a directory.
The resulting directory is owned by the
super ID, and all permission bits are set
(rwxrwxrwx).
If there are bits in the mode parameter
other than permission bits S_ISVTX
and S_IFDIR, errno is set to
EINVAL, or the bits are undefined.
The group ID is set to 255.
The group ID of the new directory is
set to the group ID of the parent
directory if S_ISGID is set there,
otherwise, the group ID is set to the
effective group ID of the caller.
Can return extended errors.
OSS SEEP consultation.
FDM set.The file type S_IFBLK is not a valid
file type.
mknod()
Creates a file or assigns a pathname
to a character special file.
The file attribute S_NONSTOP is
supported.
Can return extended errors.
OSS SEEP consultation.
Can be called by native processes.Can be called by native processes.mkstemp()
Makes a unique filename.
FDM set.Can return extended errors.nftw()
Guardian files that are visible to the
opendir() function can be traversed.
Recursive access from / can cause
unexpected results.
nftw64()
Traverses a file tree.
Security controls on Guardian object
Can return Guardian file-system error
numbers in errno.
OSS File-System Functions 95