dg_stat(2) DG/UX 5.4.2 dg_stat(2)
NAME
dgstat - get extended file status information
SYNOPSIS
#include <sys/types.h>
#include <sys/stat.h>
#include <sys/dgstat.h>
int dgstat (path, bufferptr, linkintent, version)
char * path;
struct dgstat * bufferptr;
int linkintent;
unsigned short version;
where:
path Address of a pathname
bufferptr Address of a dgstat buffer to fill
linkintent Instructions on what to do if the component of path is
a symbolic link
version Version of the struct dgstat packet that bufferptr
refers to; should be set to DG_STAT_VERSION_NUMBER
DESCRIPTION
Dgstat(2) returns the current extended attributes of the file named
by path into the dgstat buffer at the location specified by
bufferptr. If path refers to a symbolic link and linkintent is
DG_STAT_FOLLOW_SYMLINK, then file status for the target of the
symbolic link is returned. If path refers to a symbolic link and
linkintent is DG_STAT_EXAMINE_SYMLINK, then file status for the
symbolic link itself is returned. If path does not refer to a
symbolic link, then the value of linkintent is irrelevant, but it
must be one of the aforementioned constants. If dgstat fails, the
contents of the buffer are undefined.
The size and composition of the structure referred to by bufferptr
is determined by the version parameter. All calls to this function
should use DG_STAT_VERSION_NUMBER for this parameter. version allows
for future revisions of struct dgstat to be handled in a compatible
way.
The interpretation of the file's attributes depends on the file's
type [see dgstat(5) and stat(5)].
ACCESS CONTROL
Read, write, or execute permission of the named file is not required,
but the process must have permission to resolve path.
RETURN VALUE
0 The dgstat operation was successful.
-1 An error occurred. errno is set to indicate the error.
DIAGNOSTICS
Errno may be set to one of the following error codes:
Licensed material--property of copyright holder(s) 1
dg_stat(2) DG/UX 5.4.2 dg_stat(2)
EINVAL version is not a supported version of struct dgstat.
EINVAL linkintent is not one of DG_STAT_EXAMINE_SYMLINK or
DG_STAT_FOLLOW_SYMLINK.
EFAULT bufferptr points to an invalid address.
ENOENT The file the pathname resolved to does not exist.
ENOENT A non-terminal component of the pathname does not
exist.
ENOTDIR A non-terminal component of the pathname was not a
directory or symbolic link.
ENAMETOOLONG The pathname exceeds the length limit for pathnames.
ENAMETOOLONG A component of the pathname exceeds the length limit
for filenames.
ENOMEM There are not enough system resources to resolve the
pathname or to expand a symbolic link.
ELOOP The number of symbolic links encountered during
pathname resolution exceeded MAXSYMLINKS. A symbolic
link cycle is suspected.
EPERM The pathname contains a character not in the allowed
character set.
EFAULT The pathname does not completely reside in the
process's address space or the pathname does not
terminate in the process's address space.
EACCES The calling process does not have permission to
resolve the pathname.
SEE ALSO
chmod(2), chown(2), creat(2), dgfstat(2), dgmstat(2), fchmod(2),
fchown(2), fstat(2), link(2), lstat(2), mknod(2), pipe(2), read(2),
stat(2), time(2), unlink(2), utime(2), utimes(2), write(2),
dgstat(5), stat(5).
Licensed material--property of copyright holder(s) 2