X-Git-Url: https://git.grml.org/?p=grml-debootstrap.git;a=blobdiff_plain;f=grml-debootstrap.8.txt;h=b572f5cb06d0c035621abd2b7e030d2bed5e21cd;hp=205e788d481903e5cdf6f4c7224724d8297d1ecd;hb=b1008a63920208df5814d8c10543f1a7032187da;hpb=0b1d9821475753d8580982724b807cc8f2daa7e5 diff --git a/grml-debootstrap.8.txt b/grml-debootstrap.8.txt index 205e788..b572f5c 100644 --- a/grml-debootstrap.8.txt +++ b/grml-debootstrap.8.txt @@ -85,8 +85,11 @@ Options and environment variables *--defaultinterfaces*:: - Install a default /etc/network/interfaces file (enabling DHCP for eth0) + Install a default /etc/network/interfaces file (enabling DHCP for all local + Ethernet, WLAN and WWAN interfaces using predictable network interface names + and using eth0 as traditional interface name for backward compatibility) instead of taking over config from host system. + This option is automatically enabled when using --vm or --vmfile. *--efi* _device_:: @@ -155,7 +158,6 @@ Options and environment variables *--nointerfaces*:: Do not copy /etc/network/interfaces from host system to the target. - This option is automatically enabled when using --vm or --vmfile. *--nokernel*:: @@ -217,13 +219,20 @@ Options and environment variables Specify release of new Debian system. Supported releases names: lenny, squeeze, wheezy, jessie, stretch, buster, bullseye and sid. Corresponding with configuration - variable RELEASE. Default release: buster + variable RELEASE. Default release: bullseye *--remove-configs*:: Delete grml-debootstrap configuration files (/etc/debootstrap/*) from installed system. Useful for reproducible builds or if you don't want to leak information. +*--sshcopyauth*:: + + Use locally available _$HOME/.ssh/authorized_keys_ to authorise root login on the target system. + This installs _$HOME/.ssh/authorized_keys_ as _/root/.ssh/authorized_keys_ on + the target system. If a different file than _$HOME/.ssh/authorized_keys_ should + be used, the environment variable _AUTHORIZED_KEYS_SOURCE_ can be used. + *--sshcopyid*:: Use locally available public keys to authorise root login on the target system. @@ -246,6 +255,7 @@ Options and environment variables partitioned. This allows deployment of a Virtual Machine. The options needs to be combined with the --target option. + This option automatically enables the --defaultinterfaces option. Usage example: --vm --target /dev/mapper/your-vm-disk *--vmfile*:: @@ -254,6 +264,7 @@ Options and environment variables partition/block device or directory. This allows deployment of a Virtual Machine. The options needs to be combined with the --target option ('qemu-img create -f raw ...' is executed on the specified target). + This option automatically enables the --defaultinterfaces option. Usage example: --vmfile --target /mnt/sda1/qemu.img *--vmsize* _size_:: @@ -271,12 +282,19 @@ WARNING: the command line parsing of grml-debootstrap usually does not validate the provided arguments for the command line options. Please be careful and check docs and /etc/debootstrap/config for further information. +Networking +---------- + +By default (that is, if none of the options *--nointerfaces*, +*--defaultinterfaces*, *--vmfile* or *--vm* are given) /etc/network/interfaces +will be copied from the host to the target system. + Usage examples --------------- grml-debootstrap --target /dev/sda1 --grub /dev/sda -Install default Debian release (buster) on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda. +Install default Debian release (bullseye) on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda. grml-debootstrap --release stretch --target /dev/sda1 --grub /dev/sda --hostname debian01 --password changeme @@ -289,32 +307,32 @@ Install Debian unstable/sid on /dev/sda6 and install bootmanager GRUB in MBR (ma DEBOOTSTRAP=mmdebstrap grml-debootstrap --target /dev/sda1 --grub /dev/sda -Install default Debian release (buster) on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda. +Install default Debian release (bullseye) on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda. Use mmdebstrap instead of default debootstrap tool for bootstrapping. grml-debootstrap --target /dev/mapper/vg0-rootfs --grub /dev/sda -Install default Debian release (buster) on LVM device /dev/mapper/vg0-rootfs and install bootmanager GRUB in MBR (master boot record) of /dev/sda. +Install default Debian release (bullseye) on LVM device /dev/mapper/vg0-rootfs and install bootmanager GRUB in MBR (master boot record) of /dev/sda. - grml-debootstrap --efi /dev/sda1 --target /dev/sda2 --grub /dev/sda --efi + grml-debootstrap --efi /dev/sda1 --target /dev/sda2 --grub /dev/sda -Install default Debian release (buster) on /dev/sda2 and install bootmanager GRUB in MBR (master boot record) of /dev/sda. +Install default Debian release (bullseye) on /dev/sda2 and install bootmanager GRUB in MBR (master boot record) of /dev/sda. Use /dev/sda1 as EFI partition (requires EFI support in booted system). mount /dev/sda1 /data/chroot grml-debootstrap --target /data/chroot -Install default Debian release (buster) in directory /data/chroot (without any bootloader). +Install default Debian release (bullseye) in directory /data/chroot (without any bootloader). grml-debootstrap --target /dev/sda3 --grub /dev/sda --mirror ftp://ftp.tugraz.at/mirror/debian -Install default Debian release (buster) on /dev/sda3 and install bootmanager GRUB in MBR (master boot record) of /dev/sda. +Install default Debian release (bullseye) on /dev/sda3 and install bootmanager GRUB in MBR (master boot record) of /dev/sda. Use specified mirror instead of the default (http://deb.debian.org/debian) one. mount /dev/sda1 /mnt/sda1 grml-debootstrap --vmfile --vmsize 3G --target /mnt/sda1/qemu.img -Install default debian release (buster) in a Virtual Machine file with 3GB disk size (including GRUB as bootmanager in MBR of the virtual disk file): +Install default debian release (bullseye) in a Virtual Machine file with 3GB disk size (including GRUB as bootmanager in MBR of the virtual disk file): mount -o loop ./debian-CD-1.iso /media/cdrom grml-debootstrap --target /dev/sda1 --grub /dev/sda --iso /media/cdrom @@ -386,7 +404,7 @@ Where do you want to install grub to? Usage example: grub=/dev/sda release=... -Specify release of new Debian system. Defaults to Debian buster. Supported +Specify release of new Debian system. Defaults to Debian bullseye. Supported releases: lenny, squeeze, wheezy, jessie, stretch, buster, bullseye and sid. Usage example: release=stretch mirror=...