NOMBRE
chmod, fchmod − cambia los permisos de un fichero
SINOPSIS
#include
<sys/types.h>
#include <sys/stat.h>
int
chmod(const char *path, mode_t
mode);
int fchmod(int fildes, mode_t
mode);
DESCRIPCIÓN
Cambia el modo del fichero dado mediante path o referido por fildes
Los modos se especifican mediante un O lógico de los siguientes valores:
|
S_ISUID |
04000 asignar ID de usuario al ejecutar |
|||
|
S_ISGID |
02000 asignar ID de group al ejecutar |
|||
|
S_ISVTX |
01000 bit pegajoso (sticky bit) |
S_IRUSR (S_IREAD)
00400 lectura para el propietario
S_IWUSR (S_IWRITE)
00200 escritura para el propietario
S_IXUSR (S_IEXEC)
00100 ejecución/busqueda para el propietario
|
S_IRGRP |
00040 lectura para el grupo |
|||
|
S_IWGRP |
00020 escritura para el grupo |
|||
|
S_IXGRP |
00010 ejecución/busqueda para el grupo |
|||
|
S_IROTH |
00004 lectura para otros |
|||
|
S_IWOTH |
00002 escritura para otros |
|||
|
S_IXOTH |
00001 ejecución/busqueda para otros |
El UID efectivo del proceso debe ser cero o debe coincidir con el propietario del fichero.
Si el UID efectivo del proceso no es cero y el grupo del fichero no coincide con el ID de grupo efectivo del proceso o con uno de sus IDs de grupo sumplementarios, el bit S_ISGID se desactivará, aunque esto no provocará que se devuelva un error.
Dependiendo del sistema de ficheros, los bits S_ISUID y S_ISGID podrían desactivarse si el fichero es escrito. En algunos sistemas de ficheros, solo el superusuario puede asignar el bit pegajoso, lo cual puede tener un significado especial. Para el bit pegajoso, y para los bits SUID y SGID sobre directorios, véase stat(2).
En sistemas de ficheros NFS, la restricción de permisos influirá inmediatamente en los ficheros ya abiertos, ya que el control de acceso se hacen en el servidor, pero los ficheros abiertos son mantenidos por el cliente. La ampliación de permisos puede verse retrasada para otros clientes si en ellos está habilitada la ocultación (caching) de atributos.
VALOR DEVUELTO
En caso de éxito, devuelve 0. En caso de error, −1 y se asigna a la variable errno un valor adecuado.
ERRORES
Dependiendo del sistema de ficheros, se pueden devolver otros errores. Los más generales para chmod están listados a continuación:
|
EPERM |
El UID efectivo no coincide con el propietario del fichero, o no es cero. | ||
|
EROFS |
El fichero nombrado reside en un sistema de ficheros de sólo lectura. | ||
|
EFAULT |
path apunta fuera del espacio de direcciones accesible. |
ENAMETOOLONG
path es demasiado largo.
|
ENOENT |
El fichero no existe. |
|||
|
ENOMEM |
No hubo suficiente memoria en el núcleo. |
ENOTDIR
Un componente del camino path no es un directorio.
|
EACCES |
Se ha denegado el permiso de búsqueda para uno de los componentes del camino. | ||
|
ELOOP |
Se han encontrado demasiados enlaces simbólicos al resolver path. | ||
|
EIO |
Ha ocurrido un error de E/S. |
Los errores comunes para fchmod son:
|
EBADF |
El descriptor de fichero fildes no es válido. |
|||
|
EROFS |
Lea nota anterior. |
|||
|
EPERM |
Lea nota anterior. |
|||
|
EIO |
Lea nota anterior. |
CONFORME A
La llamada chmod conforma con SVr4, SVID, POSIX, X/OPEN, 4.4BSD. SVr4 documenta además las condiciones de error EINTR, ENOLINK y EMULTIHOP, pero no ENOMEM. POSIX.1 no documenta las condiciones de error EFAULT, ENOMEM, ELOOP y EIO, ni las macros S_IREAD, S_IWRITE y S_IEXEC.
La llamada fchmod conforma con 4.4BSD y SVr4. SVr4 documenta además las condiciones de error EINTR y ENOLINK. Si se define al menos una de la variables _POSIX_MAPPED_FILES o _POSIX_SHARED_MEMORY_OBJECTS, POSIX exige la función fchmod y documenta las condiciones de error adicionales ENOSYS y EINVAL, pero no documenta EIO.