Provided by: manpages-es_1.55-10_all bug

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)