1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" This manpage is Copyright (C) 1992 Drew Eckhardt;
.\" 1993 Ian Jackson.
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" Modified Sat Jul 24 13:00:50 1993 by Rik Faith <faith@cs.unc.edu>
.\" Modified Sun Sep 8 18:59:01 1996 by aeb following remarks by
.\" Arnt Gulbrandsen <agulbra@troll.no>
.\" Modified Fri Jan 31 23:49:15 1997 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified Thu May 17 12:15:26 2001 by aeb
.\"
.\" Traducción por Urko Lusa <ulusa@arrakis.es> 19980204
.\" Translation revised Mon Aug 17 1998 by Juan Piernas <piernas@ditec.um.es>
.\" Translation revised Thu Dec 31 1998 by Juan Piernas <piernas@ditec.um.es>
.\" Translation revised Mon Apr 17 2000 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH UNLINK 2 "21 agosto 1997" "Linux 2.0.30" "Manual del programador de Linux"
.SH NOMBRE
unlink \- borra un nombre y posiblemente el fichero al que hace referencia
.SH SINOPSIS
.B #include <unistd.h>
.sp
.BI "int unlink(const char *" pathname );
.SH DESCRIPCIÓN
.B 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.
.SH "VALOR DEVUELTO"
En caso de éxito, se devuelve cero. En caso de error, se
devuelve -1 y se establece el
.I errno
apropiado.
.SH ERRORES
.TP
.B EACCES
No se otorga permiso de escritura para el directorio contenido en
.I pathname
al identificador de usuario efectivo del proceso, o uno de los directorios
de
.IR pathname
no permite búsquedas (no tiene permiso de ejecución).
.TP
.BR EPERM " o " EACCES
El directorio contenido en
.I pathname
tiene puesto el
.I sticky-bit
.RB ( 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.
.TP
.BR EPERM " (sólo para Linux)"
El sistema de ficheros no permite el borrado de ficheros.
.TP
.B 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.)
.TP
.B EISDIR
.I pathname
hace referencia a un directorio.
(Este es el valor no conforme con POSIX devuelto por Linux desde la versión 2.1.132.)
.TP
.BR EBUSY " (no en Linux)"
El fichero
.I pathname
no puede ser borrado porque está siendo usado por el sistema
o por otro proceso y la implementación considera ésto un error.
.TP
.B EFAULT
.I pathname
apunta fuera del espacio de direcciones accesible.
.TP
.B ENAMETOOLONG
.IR pathname " es demasiado largo."
.TP
.B ENOENT
Un elemento en
.I pathname
no existe o es un enlace simbólico colgado, o
.I pathname
está vacío.
.TP
.B ENOTDIR
Un elemento usado como directorio en
.I pathname
no es en realidad un directorio.
.TP
.B ENOMEM
No hay suficiente memoria disponible en el núcleo.
.TP
.B EROFS
.I pathname
hace referencia a un fichero de un sistema de ficheros de sólo lectura.
.TP
.B ELOOP
Se encontraron demasiados enlaces simbólicos al traducir
.IR pathname .
.TP
.B EIO
Ocurrió un error de E/S.
.SH "CONFORME A"
SVr4, SVID, POSIX, X/OPEN, 4.3BSD. SVr4 documenta las condiciones de error
adicionales EINTR, EMULTIHOP, ETXTBSY, ENOLINK.
.SH FALLOS
Algunos hechos desafortunados en el protocolo NFS pueden causar la desaparición
inesperada de ficheros que siguen en uso.
.SH "VÉASE TAMBIÉN"
.BR link (2),
.BR rename (2),
.BR open (2),
.BR rmdir (2),
.BR mknod (2),
.BR mkfifo (3),
.BR remove (3),
.BR rm (1)
|
