NOMBRE

       chown, fchown, lchown - cambian el propietario de un fichero

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.

VÉASE TAMBIÉN

       chmod(2), flock(2).