dgmstat(2)
_________________________________________________________________
dgmstat System Call
Get file status.
_________________________________________________________________
SYNTAX
#include <sys/types.h>
#include <sys/stat.h>
int dg_mstat (path, buffer_ptr)
char * path;
struct stat * buffer_ptr;
PARAMETERS
path Address of a pathname.
buffer_ptr Address of a stat buffer to fill.
DESCRIPTION
Dg_mstat returns the current attributes of the file pointed to by
<path> into the status buffer at the location specified by
<buffer_ptr>. If <path> refers to a symbolic link, file status
for the target of the symbolic link is returned. Furthermore, if
<path> (after symbolic link resolution, if any) refers to a mount
point for a file system, status information for the mounted on
directory is returned.
The interpretation of the file's attributes depends on the file's
type (see stat(5) for details). The subject file must be of type
`ordinary-disk-file', `directory', `block-special-file',
`character-special-file', or `fifo-special-file'.
If dg_mstat fails, the contents of the buffer are undefined.
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 dg_mstat operation was successful.
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
dgmstat(2)
-1 An error occurred. Errno is set to indicate the
error.
EXCEPTIONS
Errno may be set to one of the following error codes:
EFAULT <Buffer_ptr> 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.
SEE ALSO
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)
dgmstat(2)
The related manual sections: chmod(2), chown(2), creat(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),
stat(5).
DG/UX 4.00 Page 3
Licensed material--property of copyright holder(s)