4.3BSD-Reno/share/man/cat2/getfh.0

GETFH(2)		      1990			 GETFH(2)



NNAAMMEE
     getfh - get file handle

SSYYNNOOPPSSIISS
     ##iinncclluuddee <<ssyyss//ttyyppeess..hh>>
     ##iinncclluuddee <<ssyyss//mmoouunntt..hh>>

     ggeettffhh((ppaatthh,, ffhhpp))
     cchhaarr **ppaatthh;;
     ssttrruucctt ffhhaannddllee__tt **ffhhpp;;

DDEESSCCRRIIPPTTIIOONN
     _G_e_t_f_h returns a file handle for the specified file or direc-
     tory in the file handle pointed to by _f_h_p . This system call
     is restricted to the superuser.

RREETTUURRNN VVAALLUUEE
     Upon successful completion, a value of 0 is returned.  Oth-
     erwise, -1 is returned and the global variable _e_r_r_n_o is set
     to indicate the error.

EERRRROORRSS
     _G_e_t_f_h fails if one or more of the following are true:

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

     EINVAL	    _p_a_t_h contains a character with the high-order
		    bit set.

     ENAMETOOLONG   The length of a component of _p_a_t_h exceeds 255
		    characters, or the length of _p_a_t_h exceeds
		    1023 characters.

     ENOENT	    The file referred to by _p_a_t_h does not exist.

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

     ELOOP	    Too many symbolic links were encountered in
		    translating _p_a_t_h.

     EFAULT	    _F_h_p points to an invalid address.

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









Printed 7/27/90               June				1