Provided by: manpages-pt-dev_20040726-1_all bug

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)