Configuration settings:
-----------------------
-grml myconfig=/dev/fd0 Execute "grml.sh" and extract config.tbz from a partition:
+grml myconfig=/dev/fd0 Set the DCS dir (debs, config, scripts) to the root of this device
+ DCS dir defaults to the live image or a device labeled GRMLCFG
+ 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 netconfig=server/config.tbz Download file and extract configuration archive
+grml netscript=server/file Download and execute file [Note: only available in releases >2009.05]
grml partconf=/dev/hda2 Copy files specified in /etc/grml/partconf from /dev/hda2
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
+ http://wiki.grml.org/doku.php?id=persistency
grml home=/dev/hda2 Mount specified partition as grml homedir
grml home=/dev/sda1/grml.img Mount loopback file as /home/grml
grml home=scan Automatic search for grml homedir (using file grml.img)
grml hostname=... Set hostname
+grml nodhcphostname Do not to set the hostname according to the dns information
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
+ (/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 mypath=... Add specified option into $PATH of Zsh.
+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 noautoconfig Disable searching for device labeled GRMLCFG.
-
-Notice: Take a look at http://grml.org/config/ and /usr/share/doc/grml-saveconfig/grml-config.html
+ 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
+ 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
+
+Notice: Take a look at http://grml.org/config/ and 'man 1 grml-autoconfig'
for more information regarding the configuration framework of grml.
Booting related options:
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.
+ 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.
+grml bootfrom=/dev/sda1 Use the squashfs file from directory 'live' of the specified device
Setup can be done booting 'grml tohd=/dev/sda1' or
- running 'rsync -a --progress /live/image/live /mnt/sda1/'.
-grml isofrom=/dev/sda1/grml.iso Use specified ISO image for booting.
+ running 'rsync -a --progress /live/image/live /mnt/sda1/'
+grml bootfrom=removable Restrict search for the live media to removable type only.
+grml bootfrom=removable-usb Restrict search for the live media to usb mass storage only.
+grml isofrom=/dev/sda1/grml.iso Use specified ISO image for booting
Useful when booting as a rescue system from harddisk - just boot
the according grml kernel and initrd using the bootoptions
- "boot=live isofrom=/dev/sda1/grml.iso".
+ "boot=live isofrom=/dev/sda1/grml.iso"
Notice: "fromiso" does the same as "isofrom", it's just there
- to prevent any typing errors.
-
-grml live-media-path=live Sets the path to the live filesystem on the medium.
- By default, it is set to /live.
+ to prevent any typing errors
+grml findiso=/grml_2009.10.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=....). [Available since Grml 2009.05]
+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
be specified without the extension ".module"; it should be placed
- on "/live" directory of the live medium.
+ on "/live" directory of the live medium
Useful for Multiboot USB pen, see
http://wiki.grml.org/doku.php?id=tips#multiboot_usb_pen
+grml bootid=mybootid Use specified argument as identifier for the ISO.
+ [Note: only available in releases >2009.10]
+grml ignore_bootid Disable bootid verification.
+ [Note: only available in releases >2009.10]
+
Debugging related settings:
---------------------------
-debug Get shells during process of booting, using GNU screen, most verbose
-grml debug Get shells during process of booting, using GNU screen, verbose
+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.
grml debug=noscreen Get shells during process of booting, verbose, but without using GNU screen
grml nocolor Disable colorized output while booting
grml log Log error messages while booting to /tmp/grml.log.`date +%Y%m%d`"
- and /var/log/boot.
+ and /var/log/boot
grml testcd Check CD data integrity and md5sums
Service related settings:
grml gcc=3.4 gpp=3.4 Link /usr/bin/gcc, /usr/bin/cpp and /usr/bin/c++ to specified version
grml startx{=windowmanager} Start X window system automatically
Default window manager (if not provided): wm-ng (wrapper around fluxbox)
+grml nostartx If using startx as default bootoption the nostartx *disables* automatic
+ 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.)
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.
+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.
+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
+grml speakup.synth=... Use speakup kernel module with given hardware type
+ Usage example: speakup.synth=apollo
Hardware related settings:
--------------------------
grml nolvm Disable scanning for Logical Volumes (LVM)
grml lvm Automatically activate Logival Volumes (LVM) during boot
grml readonly Make sure all harddisk devices (/dev/hd* /dev/sd*) are forced to read-only mode
+grml ethdevice=... Use specified network device for network boot instead of default (eth0)
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 pci=bios Workaround for bad PCI controllers
grml ide2=0x180 nopcmcia Boot from PCMCIA-CD-ROM (some notebooks)
grml mem=128M Specify Memory size in MByte
-grml dma Enable DMA accelleration for ALL IDE-Drives
-grml nodma ide=nodma Disable DMA accelleration for ALL IDE-Drives
+grml libata.force=[ID:]VAL Force configurations for libata.
+ Usage example: grml libata.force=1:pio4
+ 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
directory live, containing the squashfs compressed filesystem file,
must be located in the top level directory of the CD.
-*) Caution: screensavers: Don't start xlock/vlock or any other screensaver
+*) Caution: screensavers: Don't start vlock or any screensaver
that requires a password. There are no default passwords on grml,
i.e. all accounts are LOCKED unless you explicitly set a password.
See also README.txt about this issue.
projects / grml-live.git / blobdiff