dgmstat(2)                DG/UX 4.30                 dgmstat(2)



     NAME
          dg_mstat - Get file status.

     SYNOPSIS
          #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.


          -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.



     Licensed material--property of copyright holder(s)         Page 1

     dgmstat(2)                DG/UX 4.30                 dgmstat(2)



          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
          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).









     Licensed material--property of copyright holder(s)         Page 2