Raspberry Pi: ¿Qué es cmdline.txt y Cómo se Utiliza?

Cuando creas una nueva tarjeta SD para tu Raspberry Pi, no solo incluye los archivos del sistema de Raspberry Pi OS (o cualquier otra distribución), sino también algunos archivos de configuración menos conocidos, como config.txt y cmdline.txt. En este artículo, te presentaré cmdline.txt. En la mayoría de los casos, no necesitas editarlo, pero puede ser útil saber un poco más al respecto.

El archivo cmdline.txt es un archivo de configuración, ubicado en la partición de arranque de la tarjeta SD en Raspberry Pi, y se utiliza para pasar parámetros adicionales al núcleo de Linux durante el arranque del sistema.

Comenzaré dándote más detalles sobre la teoría, luego explicaré los diferentes parámetros que se pueden configurar y en qué casos podría serte útil.

Introducción al archivo cmdline.txt en Raspberry Pi

Objetivo

El núcleo de Linux (kernel) es el elemento principal de cualquier sistema Linux. Es un software de bajo nivel que crea la interfaz entre el hardware y el sistema operativo. Al arrancar, se inicia antes que el sistema principal; el sistema operativo depende de él para funcionar.

Raspberry Pi OS utiliza cmdline.txt para establecer opciones que el kernel usará al iniciar. Por ejemplo, este archivo puede incluir algunas configuraciones de hardware, como el ID del disco de almacenamiento, para que el kernel sepa qué hacer al arrancar.

Un archivo cmdline.txt existe en la mayoría de los sistemas Linux; no es solo para Raspberry Pi OS, pero me centraré en el ejemplo de Raspberry Pi OS en este artículo.

Si necesitas una introducción (o repaso) sobre el kernel de Linux, este video es un excelente punto de partida:

Ubicación

El cmdline.txt se crea en la partición de arranque (/boot) cuando un nuevo sistema se copia en una tarjeta SD de Raspberry Pi.

Es la partición formateada en FAT en la tarjeta SD, por lo que se puede leer desde cualquier sistema operativo (incluso en Windows):

Nota: En las versiones recientes de Raspberry Pi OS, este archivo se encuentra en la subcarpeta /firmware, pero su contenido sigue siendo el mismo.

Artículo relacionado: Explicación del sistema de archivos de Raspberry Pi.

Editar el archivo cmdline.txt

El archivo cmdline.txt, generado en la tarjeta SD durante la instalación, se puede editar desde cualquier computadora o sistema operativo.

Si usas Windows para copiar una imagen en la tarjeta SD, es posible que necesites desconectar y volver a conectar la tarjeta SD nuevamente una vez que Raspberry Pi Imager o Etcher hayan terminado (estas herramientas expulsan automáticamente la tarjeta SD al finalizar). Pero el archivo está ubicado en la partición que puedes leer y editar, así que no es complicado.

Si estás intentando leerlo desde un sistema Linux, la ubicación del archivo variará según el punto de montaje (en inglés), pero encontrarás la partición de arranque en tu explorador de archivos (solo asegúrate de que sea la que está en la tarjeta SD, y no la que está en /boot, que es para tu PC).

También puedes editar el archivo en la tarjeta SD directamente desde tu Raspberry Pi. En este caso, el archivo que debes abrir está en la carpeta /boot.
No olvides usar el comando sudo (en inglés) si planeas editarlo, por ejemplo:
sudo nano /boot/cmdline.txt

Cualquier editor de texto puede ser usado para abrir y editar este archivo (ver mis favoritos aquí).
Todos los parámetros están en una línea, por lo que no hay necesidad de usar nada sofisticado para esta tarea.

¿Qué hay dentro de cmdline.txt en Raspberry Pi?

En una Raspberry Pi, cmdline.txt se utiliza para pasarle parámetros al núcleo de Linux para el proceso de arranque. Se utiliza principalmente para configurar las acciones que sucederán en el primer arranque o especificar la partición del sistema operativo.

La configuración predeterminada de cmdline.txt

Empecemos echando un vistazo al contenido predeterminado del archivo.

En Raspberry Pi OS, el cmdline.txt es diferente en el primer arranque y después de que la instalación se completa.

Antes del primer arranque

