NOMBRE

       access - comprueba los permisos de usuario para un fichero

SINOPSIS

       #include <unistd.h>

       int access(const char *pathname, int mode);

DESCRIPCIÓN

       access  comprueba  si al proceso se le permitiría leer, escribir o comprobar la existencia del fichero (u
       otro objeto del sistema de ficheros) cuyo nombre es pathname.  Si pathname  es  un  enlace  simbólico  se
       comprueban los permisos del fichero referenciado por dicho enlace simbólico.

       mode es una máscara compuesta por uno o más de los siguientes elementos: R_OK, W_OK, X_OK y F_OK.

       R_OK,  W_OK  y  X_OK  se  utilizan  para  la  comprobación de lectura, escritura o ejecución del fichero,
       respectivamente.  F_OK se utiliza para ver si se permite  la  mera  comprobación  de  la  existencia  del
       fichero.  Esto depende de los permisos de los directorios que aparecen en el camino hasta el fichero, tal
       como se da en pathname, y de los permisos de los directorios y ficheros  referenciados  por  los  enlaces
       simbólicos que se pueden encontrar a lo largo del camino.

       La comprobación se realiza con los uid y gid reales del proceso, en lugar de utilizar los identificadores
       efectivos, tal como se hace cuando realmente se intenta una operación. Esto permite a los  programas  con
       el bit SETUID activo determinar fácilmente la autoridad del usuario invocador.

       Sólo  se  comprueban  los  bits  de  acceso,  no  el  tipo  de fichero o sus contenidos. Por lo tanto, si
       encontramos que un directorio se puede "escribir", probablemente  esto  significa  que  se  pueden  crear
       ficheros  en  el  directorio,  no  que  el  directorio  se  pueda  escribir  como se hace con un fichero.
       Similarmente, podemos encontrar un fichero DOS como "ejecutable" y, aún así, puede fallar una  llamada  a
       execve(2).

       Si  el  proceso tiene los privilegios apropiados, una implementación puede indicar éxito para X_OK aun si
       ninguno de los bits de permiso de ejecución del fichero están activos.

VALOR DEVUELTO

       Si ha habido éxito (se han concedido todos los permisos solicitados) la función devuelve un valor  0.  Si
       se  ha  producido  un  error (al menos, uno de los bits de mode ha interrogado por un permiso que ha sido
       denegado, o ha ocurrido algún otro tipo de error), la función devuelve -1 y a errno se le asigna un valor
       adecuado.

ERRORES

       access fallará si:

       EACCES Se  denegaría  el acceso solicitado al fichero o se deniega el permiso de búsqueda para uno de los
              directorios en pathname.

       ELOOP  Se han encontrado demasiados enlaces simbólicos al resolver pathname.

       ENAMETOOLONG
              pathname es demasiado largo.

       ENOENT Un directorio componente de pathname es accesible pero no existe o es un enlace simbólico colgado.

       ENOTDIR
              Un componente usado como directorio en pathname no es, de hecho, un directorio.

       EROFS  Se ha solicitado permiso de escritura para un fichero en un sistema de ficheros de sólo lectura.

       access puede fallar si:

       EFAULT pathname apunta fuera del espacio de direcciones al que tiene acceso."

       EINVAL mode se ha especificado incorrectamente

       ENOMEM No hay suficiente memoria disponible en el núcleo.

       EIO    Ha ocurrido un error de E/S.

       ENOMEM Memoria del núcleo insuficiente.

       ETXTBSY
              Se requiere acceso de escritura para un ejecutable que está siendo ejecutado.

RESTRICCIONES

       access regresa un error si falla cualquiera de los tipos de acceso  especificados  en  la  llamada  a  la
       función, aunque los otros tipos tuvieran éxito.

       access  no  puede  funcionar correctamente sobre sistemas de ficheros NFS que tengan activa la aplicación
       del UID, porque la aplicación del UID se realiza en el servidor y se oculta a los clientes que comprueban
       los permisos.

       Usar  access  para  comprobar si un usuario está autorizado a, por ejemplo, abrir un fichero antes de que
       realmente lo haga usando open(2), crea un agujero de seguridad ya que el usuario podría explotar el breve
       intervalo de tiempo que hay entre la comprobación y la apertura del fichero para manipularlo.

CONFORME A

       SVID, AT&T, POSIX, X/OPEN, BSD 4.3

VÉASE TAMBIÉN

       stat(2), open(2), chmod(2), chown(2), setuid(2), setgid(2)