Provided by:
manpages-es_1.55-8_all 
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)