= Live Boot Parameters :params-page: {start-toc} [[toc]] [compact] * link:#under-toc[Synopsis] * link:#_new_since_antix_15[New since antiX-15!] * link:#_boot_livecd_usb[Boot LiveCD/USB] ** link:#_the_boot_device[The Boot Device] ** link:#_the_boot_directory[The Boot Directory] ** link:#_debugging[Debugging] ** link:#_loading_modules[Loading Modules] ** link:#_other_booting_options[Other Booting options] * link:#_persistence[Persistence] ** link:#_the_persistence_device[The Persistence Device] ** link:#boot-options[Other Persistence Options] * link:#_remastering[Remastering] * link:#_frugal_install[Frugal Install] ** link:#_the_frugal_device[The Frugal Device] * link:#_x_windows[X-Windows] ** link:#_keyboard_options[Keyboard Options] ** link:#_x_windows_video_options[X-Windows Video Options] * link:#_mounting[Mounting] * link:#_personalization[Personalization] * link:#_other_live_system_features[Other Live System Features] ** link:#_disable_some_systemv_services[Disable Some SystemV Services] ** link:#_other_live_options[Other Live Options] * link:#_list_of_all_boot_parameters_described[List of All Boot Parameters Described] [[under-toc]] == Synopsis {top} This page explains many of the boot parameters that are used by antiX Live systems. Most users will get by just fine by making selections in the bootloader menus. The boot menus provide a convenient GUI for setting some of the options documented here. Use the cheat:F12: key in the bootloader to see what boot options are selected by your current menu choices. == New since antiX-15! These boot parameters have been recently added. * cheat:blacklist=: A list of kernel modules to blacklist. These modules won't get automatically loaded. * cheat:blacklist=VIDEO: If you add cheat:VIDEO: to the list then all KMS video modules will get blacklisted. * cheat:bootchart: Create /var/log/bootchart.tgz. Use the program +pybootchartgui to convert this to a .png image to view what happens when the Live system boots. It is designed to stop recording a few seconds after conky starts. * cheat:desktheme=dark|light: Choose either a dark theme or a light theme for the desktop. Use the command +set-desktop-theme+ to change the theme from the command line. * cheat:earlyvid: Try to load KMS video modules earlier in the boot process. This is mainly for debugging but if it works, it may give a a higher resolution console slighter earlier in the boot process. * cheat:failsafe: This has the effect of combining several different boot parameters that should allow antiX to boot on most systems and get to X-Windows. Some older system may need to use cheat:acpi=off: and so forth. These options are not enabled by default because they may be rarely needed and each one has a cost associated with it such as poorer graphics resolution and performance in X-Windows. We hope on one will ever need to use the cheat:failsafe: option. These are the boot options it enables: load=all blacklist=VIDEO from=all xorg=safe * cheat:hwclock=local|utc: Assume that the hardware clock is set to either UTC or to localtime. If you are dual booting with Windows then you should set the hardware clock to localtime. Otherwise, UTC is preferred. * cheat:menus: Enable a series of text-based menus to make the selections that are normally made by the function key popup menus in the Live bootloader. This is primarily for booting via UEFI since the UEFI bootloaders don't provide support for separate menus. * cheat:plink: Enable pseudo-links in the AUFS file system. If you don't know what this means then you probably don't want to use it although it shouldn't do any harm. * cheat:private: Get prompted for new root and demo passwords during the boot process. The well known and well advertised default passwords for the root and demo accounts on the Live system are a security risk. Using your own passwords instead of the defaults should make your system a little safer. * cheat:savestate: (**LiveUSB Only**) Save certain "state" files across reboots even without persistence enabled. Also save certain machine-specific state files across reboots. You can control which files get saved by editing the files +/live/boot-dev/antiX/state/general-state-files+ and +/live/boot-dev/antiX/state/machine-state-files+. Those files and the directory they are in will be created automatically the first time you boot the LiveUSB. This is enabled by default and it is "sticky" so once you enable it it will stay enabled until you turn it off. See below. * cheat:nosavestate: (**LiveUSB Only**) disable saving state files. See description above. This too is sticky so when you use it saving state will stay disabled until you re-enable it. == Boot LiveCD/USB {top} These options control how the Live media boots. In particular the control where we look for the +linuxfs+ file. The location of this file will be used for other Live features such as persistence and remastering. === The Boot Device {top} The primary job of Live initrd is to find the compressed file system called a *squashfs* file. For antiX and MX this file is normally named +linuxfs+. We need to find the device this file is on and find the file on that device. Normally we scan all cdrom (and dvd) and usb devices for that file. This default behavior can be modified with the following options. The easiest way to specify the boot device is the cheat:from: option which specifies what type of device to boot from. * cheat:from=: The type of boot device. Valid values: cheat:cd hd usb:, and cheat:all:. More than one is allowed. The default is cheat:usb,cd: so by default we will only look at cdrom/dvd devices and usb devices to for the boot directory. You can also specify a device more specifically by giving a device name (like +sda1+), a partition label, or a partition UUID. The cheat:bdev:, cheat:blab:, and cheat:buuid: options allow you to specify which device we look on to find the +linuxfs+ file. * cheat:bdev=: The name of the boot device. For example cheat:bdev=sda:.. * cheat:blab=