BOOTPARAM(7)

NOMBRE
bootparam - introducción a los parámetros de arranque del núcleo de Linux

DESCRIPCIÓN
El núcleo Linux acepta ciertas `opciones de la línea de orden' o `parámetros de arranque' cuando se carga. En general esto sirve para suministrar al núcleo información sobre parámetros del equipo que el núcleo es incapaz de determinar por sí mismo, o para evitar o cambiar los valores que el núcleo detectaría.

Cuando es la BIOS quien arranca directamente el núcleo, Ud. no tiene oportunidad de especificar ningún parámetro. Así que para aprovechar esta posibilidad Ud. debe emplear algún programa capaz de pasar parámetros, como GRUB.

  La lista de argumentos
La línea de órdenes del núcleo se analiza y divide en una lista de cadenas de caracteres (argumentos del arranque) separadas por espacios. La mayoría de argumentos de arranque toman la forma:

    nombre[=valor_1][,valor_2]...[,valor_10]

where 'name' is a unique keyword that is used to identify what part of the kernel the associated values (if any) are to be given to. Note the limit of 10 is real, as the present code handles only 10 comma separated parameters per keyword. (However, you can reuse the same keyword with up to an additional 10 parameters in unusually complicated situations, assuming the setup function supports it.)

Most of the sorting is coded in the kernel source file init/main.c. First, the kernel checks to see if the argument is any of the special arguments 'root=', 'nfsroot=', 'nfsaddrs=', 'ro', 'rw', 'debug', or 'init'. The meaning of these special arguments is described below.

