LINK

Section: Manual del Programador de Linux (2)
Updated: 10 diciembre 1997
Index Return to Main Contents

NOMBRE

link - crea un nuevo nombre para un fichero

SINOPSIS

#include <unistd.h>

int link(const char *oldpath, const char *newpath);

DESCRIPCIÓN

link

crea un nuevo enlace (también conocido como enlace físico) a un fichero existente.

Si newpath existe, no será sobreescrito.

Este nuevo nombre podrá ser usado exactamente igual que el viejo para cualquier operación; ambos nombres se refieren al mismo fichero (y por lo tanto, tienen los mismos permisos y propietario) y es imposible decir qué nombre era el `original'.

VALOR DEVUELTO

Si hubo éxito, se devuelve cero. Si hubo error, se devuelve -1, y errno se actualiza apropiadamente.

ERRORES

EXDEV: oldpath y newpath no están en el mismo sistema de ficheros.
EPERM: El sistema de ficheros que contiene oldpath y newpath no soporta la creación de enlaces físicos.
EFAULT: oldpath o newpath apunta fuera de tu espacio de direcciones accesibles.
EACCES: El acceso de escritura al directorio que contiene newpath no está permitido para el uid efectivo del proceso, o uno de los directorios en oldpath o newpath no da permiso de búsqueda (ejecución).
ENAMETOOLONG: oldpath o newpath es demasiado largo.
ENOENT: Un componente del directorio en oldpath o newpath no existe o es un enlace simbólico colgado.
ENOTDIR: Un componente usado como directorio en oldpath o newpath no es, de hecho, un directorio.
ENOMEM: Memoria de núcleo insuficiente.
EROFS: El fichero está en un sistema de ficheros de sólo lectura.
EEXIST: newpath ya existe.
EMLINK: El fichero a que se refiere oldpath ya tiene el número máximo de enlaces a él.
ELOOP: Se han encontrado demasiados enlaces simbólicos al resolver oldpath o newpath.
ENOSPC: El dispositivo que contiene el fichero no tiene espacio para la nueva entrada de directorio.
EPERM: oldpath es un directorio.
EIO: Se ha producido un error de E/S.

NOTAS

Los enlaces físicos, tal y como los crea link, no pueden cruzar sistemas de ficheros. Utiliza symlink si esto es necesario.

CONFORME A

SVr4, SVID, POSIX, BSD 4.3 y X/OPEN. SVr4 documenta las condiciones de error adicionales ENOLINK y EMULTIHOP; POSIX.1 no documenta ELOOP. X/OPEN no documenta EFAULT, ENOMEM ni EIO.

FALLOS

En sistemas de ficheros NFS, el valor devuelto podría ser incorrecto en caso de que el servidor NFS lance la creación del enlace y muera antes de poder terminarlo. Utiliza stat(2) para averiguar si se creó el enlace.

VÉASE TAMBIÉN

symlink

(2), unlink(2), rename(2), open(2), stat(2), ln(1)

This document was created by man2html, using the manual pages.
Time: 06:16:20 GMT, January 22, 2005