NAME    [Toc]    [Back]

     getfh -- get file handle

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <sys/param.h>
     #include <sys/mount.h>

     int
     getfh(const char *path, fhandle_t *fhp);

DESCRIPTION    [Toc]    [Back]

     The getfh() system call returns a file handle for the specified file or
     directory in the file handle pointed to by fhp.  This system call is
     restricted to the superuser.

RETURN VALUES    [Toc]    [Back]

     The getfh() function returns the value 0 if successful; otherwise the
     value -1 is returned and the global variable errno is set to indicate the
     error.

ERRORS    [Toc]    [Back]

     The getfh() system call fails if one or more of the following are true:

     [ENOTDIR]		A component of the path prefix of path is not a directory.


     [ENAMETOOLONG]	The length of a component of path exceeds 255 characters,
 or the length of path exceeds 1023 characters.

     [ENOENT]		The file referred to by path does not exist.

     [EACCES]		Search permission is denied for a component of the
			path prefix of path.

     [ELOOP]		Too many symbolic links were encountered in translating
 path.

     [EFAULT]		The fhp argument points to an invalid address.

     [EIO]		An I/O error occurred while reading from or writing to
			the file system.

HISTORY    [Toc]    [Back]

     The getfh() system call first appeared in 4.4BSD.


FreeBSD 5.2.1			 June 9, 1993			 FreeBSD 5.2.1