.\" Copyright (c) 1989 The Regents of the University of California.
.\" Redistribution and use in source and binary forms are permitted
.\" provided that the above copyright notice and this paragraph are
.\" duplicated in all such forms and that any documentation,
.\" advertising materials, and other materials related to such
.\" distribution and use acknowledge that the software was developed
.\" by the University of California, Berkeley. The name of the
.\" University may not be used to endorse or promote products derived
.\" from this software without specific prior written permission.
.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
.\" @(#)getfh.2 6.1 (Berkeley) %G%
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.
An I/O error occurred while reading from or writing to the file system.