1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Live Systems Project
3 # This file is distributed under the same license as the live-boot package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
9 "Project-Id-Version: live-boot 1:20180603\n"
10 "POT-Creation-Date: 2019-05-09 14:58+0200\n"
11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
16 "Content-Type: text/plain; charset=CHARSET\n"
17 "Content-Transfer-Encoding: 8bit\n"
20 #: en/live-boot.7:1 en/persistence.conf.5:1
26 #: en/live-boot.7:1 en/persistence.conf.5:1
32 #: en/live-boot.7:1 en/persistence.conf.5:1
38 #: en/live-boot.7:1 en/persistence.conf.5:1
40 msgid "Live Systems Project"
44 #: en/live-boot.7:3 en/persistence.conf.5:3
51 msgid "B<live-boot> - System Boot Components"
55 #: en/live-boot.7:6 en/persistence.conf.5:7
63 "B<live-boot> contains the components that configure a live system during the "
64 "boot process (early userspace)."
71 "live-boot is a hook for the initramfs-tools, used to generate a initramfs "
72 "capable to boot live systems, such as those created by I<live-helper>(7). "
73 "This includes the Live systems ISOs, netboot tarballs, and usb stick images."
80 "At boot time it will look for a (read-only) medium containing a \"/live\" "
81 "directory where a root filesystems (often a compressed filesystem image like "
82 "squashfs) is stored. If found, it will create a writable environment, using "
83 "aufs, to boot the system from."
95 "B<live-boot> can be configured through a boot parameter or a configuration "
102 "To configure the live-boot parameters used by default in a live image, see "
103 "the --bootappend-live option in the I<lb_config>(1) manual page."
109 msgid "Kernel Parameters"
115 "B<live-boot> is only activated if 'boot=live' was used as a kernel parameter."
121 "In addition, there are some more boot parameters to influence the behaviour, "
128 msgid "Configuration Files"
134 "B<live-boot> can be configured (but not activated) through configuration "
135 "files. Those files can be placed either in the root filesystem itself (/etc/"
136 "live/boot.conf, /etc/live/boot/*), or on the live media (live/boot.conf, "
137 "live/boot/*). These environment variables can only be set in the "
138 "configuration files:"
144 msgid "B<DISABLE_CDROM>=[I<true>|I<false>]"
150 "Disable support for booting from CD-ROMs. If set to 'I<true>' mkinitramfs "
151 "will build an initramfs without the kernel modules for reading CD-ROMs."
157 msgid "B<DISABLE_FAT>=[I<true>|I<false>]"
163 "Disable support for booting from FAT file systems. If set to 'I<true>' "
164 "mkinitramfs will build an initramfs without the kernel module vfat and some "
171 msgid "B<DISABLE_FUSE>=[I<true>|I<false>]"
177 "Disable support for booting from FUSE-based file systems. If set to "
178 "'I<true>' mkinitramfs will build an initramfs without the kernel module fuse "
179 "and file systems that depend on it (like curlftpfs and httpfs2)."
185 msgid "B<DISABLE_NTFS>=[I<true>|I<false>]"
191 "Disable support for booting from NTFS file systems. If set to 'I<true>' "
192 "mkinitramfs will build an initramfs without the kernel module ntfs."
198 msgid "B<DISABLE_USB>=[I<true>|I<false>]"
204 "Disable support for booting from USB devices. If set to 'I<true>' "
205 "mkinitramfs will build an initramfs without the kernel module sd_mod."
211 msgid "B<MINIMAL>=[I<true>|I<false>]"
217 "Build a minimal initramfs. If set to 'I<true>' mkinitramfs will build an "
218 "initramfs without some udev scripts and without rsync."
224 msgid "B<PERSISTENCE_FSCK>=[I<true>|I<false>]"
228 #: en/live-boot.7:56 en/live-boot.7:106
230 "Run fsck on persistence filesystem on boot. Will attempt to repair errors. "
231 "The execution log will be saved in /var/log/live/fsck.log."
237 msgid "B<FSCKFIX>=[I<true>|I<false>]"
243 "If PERSISTENCE_FSCK or forcefsck are set, will pass -y to fsck to stop it "
244 "from asking questions interactively and assume yes to all queries."
248 #: en/live-boot.7:61 en/persistence.conf.5:57
256 msgid "B<live-boot> currently features the following parameters."
262 msgid "B<access>=I<ACCESS>"
268 "Set the accessibility level for physically or visually impaired users. "
269 "ACCESS must be one of v1, v2, v3, m1, or m2. v1=lesser visual impairment, "
270 "v2=moderate visual impairment, v3=blindness, m1=minor motor difficulties, "
271 "m2=moderate motor difficulties."
277 msgid "B<console>=I<TTY,SPEED>"
283 "Set the default console to be used with the \"live-getty\" option. Example: "
284 "\"console=ttyS0,115200\""
295 msgid "Makes initramfs boot process more verbose."
305 msgid "Without setting debug to a value the messages may not be shown."
311 msgid "B<fetch>=I<URL>"
317 msgid "B<httpfs>=I<URL>"
323 "Another form of netboot by downloading a squashfs image from a given URL. "
324 "The fetch method copies the image to RAM and the httpfs method uses FUSE and "
325 "httpfs2 to mount the image in place. Copying to RAM requires more memory and "
326 "might take a long time for large images. However, it is more likely to work "
327 "correctly because it does not require networking afterwards and the system "
328 "operates faster once booted because it does not require to contact the "
335 "Due to current limitations in busybox's wget and DNS resolution, an URL can "
336 "not contain a hostname but an IP address only."
341 msgid "Not working: http://example.com/path/to/your_filesystem.squashfs"
346 msgid "Working: http://1.2.3.4/path/to/your_filesystem.squashfs"
352 "Also note that therefore it's currently not possible to fetch an image from "
353 "a name-based virtualhost of an httpd if it is sharing the IP address with "
354 "the main httpd instance."
359 msgid "You may also use the live ISO image in place of the squashfs image."
365 msgid "B<iscsi>=I<server-ip[,server-port];target-name>"
371 "Boot from an iSCSI target that has an ISO or disk live image as one of its "
372 "LUNs. The specified target is searched for a LUN which looks like a live "
373 "medium. If you use the B<iscsitarget> software iSCSI target solution your "
374 "ietd.conf might look like this:"
379 msgid "# The target-name you specify in the iscsi= parameter"
383 #: en/live-boot.7:102
386 "Target E<lt>target-nameE<gt>\n"
387 " Lun 0 Path=E<lt>path-to-your-live-image.isoE<gt>,Type=fileio,IOMode=ro\n"
388 " # If you want to boot multiple machines you might want to look at tuning some parameters like\n"
389 " # Wthreads or MaxConnections\n"
393 #: en/live-boot.7:102
395 msgid "B<findiso>=I</PATH/TO/IMAGE>"
399 #: en/live-boot.7:104
401 "Look for the specified ISO file on all disks where it usually looks for the ."
402 "squashfs file (so you don't have to know the device name as in fromiso=....)."
406 #: en/live-boot.7:104
412 #: en/live-boot.7:106
414 msgid "B<fromiso>=I</PATH/TO/IMAGE>"
418 #: en/live-boot.7:108
420 "Use a filesystem from within an ISO image that's available on live-media. "
421 "The first part of the argument should be the block device where the image is "
422 "stored, followed by the path and filename (e.g. fromiso=/dev/sda1/live/image."
427 #: en/live-boot.7:110
429 "Alternatively, it can be used to boot from an ISO embedded into an initrd (e."
430 "g. fromiso=/live/image.iso)."
434 #: en/live-boot.7:110
436 msgid "B<ignore_uuid>"
440 #: en/live-boot.7:112
442 "Do not check that any UUID embedded in the initramfs matches the discovered "
443 "medium. live-boot may be told to generate a UUID by setting "
444 "LIVE_GENERATE_UUID=1 when building the initramfs."
448 #: en/live-boot.7:112
450 msgid "B<verify-checksums>"
454 #: en/live-boot.7:114
456 "If specified, an MD5 sum is calculated on the live media during boot and "
457 "compared to the value found in md5sum.txt found in the root directory of the "
462 #: en/live-boot.7:114
464 msgid "B<ip>=[I<DEVICE>]:[I<CLIENT_IP>]:[I<NETMASK>]:[I<GATEWAY_IP>]:[I<NAMESERVER>] [,[I<DEVICE>]:[I<CLIENT_IP>]:[I<NETMASK>]:[I<GATEWAY_IP>]:[I<NAMESERVER>]]"
468 #: en/live-boot.7:116
470 "Let you specify the name(s) and the options of the interface(s) that should "
471 "be configured at boot time. Do not specify this if you want to use dhcp "
472 "(default). It will be changed in a future release to mimic official kernel "
473 "boot param specification (e.g. ip=10.0.0.1::10.0.0.254:255.255.255.0::"
474 "eth0,:::::eth1:dhcp)."
478 #: en/live-boot.7:116
480 msgid "B<ip>=[I<frommedia>]"
484 #: en/live-boot.7:118
486 "If this variable is set, dhcp and static configuration are just skipped and "
487 "the system will use the (must be) media-preconfigured /etc/network/"
488 "interfaces instead."
492 #: en/live-boot.7:118
494 msgid "{B<live-media>|B<bootfrom>}=I<DEVICE>"
498 #: en/live-boot.7:120
500 "If you specify one of this two equivalent forms, live-boot will first try to "
501 "find this device for the \"/live\" directory where the read-only root "
502 "filesystem should reside. If it did not find something usable, the normal "
503 "scan for block devices is performed."
507 #: en/live-boot.7:122
509 "Instead of specifying an actual device name, the keyword 'removable' can be "
510 "used to limit the search of acceptable live media to removable type only. "
511 "Note that if you want to further restrict the media to usb mass storage "
512 "only, you can use the 'removable-usb' keyword."
516 #: en/live-boot.7:122
518 msgid "{B<live-media-encryption>|B<encryption>}=I<TYPE>"
522 #: en/live-boot.7:124
524 "live-boot will mount the encrypted rootfs TYPE, asking the passphrase, "
525 "useful to build paranoid live systems :-). TYPE supported so far is \"aes\" "
526 "for loop-aes encryption type."
530 #: en/live-boot.7:124
532 msgid "B<live-media-offset>=I<BYTES>"
536 #: en/live-boot.7:126
538 "This way you could tell live-boot that your image starts at offset BYTES in "
539 "the above specified or autodiscovered device, this could be useful to hide "
540 "the live system ISO or image inside another ISO or image, to create \"clean"
545 #: en/live-boot.7:126
547 msgid "B<live-media-path>=I<PATH>"
551 #: en/live-boot.7:128
553 "Sets the path to the live filesystem on the medium. By default, it is set to "
554 "'/live' and you should not change that unless you have customized your media "
559 #: en/live-boot.7:128
561 msgid "B<live-media-timeout>=I<SECONDS>"
565 #: en/live-boot.7:130
567 "Set the timeout in seconds for the device specified by \"live-media=\" to "
568 "become ready before giving up."
572 #: en/live-boot.7:130
574 msgid "B<module>=I<NAME>"
578 #: en/live-boot.7:132
580 "Instead of using the default optional file \"filesystem.module\" (see below) "
581 "another file could be specified without the extension \".module\"; it should "
582 "be placed on \"/live\" directory of the live medium."
586 #: en/live-boot.7:132
588 msgid "B<netboot>[=nfs|cifs]"
592 #: en/live-boot.7:134
594 "This tells live-boot to perform a network mount. The parameter \"nfsroot="
595 "\" (with optional \"nfsopts=\"), should specify where is the location of the "
596 "root filesystem. With no args, will try cifs first, and if it fails nfs."
600 #: en/live-boot.7:134
606 #: en/live-boot.7:136
607 msgid "This lets you specify custom nfs options."
611 #: en/live-boot.7:136
613 msgid "B<nofastboot>"
617 #: en/live-boot.7:138
619 "This parameter disables the default disabling of filesystem checks in /etc/"
620 "fstab. If you have static filesystems on your harddisk and you want them to "
621 "be checked at boot time, use this parameter, otherwise they are skipped."
625 #: en/live-boot.7:138
627 msgid "B<nopersistence>"
631 #: en/live-boot.7:140
633 "disables the \"persistence\" feature, useful if the bootloader (like "
634 "syslinux) has been installed with persistence enabled."
638 #: en/live-boot.7:140 en/live-boot.7:164
644 #: en/live-boot.7:142
645 msgid "Do not prompt to eject the live medium."
649 #: en/live-boot.7:142
651 msgid "B<ramdisk-size>"
655 #: en/live-boot.7:144
657 "This parameter defines a custom ramdisk size (it's the '-o size' option of "
658 "tmpfs mount). By default, there is no ramdisk size set, so the default of "
659 "mount applies (currently 50% of available RAM). Note that this option has "
660 "currently no effect when booting with toram."
664 #: en/live-boot.7:144
666 msgid "B<overlay-size>=I<SIZE>"
670 #: en/live-boot.7:146
672 "The size of the tmpfs mount (used for the upperdir union root mount) in "
673 "bytes, and rounded up to entire pages. This option accepts a suffix % to "
674 "limit the instance to that percentage of your physical RAM or a suffix k, m "
675 "or g for Ki, Mi, Gi (binary kilo (kibi), binary mega (mebi) and binary giga "
676 "(gibi)). By default, 50% of available RAM will be used."
680 #: en/live-boot.7:146
686 #: en/live-boot.7:148
687 msgid "This parameter enables usage of local swap partitions."
691 #: en/live-boot.7:148
693 msgid "B<persistence>"
697 #: en/live-boot.7:150
699 "live-boot will probe devices for persistence media. These can be partitions "
700 "(with the correct GPT name), filesystems (with the correct label) or image "
701 "files (with the correct file name). Overlays are labeled/named \"persistence"
702 "\" (see I<persistence.conf>(5)). Overlay image files are named \"persistence"
707 #: en/live-boot.7:150
709 msgid "B<persistence-encryption>=I<TYPE1>,I<TYPE2> ... I<TYPEn>"
713 #: en/live-boot.7:152
715 "This option determines which types of encryption that are allowed to be used "
716 "when probing devices for persistence media. If \"none\" is in the list, we "
717 "allow unencrypted media; if \"luks\" is in the list, we allow LUKS-encrypted "
718 "media. Whenever a device containing encrypted media is probed the user will "
719 "be prompted for the passphrase. The default value is \"none\"."
723 #: en/live-boot.7:152
725 msgid "B<persistence-media>={I<removable>|I<removable-usb>}"
729 #: en/live-boot.7:154
731 "If you specify the keyword 'removable', live-boot will try to find "
732 "persistence partitions on removable media only. Note that if you want to "
733 "further restrict the media to usb mass storage only, you can use the "
734 "'removable-usb' keyword."
738 #: en/live-boot.7:154
740 msgid "B<persistence-method>=I<TYPE1>,I<TYPE2> ... I<TYPEn>"
744 #: en/live-boot.7:156
746 "This option determines which types of persistence media we allow. If "
747 "\"overlay\" is in the list, we consider overlays (i.e. \"live-rw\" and "
748 "\"home-rw\"). The default is \"overlay\"."
752 #: en/live-boot.7:156
754 msgid "B<persistence-path>=I<PATH>"
758 #: en/live-boot.7:158
760 "live-boot will look for persistency files in the root directory of a "
761 "partition, with this parameter, the path can be configured so that you can "
762 "have multiple directories on the same partition to store persistency files."
766 #: en/live-boot.7:158
768 msgid "B<persistence-read-only>"
772 #: en/live-boot.7:160
774 "Filesystem changes are not saved back to persistence media. In particular, "
775 "overlays and netboot NFS mounts are mounted read-only."
779 #: en/live-boot.7:160
781 msgid "B<persistence-storage>=I<TYPE1>,I<TYPE2> ... I<TYPEn>"
785 #: en/live-boot.7:162
787 "This option determines which types of persistence storage to consider when "
788 "probing for persistence media. If \"filesystem\" is in the list, filesystems "
789 "with matching labels will be used; if \"file\" is in the list, all "
790 "filesystems will be probed for archives and image files with matching "
791 "filenames. The default is \"file,filesystem\"."
795 #: en/live-boot.7:162
797 msgid "B<persistence-label>=I<LABEL>"
801 #: en/live-boot.7:164
803 "live-boot will use the name \"LABEL\" instead of \"persistence\" when "
804 "searching for persistent storage. LABEL can be any valid filename, partition "
805 "label, or GPT name."
809 #: en/live-boot.7:166
811 "This option causes live-boot to reboot without attempting to eject the media "
812 "and without asking the user to remove the boot media."
816 #: en/live-boot.7:166
818 msgid "B<showmounts>"
822 #: en/live-boot.7:168
824 "This parameter will make live-boot to show on \"/\" the ro filesystems "
825 "(mostly compressed) on \"/lib/live\". This is not enabled by default because "
826 "could lead to problems by applications like \"mono\" which store binary "
827 "paths on installation."
831 #: en/live-boot.7:168
837 #: en/live-boot.7:170
839 "If you boot with the normal quiet parameter, live-boot hides most messages "
840 "of its own. When adding silent, it hides all."
844 #: en/live-boot.7:170
846 msgid "B<todisk>=I<DEVICE>"
850 #: en/live-boot.7:172
852 "Adding this parameter, live-boot will try to copy the entire read-only media "
853 "to the specified device before mounting the root filesystem. It probably "
854 "needs a lot of free space. Subsequent boots should then skip this step and "
855 "just specify the \"live-media=DEVICE\" boot parameter with the same DEVICE "
860 #: en/live-boot.7:172
866 #: en/live-boot.7:174
868 "Adding this parameter, live-boot will try to copy the whole read-only media "
869 "to the computer's RAM before mounting the root filesystem. This could need a "
870 "lot of ram, according to the space used by the read-only media."
874 #: en/live-boot.7:174
876 msgid "B<union>=overlay|aufs"
881 #: en/live-boot.7:177
883 "By default, live-boot uses overlay. With this parameter, you can switch to "
889 #: en/live-boot.7:179
895 #: en/live-boot.7:180
897 msgid "B</etc/live.conf>"
901 #: en/live-boot.7:182
903 "Some variables can be configured via this config file (inside the live "
908 #: en/live-boot.7:182
910 msgid "B<live/filesystem.module>"
915 #: en/live-boot.7:185
917 "This optional file (inside the live media) contains a list of white-space or "
918 "carriage-return-separated file names corresponding to disk images in the \"/"
919 "live\" directory. If this file exists, only images listed here will be "
920 "merged into the root aufs, and they will be loaded in the order listed here. "
921 "The first entry in this file will be the \"lowest\" point in the aufs, and "
922 "the last file in this list will be on the \"top\" of the aufs, directly "
923 "below /overlay. Without this file, any images in the \"/live\" directory "
924 "are loaded in alphanumeric order."
928 #: en/live-boot.7:186
934 #: en/live-boot.7:187
936 msgid "B</etc/live/boot.conf>"
940 #: en/live-boot.7:188
942 msgid "B</etc/live/boot/*>"
946 #: en/live-boot.7:189
948 msgid "B<live/boot.conf>"
952 #: en/live-boot.7:190
954 msgid "B<live/boot/*>"
958 #: en/live-boot.7:191
960 msgid "B<persistence.conf>"
964 #: en/live-boot.7:193 en/persistence.conf.5:190
970 #: en/live-boot.7:195
971 msgid "I<persistence.conf>(5)"
975 #: en/live-boot.7:197 en/persistence.conf.5:194
976 msgid "I<live-build>(7)"
980 #: en/live-boot.7:199 en/persistence.conf.5:196
981 msgid "I<live-config>(7)"
985 #: en/live-boot.7:201 en/persistence.conf.5:198
986 msgid "I<live-tools>(7)"
990 #: en/live-boot.7:202 en/persistence.conf.5:199
996 #: en/live-boot.7:204 en/persistence.conf.5:201
998 "More information about live-boot and the Live Systems project can be found "
999 "on the homepage at E<lt>I<https://wiki.debian.org/DebianLive>E<gt> and in "
1000 "the manual at E<lt>I<https://live-team.pages.debian.net/live-manual/>E<gt>."
1004 #: en/live-boot.7:205 en/persistence.conf.5:202
1010 #: en/live-boot.7:207 en/persistence.conf.5:204
1012 "Bugs can be reported by submitting a bugreport for the live-boot package in "
1013 "the Bug Tracking System at E<lt>I<http://bugs.debian.org/>E<gt> or by "
1014 "writing a mail to the Live Systems mailing list at E<lt>I<debian-live@lists."
1019 #: en/live-boot.7:208 en/persistence.conf.5:205
1025 #: en/live-boot.7:209 en/persistence.conf.5:206
1027 "live-boot was written by Daniel Baumann E<lt>I<mail@daniel-baumann.ch>E<gt>."