Cómo usar stat en Linux para consultar metadatos

comando-stat
comando-stat

El comando stat en Linux muestra metadatos de archivos y directorios: permisos, propietario, tamaño, inode y fechas. También puede consultar el sistema de archivos donde reside una ruta. Su ventaja frente a ls es que permite pedir campos concretos y obtener un formato repetible para revisar varios archivos.

Esta guía se basa en GNU stat, incluido en la mayoría de distribuciones GNU/Linux. Algunas opciones y formatos pueden variar en otros sistemas. Los ejemplos crean una carpeta de prueba en /tmp y distinguen con claridad los datos de un archivo de los datos de su sistema de archivos.

Qué información muestra el comando stat en Linux

Sin opciones, stat imprime un resumen detallado de cada ruta. En un archivo regular verás el tipo, el tamaño lógico en bytes, los bloques asignados, los permisos, el propietario y las marcas de tiempo. El tamaño lógico no siempre coincide con el espacio físico ocupado en disco, por ejemplo en archivos dispersos.

Una fecha que suele confundir es el cambio de estado: no es la fecha de creación. La marca de modificación cambia al modificar el contenido; la de cambio de estado cambia cuando cambian metadatos como permisos o propietario. La fecha de nacimiento puede no estar disponible y GNU stat puede mostrar un guion en ese caso.

Sintaxis básica

stat [opciones] archivo...
  • archivo puede ser una ruta o varias; stat procesa cada operando.
  • Sin una opción de formato, muestra un resumen legible de los metadatos del archivo.
  • Con -c se eligen campos y etiquetas para construir una salida propia.

Opciones frecuentes del comando stat en Linux

OpciónQué consultaUso habitual
-c formatoMetadatos del archivo con los campos indicados.Crear una salida compacta para lectura o scripts.
-fDatos del sistema de archivos que contiene la ruta.Consultar tipo, bloques disponibles y tamaño de bloque.
-LSigue los enlaces simbólicos y consulta su destino.Comparar los metadatos del enlace con los del archivo apuntado.
-tSalida breve en una sola línea, diseñada para procesamiento.Automatizaciones que conocen el formato de GNU Coreutils.

En GNU stat, -f cambia el objeto de la consulta: informa del sistema de archivos y usa un conjunto distinto de especificadores para el formato. Por su parte, -L cambia cómo se tratan los enlaces simbólicos; sin esa opción, stat muestra por defecto los metadatos del propio enlace.

Preparar un archivo y un enlace de prueba

Crea un archivo dentro de una carpeta temporal y un enlace simbólico a él. Si /tmp/prueba-stat ya existe de una prueba anterior, utiliza un nombre nuevo en todos los comandos para no mezclar resultados.

mkdir -p /tmp/prueba-stat
printf 'archivo de ejemplo\n' > /tmp/prueba-stat/archivo.txt
ln -s archivo.txt /tmp/prueba-stat/enlace.txt

Consultar los datos de archivo con el comando stat en Linux

Ejecuta stat sin opciones para ver el resumen completo. Después usa un formato propio: %n es el nombre, %F el tipo, %s el tamaño en bytes, %A los permisos simbólicos, %i el inode y %h el número de enlaces duros.

stat /tmp/prueba-stat/archivo.txt
stat -c 'nombre=%n | tipo=%F | tamaño=%s bytes | permisos=%A | inode=%i | enlaces=%h' /tmp/prueba-stat/archivo.txt

Interpretar las fechas que muestra el comando stat en Linux

GNU stat ofrece campos separados para el último acceso, la modificación del contenido y el cambio de estado. El campo de nacimiento corresponde al tiempo de creación si el sistema de archivos lo proporciona; no siempre se conoce.

stat -c 'acceso=%x | modificación=%y | cambio de estado=%z | nacimiento=%w' /tmp/prueba-stat/archivo.txt
  • %x indica el último acceso registrado; la política de montaje del sistema puede limitar cuándo se actualiza.
  • %y indica la última modificación del contenido.
  • %z indica el último cambio de estado o metadatos; no es la fecha de nacimiento.
  • %w muestra el nacimiento si está disponible; en caso contrario GNU stat muestra un guion.

Consultar un enlace simbólico

Por defecto, stat recibe la ruta del enlace y describe el enlace. Añade -L para seguirlo y consultar el archivo de destino. Así puedes comparar sus inodes y tipos.

stat -c 'tipo=%F inode=%i nombre=%N' /tmp/prueba-stat/enlace.txt
stat -L -c 'tipo=%F inode=%i nombre=%n' /tmp/prueba-stat/enlace.txt

Consultar un sistema de archivos con el comando stat en Linux

Añade -f para obtener datos del sistema de archivos que contiene la ruta. En este modo, %T es el tipo de sistema de archivos, %b el total de bloques, %a los bloques disponibles para usuarios no privilegiados y %S el tamaño fundamental del bloque.

stat -f -c 'tipo=%T | bloques=%b | disponibles=%a | tamaño de bloque=%S' /tmp/prueba-stat/archivo.txt

No reutilices sin cambios un formato pensado para archivos cuando añadas -f: los códigos de formato tienen significados diferentes en este modo.

Retirar los archivos de prueba

Al terminar, elimina únicamente el enlace y el archivo de prueba que creaste; después puedes retirar la carpeta vacía. Comprueba las rutas antes de copiar el bloque.

rm /tmp/prueba-stat/enlace.txt /tmp/prueba-stat/archivo.txt
rmdir /tmp/prueba-stat

Errores frecuentes

  • Confundir tamaño con espacio utilizado: %s informa del tamaño lógico del archivo; los bloques asignados son otro dato.
  • Tratar el cambio de estado como creación: ctime refleja cambios de metadatos; la fecha de nacimiento puede ser desconocida.
  • Olvidar que un enlace simbólico se inspecciona por defecto: añade -L para consultar el destino.
  • Mezclar formatos de archivo y sistema de archivos: -f cambia los campos que acepta la cadena de formato.
  • Usar la salida breve como si fuera estable para cualquier sistema: -t está pensada para procesamiento y depende de la implementación.

Preguntas frecuentes sobre el comando stat en Linux

¿stat muestra la fecha de creación?

Puede mostrar el tiempo de nacimiento con el especificador %w cuando el sistema de archivos y el sistema operativo lo conocen. Si no está disponible, GNU stat muestra un guion. La fecha de cambio de estado no sustituye a la fecha de creación.

¿Qué diferencia hay entre stat y stat -f?

stat consulta los metadatos de archivos o directorios. Con -f consulta el sistema de archivos que contiene la ruta y usa otros especificadores de formato.

¿stat sigue un enlace simbólico?

Por defecto, GNU stat informa del enlace simbólico. Con -L sigue el enlace e informa del archivo de destino.

Referencia oficial

La documentación de GNU Coreutils explica las opciones y los campos de salida de stat, incluidos los formatos distintos para archivos y sistemas de archivos.

Demostración en video

El video muestra ejemplos del comando stat. Úsalo como referencia visual y contrasta la información mostrada con las definiciones de los campos de esta guía.

Lecciones relacionadas

👉 Y recuerda, si quieres aprender más de Linux, visita el curso de Linux gratis.

🐳 Si quieres aprender más de Docker, visita el curso de Docker gratis.

Comentarios

No hay comentarios aún. ¿Por qué no comienzas el debate?

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *