Index Index for Section 2
Index Alphabetical listing for G 

getfh(2)


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

  fd	    File descriptor of the path to be exported.

  fhp	    Points to a fhandle_t structure.

  exp_fd    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 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.