Voltar à lista
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âmetroTipoDescrição
olddirfdintDescritor do diretório base da origem, ou AT_FDCWD.
oldpathconst char *Caminho de origem.
newdirfdintDescritor do diretório base do destino, ou AT_FDCWD.
newpathconst char *Caminho de destino.

Registradores (x86_64)

RegistradorPapelArgumento
raxnúmero da syscall (chamada) / valor de retorno (após SYSCALL)
rdiargumento 1olddirfdint
rsiargumento 2oldpathconst char *
rdxargumento 3newdirfdint
r10argumento 4newpathconst 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.

Relacionadas