Linux x86_64Sistema de arquivos#264
renameat
Como rename, mas resolve origem e destino relativos a (possivelmente diferentes) descritores de diretório.
Descrição
Parte da família *at().
man 2Desde o kernel 2.6.16
Nota
Para as flags modernas (RENAME_NOREPLACE, RENAME_EXCHANGE, RENAME_WHITEOUT), use `renameat2` (syscall 316).
Assinatura
int renameat(
int olddirfd,
const char * oldpath,
int newdirfd,
const char * newpath
);Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| olddirfd | int | Descritor do diretório base da origem, ou AT_FDCWD. |
| oldpath | const char * | Caminho de origem. |
| newdirfd | int | Descritor do diretório base do destino, ou AT_FDCWD. |
| newpath | const char * | Caminho de destino. |
Registradores (x86_64)
| Registrador | Papel | Argumento |
|---|---|---|
| rax | número da syscall (chamada) / valor de retorno (após SYSCALL) | — |
| rdi | argumento 1 | olddirfdint |
| rsi | argumento 2 | oldpathconst char * |
| rdx | argumento 3 | newdirfdint |
| r10 | argumento 4 | newpathconst char * |
Valor de retorno
0 em sucesso; -1 em erro, com errno definido.
Códigos de erro (errno)
- EACCES(13)
- Permissão negada.
- EBUSY(16)
- Dispositivo ou recurso ocupado.
- EEXIST(17)
- Arquivo já existe.
- ENOTEMPTY(39)
- Diretório não vazio.
- EXDEV(18)
- Link cruzando dispositivos/sistemas de arquivos diferentes.