Commit Graph

364 Commits

Author SHA1 Message Date
Lyndon Brown dab716e079 "Live Systems" -> "Debian Live" 2020-03-11 15:23:31 +00:00
Lyndon Brown 7a4a9f94b8 amend copyright & licensing blocks
Current versions of the project files are built upon versions published
and licensed by Daniel Baumann, but are modified copies of those files and
thus need to be marked as such per licensing requirements (afaik he did
not pass along ownership / licensing rights to anyone when he left the
project). We should also be careful to not be misrepresenting such
modified copies as being attributed to Daniel.

Adding a new copyright line referring to "The Debian Live team" should
suffice for this.

The authorship block in man pages has also similarly been updated.

Notes:
 - tweaked a copy of daniel copyright lines stating 2014 instead of 2015.
   both of these cases were in files that i had personally introduced in
   some of my past merged commits that moved some code around. i don't know
   why they stated 2014.
 - binary_onie was introduced in 2018, so that has a 2018 date instead of
   2016 unlike the rest.
 - 'efi-image' is a 3rd-party (Canonical Ltd) work that we bundle, but it
   has been modified by 674794a8f4 and
   36a3ba7634 so I similarly added a
   debian live copyright line.
 - 'grub-cpmodules' is similar. it was only changed by the indentation fix
   of 36a3ba7634 but modification is
   modification, and this does help cover any possible future changes that
   might be made.
2020-03-11 13:51:19 +00:00
Lyndon Brown 8b109ffb96 config: rename --architectures to --architecture
this has only ever supported specifying a single arch, thus was confusing
being plural

Gbp-Dch: Short
Closes: #952892
2020-03-05 20:39:53 +00:00
jnqnfe fcafaede19 simplify --debian-installer choices
`false` and `none` make no sense as choices for this option. Here we
replace `false` with `none`, and remove `true`.

Note that `true` was treated as an alias for netinst (see the changes to
source_disk and and binary_disk).

For backwards compatibility we still allow `true` and `false` by converting
them to `netinst` and `none` respectively, whilst printing a warning to
encourage users to move to `netinst`/`none`.

Gbp-Dch: Short
Closes: #952864
2020-03-05 11:36:55 +00:00
Lyndon Brown a96107a3f1 manpage: fix missing mention of a config file
this is the last commit for the set reported as #952856 and thus closes it

Gbp-Dch: Ignore
Closes: #952856
2020-03-05 11:28:19 +00:00
Lyndon Brown cb0f943c43 manpage: better explain --distribution
some might think "distribution" refers to "debian"/"ubuntu"/"redhat"/etc

Gbp-Dch: Short
2020-03-05 11:28:19 +00:00
Lyndon Brown 09b24a5dd6 manpage: add non-free firmware note 2020-03-05 11:28:19 +00:00
Lyndon Brown ba08531da3 manpage: fix wrong description for --firmware-binary
--firmware-binary adds firmware to d-i, --firmware-chroot adds to live

Gbp-Dch: Short
2020-03-05 11:28:19 +00:00
Lyndon Brown 54f19a3efe manpage: ubuntu support was dropped
...so remove obsolete mentions

Gbp-Dch: Short
2020-03-05 11:28:19 +00:00
Lyndon Brown 54f77db4f1 manpage: document --system default
Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown 78f361a571 manpage: clarify
Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown 887bb3ccd5 manpage: grammar
Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown f15d1af0ea manpage: fix typo
"automatise" -> "automate"

Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown 888f63eb86 manpage: actually explain the purpose of the option in the description
Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown 1a8377de7d manpage: better explain --debian-installer-gui
Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown 3c5b687aed manpage: clarity
Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown 0d86c79880 manpage: clarity
Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown 3cb4608d2b manpage: fix package cache explanation
"from the local mirror" suggested that live-build is always used with a
local mirror, which is not the case.

Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown bc4fc322b5 manpage: clarity
Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown 23bd035708 manpage: fix typo
"the their"

Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
Lyndon Brown cdb44f4bcc manpage: fix typo
"of each packages" -> "of each package"

Gbp-Dch: Ignore
2020-03-05 11:28:19 +00:00
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
Raphaël Hertzog 10a5580c3a Fix english mistakes in lb_config(1) 2016-12-16 10:03:45 +01:00
Raphaël Hertzog 75aa6dec5b Minor updates to lb_config and its manual page
* Update the manual page with the missiong --bootappend-live-failsafe
  option.
