Provided by:
manpages-es_1.55-10_all 
NOMBRE
link - crea un nuevo nombre para un fichero
SINOPSIS
#include <unistd.h>
int link(const char *oldpath, const char *newpath);
DESCRIPCI'ON
link crea un nuevo enlace (tambien conocido como enlace fisico) a un
fichero existente.
Si newpath existe, no sera sobreescrito.
Este nuevo nombre podra ser usado exactamente igual que el viejo para
cualquier operacion; ambos nombres se refieren al mismo fichero (y por
lo tanto, tienen los mismos permisos y propietario) y es imposible
decir que nombre era el `original'.
VALOR DEVUELTO
Si hubo exito, se devuelve cero. Si hubo error, se devuelve -1, y errno
se actualiza apropiadamente.
ERRORES
EXDEV oldpath y newpath no estan en el mismo sistema de ficheros.
EPERM El sistema de ficheros que contiene oldpath y newpath no soporta
la creacion de enlaces fisicos.
EFAULT oldpath o newpath apunta fuera de tu espacio de direcciones
accesibles.
EACCES El acceso de escritura al directorio que contiene newpath no
esta permitido para el uid efectivo del proceso, o uno de los
directorios en oldpath o newpath no da permiso de busqueda
(ejecucion).
ENAMETOOLONG
oldpath o newpath es demasiado largo.
ENOENT Un componente del directorio en oldpath o newpath no existe o es
un enlace simbolico colgado.
ENOTDIR
Un componente usado como directorio en oldpath o newpath no es,
de hecho, un directorio.
ENOMEM Memoria de nucleo insuficiente.
EROFS El fichero esta en un sistema de ficheros de solo lectura.
EEXIST newpath ya existe.
EMLINK El fichero a que se refiere oldpath ya tiene el numero maximo de
enlaces a el.
ELOOP Se han encontrado demasiados enlaces simbolicos 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.
OBSERVACIONES
Los enlaces fisicos, 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 podria ser incorrecto en
caso de que el servidor NFS lance la creacion del enlace y muera antes
de poder terminarlo. Utiliza stat(2) para averiguar si se creo el
enlace.
V'EASE TAMBI'EN
symlink(2), unlink(2), rename(2), open(2), stat(2), ln(1)