getfh(2) — DG/UX R4.11



getfh(2)                          SDK R4.11                         getfh(2)


NAME
       getfh - return the file handle of the export entry containing
       filename

SYNOPSIS
       #include <sys/types.h>
       #include <sys/nfs.h>

       int  getfh (filename, filehandleptr)
       char * filename;
       fhandlet * filehandleptr;

   where:
       filename       The filename to get the filehandle of

       filehandleptr Where to put filehandle for the file specified by
                      filename

DESCRIPTION
       If filename has been exported via exportfs(2), then the filehandle
       for the filesystem that is exported is returned.  This system call is
       normally used only by mountd(1M), the NFS mount server.

ACCESS CONTROL
       The calling process must have appropriate privilege.  For systems
       supporting the DG/UX Capability Option, appropriate privilege is
       defined as having one or more specific capabilities enabled in the
       effective capability set of the calling process.  See capdefaults(5)
       for the default capability for this system call.

       On systems without the DG/UX Capability Option, appropriate privilege
       means that the process has an effective UID of 0.  See the
       appropriateprivilege(5) man page for more information.

RETURN VALUE
       0      Successful completion.  The file handle for filename is
              returned in filehandleptr.

       -1     An error occurred.  errno is set to indicate the error.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       EINVAL         No export entry exists for this filename.

       EFAULT         Some part of the space pointed to by filehandleptr
                      lies outside the process's readable address space.

       EPERM          The caller does not have appropriate privilege.  (See
                      ACCESS CONTROL, above.)

       EOPNOTSUPP     Kernel support for NFS is not present.

SEE ALSO
       dgmount(2), appropriateprivilege(5).
       capdefaults(5).


Licensed material--property of copyright holder(s)
Museum
