forked from josch/mmdebstrap
wrap POD to 79 characters width
This commit is contained in:
parent
2782d14348
commit
6abbb3ebd9
1 changed files with 39 additions and 23 deletions
62
mmdebstrap
62
mmdebstrap
|
@ -3581,18 +3581,18 @@ B<required>. See the section B<VARIANTS> for more information.
|
||||||
=item B<--mode>=I<name>
|
=item B<--mode>=I<name>
|
||||||
|
|
||||||
Choose how to perform the chroot operation and create a filesystem with
|
Choose how to perform the chroot operation and create a filesystem with
|
||||||
ownership information different from the current user. Valid mode I<name>s are B<auto>,
|
ownership information different from the current user. Valid mode I<name>s are
|
||||||
B<sudo>, B<root>, B<unshare>, B<fakeroot>, B<fakechroot> and B<proot>. The
|
B<auto>, B<sudo>, B<root>, B<unshare>, B<fakeroot>, B<fakechroot> and B<proot>.
|
||||||
default mode is B<auto>. See the section B<MODES> for more information.
|
The default mode is B<auto>. See the section B<MODES> for more information.
|
||||||
|
|
||||||
=item B<--aptopt>=I<option>|I<file>
|
=item B<--aptopt>=I<option>|I<file>
|
||||||
|
|
||||||
Pass arbitrary I<option>s to apt. Will be added to
|
Pass arbitrary I<option>s to apt. Will be added to
|
||||||
F</etc/apt/apt.conf.d/99mmdebstrap> inside the chroot. Can be specified
|
F</etc/apt/apt.conf.d/99mmdebstrap> inside the chroot. Can be specified
|
||||||
multiple times. Each I<option> will be appended to 99mmdebstrap. A semicolon will
|
multiple times. Each I<option> will be appended to 99mmdebstrap. A semicolon
|
||||||
be added at the end of the option if necessary. If the command line argument
|
will be added at the end of the option if necessary. If the command line
|
||||||
is an existing I<file>, the content of the file will be appended to 99mmdebstrap
|
argument is an existing I<file>, the content of the file will be appended to
|
||||||
verbatim.
|
99mmdebstrap verbatim.
|
||||||
|
|
||||||
Example: This is necessary for allowing old timestamps from snapshot.debian.org
|
Example: This is necessary for allowing old timestamps from snapshot.debian.org
|
||||||
|
|
||||||
|
@ -3618,7 +3618,8 @@ Example: For situations in which the apt sandbox user cannot access the chroot
|
||||||
Example: Minimizing the number of packages installed from experimental
|
Example: Minimizing the number of packages installed from experimental
|
||||||
|
|
||||||
--aptopt='APT::Solver "aspcud"'
|
--aptopt='APT::Solver "aspcud"'
|
||||||
--aptopt='APT::Solver::aspcud::Preferences "-count(solution,APT-Release:=/a=experimental/),-removed,-changed,-new"'
|
--aptopt='APT::Solver::aspcud::Preferences
|
||||||
|
"-count(solution,APT-Release:=/a=experimental/),-removed,-changed,-new"'
|
||||||
|
|
||||||
=item B<--keyring>=I<file>|I<directory>
|
=item B<--keyring>=I<file>|I<directory>
|
||||||
|
|
||||||
|
@ -3653,8 +3654,8 @@ pointing to F</usr/share/keyrings/ubuntu-archive-keyring.gpg>.
|
||||||
Pass arbitrary I<option>s to dpkg. Will be added to
|
Pass arbitrary I<option>s to dpkg. Will be added to
|
||||||
F</etc/dpkg/dpkg.cfg.d/99mmdebstrap> inside the chroot. Can be specified
|
F</etc/dpkg/dpkg.cfg.d/99mmdebstrap> inside the chroot. Can be specified
|
||||||
multiple times. Each I<option> will be appended to 99mmdebstrap. If the command
|
multiple times. Each I<option> will be appended to 99mmdebstrap. If the command
|
||||||
line argument is an existing I<file>, the content of the file will be appended to
|
line argument is an existing I<file>, the content of the file will be appended
|
||||||
99mmdebstrap verbatim.
|
to 99mmdebstrap verbatim.
|
||||||
|
|
||||||
Example: Exclude paths to reduce chroot size
|
Example: Exclude paths to reduce chroot size
|
||||||
|
|
||||||
|
@ -3729,13 +3730,17 @@ information.
|
||||||
|
|
||||||
Example: Setup merged-/usr via symlinks
|
Example: Setup merged-/usr via symlinks
|
||||||
|
|
||||||
--setup-hook='for d in bin sbin lib; do ln -s usr/$d "$1/$d"; mkdir -p "$1/usr/$d"; done'
|
--setup-hook='for d in bin sbin lib; do ln -s usr/$d "$1/$d";
|
||||||
|
mkdir -p "$1/usr/$d"; done'
|
||||||
|
|
||||||
Example: Setup chroot for installing a sub-essential busybox-based chroot with
|
Example: Setup chroot for installing a sub-essential busybox-based chroot with
|
||||||
--variant=custom --include=dpkg,busybox,libc-bin,base-files,base-passwd,debianutils
|
--variant=custom
|
||||||
|
--include=dpkg,busybox,libc-bin,base-files,base-passwd,debianutils
|
||||||
|
|
||||||
--setup-hook='mkdir -p "$1/bin"'
|
--setup-hook='mkdir -p "$1/bin"'
|
||||||
--setup-hook='for p in awk cat chmod chown cp diff echo env grep less ln mkdir mount rm rmdir sed sh sleep sort touch uname; do ln -s busybox "$1/bin/$p"; done'
|
--setup-hook='for p in awk cat chmod chown cp diff echo env grep less ln
|
||||||
|
mkdir mount rm rmdir sed sh sleep sort touch uname; do
|
||||||
|
ln -s busybox "$1/bin/$p"; done'
|
||||||
--setup-hook='echo root:x:0:0:root:/root:/bin/sh > "$1/etc/passwd"'
|
--setup-hook='echo root:x:0:0:root:/root:/bin/sh > "$1/etc/passwd"'
|
||||||
--setup-hook='printf "root:x:0:\nmail:x:8:\nutmp:x:43:\n" > "$1/etc/group"'
|
--setup-hook='printf "root:x:0:\nmail:x:8:\nutmp:x:43:\n" > "$1/etc/group"'
|
||||||
|
|
||||||
|
@ -3748,12 +3753,16 @@ more information.
|
||||||
|
|
||||||
Example: Enable unattended upgrades
|
Example: Enable unattended upgrades
|
||||||
|
|
||||||
--essential-hook='echo unattended-upgrades unattended-upgrades/enable_auto_updates boolean true | chroot "$1" debconf-set-selections'
|
--essential-hook='echo unattended-upgrades
|
||||||
|
unattended-upgrades/enable_auto_updates boolean true
|
||||||
|
| chroot "$1" debconf-set-selections'
|
||||||
|
|
||||||
Example: Select Europe/Berlin as the timezone
|
Example: Select Europe/Berlin as the timezone
|
||||||
|
|
||||||
--essential-hook='echo tzdata tzdata/Areas select Europe | chroot "$1" debconf-set-selections'
|
--essential-hook='echo tzdata tzdata/Areas select Europe
|
||||||
--essential-hook='echo tzdata tzdata/Zones/Europe select Berlin | chroot "$1" debconf-set-selections'
|
| chroot "$1" debconf-set-selections'
|
||||||
|
--essential-hook='echo tzdata tzdata/Zones/Europe select Berlin
|
||||||
|
| chroot "$1" debconf-set-selections'
|
||||||
|
|
||||||
=item B<--customize-hook>=I<command>
|
=item B<--customize-hook>=I<command>
|
||||||
|
|
||||||
|
@ -3764,7 +3773,8 @@ B<HOOKS> for more information.
|
||||||
Example: Preparing a chroot for use with autopkgtest
|
Example: Preparing a chroot for use with autopkgtest
|
||||||
|
|
||||||
--customize-hook='chroot "$1" passwd --delete root'
|
--customize-hook='chroot "$1" passwd --delete root'
|
||||||
--customize-hook='chroot "$1" useradd --home-dir /home/user --create-home user'
|
--customize-hook='chroot "$1" useradd --home-dir /home/user
|
||||||
|
--create-home user'
|
||||||
--customize-hook='chroot "$1" passwd --delete user'
|
--customize-hook='chroot "$1" passwd --delete user'
|
||||||
--customize-hook='echo host > "$1/etc/hostname"'
|
--customize-hook='echo host > "$1/etc/hostname"'
|
||||||
--customize-hook='echo "127.0.0.1 localhost host" > "$1/etc/hosts"'
|
--customize-hook='echo "127.0.0.1 localhost host" > "$1/etc/hosts"'
|
||||||
|
@ -3898,7 +3908,8 @@ The B<minbase> set plus build-essential.
|
||||||
|
|
||||||
=item B<important>, B<debootstrap>, B<->
|
=item B<important>, B<debootstrap>, B<->
|
||||||
|
|
||||||
The B<required> set plus all packages with Priority:important. This is the default of debootstrap.
|
The B<required> set plus all packages with Priority:important. This is the
|
||||||
|
default of debootstrap.
|
||||||
|
|
||||||
=item B<standard>
|
=item B<standard>
|
||||||
|
|
||||||
|
@ -4019,7 +4030,8 @@ If you don't want this behaviour, you can override it by manually specifying a
|
||||||
mirror in various different ways:
|
mirror in various different ways:
|
||||||
|
|
||||||
$ mmdebstrap stable stable-chroot.tar http://deb.debian.org/debian
|
$ mmdebstrap stable stable-chroot.tar http://deb.debian.org/debian
|
||||||
$ mmdebstrap stable stable-chroot.tar "deb http://deb.debian.org/debian stable main"
|
$ mmdebstrap stable stable-chroot.tar \
|
||||||
|
"deb http://deb.debian.org/debian stable main"
|
||||||
$ mmdebstrap stable stable-chroot.tar /path/to/sources.list
|
$ mmdebstrap stable stable-chroot.tar /path/to/sources.list
|
||||||
$ mmdebstrap stable stable-chroot.tar - < /path/to/sources.list
|
$ mmdebstrap stable stable-chroot.tar - < /path/to/sources.list
|
||||||
|
|
||||||
|
@ -4049,7 +4061,8 @@ Use as replacement for autopkgtest-build-qemu and vmdb2:
|
||||||
|
|
||||||
$ mmdebstrap --variant=important --include=linux-image-amd64 \
|
$ mmdebstrap --variant=important --include=linux-image-amd64 \
|
||||||
--customize-hook='chroot "$1" passwd --delete root' \
|
--customize-hook='chroot "$1" passwd --delete root' \
|
||||||
--customize-hook='chroot "$1" useradd --home-dir /home/user --create-home user' \
|
--customize-hook='chroot "$1" useradd --home-dir /home/user
|
||||||
|
--create-home user' \
|
||||||
--customize-hook='chroot "$1" passwd --delete user' \
|
--customize-hook='chroot "$1" passwd --delete user' \
|
||||||
--customize-hook='echo host > "$1/etc/hostname"' \
|
--customize-hook='echo host > "$1/etc/hostname"' \
|
||||||
--customize-hook='echo "127.0.0.1 localhost host" > "$1/etc/hosts"' \
|
--customize-hook='echo "127.0.0.1 localhost host" > "$1/etc/hosts"' \
|
||||||
|
@ -4076,7 +4089,8 @@ Use as replacement for autopkgtest-build-qemu and vmdb2:
|
||||||
|
|
||||||
Build a non-Debian chroot like Ubuntu bionic:
|
Build a non-Debian chroot like Ubuntu bionic:
|
||||||
|
|
||||||
$ mmdebstrap --aptopt='Dir::Etc::Trusted "/usr/share/keyrings/ubuntu-keyring-2012-archive.gpg"' bionic bionic.tar
|
$ mmdebstrap --aptopt='Dir::Etc::Trusted
|
||||||
|
"/usr/share/keyrings/ubuntu-keyring-2012-archive.gpg"' bionic bionic.tar
|
||||||
|
|
||||||
=head1 ENVIRONMENT VARIABLES
|
=head1 ENVIRONMENT VARIABLES
|
||||||
|
|
||||||
|
@ -4097,7 +4111,7 @@ This section lists some differences to debootstrap.
|
||||||
|
|
||||||
=item * 3-6 times faster
|
=item * 3-6 times faster
|
||||||
|
|
||||||
=item * Can create a chroot with only C<Essential:yes> packages and their dependencies
|
=item * Can create a chroot with only C<Essential:yes> packages and their deps
|
||||||
|
|
||||||
=item * Reproducible output by default if $SOURCE_DATE_EPOCH is set
|
=item * Reproducible output by default if $SOURCE_DATE_EPOCH is set
|
||||||
|
|
||||||
|
@ -4119,7 +4133,9 @@ Limitations in comparison to debootstrap:
|
||||||
|
|
||||||
=item * No I<--second-stage> and I<--exclude> option.
|
=item * No I<--second-stage> and I<--exclude> option.
|
||||||
|
|
||||||
=item * No-op options I<--resolve-deps>, I<--force-check-gpg>, I<--merged-usr> and I<--no-merged-usr>
|
=item * Some debootstrap options don't exist, namely:
|
||||||
|
|
||||||
|
I<--resolve-deps>, I<--force-check-gpg>, I<--merged-usr> and I<--no-merged-usr>
|
||||||
|
|
||||||
=back
|
=back
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue