NAME

getfh − Get a file handle

SYNOPSIS

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

PARAMETERS

fdSpecifies the file descriptor of the path to be exported. 

fhpPoints to a fhandle_t structure. 

exp_fdSpecifies the file 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 root user. 

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.