El archivo cmdline.txt inicial incluye parámetros adicionales, indicando al kernel las tareas que deben iniciarse en el primer arranque. Cuando acabas de copiar la tarjeta SD con Raspberry Pi OS, el archivo se ve así:

console=serial0,115200 console=tty1 root=PARTUUID=1d124286-02 rootfstype=ext4 fsck.repair=yes rootwait quiet init=/usr/lib/raspberrypi-sys-mods/firstboot splash plymouth.ignore-serial-consoles systemd.run=/boot/firstrun.sh systemd.run_success_action=reboot systemd.unit=kernel-command-line.target

Todo está en una línea, así que no es fácil de leer, pero son solo varios argumentos uno tras otro.
Explicaré qué significan más adelante, pero puedes identificar un patrón de sintaxis como este:
argumento1=valor1 argumento2=valor2 argumento3=valor3 ...

Después del primer arranque

Cuando Raspberry Pi OS ha iniciado completamente al menos una vez, con las tareas de inicialización hechas, el contenido del archivo será más corto, con algo como esto:

console=serial0,115200 console=tty1 root=PARTUUID=7a905b6b-02 rootfstype=ext4 fsck.repair=yes rootwait quiet splash plymouth.ignore-serial-consoles

Puedes notar que la mayoría de los parámetros relacionados con el primer inicio ya no están presentes.

Si después de leer este artículo editas tu archivo cmdline.txt y cometes algunos errores haciendo que tu Raspberry Pi sea inestable o no quiera arrancar, puedes tomar esto como un ejemplo para restaurar tu archivo.
Solo necesitarás actualizar la variable “PARTUUID” con tu ID de partición del sistema.

Entonces, ¿qué son todos estos parámetros, y cuándo puede ser útil editar este archivo?
Comencemos explicando los que tenemos en el último ejemplo, que son los principales parámetros para el kernel de Linux.

Parámetros principales de cmdline.txt

• console: Es básicamente información sobre la interfaz de visualización.
  El kernel generalmente comienza en tty0 o tty1. En Raspberry Pi OS, es tty1.
  No deberías necesitar editar esto. Lo mismo aplica para el puerto serial, que la mayoría de la gente no usa.
  
• root: Como habrás adivinado, contiene el ID de partición para el sistema operativo.
  Es especialmente útil tenerlo allí para el argumento “rootwait” mencionado más adelante.
  Puedes usar el comando fdisk, en inglés, (como se explica aquí) para ver todos tus ID de particiones.
  
• rootfstype: El formato de archivo usado para la partición principal. En la mayoría de las distribuciones de Linux, será EXT4.
  
• rootwait: Indicamos al kernel que espere a que la partición del sistema sea accesible antes de iniciar el sistema operativo. Como trabajamos con una tarjeta SD, puede tardar más tiempo que en una computadora tradicional.
  
• splash: Define si la imagen de bienvenida debería mostrarse al iniciar o no (el logo de Raspberry Pi).
  Si eliminas esta opción, solo se mostrará una pantalla negra.
  
• plymouth.ignore-serial-consoles: Indica a Plymouth que no muestre nada en la salida de la consola serial. Plymouth es el gestor de pantalla durante el proceso de arranque.

Opciones adicionales en cmdline.txt

En el archivo utilizado para el primer arranque, hay algunos otros parámetros:

• systemd.run y systemd.run_success_action: Usados por la Fundación Raspberry Pi para las tareas adicionales a ejecutar en el primer arranque.
  Básicamente, ejecutan un script (firstrun.sh) que hará todas las tareas que configures en las opciones avanzadas con Raspberry Pi Imager.
  Si miras el script antes del primer arranque, se ve así:
  
  En este ejemplo, cambiará el nombre de host predeterminado y habilitará SSH.
  
• init: No estoy 100% seguro de este, pero creo que es otro script creado por los desarrolladores de Raspberry Pi. Diría que probablemente sea para ejecutar las tareas iniciales antes del primer arranque, como redimensionar la partición del sistema.
  También es posible usar este parámetro para otras cosas, como arrancar en modo sencillo cuando has perdido tu contraseña (más detalles aquí).

