checkbashisms can be found on salsa.debian.org now.

[live-boot-grml.git] / manpages / en / live-boot.7

diff --git a/manpages/en/live-boot.7 b/manpages/en/live-boot.7
index e6bc73f..3a8c1a9 100644 (file)
--- a/manpages/en/live-boot.7
+++ b/manpages/en/live-boot.7
@@ -27,29 +27,37 @@ In addition, there are some more boot parameters to influence the behaviour, see
 These environment variables can only be set in the configuration files:
 
 .TP
 These environment variables can only be set in the configuration files:
 
 .TP

-\fBDISABLE_CDROM\fR=[\fIy\fR|\fIn\fR]
+\fBDISABLE_CDROM\fR=[\fItrue\fR|\fIfalse\fR]

 Disable support for booting from CD-ROMs.  If set to '\fIy\fR' mkinitramfs will build an initramfs without the kernel modules for reading CD-ROMs.
 
 .TP
 Disable support for booting from CD-ROMs.  If set to '\fIy\fR' mkinitramfs will build an initramfs without the kernel modules for reading CD-ROMs.
 
 .TP

-\fBDISABLE_FAT\fR=[\fIy\fR|\fIn\fR]
+\fBDISABLE_FAT\fR=[\fItrue\fR|\fIfalse\fR]

 Disable support for booting from FAT file systems.  If set to '\fIy\fR' mkinitramfs will build an initramfs without the kernel module vfat and some nls_* modules.
 
 .TP
 Disable support for booting from FAT file systems.  If set to '\fIy\fR' mkinitramfs will build an initramfs without the kernel module vfat and some nls_* modules.
 
 .TP

-\fBDISABLE_FUSE\fR=[\fIy\fR|\fIn\fR]
+\fBDISABLE_FUSE\fR=[\fItrue\fR|\fIfalse\fR]

 Disable support for booting from FUSE-based file systems.  If set to '\fIy\fR' mkinitramfs will build an initramfs without the kernel module fuse and file systems that depend on it (like curlftpfs and httpfs2).
 
 .TP
 Disable support for booting from FUSE-based file systems.  If set to '\fIy\fR' mkinitramfs will build an initramfs without the kernel module fuse and file systems that depend on it (like curlftpfs and httpfs2).
 
 .TP

-\fBDISABLE_NTFS\fR=[\fIy\fR|\fIn\fR]
+\fBDISABLE_NTFS\fR=[\fItrue\fR|\fIfalse\fR]

 Disable support for booting from NTFS file systems.  If set to '\fIy\fR' mkinitramfs will build an initramfs without the kernel module ntfs.
 
 .TP
 Disable support for booting from NTFS file systems.  If set to '\fIy\fR' mkinitramfs will build an initramfs without the kernel module ntfs.
 
 .TP

-\fBDISABLE_USB\fR=[\fIy\fR|\fIn\fR]
+\fBDISABLE_USB\fR=[\fItrue\fR|\fIfalse\fR]

 Disable support for booting from USB devices.  If set to '\fIy\fR' mkinitramfs will build an initramfs without the kernel module sd_mod.
 
 .TP
 Disable support for booting from USB devices.  If set to '\fIy\fR' mkinitramfs will build an initramfs without the kernel module sd_mod.
 
 .TP

-\fBMINIMAL\fR=[\fIy\fR|\fIn\fR]
+\fBMINIMAL\fR=[\fItrue\fR|\fIfalse\fR]

 Build a minimal initramfs.  If set to '\fIy\fR' mkinitramfs will build an initramfs without some udev scripts and without rsync.
 
 Build a minimal initramfs.  If set to '\fIy\fR' mkinitramfs will build an initramfs without some udev scripts and without rsync.
 

+.TP
+\fBPERSISTENCE_FSCK\fR=[\fItrue\fR|\fIfalse\fR]
+Run fsck on persistence filesystem on boot. Will attempt to repair errors. The execution log will be saved in /var/log/live/fsck.log.
+
+.TP
+\fBFSCKFIX\fR=[\fItrue\fR|\fIfalse\fR]
+If PERSISTENCE_FSCK or forcefsck are set, will pass -y to fsck to stop it from asking questions interactively and assume yes to all queries.
+

 .SH OPTIONS
 \fBlive\-boot\fR currently features the following parameters.
 .\" FIXME
 .SH OPTIONS
 \fBlive\-boot\fR currently features the following parameters.
 .\" FIXME


@@ -93,8 +101,12 @@ Target <target-name>
   # Wthreads or MaxConnections
 .IP "\fBfindiso\fR=\fI/PATH/TO/IMAGE\fI" 4
 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 fromiso=....).
   # Wthreads or MaxConnections
 .IP "\fBfindiso\fR=\fI/PATH/TO/IMAGE\fI" 4
 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 fromiso=....).

+.IP "\fBforcefsck\fR" 4
+Run fsck on persistence filesystem on boot. Will attempt to repair errors. The execution log will be saved in /var/log/live/fsck.log.

 .IP "\fBfromiso\fR=\fI/PATH/TO/IMAGE\fI" 4
 .IP "\fBfromiso\fR=\fI/PATH/TO/IMAGE\fI" 4

-Use a filesystem from within an ISO image that's available on live-media.
+Use a filesystem from within an ISO image that's available on live-media. The first part of the argument should be the block device where the image is stored, followed by the path and filename (e.g. fromiso=/dev/sda1/live/image.iso).
+.br
+Alternatively, it can be used to boot from an ISO embedded into an initrd (e.g. fromiso=/live/image.iso).

 .IP "\fBignore_uuid\fR" 4
 Do not check that any UUID embedded in the initramfs matches the discovered medium. live\-boot may be told to generate a UUID by setting LIVE_GENERATE_UUID=1 when building the initramfs.
 .IP "\fBverify\-checksums\fR" 4
 .IP "\fBignore_uuid\fR" 4
 Do not check that any UUID embedded in the initramfs matches the discovered medium. live\-boot may be told to generate a UUID by setting LIVE_GENERATE_UUID=1 when building the initramfs.
 .IP "\fBverify\-checksums\fR" 4