Linux x86_64Sistema de arquivos#261Depreciada
futimesat
Como utimes, mas resolve o caminho relativo a um descritor de diretório.
Descrição
Parte da família *at(), intermediária de curta duração — logo superada por `utimensat`.
man 2Desde o kernel 2.6.16
Depreciada
Prefira `utimensat`, mais completa e adicionada quase simultaneamente.
Assinatura
int futimesat(
int dirfd,
const char * pathname,
const struct timeval[2] times
);Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| dirfd | int | Descritor do diretório base, ou AT_FDCWD. |
| pathname | const char * | Caminho, absoluto ou relativo a `dirfd`. |
| times | const struct timeval[2] | Novos timestamps, ou NULL para o horário atual. |
Registradores (x86_64)
| Registrador | Papel | Argumento |
|---|---|---|
| rax | número da syscall (chamada) / valor de retorno (após SYSCALL) | — |
| rdi | argumento 1 | dirfdint |
| rsi | argumento 2 | pathnameconst char * |
| rdx | argumento 3 | timesconst struct timeval[2] |
Valor de retorno
0 em sucesso; -1 em erro, com errno definido.
Códigos de erro (errno)
- EACCES(13)
- Permissão negada.
- EBADF(9)
- Descritor de arquivo inválido.
- ENOENT(2)
- Arquivo ou diretório inexistente.