Commit Graph

293 Commits

Author SHA1 Message Date
Lyndon Brown 09c4f89263 manpage: fix typo
"to be build" -> "to be built"

Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown c2fb7516ee manpage: source archives clarification
Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown 14a56deb0e manpage: use upper case acronyms
not sure that ISO is an acronym, but included anyway

Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown aed4e0fef2 manpage: explain specifying multiple bootloaders 2020-03-05 11:28:19 +00:00
Lyndon Brown 009ddccaed manpage: fix poor bootloaders description 2020-03-05 11:28:19 +00:00
Lyndon Brown 4037226376 manpage: fix typo
"know" -> "known"

Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown a150e0573d manpage: fix typo
"some times" -> "sometimes"

Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown 513befa3f5 manpage: fix possible parent installer values
the parent one allows "daily" also

Gbp-Dch: Short
2020-03-05 11:28:19 +00:00
Raphaël Hertzog 44b9b0a650 Support --distribution-binary and --distribution-chroot
This makes it possible to build an image against a first distribution
(--distribution-chroot) and have the resulting image point to another
distribution (--distribution-binary). We can use this to build against a
snapshot and have the result use the original distribution that was
snapshotted.

Closes: #888507
2019-12-19 18:18:44 +01:00
Roland Clobus 1682c5c8d1
Manpage: Update the default values of --mirror-* and --parent-mirror-* 2019-06-22 13:58:54 +02:00
Roland Clobus 14d82a8065
Manpage: use 3rd person form when describing an option 2019-06-22 13:08:57 +02:00
Roland Clobus 137ec1559c
Manpage: simplify the description 2019-06-22 13:05:59 +02:00
Roland Clobus 6ed2715e23
Manpage: the configuration directory (config) cannot be modified 2019-06-19 13:26:16 +02:00
Roland Clobus a9dba166ad
Manpage: removed FIXME for the SYNOPSIS section, all options are now listed 2019-06-19 13:20:15 +02:00
Roland Clobus a2d2065dec
Manpage: removed incorrect mentioning of the -d command line option 2019-06-19 13:11:11 +02:00
Roland Clobus 5aaf2181b8
--mirror-binary* was not properly sorted 2019-06-19 13:07:10 +02:00
Roland Clobus e7a629fb02
Manpage: Use alphabetical order for the description of the command line options 2019-06-19 13:05:24 +02:00
Roland Clobus a50dbe2567
Manpage: typo 2019-06-19 12:27:06 +02:00
Roland Clobus 0a97e7c069
Manpage: consistent use of whitespace in the command line option list 2019-06-19 12:26:07 +02:00
Roland Clobus a957982203
Manpage: added missing \fR tags 2019-06-19 12:25:13 +02:00
Roland Clobus 1837f6a40b
Reordered the command line options to make them in alphabetical order 2019-06-16 13:12:06 +02:00
Roland Clobus a844199e30
Manpage: Added documentation for --bootstrap-qemu-[arch|exclude|static] 2019-06-16 12:47:29 +02:00
Roland Clobus 58a82854a4
Manpage: Added documentation for --loadlin 2019-06-16 12:47:29 +02:00
Roland Clobus aef1b75233
Manpage: Added documentation for --swap-file-path and --swap-file-size 2019-06-16 12:47:29 +02:00
Roland Clobus c8fddcd702
Manpage: Added documentation for --firmware-binary and --firmware-chroot 2019-06-16 12:47:29 +02:00
Roland Clobus 554c37fd9e
Manpage: --parent-archive-areas uses the same argument name as 'lb config --help' 2019-06-16 12:47:29 +02:00
Roland Clobus 7c02640b62
Manpage: --mode explicitly supports debian and progress-linux. Special handling for ubuntu was dropped 2015-05-03 2019-06-16 12:47:29 +02:00
Roland Clobus 05ed83a2b6
Manpage: Added documentation for --hdd-label, --hdd-size and --hdd-partition-start 2019-06-16 12:47:28 +02:00
Roland Clobus 6c6151d0c9
Manpage: Added documentation for --image-name 2019-06-16 12:47:28 +02:00
Roland Clobus c54aa22bf6
Manpage: Added documentation for --initsystem 2019-06-16 12:47:28 +02:00
Roland Clobus ab8c09eca1
--initramfs support none and live-boot 2019-06-16 12:47:28 +02:00
Roland Clobus e9af6d559f
Manpage: Removed references to command line options that are no longer
in the code:
--firmware-binary
--firmware-chroot
--hooks
--parent-mirror-chroot-updates
--parent-mirror-chroot-backports
--parent-mirror-binary-updates
--parent-mirror-binary-backports
--mirror-chroot-updates
--mirror-chroot-backports
--mirror-binary-updates
--mirror-binary-backports
--templates
2019-06-16 12:47:28 +02:00
Roland Clobus f8f09c77c7
Manpage: Added documentation for --zsync 2019-06-16 12:47:28 +02:00
Roland Clobus ae5a77aedb
Manpage: --config synchronised to 'lb config --help' 2019-06-16 12:47:28 +02:00
Roland Clobus 9a4c334a55
Manpage: --compression also accepts xz. The default is none 2019-06-16 12:47:27 +02:00
Roland Clobus 75733ac554
Manpage: Added documentation for --breakpoints 2019-06-16 12:47:12 +02:00
Roland Clobus 45e45a8a22
Matched the documentation of --checksums to the implementation in live-boot 2019-06-16 12:44:13 +02:00
Roland Clobus d9961a8a54
Manpage: --binary-filesystem also accepts ntfs 2019-06-04 08:04:42 +02:00
Roland Clobus c166c87497 Removed option none for --apt-indices, which was removed in 3.0.2-1. 2019-06-03 10:48:58 +00:00
Roland Clobus c4abbbcc7e Reenabled the command line option for colored messages for lb_config. The functionality was added 2008-11-01, but was not really active. 2019-06-03 10:48:58 +00:00
Roland Clobus c035b3f106
Updated URL in the LB_ISO_PUBLISHER field. 2019-04-17 21:29:34 +02:00
Roland Clobus f460533ca1
Updated URL in the LB_ISO_PREPARER field. 2019-04-17 21:27:04 +02:00
Roland Clobus d8eb2d4d1b
Updated homepage URL. 2019-04-17 21:00:02 +02:00
Matthijs Kooijman 3227d34966 Remove --templates from lb_config manpage
This option was removed in commit 7e633e77f (Moving grub and grub2
templates into shared bootloader config directory.), but the
documentation stayed around.
2019-04-16 17:25:12 +02:00
Adrian Gibanel Lopez 80aa5ab611 Fixed foreign architecture package support to linux kernel flavours
Before Stretch there was an special amd64 kernel in the i386 arch repo.
So if you wanted to install an amd64 kernel alongside an i386 system
you did not need an additional arch repo.

