NAME

getfh − returns a file handle for a file on a remote node. 

SYNOPSIS

#include <sys/types.h>
#include <netinet/in.h>
#include <nfs/nfs.h>
int getfh(fildes, fhp)
int  fildes;
fhandle_t  *fhp;

DESCRIPTION

Getfh returns a file handle in the struct pointed to by fhp for an open file referenced by the file descriptor fildes. This information is used to perform an NFS mount for a remote node.  The getfh is executed on the remote node; the results are passed back to the program doing the NFS mount.  The caller should never examine the file handle contents. The file handle only identifies a file to the node that produced the file handle.  (The term "file handle" refers to an NFS concept.) 

Only the super-user can invoke getfh . 

RETURN VALUE

Getfh returns a 0 if it succeeds and -1 if an error occurs.  Errno will contain the appropiate value if getfh returns with -1. 

ERRORS

Getfh fails if one of the following conditions is true; errno will be set accordingly. 

[EPERM] The effective user ID is not super-user. 

[EBADF] Fildes is not a valid file descriptor. 

WARNINGS

This call should be used only by HP supplied commands and is not recommended for use by non-HP supplied programs. 

AUTHOR

Sun Microsystems, Inc. 

SEE ALSO

mount(1M), vfsmount(2). 

Hewlett-Packard Company  —  May 11, 2021