chown(2) cambian el propietario de un fichero

Other Alias

fchown, lchown

SINOPSIS

#include <sys/types.h>
#include <unistd.h>

int chown(const char *path, uid_t owner, gid_t group);
int fchown(int fd, uid_t owner, gid_t group);
int lchown(const char *path, uid_t owner, gid_t group);

DESCRIPCIÓN

Cambia el propietario del fichero especificado por path o 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 owner o 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 también debe ocurrir cuando el superusuario realiza un chown; el comportamiento de Linux depende de la versión del núcleo. 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 chown.

VALOR DEVUELTO

En caso de éxito, devuelve 0. Si se encuentra algún error, devuelve -1, y a errno se le asigna un valor apropiado.

ERRORES

Dependiendo del sistema de ficheros, se pueden generar otros errores. Los errores más generales para chown son:

EPERM
El UID efectivo no coincide con el propietario del fichero, y no es cero; o el propietario (owner) o grupo (group) han sido especificados incorrectamente.
EROFS
El fichero en cuestión reside en un sistema de ficheros de sólo lectura.
EFAULT
path apunta fuera de su espacio de direcciones accesible.
ENAMETOOLONG
path es demasiado largo.
ENOENT
El fichero no existe.
ENOMEM
No había suficiente memoria disponible en el núcleo.
ENOTDIR
Un componente del camino path no es un directorio.
EACCES
Permiso de busqueda denegado en un componente del camino (path).
ELOOP
Se encontraron demasiados enlaces simbólicos al resolver path.

Los errores comunes para fchown se listan a continuación:

EBADF
El descriptor no es válido.
ENOENT
Lea nota anterior.
EPERM
Lea nota anterior.
EROFS
Lea nota anterior.
EIO
Ocurrió un error de E/S de bajo nivel mientras se modificaba el nodo-i.

OBSERVACIONES

En las versiones de Linux anteriores a la 2.1.81 (y distintas de la 2.1.46), chown no seguía los enlaces simbólicos. Desde la versión 2.1.81 de Linux chown sigue los enlaces simbólicos y existe una nueva llamada al sistema, lchown, que no sigue los enlaces simbólicos. Desde la versión 2.1.86 de Linux, esta nueva llamada (que tiene la misma semántica que la antigua chown) tiene el mismo número de llamada al sistema y chown obtiene el número recién introducido.

El prototipo para fchown sólo está disponible si se ha definido _BSD_SOURCE(bienexplícitamente,oexplícitamente,alnodefinir _POSIX_SOURCE o compilando con la opción -ansi).

CONFORME A

La llamada chown es conforme a SVr4, SVID, POSIX y X/OPEN. La versión de esta llamada en 4.4BSD sólo 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.

La llamada fchown es conforme a 4.4BSD y SVr4. SVr4 documenta además las condiciones de error EINVAL, EIO, EINTR y ENOLINK.

RESTRICCIONES

La semántica de chown() es violada deliberadamente en los sistemas de ficheros NFS que han habilitado la asociación del UID. Además, se viola la semántica de todas las llamadas al sistema que acceden a los contenidos de los ficheros ya que chown() pueden producir la revocación de acceso inmediata sobre ficheros ya abiertos. La ocultación (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.