Debian added multiarch support. That way you can install library packages
from multiple architectures on the same machine.

So there is no longer a need for having an amd64 kernel in i386 arch repo.
You can add an amd64 arch repo to an i386 arch system and fetch the amd64
kernel from the am64 arch repo.

live-build can be setup to use several linux kernel flavours in a single
image.

So in the days previous to this patch you could issue:
lb config --linux-flavours "486 amd64"
to use both 486 and amd64 kernel flavours.

Adding additional arch support to linux flavours poses two problems:

* Packages need to have its arch suffix (e.g. amd64:amd64).
If the suffix is not there apt-get insists on search amd64 kernel
package on i386 arch repo and, of course, fails to find it.

* The rest of the code which handles labels (bootloader config files)
or installed filenames (kernel images themselves) do not use the arch suffix.

This patch adds foreign architecture package support to
linux kernel flavours having taken those problems into account.

Practical example usage: i386 system and extra amd64 kernel.

First add amd64 foreign architecture in your i386 system
thanks to:

dpkg --add-architecture amd64
apt-get update

.

Finally enable amd64 kernel from amd64 arch alongside the
i386 system's 686 kernel thanks to:

lb config --architectures i386 --linux-flavours "686 amd64:amd64"
2019-03-14 23:06:31 +01:00
Luca Boccassi 46c9596926 Add options to build ONIE images
Open Network Install Environment is an open image format used by
networking vendor to ship a standardised image for networking white
box switches.

