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ón | Qué consulta | Uso habitual |
|---|---|---|
| -c formato | Metadatos del archivo con los campos indicados. | Crear una salida compacta para lectura o scripts. |
| -f | Datos del sistema de archivos que contiene la ruta. | Consultar tipo, bloques disponibles y tamaño de bloque. |
| -L | Sigue los enlaces simbólicos y consulta su destino. | Comparar los metadatos del enlace con los del archivo apuntado. |
| -t | Salida 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.txtConsultar 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.txtInterpretar 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.txtConsultar 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.txtNo 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-statErrores 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
- Diferencias entre enlaces duros y simbólicos
- Cómo listar archivos con ls
- Cómo buscar archivos con find
- Cómo cambiar permisos con chmod
👉 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.