Estas son todas las opciones que puedes encontrar para Raspberry Pi OS por defecto, así que espero haberlas aclarado. Pero hay muchas otras cosas que puedes hacer con este archivo y preguntas adicionales que podrías tener.
Intentaré responder los usos más comunes de este archivo en un formato de preguntas y respuestas.

Si tienes algo más que quieras saber sobre este archivo, por favor pregúntalo dentro de los foros de la comunidad.

Preguntas frecuentes

¿Puedes establecer una dirección IP estática mediante el archivo cmdline.txt?

El parámetro adicional “ip” se puede añadir al archivo cmdline.txt para establecer una dirección IP estática en el primer arranque.

Un ejemplo sería añadir algo así al final del archivo (misma línea):
ip=192.168.222.50::192.168.222.1:255.255.255.0:rpi:eth0:off

En este ejemplo, mi Raspberry Pi arrancará con la dirección IP 192.168.222.50, utilizando 192.168.222.1 como la puerta de enlace, y la máscara tradicional (/24).

Funcionó bien durante mis pruebas, pero no recomiendo usarlo. Intenta usar tu DHCP en el primer arranque en su lugar (o empieza sin ninguna red) y luego sigue este otro tutorial para establecer una dirección IP estática en la Raspberry Pi.

Si configuras una IP estática en cmdline.txt, solo funcionará en el primer arranque, y muy probablemente creará conflictos con el servicio dhcpcd si hay un servidor DHCP activo en tu red (trayendo por consecuencia que la Raspberry Pi tenga dos IP asignadas y cambie de una a otra constantemente).

¿Puedes usar cmdline.txt para habilitar SSH en el arranque?

La forma más fácil de habilitar SSH en el arranque en Raspberry Pi es añadir “opciones de personalización del sistema operativo” en Raspberry Pi Imager al copiar un nuevo sistema o crear un archivo vacío llamado “ssh” en la partición de arranque de la tarjeta SD. No es necesario usar cmdline.txt para esto.

Puedes leer este otro artículo si quieres aprender más sobre ello: Instalar tu Raspberry Pi Zero sin Teclado ni Monitor.

¿Sería posible configurar el arranque por red mediante cmdline.txt?

Las últimas versiones de firmware de Raspberry Pi te permiten usar arranque por red directamente (como se explica aquí), así que no hay necesidad de editar el archivo cmdline.txt para configurar esto.

He visto algunos tutoriales antiguos que lo hacen con parámetros adicionales, pero no veo el sentido de hacerlo actualmente (quizás me esté perdiendo algo, si es así, por favor házmelo saber).

¿Por qué recibo un error “/boot/cmdline.txt is unwritable”?

El archivo cmdline.txt no es editable por el usuario predeterminado en Raspberry Pi, se requieren privilegios de administrador, así que necesitas usar sudo para editar su contenido:
sudo nano /boot/cmdline.txt

Aprende más sobre los privilegios de administrador aquí, y también puedes ver mi guía para Nano si no estás acostumbrado a ello.

¿Es el archivo cmdline.txt diferente en otras distribuciones?

La mayoría de las distribuciones de Linux tienen un archivo cmdline.txt, con contenido similar, para pasar parámetros opcionales al kernel. Usarán diferentes opciones y valores, pero el formato es similar.

Por ejemplo, aquí está el archivo cmdline.txt predeterminado en Ubuntu:
elevator=deadline net.ifnames=0 console=serial0,115200 dwc_otg.lpm_enable=0 console=tty1 root=LABEL=writable rootfstype=ext4 rootwait fixrtc quiet splash

Algunas de estas opciones son familiares (“console“, “root“, “splash“, etc.), pero hay algunas adicionales basadas en la distribución Ubuntu.

¿Hay documentación completa sobre cómo usar este archivo?

Desafortunadamente, no encontré ninguna buena documentación de referencia sobre el archivo cmdline.txt. Es por eso que algunas de mis respuestas aquí pueden parecer más “suposiciones” que explicaciones formales.

La Fundación Raspberry Pi no tiene nada sobre esto; incluso para PC, es difícil encontrar algo completo.

Si necesitas más detalles, intentaría buscar las opciones para Debian (debería ser muy similar a Raspberry Pi OS), o hacer tus preguntas en los foros oficiales de las principales distribuciones.