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
TRADUZIDO POR LDP-BR em 21/08/2000.
André L. Fassone Canova <lonelywolf [AT] blv.br> (tradução) xxxxxxxxxxxxxxxxxxxxxxxxx <xxx [AT] xxxxxx.xx> (revisão)