GETFH(2) BSD Programmer's Manual GETFH(2) NNAAMMEE ggeettffhh - get file handle SSYYNNOOPPSSIISS ##iinncclluuddee <<ssyyss//ttyyppeess..hh>> ##iinncclluuddee <<ssyyss//mmoouunntt..hh>> _i_n_t ggeettffhh(_c_h_a_r _*_p_a_t_h, _f_h_a_n_d_l_e___t _*_f_h_p); DDEESSCCRRIIPPTTIIOONN GGeettffhh() returns a file handle for the specified file or directory in the file handle pointed to by _f_h_p. This system call is restricted to the su- peruser. RREETTUURRNN VVAALLUUEESS Upon successful completion, a value of 0 is returned. Otherwise, -1 is returned and the global variable _e_r_r_n_o is set to indicate the error. EERRRROORRSS GGeettffhh() 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. HHIISSTTOORRYY The ggeettffhh function first appeared in 4.4BSD. 4.4BSD June 9, 1993 1