debug Get shells during process of booting for debugging
bootchart Create chart of booting sequence in /var/log/bootchart.tgz
forensic Do not touch any harddisks during hardware recognition
-serial Activate ttyS0 and start mgetty
+serial Activate ttyS0 and start a getty
grub Boot Grub bootloader (special all-in-one-image)
dos Boot FreeDOS
bsd Boot MirOS BSD
hdt Boot Hardware Detection Tool (from syslinux project)
-qemu Boot with special options for use in Qemu
-vmware Boot with special options for use in VMware
-Further documentation regarding the init process can be found at:
+Further documentation regarding the boot process can be found at:
* http://git.grml.org/?p=live-initramfs-grml.git;a=blob_plain;f=manpages/live-initramfs.en.7.txt;hb=HEAD
+* http://git.grml.org/?p=live-boot-grml.git;a=blob;f=manpages/en/live-boot.7;hb=HEAD
* http://git.debian.org/?p=kernel/initramfs-tools.git;a=blob_plain;f=initramfs-tools.8;hb=HEAD
+* http://www.kernel.org/doc/Documentation/kernel-parameters.txt
The following boot options can be combined.
Notice: not all of them are available on all the Grml flavours.
grml localtime Use local time (UTC=no)
grml tz=Europe/Vienna Use specified timezone for TZ
grml keyboard=us xkeyboard=us Use different keyboard layout (text-console/X)
-grml setkeycodes Set some special function keys for MS/HP keyboards
Configuration settings:
-----------------------
If a file /config.tbz exists, it is extracted from there.
/dev/fd0 for floppy disk
/dev/sda1 for USB-stick/first SCSI-device
+grml autoconfig=SOMELABEL Set the DCS dir to the root of the device labeled with SOMELABEL.
+ If undefined search for a device labeled with GRMLCFG.
grml netconfig=server/config.tbz Download file and extract configuration archive
grml netscript=server/file Download and execute file
-grml partconf=/dev/hda2 Copy files specified in /etc/grml/partconf from /dev/hda2
+grml partconf=/dev/sda2 Copy files specified in /etc/grml/partconf from /dev/sda2
to booting grml system
grml file=foobar.tbz Use specified file as name for configuration archive
instead of the default one (config.tbz)
grml extract=/etc Extract only /etc from configuration archive,
use it in combination with myconfig or netconfig
-grml persistent Enable persistency feature, more details available at
+grml persistent=nofiles Enable persistency feature, more details available at
http://wiki.grml.org/doku.php?id=persistency
+ Notice that the "=nofiles" argument is optional, though recommended
+ as default setting.
grml hostname=... Set hostname to given argument
grml hostname Set a random hostname
[Note: only available with releases newer than 2010.04]
grml nodhcphostname Do not to set the hostname according to the dns information
+grml nonetworking Do not create/overwrite /etc/network/interface during startup
grml distri=... Set distribution name to given argument. If a jpg file named like the
given distri name can be found in directory desktop on the ISO
(/cdrom/desktop/"$DISTRI") it will be taken as wallpaper for grml
grml debnet Search through local partitions for file /etc/network/interfaces,
copy /etc/network to local system and restart networking then
+grml dns=8.8.8.8,8.8.4.4 Set DNS resolvers during boot and for live system.
+grml ip=... Standard Linux kernel ip= boot option. Arguments:
+ clientip:nfsserverip:gwip:netmask:hostname:device:autoconf
+ Valid values for autoconf: off, on, dhcp, bootp, rarp, both.
+ Almost everything is optional. Most common form: ip=dhcp
grml mypath=... Add specified option into $PATH of Zsh
For example when using "grml mypath=/foobar" then /foobar
will be added to the end of $PATH inside Zsh
-grml debs=path-name-wildcard install Debian packages matching the path-name-wildcard in the
- DCS dir
-grml scripts=path-name execute script (defaulting to grml.sh) inside DCS dir. Path names
+grml debs Install all Debian packages from the "debs" directory of your DCS
+ directory (see myconfig=, typically the root of your ISO image).
+grml debs=path-name-wildcard Install Debian packages from DCS directory (see myconfig=,
+ typically the root of your ISO image). If path does not contain a
+ "/" the package(s) will be installed from directory "debs" of the
+ DCS directory instead. The "path-name-wildcard" can contain
+ wildcards (e.g. debs=rat* will install a packages starting with "rat"
+ from directory debs/).
+grml scripts=path-name Execute script (defaulting to grml.sh) inside DCS dir. Path names
allowed. If path-name points to a directory, all scripts found in
the directory are executed.
-grml config=path-name unpack archive that path-name points to
+grml config=path-name Unpack archive that path-name points to
grml noautoconfig Disable searching for device labeled GRMLCFG
Notice: Take a look at http://grml.org/config/ and 'man 1 grml-autoconfig'
-for more information regarding the configuration framework of grml.
+for more information regarding the configuration framework of Grml.
Booting related options:
------------------------
-grml2ram Copy Grml's squashfs file to RAM and run from there
grml toram Copy the whole CD/medium to RAM and run from there
grml toram=filename.squashfs Copy the specified file to RAM and run from there
Usage example: grml toram=grml-medium.squashfs
Notice: grml2ram is an alias for this option which
corresponds with the grml flavour settings by default
-
grml tohd=/dev/sda1 Copy Grml's squashfs file to harddisk partition for later
use via "grml bootfrom=/dev/sda1"
grml bootfrom=/dev/sda1 Use the squashfs file from directory 'live' of the specified device
"boot=live isofrom=/dev/sda1/grml.iso"
Notice: "fromiso" does the same as "isofrom", it's just there
to prevent any typing errors
-grml findiso=/grml_2010.04.iso Look for the specified ISO file on all disks where it usually
+grml findiso=/grml_2010.12.iso Look for the specified ISO file on all disks where it usually
looks for the .squashfs file (so you don't have to know the device name
as in isofrom=....).
grml fetch=$IP/filename.squashfs Download a squashfs image from a given url, copying to ram and booting it.
- Due to current limitations in busyboxs wget and DNS resolution, an URL
- can not contain a hostname but an IP only.
+ [Note: releases before 2011.05 didn't support DNS but IP only.]
grml live-media-path=live Sets the path to the live filesystem on the medium
By default, it is set to /live
grml module=grml Instead of using the default "$name.module" another file can
Debugging related settings:
---------------------------
-debug Get shells during process of booting, using GNU screen, be very verbose
grml debug Get shells during process of booting, using GNU screen, be verbose
grml debug=1 Get shells during process of booting, using GNU screen, be verbose and
display shell code being executed in initramfs.
to force pio4 mode on device "ata1:00:"
grml libata.dma=0 Disable DMA on PATA and SATA devices
grml libata.ignore_hpa=1 Disable host protected area (which should enable the whole disk)
-grml vga=normal [video=ofonly] No-framebuffer mode (does not influence X)
-grml vga=ask [video=ofonly] Display menu for framebuffer mode
+grml vga=normal No-framebuffer mode (does not influence X)
+grml vga=ask Display menu for framebuffer mode
+grml radeon.modeset=0 nomodeset Disable Kernel Mode Setting (KMS) for Radeon driver.
+grml i915.modeset=0 nomodeset Disable Kernel Mode Setting (KMS) for Intel driver.
+grml nouveau.modeset=0 nomodeset Disable Kernel Mode Setting (KMS) for Nouveau driver.
Installation related settings:
------------------------------
-Caution: do *not* use the grml2hd and/or debian2hd bootoption if you do not know what you are doing!
+Caution: do *NOT* use the grml2hd and/or debian2hd bootoption if you do not know what you are doing!
Install plain Debian via debian2hd bootoption (which runs grml-debootstrap in non-interactive mode):
debian2hd <options> ... whereas valid options for debian2hd are:
- target= target partition/directory of the new Debian system, e.g.: target=/dev/hda1
- grub= where to install grub to? Use grub syntax for specifying, e.g.: grub=hd0
- groot= specify root device for usage in grub (use grub syntax), e.g.: groot=hd0,0
+ target= target partition/directory of the new Debian system, e.g.: target=/dev/sda1
+ grub= where to install grub to, e.g.: grub=/dev/sda
release= specify release of new Debian system (default is stable), e.g.: release=sid
- mirror= specify mirror for apt-get/aptitude, e,g.: mirror=ftp://ftp.tugraz.at/mirror/debian
+ mirror= specify mirror for apt-get/aptitude, e,g.: mirror=http://cdn.debian.net/debian
password= set passwort of user root without prompting for it, e.g.: password=AiTh5ahn
Usage example for automatic installation:
- debian2hd target=/dev/hda1 grub=hd0 groot=hd0,0 mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar
+ debian2hd target=/dev/sda1 grub=/dev/sda mirror=http://cdn.debian.net/debian password=foobar
See http://grml.org/grml-debootstrap/ for more information.
partition=/dev/... partition where grml should be installed
Usage example for booting:
- grml2hd partition=/dev/hda4 mbr=/dev/hda filesystem=ext3 user=mika
+ grml2hd partition=/dev/sda4 mbr=/dev/sda filesystem=ext3 user=mika
Passwords of user root and user are "grml" - please adjust after hd-install!