ONIE hardware takes this image at boot and a script to chain load
into the final environment via kexec. We can support Debian and
derivatives on such systems by packing an ISO which then gets
unpacked, kexec'ed and live-booted.

A base ONIE system can be tested in QEMU by building a VM following
these instrunctions:

https://github.com/opencomputeproject/onie/blob/master/machine/kvm_x86_64/INSTALL

Once built, boot onie-recovery-x86_64-kvm_x86_64-r0.iso in QEMU/libvirt
and on the console there will be the terminal prompt. Check the IP
assigned by libvirt and then scp the live image (ssh access is enabled
as root without password...). Then the .bin can be booted with:
 ONIE-RECOVERY:/ # onie-nos-install /tmp/live.hybrid.iso-ONIE.bin

The implementation is inspired by ONIE's own scripts that can be found
at:
https://github.com/opencomputeproject/onie/blob/master/contrib/debian-iso/cook-bits.sh

A new option, --onie (false by default) can be set to true to enable
building this new format in addition to an ISO.
An additional option, --onie-kernel-cmdline can be used to specify
additional options that the ONIE system should use when kexec'ing the
final image.
Note that only iso or hybrid-iso formats are supported.

For more information about the ONIE ecosystem see:
http://onie.org

Signed-off-by: Erik Ziegenbalg <eziegenb@Brocade.com>
Signed-off-by: Luca Boccassi <bluca@debian.org>
2018-03-22 16:14:01 +00:00
Luca Boccassi 035518ff69 UEFI: add support for Secure Boot on amd64 and arm64
Support for UEFI Secure Boot is modelled after how it currently works
in Ubuntu and on how it is going to work on Debian.
A minimal bootloader, shim, is used as the first-stage and it then
loads grub. Both have to be signed.
shim-signed is already available in Debian so the filenames are
already established, and the grub2 repository and packaging is common
between the 2 distros so we can already be reasonably sure of what it
is going to be.
So if both are available, copy /usr/lib/shim/shim[x64|aa64].efi.signed
as boot[x64|aa64].efi so that UEFI loads it first, and copy
/usr/lib/grub/[x86_64|arm64]-efi-signed/grub[x64|aa64].efi.signed as
grub[x64|aa64].efi.
This grub2 EFI monolithic image is currently hard-coded in grub2's
repository to look for a config file in efi/debian, so make a copy
of the previously added minimal grub.cfg that loads the real one in
that directory in both the fat32 and ISO 9660 partitions.

The new option --uefi-secure-boot can be set to auto (default,
enable or disable.
In auto, the lack of the signed EFI binaries is intentionally left as a
soft failure - live-build will simply fallback to using the locally
generated non-signed grub2 monolithic EFI binary as the only
bootloader. Given the difficulties surrounding the Secure Boot
signing infrastructure this approach gives the most flexibility and
makes sure things will "just work" once the packages are available,
without the need to change anything in the configuration.
This will also greatly help downstream distributions and users who
want to do self-signing.
The enable or disable options work as expected.

Closes: #821084
2018-03-09 20:57:54 +00:00
Raphaël Hertzog 37840d9cb2 Fix version strings in manual pages 2017-08-29 15:07:32 +02:00
Raphaël Hertzog c5a334deb8 Update PREPARER data for consistency 2017-08-29 15:06:35 +02:00
Raphaël Hertzog 3f909bf486 Drop all references to live-systems.org and update copyright file
Also fix the version string in the manual pages.

Closes: #859290
2017-08-29 14:12:33 +02:00