home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / gnu / ixemul-39.47-env-bin.lha / man / cat2 / readlink.0 < prev    next >
Encoding:
Text File  |  1993-12-07  |  2.0 KB  |  67 lines
  1.  
  2. READLINK(2)                UNIX Programmer's Manual                READLINK(2)
  3.  
  4. NNAAMMEE
  5.      rreeaaddlliinnkk - read value of a symbolic link
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<uunniissttdd..hh>>
  9.  
  10.      _i_n_t
  11.      rreeaaddlliinnkk(_c_o_n_s_t _c_h_a_r _*_p_a_t_h, _c_h_a_r _*_b_u_f, _i_n_t _b_u_f_s_i_z)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      RReeaaddlliinnkk() places the contents of the symbolic link _p_a_t_h in the buffer
  15.      _b_u_f, which has size _b_u_f_s_i_z. RReeaaddlliinnkk does not append a NUL character to
  16.      _b_u_f.
  17.  
  18. RREETTUURRNN VVAALLUUEESS
  19.      The call returns the count of characters placed in the buffer if it suc­
  20.      ceeds, or a ­1 if an error occurs, placing the error code in the global
  21.      variable _e_r_r_n_o.
  22.  
  23. EERRRROORRSS
  24.      RReeaaddlliinnkk() will fail if:
  25.  
  26.      [ENOTDIR]     A component of the path prefix is not a directory.
  27.  
  28.      [EINVAL]      The pathname contains a character with the high­order bit
  29.                    set.
  30.  
  31.      [ENAMETOOLONG]
  32.                    A component of a pathname exceeded 255 characters, or an
  33.                    entire path name exceeded 1023 characters.
  34.  
  35.      [ENOENT]      The named file does not exist.
  36.  
  37.      [EACCES]      Search permission is denied for a component of the path
  38.                    prefix.
  39.  
  40.      [ELOOP]       Too many symbolic links were encountered in translating the
  41.                    pathname.
  42.  
  43.      [EINVAL]      The named file is not a symbolic link.
  44.  
  45.      [EIO]         An I/O error occurred while reading from the file system.
  46.  
  47.      [EFAULT]      _B_u_f extends outside the process's allocated address space.
  48.  
  49. SSEEEE AALLSSOO
  50.      stat(2),  lstat(2),  symlink(2)
  51.  
  52. HHIISSTTOORRYY
  53.      The rreeaaddlliinnkk function call appeared in 4.2BSD.
  54.  
  55. 4.2 Berkeley Distribution       March 10, 1991                               1
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.