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
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
|
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" This manpage is Copyright (C) 1992 Drew Eckhardt;
.\" 1993 Michael Haardt;
.\" 1993,1995 Ian Jackson.
.\"
.\" La venia es concedida para hacer y distribuir copias verbatim de este
.\" manual provisto de copyright y esta venia preserva sobre todas las copias.
.\"
.\" La venia es concedida para copiar y distribuir versiones modificadas de este
.\" manual bajo las condiciones de copiado de verbatim, siempre que el completo
.\" resultado derivado del trabajo sea distribudo bajo los trminos de una venia
.\" idntica a sta.
.\"
.\" Ya que el kernel de Linux y las biliotecas estn constantemente cambiando,
.\" esta pgina puede ser incorrecta o desactualizada. El autor(es) no asumen
.\" reponsabilidades referentes a errores u omisiones, o resultados peligrosos
.\" derivados del uso de esta informacin aqu contenida. EL autor(es) no deben
.\" de haber tenido el mismo nivel de cuidad en la produccin de este manual,
.\" el cul est libre de cargo por licencia, como han podido cuando trabajan
.\" profesionalmente.
.\"
.\" Versiones formateadas o procesadas de este manual, si no estn acompaadas por
.\" la fuente, deben reconocer el copyright y el autor de este trabajo.
.\"
.\" Modified Sat Jul 24 00:35:52 1993 by Rik Faith <faith@cs.unc.edu>
.\"
.TH RENAME 2 "24 Julio 1993" "Linux 0.99.7" "Manual del Programador de Linux"
.SH NOMBRE
rename \- cambia el nombre o localizacion de un fichero
.SH SINOPSIS
.B #include <unistd.h>
.sp
.BI "int rename(const char *" antiguo-path ", const char *" nuevo-path );
.SH DESCRIPCIN
.B rename
renombra un fichero, movindolo entre directorios si se requiere.
Cualquier otro nexo al archivo (como los creados usando
.BR link )
no son afectados.
Si
.I newpath
todava existe ser automticamente sobreescrito (sujeto a
a unas pocas condiciones - ver ERRORES ms adelante),no obstante
no hay punto al cual otro proceso que intente acceder a
.I newpath
se encontrar extraando.
Si
.I newpath
existe pero la operacin falla por cualqier circunstancia o el sistema cae,
.B rename
da garantas para dejar una instancia de
.I newpath
en el lugar.
Como siempre, cuando se sobreescribe habra probablemente una ventana en la cual
.I oldpath
y
.I newpath
se refieren al archivo inicialmente renombrado.
Si
.I oldpath
se refiere a un enlace simblico, el enlace es renombrado; si
.I newpath
se refiere a un enlace simblico el enlace ser sobreescrito.
.SH "VALORES DEVULTOS"
Si xito, cero es devuelto. Si error, \-1 es devuelto, y
.I errno
est configurado apropiadamente.
.SH ERRORES
.TP 0.8i
.B EISDIR
.I newpath
es un directorio existente, pero
.I oldpath
no es un directorio.
.TP
.B EXDEV
.IR oldpath " y " newpath
no estn en e mismo sistema de ficheros.
.TP
.B ENOTEMPTY
.IR newpath
es un directorio no vaco.
.TP
.B EBUSY
.I newpath
existe y es el actual directorio de trabajo o directoio root de algunos
procesos.
.TP
.B EEXIST
El nuevo pathname contiene un prefijo de path del anterior.
.TP
.B EINVAL
Fue hecho un intento de crear un directorio un subdirectoirio de s mismo.
.TP
.B EMLINK
.I oldpath
todava tiene el mximo nmero de enlaces a l, o
era un directorio y del directorio que contena
.I newpath
tena el mximo nmero de enlace.
.TP
.B ENOTDIR
Un componente usado como un directorio en
.IR oldpath " o " newpath
no es, de hecho, un directorio.
.TP
.B EFAULT
.IR oldpath " o " newpath " apuntan fuera de su
espacio de direccionamiento accesible."
.TP
.B EACCES
El acceso de escritura del directorio que contena
.IR oldpath " o " newpath
no est permitido por el proceso uid efectivo, o uno de los
directorios en
.IR oldpath " o " newpath
no permiten permisos de bsqueda(ejecucin), o
.I oldpath
era un directorio y no permiti el permiso de escrituradid (necesitado para actualizar
la
.B ..
entrada).
.TP
.B EPERM
El directorio que contena
.I oldpath
tiene activo el sticky-bit set y el efectivo proceso de uid no es ni el
uid del fichero a ser borrado ni ese directorio que lo contiene,
o el sistema de ficheros que contiene
.IR pathname
no soporta renombramientos de los tipos requeridos.
.TP
.B ENAMETOOLONG
.IR oldpath " o " newpath " eran demasiado largos."
.TP
.B ENOENT
Un componente del directorio en
.I oldpath " o " newpath
no existe o es un enlace simblico balanceado(supongo inistable).
.TP
.B ENOMEM
Insuficiente memoria kernel estaba disponible.
.TP
.B EROFS
El fichero est en un sistema de ficheros de slo lectura.
.TP
.B ELOOP
.IR oldpath " o " newpath
contienen una referencia a un enlace simblico circular, es decir, un enlace simblico
, cuya expancin contiene una referencia asmismo.
.TP
.B ENOSPC
El dispositivo que contiene el fichero no tiene habitacin(supongo espacio)para la nueva
entrada de diretorio.
.SH "CONFORME A"
POSIX, 4.3BSD, ANSI C
.SH BUGS
En los sistemas de ficheros NFS, usted puede no asumir que si la operacin
falla el fichero no habr sido renombrado. Si el servidor hace la operacin de renombrar
y luego cae, el RPC transmitido, el cual ser procesado cuando el servidor
se levante de nuevo, causar u fallo. The application is expected to
deal with this. Ver
.IR link (2)
para problemas similares.
.SH "VER TAMBIN"
.BR link "(2), " unlink "(2), " symlink "(2), " mv "(1)."
|
