NOME

       utime, utimes - altera a data de acesso ou modificação de um inode

SINOPSE

       #include <sys/types.h>
       #include <utime.h>

       int utime(const char *filename, struct utimbuf *buf);

       #include <sys/time.h>

       int utimes(char *filename, struct timeval *tvp);

DESCRIÇÃO

       utime  altera  a data de acessou modificação de um inode especificado por filename para os
       respectivos campos actime e modtime  do  buf  buf  é  NULL,  então  a  data  de  acesso  e
       modificação dos arquivos são modificadas para a data atual. A estrutura utimbuf é:

              struct utimbuf {
                      time_t actime;  /* access time */
                      time_t modtime; /* modification time */
              };

       Nas bibliotecas DLL 4.4.1 do Linux, utimes é justamente uma capa para utime: tvp[0].tv_sec
       é actime, e tvp[1].tv_sec é modtime.  A estrutura timeval é:

              struct timeval {
                      long    tv_sec;         /* seconds */
                      long    tv_usec;        /* microseconds */
              };

VALORES RETORNADOS

       Em caso de sucesso,  zero  é  retornado.  Caso  contrário,  -1  é  retornado,  e  errno  é
       selecionado adequadamente.

ERRORS

       Outros erros podem ocorrer.

       EACCES A permissão para escrever no arquivo é negada.

       ENOENT filename não existe.

DE ACORDO COM

       utime:  SVr4,  SVID,  POSIX.  Na  documentação  SVr4 condições de erros adicionais EFAULT,
       EINTR, ELOOP, EMULTIHOP, ENAMETOOLONG, ENOLINK, ENOTDIR, ENOLINK, ENOTDIR, EPERM, EROFS.
       utimes: BSD 4.3

VEJA TAMBÉM

       stat(2)

TRADUZIDO POR LDP-BR em 21/08/2000.

       André  L.  Fassone  Canova  <lonelywolf@blv.com.br>  (tradução)  xxxxxxxxxxxxxxxxxxxxxxxxx
       <xxx@xxxxxx.xxx.xx> (revisão)