getfh(2) — DG/UX 5.4.2A



getfh(2)                         DG/UX 5.4.2                        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's effective user id must be superuser.

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 is not superuser.

       EOPNOTSUPP     Kernel support for NFS is not present.

SEE ALSO
       dgmount(2).











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