NAME

getfh − Gets a file handle

SYNOPSIS

#include <sys/types.h>
#include <sys/mount.h> getfh(
int fd;
fhandle_t ∗fhp );
int exp_fd );

PARAMETERS

fdFile descriptor of the path to be exported. 

fhpPoints to a fhandle_t structure. 

exp_fdFile descriptor of the exported path to use when applying export options. 

DESCRIPTION

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

RETURN VALUES

Upon successful completion, a value of 0 (zero) is returned.  Otherwise, −1 is returned and errno is set to indicate the error. 

ERRORS

If the getfh() function fails, errno may be set to one of the following values:

[EBADF]One of the file descriptor parameters is not a valid file descriptor. 

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

[EPERM]The calling process does not have appropriate privilege. 

[EREMOTE]The file system specified is not exportable.