* Keep supporting the former --bootloader (without s).
2016-12-16 10:00:36 +01:00
Raphaël Hertzog 53eab12a24 Fix lintian warning about bad whatis entry 2016-11-28 23:23:24 +01:00
Raphaël Hertzog 164f23368e Support “lb config --debootstrap-script <script>”
This option lets you use an alternate bootstrap script when running
debootstrap. Thanks to Sjoerd Simons <sjoerd@debian.org> for the initial
patch.

Closes: #790033
2016-11-28 20:58:19 +01:00
Adrian Gibanel Lopez 7becd08e4d Added EFI support by the means of grub-efi
This work is based on debian-cd team work and uses,
as much as possible, the same mkisofs options
than the Debian Installation CD disk does.

It assumes that /boot/grub/grub.cfg (and other design items)
is generated by: binary_loopback_cfg .

It relies on efi-image and grub-cpmodules being setup
as build scripts on live-build package.
In the future event of these two files being moved
to a binary package (they are originally from:
src: live-installer) the binary_grub-efi script would have
to be rewritten to take the new paths into account.
2016-07-31 15:09:13 +02:00
Ben Armstrong 1f8975cc60 Remove 586 flavour for i386 architecture. (Closes: #807972) 2015-12-15 14:01:29 +00:00
trebmuh 89040368a8 [l10n] Update French translation for manpages. 2015-12-15 14:00:26 +00:00
Daniel Baumann 4789428101
Releasing debian version 5.0~a11-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2015-08-23 10:58:02 +02:00
Daniel Baumann 44ab759038
Releasing debian version 5.0~a10-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2015-08-10 19:36:25 +02:00
Daniel Baumann 06fb96a10c
Releasing debian version 5.0~a9-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2015-06-06 06:40:39 +02:00
Daniel Baumann 3c303e7f53
Releasing debian version 5.0~a8-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2015-05-19 06:27:05 +02:00
Daniel Baumann 66d8b61303
Releasing debian version 5.0~a7-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2015-05-14 13:16:48 +02:00
Daniel Baumann 9280926b11 Switching from http.debian.net to httpredir.debian.org as default binary mirror. 2015-05-10 19:10:28 +02:00
Daniel Baumann ffb463f775
Releasing debian version 5.0~a6-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2015-05-04 20:04:23 +02:00
Daniel Baumann 7f6b1d71f8
Releasing debian version 5.0~a5-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2015-04-28 07:58:18 +02:00
Daniel Baumann 9c51918b3b
Releasing debian version 5.0~a4-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2015-04-26 20:21:09 +02:00
Daniel Baumann ba53a1f948
Releasing debian version 5.0~a3-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2015-02-07 06:57:48 +01:00
Daniel Baumann e51315ae1e Switching to default to linux-image-586 on i386. 2015-01-26 06:30:49 +01:00
Daniel Baumann 242aef5d83 Updating year in copyright notices to 2015. 2015-01-04 20:05:44 +01:00
Daniel Baumann b814f4e07e Dropping cdebootstrap support (Closes: #773657).
debootstrap is the official tool to bootstrap debian,
cdebootstrap has had the one or other bug making it
broken for times during the release cycles.

The extra effort of supporting both debootstrap
and cdebootstrap is hardly worth it since the bootstrap
stage is cached anyway.
2014-12-23 22:54:41 +01:00
Daniel Baumann 2841d696c0
Releasing debian version 5.0~a1-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2014-12-10 08:39:45 +01:00
Daniel Baumann a767601f25
Releasing debian version 4.0.4-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2014-12-10 08:24:49 +01:00
jnqnfe ef9b1e8487 Fix missing grub2 option in bootloader selection (Closes: #772671). 2014-12-10 07:51:50 +01:00
Daniel Baumann a157fbb361
Releasing debian version 4.0.3-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2014-10-25 14:39:17 +02:00
Daniel Baumann afef2c271e
Releasing debian version 4.0.2-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2014-09-12 13:42:57 +02:00
victory c736a9743d Fix typos in lb_config.1. 2014-09-09 21:00:49 +02:00
Daniel Baumann b1ce772ab7
Releasing debian version 4.0.1-1.
Signed-off-by: Daniel Baumann <mail@daniel-baumann.ch>
2014-08-28 23:26:04 +02:00
Daniel Baumann c1d85328f8 Restoring old manpages since we're back to the non-python implementation (Closes: #745134). 2014-08-28 01:01:31 +02:00
Daniel Baumann 82648922d5 Moving old manpages out of the way. 2013-05-06 14:50:07 +02:00