getfh(2)
_________________________________________________________________
getfh System Call
Return the file handle associated with a file descriptor.
_________________________________________________________________
SYNTAX
#include <sys/types.h>
#include <sys/nfs.h>
int getfh (descriptor, filehandle_ptr)
int descriptor;
fhandle_t * filehandle_ptr;
PARAMETERS
descriptor An active, valid file descriptor.
filehandle_ptr Where to put filehandle for the object specified
by <descriptor>.
DESCRIPTION
If <descriptor> is a valid, active descriptor, getfh returns the
file handle for the underlying object. This system call is
normally used only by the NFS mount daemon.
ACCESS CONTROL
The calling process's effective user id must be superuser.
RETURN VALUE
0 Successful completion. The file handle for
<descriptor> is returned in <filehandle_ptr>.
-1 An error occurred. Errno is set to indicate the
error.
EXCEPTIONS
Errno may be set to one of the following error codes:
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
getfh(2)
EFAULT Some part of the space pointed to by
<filehandle_ptr> lies outside the process's
readable address space.
EPERM The caller is not superuser.
EBADF The descriptor is not a valid, active descriptor.
EOPNOTSUPP Kernel support for NFS is not present.
SEE ALSO
The related manual sections: nfssvc(2), async_daemon(2),
nfsmount(2).
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)