Provided by: manpages-es_1.55-10_all bug

NOMBRE

       stat, fstat, lstat - obtiene el estado de un fichero

SINOPSIS

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

       int stat(const char *file_name, struct stat *buf);
       int fstat(int filedes, struct stat *buf);
       int lstat(const char *file_name, struct stat *buf);

DESCRIPCIÓN

       Estas  funciones  devuelven información del fichero especificado. No se
       necesitan derechos de acceso al fichero para conseguir  la  información
       pero  sí  se  necesitan derechos de búsqueda para todos los directorios
       del camino al fichero.

       stat examina el fichero al que apunta file_name y llena buf.

       lstat es idéntico a stat, salvo en caso de que se trate  de  un  enlace
       simbólico,  en  cuyo  caso se examina el enlace mismo, no el fichero al
       que hace referencia.

       fstat es idéntico a stat, pero sólo el  fichero  abierto  apuntado  por
       filedes  (tal  y  como  lo  devuelve  open(2)) es examinado en lugar de
       file_name.

       Todos devuelven una estructura stat, que contien los siguientes campos:

              struct stat {
                  dev_t         st_dev;      /* dispositivo */
                  ino_t         st_ino;      /* inodo */
                  mode_t        st_mode;     /* protección */
                  nlink_t       st_nlink;    /* número de enlaces físicos */
                  uid_t         st_uid;      /* ID del usuario propietario */
                  gid_t         st_gid;      /* ID del grupo propietario */
                  dev_t         st_rdev;     /* tipo dispositivo (si es
                                                dispositivo inodo) */
                  off_t         st_size;     /* tamaño total, en bytes */
                  blksize_t     st_blksize;  /* tamaño de bloque para el
                                                sistema de ficheros de E/S */
                  blkcnt_t      st_blocks;   /* número de bloques asignados */
                  time_t        st_atime;    /* hora último acceso */
                  time_t        st_mtime;    /* hora última modificación */
                  time_t        st_ctime;    /* hora último cambio */
              };

       El valor st_size da el tamaño del fichero (si es un fichero  regular  o
       un  enlace  simbólico) en bytes. El tamaño de un enlace simbólico es la
       longitud del nombre de ruta que contiene, sin contar  el  caracter  NUL
       final.

       El  valor  st_blocks  da el tamaño del fichero en bloques de 512 bytes.
       (Éste puede ser menor que st_size/512  p.e.  cuando  el  fichero  tenga
       huecos.)   El  valor st_blksize da el tamaño de bloque "preferido" para
       operaciones de E/S eficientes sobre el sistema de ficheros.   (Escribir
       en  un  fichero  en porciones más pequeñas puede producir una secuencia
       leer-modificar-reescribir ineficiente).

       No todos los sistemas de ficheros en Linux implementan todos los campos
       de  hora.  Algunos tipos de sistemas de ficheros permiten el montaje de
       tal manera que los accesos al fichero no provocan una actualización del
       campo st_atime (Vea `noatime' en mount(8).)

       El  campo  st_atime  es  modificado  por  accesos  al fichero, p.e. por
       execve(2), mknod(2), pipe(2),  utime(2)  y  read(2)  (de  más  de  cero
       bytes). Otras rutinas, como mmap(2), pueden o no actualizar st_atime.

       El  campo  st_mtime  es  modificado por cambios en el fichero, p.e. por
       mknod(2), truncate(2), utime(2) y write(2)  (de  más  de  cero  bytes).
       Además,  el  campo  st_mtime  de  un  directorio  es  modificado por la
       creación o borrado de ficheros en dicho directorio.  El campo  st_mtime
       no  es  modificado  por  cambios  en el propietario, grupo, contador de
       enlaces duros, o modo.

       El campo  st_ctime  es  modificado  por  la  escritura  o  por  cambiar
       información  del  inodo  (es  decir,  propietario,  grupo,  contador de
       enlaces, modo, etc.).

       Se definen las siguientes  macros  POSIX  para  comprobar  el  tipo  de
       fichero:

              S_ISLNK(m)  es un enlace simbólico?

              S_ISREG(m)  un fichero regular?

              S_ISDIR(m)  un directorio?

              S_ISCHR(m)  un dispositivo de caracteres?

              S_ISBLK(m)  un dispositivo de bloques?

              S_ISFIFO(m) una tubería nombrada (fifo)?

              S_ISLNK(m)  un enlace simbólico? (No presente en POSIX.1-1996.)

              S_ISSOCK(m) un conector (socket)? (No presente en POSIX.1-1996.)

       Se definen las siguientes banderas para el campo st_mode:

       S_IFMT     0017000   máscara de bits para los campos de bit del tipo
                            de fichero (no POSIX)
       S_IFSOCK   0140000   conector (no POSIX)
       S_IFLNK    0120000   enlace simbólico (no POSIX)
       S_IFREG    0100000   fichero regular (no POSIX)
       S_IFBLK    0060000   dispositivo de bloques (no POSIX)
       S_IFDIR    0040000   directorio (no POSIX)
       S_IFCHR    0020000   dispositivo de caracteres (no POSIX)
       S_IFIFO    0010000   fifo o tubería nombrada (no POSIX)
       S_ISUID    0004000   poner bit UID
       S_ISGID    0002000   poner bit GID
       S_ISVTX    0001000   sticky bit (no POSIX)
       S_IRWXU    00700     usuario (propietario del fichero) tiene permisos
                            de lectura, escritura y ejecución
       S_IRUSR    00400     usuario tiene premiso de lectura (igual que
                            S_IREAD, que no es POSIX)
       S_IWUSR    00200     usuario tiene premiso de escritura (igual que
                            S_IWRITE, que no es POSIX)
       S_IXUSR    00100     usuario tiene premiso de ejecución (igual que
                            S_IEXEC, que no es POSIX)
       S_IRWXG    00070     grupo tiene permisos de lectura, escritura y
                            ejecución
       S_IRGRP    00040     grupo tiene permiso de lectura
       S_IWGRP    00020     grupo tiene permiso de escritura
       S_IXGRP    00010     grupo tiene permiso de ejecución

       S_IRWXO    00007     otros tienen permisos de lectura, escritura y
                            ejecución
       S_IROTH    00004     otros tienen permiso de lectura
       S_IWOTH    00002     otros tienen permiso de escritura
       S_IXOTH    00001     otros tienen permiso de ejecución

       El   bit  SETGID  (S_ISGID)  tiene  varios  usos  especiales:  para  un
       directorio,  indica  que  se  va  a  usar  la  semántica  BSD  para  el
       directorio:  los ficheros creados allí heredarán su GID del directorio,
       no  del  GID  efectivo  del  proceso  que  crea  cada  fichero,  y  los
       directorios  creados  allí también tendrán el bit S_ISGID activo.  Para
       un fichero que no tiene el bit de ejecución del grupo (S_IXGRP) activo,
       indica bloqueo obligatorio de ficheros/registros.

       El  bit `sticky' (S_ISVTX) en un directorio significa que un fichero de
       ese directorio sólo puede ser renombrado o borrado por  el  propietario
       del fichero, por el propietario del directorio y por el superusuario.

VALOR DEVUELTO

       Se  devuelve cero si hubo éxito. Si hubo error, se devuelve -1, y errno
       es actualizado apropiadamente.

ERRORES

       EBADF  filedes incorrecto.

       ENOENT No existe un componente del camino file_name o el camino es  una
              cadena vacía.

       ENOTDIR
              Un componente del camino no es un directorio.

       ELOOP  Se  han  encontrado demasiados enlaces simbólicos al recorrer el
              camino.

       EFAULT Dirección errónea.

       EACCES Permiso denegado.

       ENOMEM Fuera de memoria (es decir, memoria del núcleo).

       ENAMETOOLONG
              Nombre de fichero demasiado largo.

CONFORME A

       Las llamadas stat y fstat conforman con SVr4, SVID, POSIX, X/OPEN y BSD
       4.3.  La  llamada  lstat  conforma  con  4.3BSD y SVr4.  SVr4 documenta
       condiciones de error adicionales de fstat: EINTR, ENOLINK y  EOVERFLOW.
       SVr4  documenta  condiciones  de  error  adicionales  de  stat y lstat:
       EACCES, EINTR, EMULTIHOP, ENOLINK y EOVERFLOW.  El uso  de  los  campos
       st_blocks y st_blksize puede ser poco portable. (Fueron introducidos en
       BSD. No están especificados por POSIX. La interpretación difiere  entre
       sistemas  y  posiblemente en un mismo sistema cuando están involucrados
       montajes NFS).

       POSIX no describe los bits S_IFMT, S_IFSOCK, S_IFLNK, S_IFREG, S_IFBLK,
       S_IFDIR, S_IFCHR, S_IFIFO y S_ISVTX, pero en su lugar demanda el uso de
       las macros S_ISDIR(), etc. Las macros S_ISLNK y S_ISSOCK  no  están  en
       POSIX.1-1996,  pero ambas formarán parte del próximo estándar POSIX; la
       primera es de SVID 4v2, la última de SUSv2.

       Unix V7 (y sistemas posteriores)  tenían  S_IREAD,  S_IWRITE,  S_IEXEC,
       donde POSIX prescribe los sinónimos S_IRUSR, S_IWUSR, S_IXUSR.

OTROS SISTEMAS

       Valores que han estado (o están) en uso en varios sistemas:

       hex    nombre     ls   octal    descripción
       f000   S_IFMT          170000   Máscara para el tipo de fichero
       0000                   000000   SCO: nodo-i fuera de servicio
                                       BSD: tipo desconocido
                                       SVID-v2 y XPG2: tienen tanto 0 como
                                       0100000 para ficheros ordinarios
       1000   S_IFIFO    p|   010000   Fifo (tubería con nombre)
       2000   S_IFCHR    c    020000   V7: fichero especial de caracteres
       3000   S_IFMPC         030000   V7: fichero especial de caracteres
                                       multiplexados
       4000   S_IFDIR    d/   040000   V7: directorio
       5000   S_IFNAM         050000   XENIX: fichero especial con nombre
                                       con dos subtipos, distinguidos
                                       por los valores st_rdev 1, 2:
       0001   S_INSEM    s    000001   XENIX: subtipo semáforo de IFNAM
       0002   S_INSHD    m    000002   XENIX: subtipo datos compartidos
                                       de IFNAM
       6000   S_IFBLK    b    060000   V7: fichero especial de bloques
       7000   S_IFMPB         070000   V7: fichero especial de bloques
                                       multiplexados
       8000   S_IFREG    -    100000   V7: fichero regular
       9000   S_IFCMP         110000   VxFS: fichero comprimido
       9000   S_IFNWK    n    110000   HP-UX: fichero especial de red
       a000   S_IFLNK    l@   120000   BSD: enlace simbólico
       b000   S_IFSHAD        130000   Solaris: nodo-i sombra para ACL
                                       (no visto por el espacio de usuario)
       c000   S_IFSOCK   s=   140000   BSD: conector (también "S_IFSOC" en VxFS)
       d000   S_IFDOOR   D>   150000   Solaris: puerta
       e000   S_IFWHT    w%   160000   BSD: `whiteout'(no usado para nodos-i)
       0200   S_ISVTX         001000   V7: `sticky bit': salvar el código
                                       intercambiado incluso después de usarse
                                       SVID-v2: reservado
                                       SunOS: En ficheros no directorios: no
                                       colocar en cache este fichero
                                       SVID-v4.2: En directorios: opción de
                                       elminación restringida
       0400   S_ISGID         002000   V7: SETGID al ejecuctar
                                       Para directorios: usar semántica BSD
                                       para propagación del GID
       0400   S_ENFMT         002000   SysV: Aplicar el bloqueo del fichero
                                       (compartido con S_ISGID)
       0800   S_ISUID         004000   V7: SETUID al ejecutar
       0800   S_CDF           004000   HP-UX: el directorio es un fichero
                                       dependiente del contexto

       Una orden `sticky' apareción en AT&T UNIX Version 32V.

VÉASE TAMBIÉN

       chmod(2), chown(2), readlink(2), utime(2)