NOMBRE

       unlink - borra un nombre y posiblemente el fichero al que hace referencia

SINOPSIS

       #include <unistd.h>

       int unlink(const char *pathname);

DESCRIPCIÓN

       unlink  borra un nombre del sistema de ficheros. Si dicho nombre era el último enlace a un
       fichero, y ningún proceso tiene el fichero abierto, el fichero es borrado y el espacio que
       ocupaba vuelve a estar disponible.

       Si  el  nombre  era  el  último  enlace a un fichero, pero algún proceso sigue teniendo el
       fichero abierto, el fichero seguirá existiendo hasta que el último descriptor  de  fichero
       referente a él sea cerrado.

       Si el nombre hacía referencia a un enlace simbólico, el enlace es eliminado.

       Si  el  nombre  hacía  referencia a un socket, fifo o dispositivo, el nombre es eliminado,
       pero los procesos que tengan el objeto abierto pueden continuar usándolo.

VALOR DEVUELTO

       En caso de éxito, se devuelve cero. En caso de  error,  se devuelve -1 y se  establece  el
       errno apropiado.

ERRORES

       EACCES No  se  otorga  permiso  de  escritura  para el directorio contenido en pathname al
              identificador de usuario efectivo del proceso, o uno de los directorios de pathname
              no permite búsquedas (no tiene permiso de ejecución).

       EPERM o EACCES
              El  directorio  contenido  en  pathname  tiene puesto el sticky-bit (S_ISVTX), y el
              identificador de usuario efectivo del proceso no es el identificador de usuario del
              fichero a borrar ni el del directorio que lo contiene.

       EPERM (sólo para Linux)
              El sistema de ficheros no permite el borrado de ficheros.

       EPERM  El  sistema  no  permite  el  borrado  de  directorios, o el borrado de directorios
              requiere privilegios que el proceso actual no tiene.  (Esta es el código  de  error
              recomendado por POSIX.)

       EISDIR pathname  hace referencia a un directorio.  (Este es el valor no conforme con POSIX
              devuelto por Linux desde la versión 2.1.132.)

       EBUSY (no en Linux)
              El fichero pathname no puede ser borrado porque está siendo usado por el sistema  o
              por otro proceso y la implementación considera ésto un error.

       EFAULT pathname apunta fuera del espacio de direcciones accesible.

       ENAMETOOLONG
              pathname es demasiado largo.

       ENOENT Un elemento en pathname no existe o es un enlace simbólico colgado, o pathname está
              vacío.

       ENOTDIR
              Un elemento usado como directorio en pathname no es en realidad un directorio.

       ENOMEM No hay suficiente memoria disponible en el núcleo.

       EROFS  pathname hace referencia a un fichero de un sistema de ficheros de sólo lectura.

       ELOOP  Se encontraron demasiados enlaces simbólicos al traducir pathname.

       EIO    Ocurrió un error de E/S.

CONFORME A

       SVr4, SVID, POSIX, X/OPEN, 4.3BSD.  SVr4 documenta las condiciones  de  error  adicionales
       EINTR, EMULTIHOP, ETXTBSY, ENOLINK.

FALLOS

       Algunos hechos desafortunados en el protocolo NFS pueden causar la desaparición inesperada
       de ficheros que siguen en uso.

VÉASE TAMBIÉN

       link(2), rename(2), open(2), rmdir(2), mknod(2), mkfifo(3), remove(3), rm(1)