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).
|