.\" Copyright (c) 1989, 1991 The Regents of the University of California.
.\" %sccs.include.redist.roff%
.\" @(#)getfh.2 6.4 (Berkeley) %G%
.Fd #include <sys/types.h>
.Fd #include <sys/mount.h>
.Fn getfh "char *path" "struct fhandle_t *fhp"
returns a file handle for the specified file or directory
in the file handle pointed to by
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
is set to indicate the error.
fails if one or more of the following are true:
A component of the path prefix of
contains a character with the high-order bit set.
The length of a component of
Search permission is denied for a component of the path prefix of
Too many symbolic links were encountered in translating
points to an invalid address.
error occurred while reading from or writing to the file system.