NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | HISTORY | ATTRIBUTES
#include <sys/types.h> #include <sys/mount.h>int getfh(char *path, fhandle_t *fhp);
NFS_SERVER
The getfh function returns a file handle for the specified file or directory into the file handle pointed to by fhp. This system call is restricted to the superuser.
Upon successful completion, a value of 0 is returned. Otherwise, -1 is returned and the global variable errno is set to indicate one of the following error conditions.
A component of the path prefix of path is not a directory.
path contains a character with the high-order bit set.
The length of a component of path exceeds NAME_MAX characters, or the length of path exceeds PATH_MAX characters.
The file referred to by path does not exist.
Search permission is denied for a component of the path prefix of path.
Too many symbolic links were encountered in translating path.
In user mode,fhp points to an invalid address. In supervisor mode, this is not detected, and the state of the target is unknown.
An I/O error occurred while reading from or writing to the file system.
The getfh function first appeared in 4.4 BSD.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | HISTORY | ATTRIBUTES