.\" Copyright (c) 1989, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\" %sccs.include.redist.roff%
.\" @(#)getfh.2 8.1 (Berkeley) %G%
.Fd #include <sys/types.h>
.Fd #include <sys/mount.h>
.Fn getfh "char *path" "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.
first appeared in 4.4BSD.