5.2. Boot Parameters

Boot parameters are Linux kernel parameters which are generally used to make sure that peripherals are dealt with properly. For the most part, the kernel can auto-detect information about your peripherals. However, in some cases you'll have to help the kernel a bit.

If this is the first time you're booting the system, try the default boot parameters (i.e., don't try setting arguments) and see if it works correctly. It probably will. If not, you can reboot later and look for any special parameters that inform the system about your hardware.

Information on many boot parameters can be found in the Linux BootPrompt HOWTO, including tips for obscure hardware. This section contains only a sketch of the most salient parameters. Some common gotchas are included below in Abschnitt 5.3, „Troubleshooting the Install Process“.

When the kernel boots, a message


Memory:availk/totalk available 

should be emitted early in the process. total should match the total amount of RAM, in kilobytes. If this doesn't match the actual amount of RAM you have installed, you need to use the mem=ram parameter, where ram is set to the amount of memory, suffixed with ``k'' for kilobytes, or ``m'' for megabytes. For example, both mem=65536k and mem=64m mean 64MB of RAM.

If your monitor is only capable of black-and-white, use the mono boot argument. Otherwise, your installation will use color, which is the default.

If you are booting with a serial console, generally the kernel will autodetect this If you have a videocard (framebuffer) and a keyboard also attached to the computer which you wish to boot via serial console, you may have to pass the console=device argument to the kernel, where device is your serial device, which is usually something like ttyS0.

5.2.1. Debian Installer Arguments

The installation system recognizes a few boot arguments which may be useful.

DEBCONF_PRIORITY

These parameter settings will similarly set the highest priority of messages to be displayed.

With DEBCONF_PRIORITY=critical, the installation system will display only critical messages and try to do the right thing without fuss. If problems are encountered, the installer adjusts the priority as needed.

If DEBCONF_PRIORITY=high (the default setting), both high and critical priority messages are shown, but medium and low priority messages are skipped. When DEBCONF_PRIORITY=low is used, all messages are shown.

DEBCONF_FRONTEND

This boot parameter controls the type of user interface used for the installer. The current possible parameter settings are:

  • DEBCONF_FRONTEND=noninteractive

  • DEBCONF_FRONTEND=text

  • DEBCONF_FRONTEND=newt

  • DEBCONF_FRONTEND=slang

  • DEBCONF_FRONTEND=ncurses

  • DEBCONF_FRONTEND=bogl

  • DEBCONF_FRONTEND=gtk

  • DEBCONF_FRONTEND=corba

The default front end is DEBCONF_FRONTEND=newt. DEBCONF_FRONTEND=text may be preferable for serial console installs.

BOOT_DEBUG

Passing this boot parameter will cause the boot to be more verbosely logged.

BOOT_DEBUG=0

This is the default.

BOOT_DEBUG=1

More verbose than usual.

BOOT_DEBUG=2

Lots of debugging information.

BOOT_DEBUG=3

Shells are run at various points in the boot process to allow detailed debugging. Exit the shell to continue the boot.

INSTALL_MEDIA_DEV

The value of the parameter is the path to the device to load the Debian installer from. For example, INSTALL_MEDIA_DEV=/dev/floppy/0

The boot floppy, which normally scans all floppys and USB storage devices it can to find the root floppy, can be overridden by this parameter to only look at the one device.

debian-installer/framebuffer

Some architectures use the kernel framebuffer to offer installation in a number of languages. If framebuffer causes a problem on your system you can disable the feature by the parameter debian-installer/framebuffer=false. Problem symptoms are error messages about bterm or bogl, a blank screen, or a freeze within a few minutes after starting the install.

The video=vga16:off argument may also be used to disable the framebuffer. Such problems have been reported on a Dell Inspiron with Mobile Radeon card.