home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / man / cat2 / utimes.0 < prev    next >
Text File  |  1993-12-07  |  3KB  |  133 lines
  1.  
  2. UTIMES(2)                  UNIX Programmer's Manual                  UTIMES(2)
  3.  
  4. NNAAMMEE
  5.      uuttiimmeess - set file access and modification times
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssyyss//ttiimmee..hh>>
  9.  
  10.      _i_n_t
  11.      uuttiimmeess(_c_o_n_s_t _c_h_a_r _*_f_i_l_e, _c_o_n_s_t _s_t_r_u_c_t _t_i_m_e_v_a_l _*_t_i_m_e_s)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The uuttiimmeess() function sets the access and modification times of the named
  15.      file from the structures in the argument array _t_i_m_e_s.
  16.  
  17.      The first structure is the access time, and the second is the modifica­
  18.      tion time.
  19.  
  20.      If the times are specified (the _t_i_m_e_s argument is non­NULL) the caller
  21.      must be the owner of the file or be the super­user.
  22.  
  23.      If the times are not specified (the _t_i_m_e_s argument is NULL) the caller
  24.      must be the owner of the file, have permission to write the file, or be
  25.      the super­user.
  26.  
  27. RREETTUURRNN VVAALLUUEESS
  28.      Upon successful completion, a value of 0 is returned.  Otherwise, a value
  29.      of ­1 is returned and _e_r_r_n_o is set to indicate the error.
  30.  
  31. EERRRROORRSS
  32.      UUttiimmeess() will fail if:
  33.  
  34.      [EACCES]      Search permission is denied for a component of the path
  35.                    prefix; or the _t_i_m_e_s argument is NULL and the effective us­
  36.                    er ID of the process does not match the owner of the file,
  37.                    and is not the super­user, and write access is denied.
  38.  
  39.      [EFAULT]      File or _t_i_m_e_s points outside the process's allocated ad­
  40.                    dress space.
  41.  
  42.      [EINVAL]      The pathname contains a character with the high­order bit
  43.                    set.
  44.  
  45.      [EIO]         An I/O error occurred while reading or writing the affected
  46.                    inode.
  47.  
  48.      [ELOOP]       Too many symbolic links were encountered in translating the
  49.                    pathname.
  50.  
  51.      [ENAMETOOLONG]
  52.                    A component of a pathname exceeded 255 characters, or an
  53.                    entire path name exceeded 1023 characters.
  54.  
  55.      [ENOENT]      The named file does not exist.
  56.  
  57.      [ENOTDIR]     A component of the path prefix is not a directory.
  58.  
  59.      [EPERM]       The _t_i_m_e_s argument is not NULL and the calling process's
  60.                    effective user ID does not match the owner of the file and
  61.                    is not the super­user.
  62.  
  63.      [EROFS]       The file system containing the file is mounted read­only.
  64.  
  65. SSEEEE AALLSSOO
  66.      stat(2)
  67.  
  68. HHIISSTTOORRYY
  69.      The uuttiimmeess function call appeared in 4.2BSD.
  70.  
  71. 4th Berkeley Distribution       April 19, 1991                               2
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.