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
|
.\" This file is derived from unlink.2, which has the following copyright:
.\"
.\" --snip--
.\" 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.
.\" --snip--
.\"
.\" Edited into remove.3 shape by:
.\" Graeme W. Wilford (G.Wilford@ee.surrey.ac.uk) on 13th July 1994
.\"
.\" Translated 5 Feb 1998 by
.\" Vicente Pastor Gmez <VPASTORG@santandersupernet.com , vicpastor@hotmail.com>
.\" Translation revised on Tue Apr 6 1999 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH REMOVE 3 "13 Jul 1994" Linux "GNU"
.SH NOMBRE
remove \- borra un nombre y posiblemente el fichero a que se refiere
.SH SINOPSIS
.B #include <stdio.h>
.sp
.BI "int remove(const char *" pathname );
.SH DESCRIPCIN
.B remove
borra un nombre del sistema de ficheros. La funcin llama a
.I unlink
para ficheros y a
.I rmdir
para directorios.
Si el nombre borrado es el ltimo enlace
a un fichero y este no est abierto por ningn proceso, el fichero es
borrado y el espacio que utilizaba queda disponible para ser reutilizado.
Si el nombre es el ltimo enlace a un fichero, pero algn proceso an lo
tiene abierto, el fichero sigue existiendo hasta que sea cerrado el ltimo
descriptor de fichero referente a l.
Si el nombre se refiere a un enlace simblico, se borra el enlace.
Si el nombre se refiere a un enchufe (socket), fifo, o dispositivo, se borra
el nombre, pero los procesos que tienen este objeto abierto pueden continuar
usndolo.
.SH "VALOR DEVUELTO"
Si hay xito, se devuelve cero. Si ocurre un error, se devuelve \-1, y
.I errno
se actualiza apropiadamente.
.SH ERRORES
.TP 0.8i
.B EFAULT
.IR pathname " apunta fuera del espacio de direcciones accesible."
.TP
.B EACCES
No se permite al uid efectivo del proceso el acceso de escritura al directorio
que contiene
.I pathname
, o uno de los directorios en
.IR pathname
no da permiso de bsqueda (ejecucin).
.TP
.B EPERM
El directorio que contiene
.I pathname
tiene el sticky-bit
.RB ( S_ISVTX )
puesto a 1, y el uid efectivo del proceso no es ni el uid del fichero a borra,
ni el del directorio que lo contiene o
.I pathname
es un directorio.
.TP
.B ENAMETOOLONG
.IR pathname " es demasiado largo."
.TP
.B ENOENT
Un directorio componente en
.I pathname
no existe, o es un enlace simblico colgado.
.TP
.B ENOTDIR
Un componente usado como directorio en
.I pathname
no es, en realidad, un directorio.
.TP
.B ENOMEM
No hay disponible suficiente memoria de ncleo.
.TP
.B EROFS
.I pathname
se refiere a un fichero en un sistema de ficheros de slo lectura.
.SH "CONFORME A"
ANSI C, SVID, AT&T, POSIX, X/OPEN, BSD 4.3
.SH FALLOS
Algunos fallos desafortunados en el protocolo subyacente a NFS pueden causar
la desaparicin inesperada de ficheros que an estaban siendo usados.
.SH NOTA
Bajo libc4 y libc5,
.B remove
era un alias de unlink (y, por lo tanto, no eliminaba directorios).
.SH "VASE TAMBIN"
.BR unlink "(2), " rename "(2), " open "(2), " rmdir (2),
.BR mknod "(2), " mkfifo "(3), " link "(2), " rm "(1), " unlink (8).
|