NAME
getfh() — return file handle for file on remote node
SYNOPSIS
#include <errno.h>
#include <time.h>
#include <nfs/nfs.h>
#include <rpc/rpc.h>
int getfh(char *path, fhandle_t *fhp);
DESCRIPTION
The
getfh()
system call returns a file handle in the
struct
pointed to by
fhp
for the file pointed to by
path.
This information is used to perform an NFS mount for a remote node.
getfh()
is executed on the remote node;
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.)
The effective user ID of the calling process must be superuser.
RETURN VALUE
getfh()
returns the following values:
- 0
Successful completion.
- -1
Failure.
errno
is set to indicate the error.
ERRORS
If
getfh()
fails,
errno
is set to one of the following values.
- [EINVAL]
Invalid argument, or the file or directory has not been exported by
exportfs
(see
exportfs(1M)).
- [ENOENT]
File or directory specified by
path
does not exist.
- [EPERM]
The effective user ID is not superuser.
- [EREMOTE]
The file or directory specified by
path
is a remote file or directory.
WARNINGS
This call should be used only by HP-supplied commands
and is not recommended for use by non-HP-supplied programs.
AUTHOR
getfh()
was developed by Sun Microsystems, Inc.