Luego recorre una lista de funciones setup para ver si la cadena del argumento especificado (como `fu') ha sido asociada con una función setup (`fu_setup()') para un dispositivo particular o parte del núcleo. Si se le pasa al núcleo la línea fu=3,4,5,6 entonces el núcleo buscará en el vector bootsetups si `fu' ha sido registrada. Si lo ha sido, entonces llamará a la función setup asociada con `fu' (fu_setup()) y le pasará los argumentos 3, 4, 5 y 6 tal como se dieron en la línea de órdenes del núcleo.

Cualquier cosa de la forma `fu=bar' que no se acepte como una función setup tal como se ha descrito arriba se interpreta entonces como una variable de entorno que toma un valor. Un (¿inútil?) ejemplo sería poner `TERM=vt100' como un argumento de arranque.

Cualesquiera argumentos restantes que no han sido tomados por el núcleo ni han sido interpretados como variables de entorno se pasan entonces al PID 1, que normalmente es el programa init(1). El más usual de ellos es la palabra `single', que ordena a init arrancar el sistema en modo monousuario, sin lanzar los demonios usuales. Eche un vistazo a la página del manual de la versión de init() instalada en su sistema para ver qué argumentos acepta.

  General non-device-specific boot arguments

'init=...'
    Esto indica el programa inicial que ejecutará el núcleo. Si no se establece o no se puede encontrar, el núcleo intentará ejecutar /sbin/init, luego /etc/init, después /bin/init, más tarde /bin/sh y acabará dando un mensaje de pánico (y con razón) si todo esto falla.

'nfsaddrs=...'
    Esto pone la dirección de arranque de NFS con la cadena dada. Esta dirección de arranque se emplea en caso de un arranque remoto, por red.

'nfsroot=...'
    Esto pone el nombre de la raíz de NFS con la cadena dada. Si esta cadena no empieza con '/' ni ',' ni un dígito, entonces se le añade el prefijo '/tftpboot/'. Este nombre de raíz se emplea en caso de un arranque remoto.

'root=...'
    Este argumento le dice al núcleo qué dispositivo se va a emplear como el sistema de ficheros raíz al arrancar. El valor predeterminado de este valor se pone en tiempo de compilación, usualmente como el dispositivo raíz del sistema donde se construyó el núcleo. Para tomar otro valor, y seleccionar por ejemplo la segunda disquetera como el dispositivo raíz, uno utilizaría `root=/dev/fd1'.

    The root device can be specified symbolically or numerically. A symbolic specification has the form /dev/XXYN, where XX designates the device type (e.g., 'hd' for ST-506 compatible hard disk, with Y in 'a'–'d'; 'sd' for SCSI compatible disk, with Y in 'a'–'e'), Y the driver letter or number, and N the number (in decimal) of the partition on this device.

    Observe que esto no tiene nada que ver con la designación de estos dispositivos en el sistema de ficheros. La parte `/dev/' es puramente convencional.

    La especificación numérica, más fea y menos transportable, de los posibles dispositivos raíz de arriba en formato mayor/menor, se acepta también. (Por ejemplo, /dev/sda3 tiene de número mayor 8 y de menor 3, así que se podría poner `root=0x803' de forma alternativa.)

'rootdelay='
    This parameter sets the delay (in seconds) to pause before attempting to mount the root filesystem.

'rootflags=...'
    This parameter sets the mount option string for the root filesystem (see also fstab(5)).

'rootfstype=...'
    The 'rootfstype' option tells the kernel to mount the root filesystem as if it where of the type specified. This can be useful (for example) to mount an ext3 filesystem as ext2 and then remove the journal in the root filesystem, in fact reverting its format from ext3 to ext2 without the need to boot the box from alternate media.

'ro' y 'rw'
    La opción `ro' le dice al núcleo que monte el sistema de ficheros raíz como `de lectura exclusiva', de modo que el programa de comprobación de consistencia del sistema de ficheros (fsck) pueda hacer su trabajo en un sistema de ficheros sin actividad. Ningún proceso puede escribir en ficheros del sistema de ficheros en cuestión hasta que éste se `re-monte' como capaz para lectura y escritura, por ejemplo mediante `mount -w -n -o remount /'. (Vea también mount(8).)

    La opción `rw' le dice al núcleo que monte el sistema de ficheros raíz para lectura y escritura. Esto es lo que ocurre normalmente si no se pone nada.

'resume=...'
    This tells the kernel the location of the suspend-to-disk data that you want the machine to resume from after hibernation. Usually, it is the same as your swap partition or file. Example:

        resume=/dev/hda2

'reserve=...'
    Esto se emplea para proteger regiones de E/S de pruebas. La forma de la orden es:

        reserve=baseE/S,extensión[,baseE/S,extensión]...

    En algunas máquinas puede ser necesario evitar que ciertos controladores de periféricos comprueben la existencia de éstos (auto-pruebas) en una región específica. Esto puede ser porque algún dispositivo reaccione malamente a la prueba, o porque algún otro se identifique erróneamente, o simplemente porque no queremos que el núcleo inicialice cierto hardware.

    El argumento de arranque reserve especifica una región de un puerto de E/S que no debe ser probado. Un controlador no probará una región reservada, a menos que otro argumento de arranque explícitamente le especifique que lo haga.

    Por ejemplo, la línea de arranque

        reserve=0x300,32  blah=0x300

    hace que ningún controlador pruebe la región 0x300--0x31f excepto el de `blah'.

'panic=N'
    By default, the kernel will not reboot after a panic, but this option will cause a kernel reboot after N seconds (if N is greater than zero). This panic timeout can also be set by

        echo N > /proc/sys/kernel/panic

'reboot=[warm|cold][,[bios|hard]]'
    Desde la versión Linux 2.0.22 un rearranque es por omisión un rearranque en frío. Uno obtiene el comportamiento antiguo con `reboot=warm'. (Un rearranque en frío puede ser necesario para inicializar cierto hardware, pero puede destruir datos no escritos aún en un caché de disco. Un rearranque en caliente puede ser más rápido.)

'nosmp' y 'maxcpus=N'
    (Sólo cuando se defina __SMP__ .) Una opción de línea de orden como `nosmp' o `maxcpus=0' deshabilitará por completo MPS (multiproceso simétrico); una opción como `maxcpus=N' limita el número máximo de UCPs activados en el modo MPS a N.

  Argumentos de arranque para uso de los desarrolladores del núcleo

'debug'
    Kernel messages are handed off to a daemon (e.g., klogd(8) or similar) so that they may be logged to disk. Messages with a priority above console_loglevel are also printed on the console. (For a discussion of log levels, see syslog(2).) By default, console_loglevel is set to log messages at levels higher than KERN_DEBUG. This boot argument will cause the kernel to also print messages logged at level KERN_DEBUG. The console loglevel can also be set on a booted system via the /proc/sys/kernel/printk file (described in syslog(2)), the syslog(2) SYSLOG_ACTION_CONSOLE_LEVEL operation, or dmesg(8).

'profile=N'
    Es posible habilitar una función de perfil del núcleo, si uno desea saber dónde está el núcleo gastando sus ciclos de UCP. El perfil se habilita poniendo la variable prof_shift a un valor distinto de cero. Esto se hace bien especificando CONFIG_PROFILE en la compilación, o mediante la opción `profile='. Ahora el valor que tendrá prof_shift será N, cuando se dé, o CONFIG_PROFILE_SHIFT, cuando se haya dado éste, ó 2, el valor predeterminado. La significancia de esta variable es que da la granularidad del perfil: para cada pulso del reloj, si el sistema está ejecutando código del núcleo, se incrementa un contador:

        profile[address >> prof_shift]++;

    La información de perfil, sin procesar, puede leerse de /proc/profile. Probablemente sea mejor idea emplear una herramienta como readpropfile.c para verla mejor. Escribir en /proc/profile limpiará los contadores.

  Argumentos de arranque para uso de disco en memoria
(Sólo si el núcleo ha sido compilado con CONFIG_BLK_DEV_RAM.) En general es una mala idea emplear un disco RAM en Linux; el sistema utilizará la memoria disponible más eficientemente sin él. Pero durante el arranque es útil a menudo cargar los contenidos del disquete en un disco RAM. Uno también podría tener un sistema en el cual deban cargarse primero algunos módulos (de sistemas de ficheros o periféricos) antes de que se pueda acceder al disco principal.

    In Linux 1.3.48, ramdisk handling was changed drastically. Earlier, the memory was allocated statically, and there was a 'ramdisk=N' parameter to tell its size. (This could also be set in the kernel image at compile time.) These days ram disks use the buffer cache, and grow dynamically. For a lot of information on the current ramdisk setup, see the kernel source file Documentation/blockdev/ramdisk.txt (Documentation/ramdisk.txt in older kernels).

    Hay cuatro parámetros, dos booleanos y dos enteros.

'load_ramdisk=N'
    Si N=1, cárguese un disco RAM. Si N=0, no se cargue. (Éste es el comportamiento predeterminado.)

'prompt_ramdisk=N'
    Si N=1, pídase la inserción del disquete. (Éste es el comportamiento predeterminado.) Si N=0, no se pregunte. (Por tanto, este parámetro no sirve para nada.)

'ramdisk_size=N' o (anticuado) 'ramdisk=N'
    Pone el tamaño máximo del disco RAM (o de los discos) a N kB. El valor predeterminado es 4096 (esto es, 4 MB).

'ramdisk_start=N'
    Pone el número del bloque inicial (el desplazamiento desde el principio en el disquete donde empieza el disco RAM) a N. Esto es necesario si el disco RAM está tras una imagen del núcleo.

'noinitrd'
    (Sólo si el núcleo fue compilado con CONFIG_BLK_DEV_RAM y con CONFIG_BLK_DEV_INITRD.) Actualmente es posible compilar el núcleo de forma que emplee initrd. Cuando se habilita esta característica, el proceso de arranque cargará el núcleo y un disco RAM inicial; entonces el núcleo convierte initrd a un disco RAM "normal", que se monta para lectura y escritura como el dispositivo raíz; luego se ejecuta /linuxrc; después de eso se monta el sistema de ficheros raíz "de verdad", y el sistema de ficheros initrd se mueve sobre /initrd; finalmente tiene lugar la secuencia de arranque habitual (o sea, la llamada a /sbin/init).

    For a detailed description of the initrd feature, see the kernel source file Documentation/admin-guide/initrd.rst (or Documentation/initrd.txt before Linux 4.10).

    La opción `noinitrd' le dice al núcleo que aunque haya sido compilado para la operación con initrd, no debe seguir los pasos anteriores, sino dejar los datos de initrd bajo /dev/initrd. (Este dispositivo sólo puede emplearse una vez; los datos son liberados tan pronto como el último proceso que lo haya utilizado cierre /dev/initrd.)

  Argumentos de arranque para dispositivos SCSI
Notación general para esta sección:

iobase -- el primer puerto de E/S que ocupa el anfitrión SCSI. Se especifica en notación hexadecimal y normalmente cae en el rango de 0x200 a 0x3ff.

irq -- la interrupción de hardware a la que la tarjeta está configurada. Los valores válidos dependen de la tarjeta en cuestión, pero normalmente son 5, 7, 9, 10, 11, 12 y 15. Los otros valores se emplean normalmente para periféricos comunes como discos duros IDE, disquetes, puertos serie, etc.

scsi-id -- La ID (identificación) que emplea el adaptador anfitrión para identificarse en el bus SCSI. Sólo algunos permiten que se cambie este valor, puesto que la mayoría lo tiene especificado de modo permanente e interno. El valor predeterminado más usual es 7, pero las tarjetas Seagate y Future Domain emplean el 6.

paridad -- si el adaptador anfitrión SCSI espera que los dispositivos acoplados a él suministren un valor de paridad con todos los intercambios de información. El valor 1 indica que el control de paridad está activo, y el 0 que no. De nuevo, no todos los adaptadores admiten la selección del comportamiento de la paridad como argumento de arranque.

'max_scsi_luns=...'
    A SCSI device can have a number of 'subdevices' contained within itself. The most common example is one of the new SCSI CD-ROMs that handle more than one disk at a time. Each CD is addressed as a 'Logical Unit Number' (LUN) of that particular device. But most devices, such as hard disks, tape drives, and such are only one device, and will be assigned to LUN zero.

    Algunos dispositivos SCSI pobremente diseñados no pueden admitir que se compruebe la existencia de otros LUNs distintos del 0. Por lo tanto, si la opción de compilación CONFIG_SCSI_MULTI_LUN no está puesta, los núcleos nuevos sólo probarán de forma predeterminada el LUN 0.

    Para especificar el número de LUNs probados en el arranque, uno introduce 'max_scsi_luns=n' como un argumento del arranque, siendo n un número entre 1 y 8. Para evitar problemas como los descritos anteriormente, uno debería emplear n=1 para evitar problemas con los dispositivos del párrafo anterior.

Configuración de unidades de cinta magnética SCSI
    Algo de la configuración en tiempo de arranque del controlador de cinta magnética SCSI puede hacerse mediante lo siguiente:

        st=tam_buf[,write_threshold[,bufs_max]]

    Los primeros dos números se especifican en unidades de kB. El valor predeterminado de tam_buf es 32 kB, y el tamaño máximo que puede especificarse es de 16384 ridículos kB. write_threshold es el valor al cual el búfer es volcado a la cinta, siendo el predeterminado 30 kB. El máximo número de búferes varía con el de unidades detectadas, y el valor predeterminado es 2. Un ejemplo del modo de empleo sería

        st=32,30,2

    Full details can be found in the file Documentation/scsi/st.txt (or drivers/scsi/README.st for older kernels) in the Linux kernel source.

  Discos duros

Parámetros del Controlador de Disco/CD-ROM IDE
    El controlador IDE acepta una serie de parámetros, que van desde especificaciones de la geometría del disco, a soporte para chips controladores no muy bien hechos. Opciones específicas de una unidad se dan como 'hdX=', con X en el rango 'a'–'h'.

    Las opciones no específicas de una unidad se dan con el prefijo `hd='. Observe que emplear un prefijo específico de unidad para una opción no específica de unidad, todavía funcionará, y la opción será aplicada simplemente como se espera.

    Also note that 'hd=' can be used to refer to the next unspecified drive in the (a, ..., h) sequence. For the following discussions, the 'hd=' option will be cited for brevity. See the file Documentation/ide/ide.txt (or Documentation/ide.txt in older kernels, or drivers/block/README.ide in ancient kernels) in the Linux kernel source for more details.

Las opciones 'hd=cils,cabezas,sectores[,pcomes[,irq]]'
    Estas opciones se emplean para especificar la geometría física del disco. Sólo son obligatorios los tres primeros valores. Los valores de cilindros/cabezas/sectores serán los empleados por fdisk. El valor de precompensación de escritura no se tiene en cuenta para discos IDE. El valor de IRQ especificado será el empleado para la interfaz donde resida la unidad, y no es realmente un parámetro específico de la unidad.

La opción `hd=serialize'
    La interfaz IDE dual con el chip CMD-640 está mal diseñada pues cuando se emplean unidades en la interfaz secundaria al mismo tiempo que en la primaria, se corromperán datos. Con esta opción se le dice al controlador que se asegure de que nunca se usan a la vez ambas interfaces.

La opción `hd=noprobe'
    No comprobar la existencia de esta unidad. Por ejemplo,

        hdb=noprobe hdb=1166,7,17

    inhabilitará las pruebas de existencia, pero al especificar la geometría de la unidad se registrará ésta como un dispositivo de bloque válido, y por tanto utilizable.

La opción `hd=nowerr'
    Algunas unidades tienen aparentemente el bit WRERR_STAT permanentemente encendido. Esto activa una solución para estos aparatos con este fallo.

La opción `hd=cdrom'
    Esto le dice al controlador IDE que hay un CD-ROM compatible ATAPI puesto en el lugar de un disco duro IDE normal. En la mayoría de los casos el CD-ROM se identifica automáticamente, pero si no ocurre así, esto puede ayudar.

Opciones del Controlador de Disco Estándar ST-506 ('hd=')
    El controlador estándar de disco puede aceptar argumentos de geometría para los discos, similar al controlador IDE. Observe sin embargo que sólo espera tres valores (C/CZ/S) -- más o menos de tres y sin decir nada no se tendrá en cuenta ninguno. Además, sólo acepta 'hd=' como argumento; o sea, nada de 'hda=' ni nada por el estilo. El formato es como sigue:

        hd=cils,cabezas,sects

    Si hay dos discos instalados, lo de arriba se repetirá con los parámetros de geometría del segundo disco.

  Dispositivos de red Ethernet
Controladores diferentes hacen uso de parámetros diferentes, pero todos comparten al menos un IRQ, un valor de dirección base del puerto de E/S, y un nombre. En su forma más genérica, el aspecto es el siguiente:

    ether=irq,iobase[,parám_1[,...parám_8]],nombre

El primer argumento no numérico se toma como el nombre. Los valores de los parám_i (cuando sean de aplicación) normalmente tienen significados diferentes para cada controlador/tarjeta. Usualmente se emplean para especificar cosas como direcciones de memoria compartida, selección de interfaz, canal DMA y cosas así.

El empleo más común de este parámetro es el forzar la autocomprobación de una segunda tarjeta de red, puesto que por omisión sólo se prueba una. Esto se puede hacer simplemente con:

    ether=0,0,eth1

Observe que los valores de cero para el IRQ y la dirección base de E/S en el ejemplo anterior le dicen al controlador o controladores que prueben la existencia de la(s) tarjeta(s).

El documento `Ethernet-Howto' tiene documentación extensa sobre cómo usar varias tarjetas de red y sobre los valores de los parámetros parám_i específicos a cada tarjeta/controlador donde haya que emplearlos. Los lectores interesados deberán irse a la sección de su tarjeta particular en ese documento.

  El controlador de disquetera
There are many floppy driver options, and they are all listed in Documentation/blockdev/floppy.txt (or Documentation/floppy.txt in older kernels, or drivers/block/README.fd for ancient kernels) in the Linux kernel source. See that file for the details.

  El controlador de sonido
The sound driver can also accept boot arguments to override the compiled-in values. This is not recommended, as it is rather complex. It is described in the Linux kernel source file Documentation/sound/oss/README.OSS (drivers/sound/Readme.linux in older kernel versions). It accepts a boot argument of the form:

    sound=dispositivo1[,dispositivo2[,dispositivo3...[,dispositivo10]]]

donde cada valor dispositivoN está en el formato: 0xTaaaId y los bytes se emplean como sigue:

T - tipo de dispositivo: 1=FM, 2=SB, 3=PAS, 4=GUS, 5=MPU401, 6=SB16, 7=SB16-MPU401

aaa - dirección de E/S en hexadecimal.

I - línea de interrupción en hexadecimal (i.e. 10=a, 11=b, ...)

d - canal DMA.

Como puede ver es bastante lioso, y lo mejor que puede hacer es compilar el controlador con los valores deseados como se recomienda. Un argumento de arranque como 'sound=0' anulará el controlador de sonido completamente.

  El controlador de la impresora de línea

'lp='
    Sintaxis:

        lp=0
        lp=auto
        lp=reset
        lp=port[,port...]

    Es posible indicarle al controlador de la impresora qué puertos usar y qué puertos no usar. Esto último puede ser útil si no quiere que el controlador de impresora reclame todos los puertos paralelos disponibles, con el fin de que otros controladores (p.e. PLIP, PPA) puedan usarlos.

    El formato para el argumento es de varios nombres de puerto. Por ejemplo, lp=none,parport0 usaría el primer puerto paralelo para lp1, y deshabilitaría lp0. Para deshabilitar el controlador de impresora por completo, puede usar lp=0.

VÉASE TAMBIÉN
klogd(8), mount(8)

For up-to-date information, see the kernel source file Documentation/admin-guide/kernel-parameters.txt.

COLOFÓN
Esta página es parte de la versión 5.13 del proyecto Linux man-pages. Puede encontrar una descripción del proyecto, información sobre cómo informar errores y la última versión de esta página en https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN
La traducción al español de esta página del manual fue creada por Gerardo Aburruzaga García <gerardo.aburruzaga@uca.es> y Miguel Pérez Ibars <mpi79470@alu.um.es> Esta traducción es documentación libre; lea la GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a debian-l10n-spanish@lists.debian.org>..