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)