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

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.

OBSERVACIONES

       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)