NAME    [Toc]    [Back]

       getfh - Get a file handle

SYNOPSIS    [Toc]    [Back]

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

       int getfh(
               int fd,
               fhandle_t *fhp,
               int exp_fd );

PARAMETERS    [Toc]    [Back]

       Specifies  the file descriptor of the path to be exported.
       Points to  a  fhandle_t  structure.   Specifies  the  file
       descriptor  of  the  exported  path  to  use when applying
       export options.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

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

ERRORS    [Toc]    [Back]

       If  the getfh() function fails, errno may be set to one of
       the following values: One of the file  descriptor  parameters
  is  not  a valid file descriptor.  The fhp parameter
       points to an invalid address.  The  calling  process  does
       not have appropriate privilege.  The file system specified
       is not exportable.



                                                         getfh(2)