nofb Disable framebuffer
floppy Boot from floppydisk
hd / hd1 / hd2 / hd3 Boot from (local) primary / secondary /... harddisk
-failsafe Boot with (almost) no HW-detection
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
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)
(/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 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/).
+ 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 noautoconfig Disable searching for device labeled GRMLCFG
+grml nobeep Disable welcome chime, sounded before grml-quickconfig starts.
Notice: Take a look at http://grml.org/config/ and 'man 1 grml-autoconfig'
for more information regarding the configuration framework of Grml.
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 nostats Don't send any information to the Grml project at startup.
+ Parameters sent are Grml version, if the cpu supports 64bit,
+ anonymized boot parameters and boot source (remote or local).
+ [Note: only available since release 2011.12]
grml module=grml Instead of using the default "$name.module" another file can
be specified without the extension ".module"; it should be placed
on "/live" directory of the live medium
grml nogpm Disable GPM daemon
grml noconsolefont Disable setting of console font (using consolechars)
grml noblank Disable console blanking
-grml tsplash Text based bootsplash
grml noquick Disable grml-quickconfig startup script
-grml small Do not start that many consoles
grml wondershaper=eth0,1000,500 Set up basic traffic shaping
grml services={postfix,mysql,...} Start service(s) which have an init-script (/etc/init.d/)
grml welcome Welcome message via soundoutput
startup of X again. (This bootoption is relevant for grml based derivatives
which decide to enable startx by default only, plain grml does not use
automatic startup of X by default.)
+grml vnc=password Start VNC server with startup of X.org and sets the password to the specified
+ one. To automatically start the VNC server use the startx bootoption.
+ [Note: Grml 2011.12+ doesn't include a VNC server.]
+grml vnc_connect=host[:port] Connect to a listening VNC client ("vncviewer -listen" reverse connection).
+ Can be used to connect from devices behind firewalls as connection is
+ initiated from the VNC server instead of the VNC client. Has to be
+ combined with the vnc bootoption.
+ [Note: Grml 2011.12+ doesn't include a VNC client.]
Accessibility related settings:
--------------------------------
-grml blind Start Braille-Terminal (no X)
-grml hwspeak Probe all available speakup hardware modules
-grml swspeak Prepare system for use with software synthesizer through speakup
- Run 'swspeak' after booting up to activate sound output
-grml swspeak=espeak Use espeakup (if available) as connector to speakup
- Run 'swspeak' after booting up to activate sound output
-grml swspeak=speechd Use speech-dispatcher / speechd-up (if available) as connector to speakup
- Run 'swspeak' after booting up to activate sound output
+--------------------------------
grml brltty=type,port,table Parameters for Braille device (e.g.: brltty=al,/dev/ttyS0,text.de.tbl)
-grml speakup.synth=... Use speakup kernel module with given hardware type
- Usage example: speakup.synth=apollo
+ See http://mielke.cc/brltty/guidelines.html for documentation.
Hardware related settings:
--------------------------
grml xmodule=ati|fbdev|i810|mga Use specified X.org-Module (1)
grml xmodule=nv|radeon|savage|s3 Use specified X.org-Module (2)
grml xmodule=radeon|svga|i810 Use specified X.org-Module (3)
-grml no{acpi,agp,apm,cpu,dhcp} Skip parts of HW-detection (1)
+grml no{acpi,agp,cpu,dhcp} Skip parts of HW-detection (1)
grml no{dma,fstab,modem} Skip parts of HW-detection (2)
grml no{pcmcia,scsi,swap,usb} Skip parts of HW-detection (3)
-grml 915resolution=... Start resolution modify tool for Intel graphic chipset
- usage: $MODE,$XRESO,$YRESO
grml blacklist=modulename[,module2] Completely disable loading of specified module(s) via
blacklisting through udev's /etc/modprobe.d/grml
grml fwtimeout=50 Set firmware timeout via /sys/class/firmware/timeout to specified value
grml micvol=number Set mixer volume of microphone to level $number (default: 0)
grml pnpbios=off No PnP Bios initialization
grml acpi=off Disable ACPI Bios completely
-grml nousb2 Disable initialization of USB 2.x controller(s)
-grml nousb Disable initialization of USB in booting sequence
grml nofirewire Disable initialization of firewire devices in booting sequence
grml pci=irqmask=0x0e98 Try this, if PS/2 mouse doesn't work *)
grml pci=bios Workaround for bad PCI controllers
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 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.
-Install grml via grml2hd bootoption (which runs grml2hd in non-interactive mode):
-
-grml2hd <options> ... whereas valid options for grml2hd are:
-
- user= user name for user which should be used at hd-install
- filesystem={ext2|ext3|reiserfs|reiser4|jfs|xfs} filesystem to be used
- mbr=/dev/... partition where MBR should be installed (default:=partition)
- partition=/dev/... partition where grml should be installed
-
- Usage example for booting:
- grml2hd partition=/dev/hda4 mbr=/dev/hda filesystem=ext3 user=mika
-
- Passwords of user root and user are "grml" - please adjust after hd-install!
-
- See http://grml.org/grml2hd/ for more information.
-
Additional notes:
-----------------
*) In case of a failing hardware autodetection, try booting with any of
the "no-" options as shown in the table above, like in
- grml noagp noapm noapic acpi=off nodma
+ grml noagp noapic acpi=off nodma
to skip some critical parts of the autodetection system.
*) Some boards (especially those with E-ISA slots) apparently don't pass