File: chown.2

package info (click to toggle)
manpages-es 1.24a-6
  • links: PTS
  • area: main
  • in suites: potato
  • size: 4,256 kB
  • ctags: 7
  • sloc: makefile: 66; sh: 62
file content (186 lines) | stat: -rw-r--r-- 6,268 bytes parent folder | download
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
174
175
176
177
178
179
180
181
182
183
184
185
186
.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
.\" Copyright (c) 1998 Andries Brouwer (aeb@cwi.nl)
.\"
.\" 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 by Michael Haardt (u31b3hs@pool.informatik.rwth-aachen.de)
.\" Modified Wed Jul 21 21:53:01 1993 by Rik Faith (faith@cs.unc.edu)
.\" Translated 18 Dec 1995 Miguel A. Sepulveda (miguel@typhoon.harvard.edu)
.\" Modified 1 Jul 1996 Miguel A. Sepulveda (angel@vivaldi.princeton.edu)
.\" Modified Tue Jul  9 13:59:51 1996 by Andries Brouwer <aeb@cwi.nl>
.\" Modified Wed Nov  6 03:49:07 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified Sun May 18 10:34:09 1997 by Michael Haardt <michael@cantor.informatik.rwth-aachen.de>
.\" Translation revised 21 April 1998 by Juan Piernas <piernas@dif.um.es>
.\" Translation revised 17 August 1998 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH CHOWN 2 "18 Mayo 1997" "Linux 2.1.81" "Manual del Programador de Linux"
.SH NOMBRE
chown, fchown, lchown \- cambian el propietario de un fichero
.SH SINOPSIS
.B #include <sys/types.h>
.br
.B #include <unistd.h>
.sp
.BI "int chown(const char *" path ", uid_t " owner ", gid_t " group );
.br
.BI "int fchown(int " fd ", uid_t " owner ", gid_t " group );
.br
.BI "int lchown(const char *" path ", uid_t " owner ", gid_t " group );
.SH DESCRIPCIN
Cambia el propietario del fichero especificado por
.I path
o 
.IR fd .
Solamente el superusuario puede cambiar el propietario de un fichero.
El propietario de un fichero puede cambiar el grupo de dicho fichero a
cualquier grupo al que dicho usuario pertenezca. El superusuario
puede cambiar el grupo arbitrariamente.

Si a 
.I owner
o 
.I group
se asigna \-1, entonces dicho ID no se altera.

Cuando un no superusuario cambia el propietario o grupo de un fichero
ejecutable, se limpian los bits de modo S_ISUID y S_ISGID. POSIX no
especifica si esto tambin debe ocurrir cuando el superusuario realiza un
.IR chown ;
el comportamiento de Linux depende de la versin del ncleo. En el caso de
un fichero no ejecutable para el grupo (con el bit S_IXGRP limpio) el bit
S_ISGID indica un bloqueo obligatorio y no se limpia al ejecutar
.IR chown .

.SH "VALOR DEVUELTO"
En caso de xito, devuelve 0. Si se encuentra algn error, devuelve \-1, y a
.I errno
se le asigna un valor apropiado.
.SH ERRORES
Dependiendo del sistema de ficheros, se pueden generar otros errores.
Los errores ms generales para
.B chown
son:

.TP 0.8i
.B EPERM
El UID efectivo no coincide con el propietario del fichero, y no es cero;
o el propietario
.I (owner)
o grupo 
.I (group)
han sido especificados incorrectamente. 
.TP
.B EROFS
El fichero en cuestin reside en un sistema de ficheros de slo lectura.
.TP
.B EFAULT
.I path
apunta fuera de su espacio de direcciones accesible.
.TP
.B ENAMETOOLONG
.I path
es demasiado largo.
.TP
.B ENOENT
El fichero no existe.   
.TP
.B ENOMEM
No haba suficiente memoria disponible en el ncleo.
.TP
.B ENOTDIR
Un componente del camino
.I path
no es un directorio.
.TP
.B EACCES
Permiso de busqueda denegado en un componente del camino (path).
.TP
.B ELOOP
Se encontraron demasiados enlaces simblicos al resolver
.IR path .
.PP
Los errores comunes para
.B fchown
se listan a continuacin:
.TP 0.8i
.B EBADF
El descriptor no es vlido.
.TP
.B ENOENT
Lea nota anterior.
.TP
.B EPERM
Lea nota anterior.
.TP
.B EROFS
Lea nota anterior.
.TP
.B EIO
Ocurri un error de E/S de bajo nivel mientras se modificaba el nodo\-i.
.SH NOTAS
En las versiones de Linux anteriores a la 2.1.81 (y distintas de la 2.1.46),
.B chown
no segua los enlaces simblicos.
Desde la versin 2.1.81 de Linux
.B chown
sigue los enlaces simblicos y existe una nueva llamada al sistema, 
.BR lchown ,
que no sigue los enlaces simblicos.
Desde la versin 2.1.86 de Linux, esta nueva llamada (que tiene la misma
semntica que la antigua
.BR chown )
tiene el mismo nmero de llamada al sistema y
.B chown
obtiene el nmero recin introducido.
.LP
El prototipo para
.B fchown
slo est disponible si se ha definido
.BR __USE_BSD .
.SH "CONFORME A"
La llamada
.B chown
es conforme a SVr4, SVID, POSIX y X/OPEN.  La versin de esta llamada en 4.4BSD
slo puede ser usada por el superusuario (es decir, los usuarios ordinarios
no pueden dar ficheros a otros usuarios).
SVr4 documenta otras condiciones de error como EINVAL, EINTR, ENOLINK y
EMULTIHOP, pero no ENOMEM.  POSIX.1 no documenta las codiciones de error
ENOMEM ni ELOOP.
.PP
La llamada
.B fchown
es conforme a 4.4BSD y SVr4.
SVr4 documenta adems las condiciones de error EINVAL, EIO, EINTR y ENOLINK.
.SH RESTRICCIONES
La semntica de \fBchown\fP() es violada deliberadamente en los sistemas de
ficheros NFS que han habilitado la asociacin del UID. Adems, se viola la
semntica de todas las llamadas al sistema que acceden a los contenidos de
los ficheros ya que \fBchown\fP() pueden producir la revocacin de acceso
inmediata sobre ficheros ya abiertos. La ocultacin (caching) en los
clientes puede producir retrasos entre el instante en que la propiedad ha
sido cambiada para permitir el acceso de un usuario y el instante en que el
fichero puede realmente ser accedido por el usuario en otros clientes.

.SH "VASE TAMBIN"
.BR chmod (2),
.BR flock (2).