Linux x86_64Sistema de arquivos#265
linkat
Como link, mas resolve origem e destino relativos a (possivelmente diferentes) descritores de diretório.
Descrição
Parte da família *at(); com AT_EMPTY_PATH e um descritor de arquivo aberto como `oldpath`, permite criar um link para um arquivo já sem nome (ex.: aberto com O_TMPFILE), 'materializando-o' no sistema de arquivos.
man 2Desde o kernel 2.6.16
Assinatura
int linkat(
int olddirfd,
const char * oldpath,
int newdirfd,
const char * newpath,
int flags
);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 * | Novo caminho a criar. |
| flags | int | AT_EMPTY_PATH, AT_SYMLINK_FOLLOW. |
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 * |
| r8 | argumento 5 | flagsint |
Valor de retorno
0 em sucesso; -1 em erro, com errno definido.
Códigos de erro (errno)
- EACCES(13)
- Permissão negada.
- EEXIST(17)
- Arquivo já existe.
- ENOENT(2)
- Arquivo ou diretório inexistente.
- EPERM(1)
- Operação não permitida (falta de privilégio).
- EXDEV(18)
- Link cruzando dispositivos/sistemas de arquivos diferentes.