ÜBERSICHT

multistrap [-a ARCH] [-d VERZ] -f KONFIGURATIONSDATEI
multistrap [--simulate] -f KONFIGURATIONSDATEI
multistrap -?|-h|--help|--version

OPTIONEN

-?|-h|--help|--version - den Hilfetext ausgeben und erfolgreich beenden

--dry-run - alle Konfigurationseinstellungen zusammenstellen und eine Kurzfassung ausgeben

--simulate - entspricht --dry-run

(Die folgenden Optionen können auch in der Konfigurationsdatei gesetzt werden.)

a|--arch - Architektur der Pakete, die in den Multistrap hineinkommen

-d|--dir - Verzeichnis in das der Bootstrap installiert wird

-f|--file - Konfigurationsdatei für Multistrap [erforderlich]

-s|--shortcut - verkürzte Version von -f für Dateien an bekannten Orten

--tidy-up - die Apt-Zwischenspeicherdaten, heruntergeladene Paketdateien und den Apt-Paketzwischenspeicher entfernen. Entspricht cleanup=true.

--no-auth - die Benutzung von nicht authentifizierten Depots erlauben. Entspricht noauth=true

--source-dir VERZ - verschiebt die Inhalte von var/cache/apt/archives/ aus der Chroot in das angegebene externe Verzeichnis und fügt dann die Debian-Quellpakete für jedes benutzte Programm hinzu. Entspricht retainsources=VERZ. Falls das angegebene Verzeichnis nicht existiert, passiert nichts. Benötigt --tidy-up, um die vollständige Liste der Quellpakete einschließlich Abhängigkeiten zu berechnen.

BESCHREIBUNG

Multistrap stellt mehrere Debootstrap ähnliche Methoden bereit, die auf APT basieren, erweitert um die Unterstützung für mehrere Depots; dabei wird eine Konfigurationsdatei verwendet, um relevante Suites, Architekturen, zusätzliche Pakete und den Spiegel anzugeben, die für jeden Bootstrap benutzt werden.

Das Ziel ist es, ein komplettes Bootstrap-/Wurzeldateisystem mit allen installierten und konfigurierten Paketen zu erstellen, statt nur eines Basissystems.

In den meisten Fällen möchten Anwender die Konfigurationsdatei für jede unterschiedliche Multistrap-Benutzung erstellen.

Beispielkonfiguration:

 [General]
 arch=armel
 directory=/opt/multistrap/
 # entspricht der Option --tidy-up, falls auf »true« gesetzt
 cleanup=true
 # entspricht der Option --no-auth, falls auf »true« gesetzt
 # pro Bootstrap aufgeführte Keyring-Pakete werden trotzdem installiert
 noauth=false
 # alle heruntergeladenen Pakete extrahieren (Vorgabe ist »true«).
 unpack=true
 # ob die »/suite« hinzugefügt wird, um explizit festzulegen, wo APT
 # nach Paketen suchen muss. (Vorgabe ist »false«)
 explicitsuite=false
 # aktiviert Multiarch für die angegebenen Architekturen
 # Vorgabe ist leer
 multiarch=
 # »aptsources« ist eine Liste von Abschnitten, die die 
 # /etc/apt/sources.list.d/multistrap.sources.list des Ziels benutzen.
 # Die Reihenfolge spielt keine Rolle.
 aptsources=Debian
 # Die Bootstrap-Option legt fest, welches Depot zur Berechnung der
 # Prioritätsliste benutzt wird: Benötigte Pakete und welche Pakete in das
 # Wurzeldateisystem wandern.
 # Die Reihenfolge der Abschnitte spielt keine Rolle.
 bootstrap=Debian
 
 [Debian]
 packages=
 source=http://ftp.uk.debian.org/debian
 keyring=debian-archive-keyring
 suite=jessie

This will result in a completely normal bootstrap of Debian Jessie from the specified mirror, for armel in '/opt/multistrap/'. (This configuration is retained in the package as /usr/share/multistrap/jessie.conf)

Geben Sie ein Paket zur Erweiterung von Multistrap an, um das Paket und alle Abhängigkeiten des Pakets einzufügen.

Geben Sie weitere Depots für den Bootstrap an, indem Sie neue Abschnitte hinzufügen. Abschnittsnamen müssen für die Pakete in der »Bootstrap«-Option unter [General] aufgelistet sein, um in den Bootstrap eingefügt zu werden.

Geben Sie durch Auflisten der Abschnittsnamen in der «aptsources«-Option unter [General] an, welche Depots im fertigen System beim Start verfügbar sein sollen, z.B. um einige interne Quellen auszuschließen oder wenn ein lokaler Spiegel beim Erstellen des Wurzeldateisystems benutzt wird.

Abschnittsnamen sind von Groß- und Kleinschreibung unabhängig

Alle Abhängigkeiten werden nur durch Apt unter Benutzung aller Bootstrap-Depots aufgelöst, um nur die neusten und tauglichsten Abhängigkeiten zu benutzen. Beachten Sie, dass Multistrap Installationsempfehlungen ignoriert, so dass ein Paket, das von Multistrap benötigt wird und das nur eine empfohlene Abhängigkeit hat, explizit in der Paketzeile angegeben werden muss. Lesen Sie "Explizite Angabe der Suite", um weitere Informationen über den Erhalt spezieller Pakete von speziellen Suites zu bekommen.

»architecture« und »directory« können auf der Befehlszeile überschrieben werden. Einige andere allgemeine Optionen besitzen auch Befehlszeilenoptionen.

Online examples and documentation

"multistrap" supports a range of permutations, see the wiki and the emdebian website for more information and example configurations:

http://wiki.debian.org/Multistrap

http://www.emdebian.org/multistrap/

"multistrap" includes an example configuration file with a full list of all supported config file options: /usr/share/doc/multistrap/examples/full.conf

Kürzel

Auf eine ähnliche Weise wie "Debootstrap" unterstützt "Multistrap" auf Konfigurationsdateien an bekannten Orten über Kürzel Bezug zu nehmen. Wenn die Option "--shortcut" benutzt wird, wird Multistrap in /usr/share/multistrap und dann in /etc/multistrap.d/ nach Dateien suchen. Dabei wird eine ».conf«-Erweiterung an das angegebene Kürzel angehängt.

Diese beiden Befehle sind gleichwertig:

 $ sudo multistrap -s sid
 $ sudo multistrap -f /usr/share/multistrap/sid.conf

Beachten Sie, dass "Multistrap" auch weiterhin scheitern wird, wenn die Konfigurationsdatei nicht das Verzeichnis oder die Architektur setzt.

Depots

"aptsources" listet die Abschnitte auf, die benutzt werden sollen, um die /etc/apt/sources.list.d/multistrap.list-Apt-Quellen im fertigen System zu erstellen. Nicht alle "aptsources" müssen im Abschnitt "Bootstrap" erscheinen, falls Sie interne oder lokale Quellen haben, die für das installierte Wurzel-Dateisystem nicht verfügbar sind.

"aptsources" listet die Abschnitte auf, die benutzt werden sollen, um Multistrap selbst zu erstellen. Nur Pakete, die in "Bootstrap" aufgelistet sind, werden durch den Multistrap heruntergeladen und entpackt.

Stellen Sie sicher, dass "Bootstrap" alle Abschnitte auflistet, die Sie für Apt benötigen, um in der Lage zu sein alle Pakete zu finden, die für den Multistrap entpackt werden.

(Ältere Versionen von Multistrap unterstützen die gleiche Option unter dem "Debootstrap"-Namen – diese Schreibweise wird immer noch unterstützt, aber neuere Versionen sollten stattdessen "Bootstrap" benutzen.

Allgemeine Einstellungen:

»arch« kann auf der Befehlszeile mit der Option "--arch" überschrieben werden.

»directory« gibt das Verzeichnis auf der obersten Ebene an, auf der der Bootstrap erstellt wird – es wird nicht in ein .tgz gepackt, sobald es vollständig ist.

»bootstrap« listet die Abschnitte auf, die zur Angabe der Pakete benutzt werden, die in den Bootstrap heruntergeladen (und optional entpackt) werden.

»aptsources« listet die Abschnitte auf, die zur Angabe der Apt-Quellen im fertigen System benutzt werden, z.B. falls Sie ein lokales Depot benutzen müssen, um das Wurzeldateisystem zu generieren, das dem Gerät zur Laufzeit nicht zur Verfügung stehen wird, führen Sie den Abschnitt in "bootstrap" auf, aber nicht in "aptsources".

Wenn Sie ein Paket im Wurzel-Dateisystem haben möchten, muss es in der "Bootstrap"-Liste unter »General« aufgelistet sein.

Die Reihenfolge der Abschnittsnamen in beiden Listen ist unwichtig.

If "markauto" is set to true, "multistrap" will request apt to mark all packages specified in the combined "packages" list as manually installed and all dependencies not explicitly listed as automatically installed in the APT extended state database. "markauto" can be used independently of "unpack".

Wie auch Debootstrap wird Multistrap nach Fehlern so lange fortfahren, wie die Konfigurationsdatei korrekt ausgewertet werden kann.

Multistrap implementiert außerdem die Unterstützung für »machine:variant«, die ursprünglich in Emdebian-Crush benutzt wurde, wenngleich in einer anderen Implementierung. Bei Benutzung der stufenförmigen Konfigurationsunterstützung können bestimmte »machine:variant«-Kombinationen durch einfache Änderungen auf der Befehlszeile unterstützt werden.

Wenn "tarballname" auf »true« gesetzt wird, wird das fertige Dateisystem zusätzlich in einen Tarball gepackt.

Beachten Sie, dass Multistrap unbekannte Optionen in der Konfigurationsdatei ignoriert – dies erlaubt sowohl rückwärtskompatibles Verhalten als auch Überladen der Multistrap-Konfigurationsdateien, um andere Werkzeuge zu unterstützen (wie »pbuilder«). Benutzen Sie die Option "--simulate", um die kombinierten Konfigurationseinstellungen zu sehen.

Falls jedoch die Konfigurationsdatei selbst nicht ausgewertet werden kann, wird Multistrap abgebrochen. Prüfen Sie, ob die Konfigurationsdatei in jeder Zeile außer in Kommentaren einen Schlüssel und einen Wert hat. Alle Werte müssen in der gleichen Zeile wie ihr Schlüssel stehen.

Abschnittseinstellungen

 [Debian]
 packages=
 source=http://ftp.uk.debian.org/debian
 keyring=debian-archive-keyring
 suite=jessie

Der Abschnittsname (in »[]«-Klammern) muss in dieser Konfigurationsdatei und in allen Konfigurationsdateien, die in dieser enthalten sind, einmalig sein. Abschnittsnamen sind nicht von Groß- und Kleinschreibung abhängig (alle Vergleiche finden nach der Umwandlung in Kleinschreibung statt).

»packages« ist die Liste der Pakete, die hinzugefügt werden, wenn dieser Abschnitt in "Bootstrap" aufgelistet ist – alle Paketnamen müssen in einer einzigen Zeile aufgeführt sein, sonst scheitert die Auswertung der Datei. Alternativ können Sie Ihre Paketliste in Form mehrerer Gruppen mit Paketen, die auf funktionaler Basis oder Abhängigkeitsbasis unterteilt werden, definieren z.B. base, Xorg, networking etc. und jede Gruppe unter »bootstrap« aufführen.

 bootstrap=base networking
 [base]
 packages=udev mtd-utils
 source=http://http.debian.net/debian
 keyring=debian-archive-keyring
 suite=jessie
 [networking]
 packages=netbase ifupdown iproute net-tools samba
 source=http://http.debian.net/debian
 keyring=debian-archive-keyring
 suite=jessie

Als Sonderfall unterstützt "Multistrap" auch Paketschlüssel pro Abschnitt, einen je Zeile. Andere Schlüssel können nicht auf diese Art wiederholt werden.

 [Emdebian]
 packages=udev mtd-utils netbase ifupdown iproute
 packages=busybox net-tools samba
 source=http://http.debian.net/debian
 keyring=debian-archive-keyring
 suite=jessie

»source« ist die APT-Quelle, die für diesen Abschnitt benutzt wird. Um eine lokale Quelle auf der gleichen Maschine zu benutzen, stellen Sie sicher, dass Sie "copy://" und nicht "file://" benutzen, so dass Apt mitgeteilt wird, dass die Pakete in das Wurzel-Dateisystem kopiert werden müssen, anstatt davon auszugehen, dass sie später herunterladen werden müssen – weil dieses »später« tatsächlich nie stattfinden wird.

»keyring« listet die Pakete auf, die den Schlüssel enthalten, die von den Quellen in diesem Abschnitt benutzt werden. Falls »keyring« nicht angegeben ist, muss die Option "noauth" auf »true« gesetzt sein. Siehe »Secure-Apt«.

»suite« ist die Suite, die von dieser Quelle benutzt wird. Beachten Sie, dass dies die Suite sein sollte, nicht der Codename.

Suites change from time to time: (oldstable, stable, testing, sid) The codename (squeeze, wheezy, jessie, sid) does not change.

Secure-Apt

Um authentifizierte Apt-Depots zu benutzen, muss Multistrap entweder in der Lage sein, ein geeignetes »keyring«-Paket aus den existierenden Apt-Quellen außerhalb der Multistrap-Umgebung in das Zielsystem zu installieren. Leider können keyring«-Pakete nicht aus den in der Multistrap-Konfiguration angegebenen Depots heruntergeladen werden – dies rührt daher, dass "Apt" den »keyring« zur Aktualisierung benötigt bevor Depots benutzt werden können, die vorher unbekannt waren.

Falls relevante Pakete existieren, geben Sie diese in der »keyring«-Option für jedes Depot an. Multistrap wird dann prüfen, ob Apt dieses Paket bereits installiert hat, so dass das Depot authentifiziert wird, bevor Pakete daraus heruntergeladen werden.

Beachten Sie, dass alle Depots, die mit Multistrap benutzt werden, authentifiziert sein müssen, sonst schlägt Apt fehl. Gleichermaßen kann Apt-Secure nur für alle Depots ausgeschaltet werden (durch Benutzen der Befehlszeilenoption --no-auth oder Setzen der Option »noauth« unter [General] in der Konfigurationsdatei), auch wenn nur ein Depot über keinen geeigneten »keyring« verfügt.

Die »keyring«-Pakete werden außerdem innerhalb der Multistrap-Umgebung installiert, um für die installierten Apt-Quellen für Multistrap passend zu sein.

Status

Multistrap ist zustandslos – falls das Verzeichnis existiert, wird es einfach normal weitermachen und Apt wird nicht versuchen fortzufahren, wo es aufgehört hat.

Konfiguration des Wurzel-Dateisystems

Multistrap entpackt die heruntergeladenen Pakete, aber andere Stufen der Systemkonfiguration werden nicht durchgeführt. Enthaltene Beispiele:

 /etc/inittab
 /etc/fstab
 /etc/hosts
 /etc/securetty
 /etc/modules
 /etc/hostname
 /etc/network/interfaces
 /etc/init.d
 /etc/dhcp3

Jegliche gerätespezifischen Geräteknoten müssen außerdem unter Benutzung von MAKEDEV oder "device-table.pl" erstellt werden – einem Hilfsskript, das mit MAKEDEV-Problemen umgehen kann. device-table.pl benötigt eine Gerätetabellendatei nach dem Vorbild derjenigen im Quellpaket »mtd-utils«. Siehe /usr/share/doc/multistrap/examples/device_table.txt

Sobald Multistrap die das grundsätzliche Datei- und das Verzeichnislayout erfolgreich erstellt hat, werden andere gerätespezifische Skripte benötigt, bevor das Dateisystem entpackt und auf dem Zielgerät installiert werden kann.

Sobald sie installiert sind, müssen die Pakete selbst unter Benutzung der Paketbetreuerskripte und "dpkg --configure -a" konfiguriert werden, außer wenn dies ein nativer Multistrap ist.

Damit "Dpkg" funktioniert, müssen /proc und /sysfs eingehängt (oder einhängbar) sein, /dev/pts wird ebenfalls empfohlen.

Siehe auch: http://wiki.debian.org/Multistrap

Umgebung

Um die entpackten Pakete (ob im nativen oder Kreuzmodus) zu konfigurieren, werden bestimmte Umgebungsvariablen benötigt:

Debconf muss mitgeteilt werden, dass eine Interaktion mit dem Benutzer nicht erwünscht ist:

 DEBIAN_FRONTEND=noninteractive DEBCONF_NONINTERACTIVE_SEEN=true

Perl muss mitgeteilt werden, dass es ohne Beschwerde akzeptieren soll, dass innerhalb der Chroot keine Locales verfügbar sind.

 LC_ALL=C LANGUAGE=C LANG=C

Dann können die Pakete von Dpkg konfiguriert werden:

Chroot-Methode (PFAD = Oberstes Verzeichnis der Chroot):

 DEBIAN_FRONTEND=noninteractive DEBCONF_NONINTERACTIVE_SEEN=true \
 LC_ALL=C LANGUAGE=C LANG=C chroot /PATH/ dpkg --configure -a

in einer Anmelde-Shell:

 # export DEBIAN_FRONTEND=noninteractive DEBCONF_NONINTERACTIVE_SEEN=true
 # export LC_ALL=C LANGUAGE=C LANG=C 
 # dpkg --configure -a

(Wie oben bereits erwähnt erfordert Dpkg, dass /proc und /sysfs zuerst eingehängt werden.)

Nativer Modus – Multistrap

Multistrap war nicht für native Unterstützung gedacht, es wurde entwickelt für Unterstützung über Architekturgrenzen hinweg. Um mehrere Depots benutzen zu können, entpackt Multistrap lediglich die von Apt ausgewählten Pakete.

Im nativen Modus werden wahrscheinlich verschiedene Operationen benötigt, die Multistrap vorausgehen müssen; dies würde Debootstrap alles für Sie erledigen:

 1. Kopieren von /etc/hosts in den Chroot
 2. Bereinigen der Umgebung, so dass LANGUAGE, LC_ALL und LANG geleert
    werden, um störende Perl-Warnungen unterdrücken, die andere Fehler
    verschleiern könnten.

(Eine Alternative zum Leeren der Lokalisierungsvariablen ist es, Locales zu Ihrer Multistrap-Konfigurationsdatei in der »packages«-Option hinzuzufügen.

Ein natives Multistrap kann direkt mit Chroot benutzt werden, so dass "Multistrap" am Ende des Multistrap-Prozesses "dpkg --configure -a" ausführt, falls die Option ignorenativearch nicht im Abschnitt General der Konfigurationsdatei auf »true« gesetzt ist.

Daemons in Chroots

Abhängig davon, welches System Sie benutzen, um Pakete für "Multistrap" bereitzustellen, sollten native Chroots Daemons nicht erlauben innerhalb des Chroots zu starten. Benutzen Sie als Ihr "Einrichtungsskript" /usr/share/multistrap/chroot.sh oder fügen Sie dieses Skript in Ihr eigenes Einrichtungsskript ein.

 setupscript=/usr/share/multistrap/chroot.sh

chroot.sh meistert Systeme, die sysvinit and upstart benutzen.

Siehe auch

 http://people.debian.org/~hmh/invokerc.d-policyrc.d-specification.txt

Stufenförmige Konfiguration

Damit Multistrap mehrere Varianten der (üblichen) Basiskonfiguration unterstützt, erlauben es die Konfigurationsdateien von "Multistrap", andere (allgemeinere) Konfigurationsdateien einzuschließen, z.B. wird die ausführlichere/speziellere Konfigurationsdatei auf der Befehlszeile angegeben und diese Datei enthält eine andere Datei, die sie sich mit anderen Konfigurationen teilt.

Basisdatei:

 /usr/share/multistrap/crosschroot.conf

Variationen:

 /usr/share/multistrap/armel.conf

Wenn Sie nur die Datei »armel.conf« angeben, wird der Rest der Einstellungen von »crosschroot.conf« abgefragt, so dass übliche Änderungen nur in einer einzelnen Datei vorgenommen werden müssen.

Es wird dringend empfohlen, dass jegliche Änderungen an den beteiligten Konfigurationsdateien in jeder Stufe mit der Option "--simulate" für Multistrap getestet werden, was eine Zusammenfassung der Optionen ausgibt, die gesetzt werden, wenn die Kaskade komplett ist. Beachten Sie, dass Multistrap Sie nicht warnt, falls eine Konfigurationsdatei eine unbekannte Option enthält (für zukünftige Konfigurationen mit Backport-Konfigurationen), so dass ein einfacher Tippfehler dazu führen kann, dass Optionen nicht gesetzt werden.

»Machine:variant«-Unterstützung

Die alten »packages.conf«-Variablen von Emsandbox können alle in Multistrap-Konfigurationsvariablen umgewandelt werden. Die »Machine:variant«-Unterstützung in "Multistrap" konzentriert sich auf die Skripte config.sh und setup.sh

Anmerkung: Die Unterstützung für »machine:variant« wird wahrscheinlich durch die nachfolgend beschriebene Hook-Funktionalität ersetzt

Sobald "Multistrap" die heruntergeladenen Pakete entpackt hat, kann "setup.sh" unter der Angabe des Ortes und der Architektur aufgerufen werden, so dass andere Feineinstellungen ihren Platz einnehmen können. In diesem Schritt dürfen keine Operationen innerhalb des Wurzeldateisystems einer fremden Architektur versuchen, irgendwelche Programme innerhalb des Wurzeldateisystems auszuführen. Als letzter Schritt des Multistrap-Prozesses wird "config.sh" in das Wurzelverzeichnis des Wurzeldateisystems kopiert.

Ein Vorteil bei der Benutzung der »Machine:variant«-Unterstützung ist es, dass das vollständige Wurzeldateisystem mit einem einzigen Aufruf von Multistrap verwaltet werden kann – dies ist nützlich, wenn Wurzeldateisysteme im Bereich des Anwenders (»Userspace«) erstellt werden.

Um »Machine:variant«-Unterstützung zu aktivieren, geben Sie den Pfad zu den Skripten, die ausgeführt werden sollen, in der Variant-Konfigurationsdatei (Abschnitt »General«) an:

 [General]
 include=/path/to/general.conf
 setupscript=/path/to/setup.sh
 configscript=/path/to/config.sh

Ensure that both the setupscript and the configscript are executable or "multistrap" will ignore the script.

Example configscript.sh

 #!/bin/sh
 
 set -e
 
 export DEBIAN_FRONTEND=noninteractive DEBCONF_NONINTERACTIVE_SEEN=true
 export LC_ALL=C LANGUAGE=C LANG=C
 /var/lib/dpkg/info/dash.preinst install
 dpkg --configure -a
 mount proc -t proc /proc
 dpkg --configure -a
 umount /proc

For more information, see the Wiki: http://wiki.debian.org/Multistrap

Mounting /dev and /proc for chroot configuration

/proc can be mounted inside the chroot, as above:

 mount proc -t proc /proc

However, /dev should be mounted from outside the chroot, before running any "configscript.sh" in the chroot:

 cd /path/chroot/
 sudo tar -xzf /path/multistrap.tgz
 sudo mount /dev -o bind ./dev/
 sudo chroot . ./configscript.sh || true

Paketauswahl einschränken

"Multistrap" schließt standardmäßig benötigte Pakete ein, die aktuelle Liste der Pakete auf Ihrer eigenen Maschine kann angesehen werden unter Benutzung von:

 grep-available  -FPriority 'required' -sPackage

(Die aktuelle Liste wird aus der heruntergeladenen Datei Packages berechnet und kann sich von der Ausgabe von "grep-available" unterscheiden.)

Falls die Option OmitRequired auf »true« gesetzt ist, werden diese Pakete nicht hinzugefügt – obwohl diese Option nützlich ist, kann sie zu einem unbrauchbaren Wurzeldateisystem führen. Nur manuell in den Konfigurationsdateien angegebenen Pakete werden in den Berechnungen benutzt – Abhängigkeiten dieser Pakete werden hinzugefügt, aber keine anderen.

Pakete mit »Priority: important« hinzufügen

"Multistrap" kann "Debootstrap" imitieren, indem es automatisch alle Pakete aus allen Abschnitten hinzufügt, bei denen die heruntergeladene Datei Packages das Paket mit »Priority: important« auflistet. Standardmäßig werden solche Pakete nicht hinzugefügt, sofern sie nicht einzeln in einer "packages="-Option eingefügt werden, die in einem angegebenen Abschnitt in der "Bootstrap"-Option [General] angegeben ist. Um all diese Pakete hinzuzufügen, setzen Sie die Option »addimportant« im Abschnitt [General] auf »true«.

 addimportant=true

»Priority: important« kann nur für alle Abschnitte funktionieren, die in der Option "bootstrap" aufgelistet sind. Dies kann Verwirrung stiften, wenn Suites gemixt werden.

Es ist nicht möglich »addimportant« und »omitrequired« in der gleichen Konfiguration einzuschalten. "Multistrap" wird mit Fehlercode 7 beendet, falls sowohl irgendwelche Konfigurationsergebnisse in »addimportant« als auch in »omitrequired« auf »true« gesetzt sind. (Dies beinhaltet die Auswirkungen vom Einschluß anderer Konfigurationsdateien.)

Empfohlenes Verhalten

Das Debian-Standardverhalten nach der Veröffentlichung von Lenny war es, empfohlene Pakete als zusätzliche Pakete zu berücksichtigen, die installiert werden, wenn irgendein Paket ausgewählt ist. Empfohlene Pakete sind solche, von denen der Paketbetreuer annimmt, dass dieses Paket auf den "meisten" Installationen vorhanden wäre und erlauben von Empfehlungen bedeutet erlaubte Empfehlungen empfohlener Pakete usw.

Standardmäßig sind Empfehlungen in Multistrap AUSgeschaltet.

Setzen Sie die Option »allowrecommends« ist im Abschnitt »General« »true«, um typisches Debian-Verhalten zu bekommen.

Standardveröffentlichung

"multistrap" supports an option to explicitly set the default release to use with apt: "aptdefaultrelease". This determines which release apt will use for the base system packages and is not the same as pinning (which relates to the use of apt after installation). Multistrap sets the default-release to the wildcard * unless a release is named in the "aptdefaultrelease" field. Any release specified here must also be defined in a stanza referenced in the bootstrap list or apt will fail.

To install a specific version of a package from a newer release than the one specified as default, "explicitsuite" must also be set to true if the package exists at any version in the default release. Also, any packages upon which that package has a strict dependency (i.e. = rather than >=) must also be explicitly added to the packages line in the stanza for the desired version, even though that package does not need to be listed to get it from the default release. This is typical apt behaviour and is not a bug in multistrap.

The combination of default release, explicit suite and apt preferences can quickly become complex and bugs can be very hard to identify. "multistrap" always outputs the complete apt command line, so test this command yourself (using the files written out by "multistrap") to see what is going on. Remember that all dependency resolution and all the logic to determine which version of a specific package gets installed in your "multistrap" chroot is entirely down to apt and all "multistrap" can do is pass files and command line options to apt.

See also: apt preferences.

Explizite Angabe der Suite

Manchmal soll Apt mitgeteilt werden, dass ein bestimmtes Paket aus einer bestimmten Suite empfangen werden soll, während dabei eine aktuellere Version in einer anderen Suite derselben Quellenzusammenstellung ignoriert wird.

"Multistrap" kann mit oder ohne expliziter Suite-Option arbeiten, standardmäßig wird Apt die aktuellste Version aus der Sammlung angegebener Bootstrap-Quellen benutzen.

Die explizite Angabe der Suite hat keine Auswirkung auf das fertig installierte System – falls Ihre »aptsources« ein Depot enthalten, das wiederum eine neuere Version des/der angegebenen Paket(s) explizit enthält, wird das nächste "apt-get upgrade" auf dem Gerät zu einer neueren Version führen.

Außerdem wird Apt, wenn Pakete von einer speziellen Suite angegeben sind, auch versuchen und sicherstellen, dass die Abhängigkeiten für dieses Paket von der gleichen Suite stammen und dies kann der Grund sein, dass die Abhängigkeiten für dieses Paket von der gleichen Suite stammen; dies kann jedoch auch der Grund sein, warum apt nicht die komplette Zusammenstellung von Abhängigkeiten auflösen kann. In einer solchen Situation könnte es erforderlich sein, wenn Sie explizit ein Paket auswählen, dass Sie auch bei den abhängigen Paketen (nicht notwendigerweise allen) eine explizite Auswahl treffen müssen.

Wenn Sie »explicitsuite« benutzen, müssen Sie beim Gebrauch von »stable-proposed-updates« oder anderen temporären Orten achtsam sein – falls das Paket in eine andere Suite migriert und aus der temporären Suite entfernt wird (wie mit *-proposed-updates), wird Multistrap das Paket nicht mehr finden.

Es kann sehr schwierig sein, die explizite Behandlung der Suite richtig hinzukriegen. Im Allgemeinen ist es das Beste, eine kleine Bootstrap-Chroot Ihrer ursprünglichen Architektur zu erstellen, dann ein Chroot dort hinein vorzunehmen, die nötigen APT-Quellen hinzuzufügen und herauszufinden, welche Befehle nötig sind, um den korrekten Mix von Programmen zu bekommen. Vermeiden Sie die explizite Angabe von Versionen, um Probleme aus der Welt zu schaffen, die nur mit Suites funktionieren. Hier könnten APT-Preferences und Pinning nützlich sein, siehe APT-Preferences.

APT-Preferences

Falls eine geeignete Datei in der Option aptpreferences des Abschnitts General in der Konfigurationsdatei aufgeführt ist, wird diese Datei vor der ersten Verwendung in das APT-Preferences-Verzeichnis des Bootstraps kopiert.

Wenn eine APT-Preferences-Datei bereitgestellt ist, wird das "Vorgabeveröffentlichungs"verhalten von "multistrap" deaktiviert.

Wie auch bei anderen externen Skripten und Dateien liegt der Inhalt der APT-References-Datei jenseits des Geltungsbereichs dieser Handbuchseite. "Multistrap" versucht nicht, die bereitgestellte Datei zu überprüfen, außer, das esnsicherstellt, dass sie gelesen werden kann.

»deb-src«-Auflistungen werden ausgelassen

Einige Multistrap-Umgebungen benötigen keinen Zugriff auf die Debian-Quellen installierter Pakete, normalerweise ist dies nötig, wenn die Erstellung (oder Kreuzerstellung »cross build«) eines Chroot unter Benutzung von Multistrap vorbereitet wird.

Um diese zusätzliche Quelle auszuschalten (und sowohl Zeit zum Herunterladen als auch »Apt-Cache«-Größe zu sparen), benutzen Sie das Feld »omitdebsrc« in jedem Abschnitt.

 [Baked]
 packages=
 source=http://www.emdebian.org/baked
 keyring=emdebian-archive-keyring
 suite=testing
 omitdebsrc=true

»omitdebsrc« ist nötig, wenn Pakete von Debian-Portierungen benutzt werden, bei denen Pakete keine Quellen außer »unreleased« haben.

fakeroot

Bootstraps für fremde Architekturen können unter "Fakeroot" arbeiten ("Multistrap" wurde entworfen, um soviel wie möglich in einem einzigen Aufruf zu erledigen, um dies einfacher zu machen), aber die bei einem nativen Architektur-Bootstrap verwendete Konfigurationsstufe erfordert "Chroot", und "Chroot" seinerseits funktioniert nicht unter "Fakeroot".

Daher wird die Konfiguration im nativen Modus mit einer Warnmeldung übersprungen, falls "Multistrap" feststellt, dass "Fakeroot" gerade benutzt wird.

Das gleiche Problem betrifft "apt-get install" und daher wird die Installation des Pakets »keyring« auf dem Host-System ebenfalls übersprungen, falls Fakeroot erkannt wird.

Handhabung problematischer Pakete

Manchmal schlägt sogar das korrekte Entpacken eines bestimmten Paketes fehl, falls ein anderes Paket nicht bereits entpackt wurde. Dies kann vorkommen, falls Dpkg-Umlenkungen nicht korrekt eingerichtet sind oder wenn das Paket vorher von einer ausführbaren Datei in einem anderen Paket abhängt.

Multistrap bietet zwei Möglichkeiten diese Probleme zu handhaben. Ein Paket kann als "reinstall" oder "additional" aufgeführt werden. Jeder Abschnitt in der Konfigurationsdatei von "Multistrap" kann eine einzelne "reinstall"- oder "additional"-Auflistung haben oder beide.

»reinstall« bedeutet, dass das Paket wie üblich heruntergeladen und entpackt wird – zusammen mit allen anderen Paketen, aber es wird dann am Ende durch Ausführen des Betreuerskripts "preinst" mit dem Argument "upgrade" neu installiert. "Dpkg" wird dann mit dem Rest der Konfiguration des Pakets fortfahren.

»Additional« fügt dem Multistrap-Prozess eine zweite Runde von "apt-get install" hinzu – nach dem Entpacken am Anfang. Das zusätzliche Paket wird dann heruntergeladen und entpackt. Falls es im ursprünglichen Zustand ausgeführt wird, wird das zusätzliche Paket heruntergeladen, entpackt und konfiguriert, nachdem alle anderen Pakete heruntergeladen, entpackt und konfiguriert wurden.

Weder "reinstall" noch "additional" sollten als mehr als nur Notlösungen betrachtet werden und es sollten in Debian »wishlist«-Fehler an Pakete gesandt werden, die diesen Mechanismus nutzen (oder die Pakete, die das spezielle Paket am normalen Funktionieren hindern würden).

Debconf-Voreinstellungen

Das Hinzufügen einer Debconf-Voreinstellung kann bei der Konfiguration von Paketen für eine bestimmte Einstellung an Stelle der Paketvorgaben helfen, wenn die Konfiguration nicht interaktiv abläuft. Informationen wie Voreinstellungsdateien erstellt werden, finden Sie unter http://www.debian-administration.org/articles/394.

Sie können mehrere Voreinstellungsdateien über das Feld »debconfseed« im Abschnitt [General], getrennt durch Leerzeichen angeben:

 debconfseed=seed1 seed2

Files which do not exist or which cannot be opened will be silently ignored. Check the results of the parsing using the "--simulate" option to "multistrap". The preseeding files will be copied to a preseed directory in /tmp inside the rootfs.

To use the preseeding, add a section to the configscript.sh, prior to any calls to dpkg --configure -a. e.g. :

 #!/bin/sh
 
 set -e
 
 export DEBIAN_FRONTEND=noninteractive DEBCONF_NONINTERACTIVE_SEEN=true
 export LC_ALL=C LANGUAGE=C LANG=C
 if [ -d /tmp/preseeds/ ]; then
    for file in `ls -1 /tmp/preseeds/*`; do
    debconf-set-selections $file
    done
 fi
 dpkg --configure -a

Hooks

If a hook directory (hookdir=) is specified in the General section of the "multistrap" configuration file, the hook scripts which are executable will be run from outside the multistrap directory at the following stages:

Download-Hooks

wird vor dem Entpacken durchgeführt, sofort nachdem die Pakete heruntergeladen wurden. Download-Hooks sind ausführbare Skripte im angegebenen Hook-Verzeichnis, deren Dateiname mit download beginnt.

native hooks

Native Hook-Skripte werden nur im nativen Modus ausgeführt, unmittelbar bevor die Konfiguration der heruntergeladenen Pakete beginnt und erneut nach der Fertigstellung der Paket-Konfiguration. Native Hooks werden den absoluten Pfad, den derzeitigen Prozessstatus, Start oder Ende abfragen.

Native Skripte sind ausführbare Skripte im angegebenen Hook-Verzeichnis, deren Dateiname mit native beginnt.

Completion-Hooks

werden unmittelbar vor der Erstellung des Tarballs ausgeführt oder wenn "Multistrap" beendet wird, falls die Erstellung keines Tarballs konfiguriert wurde.

Completion scripts are executable scripts in the specified hook directory with a filename beginning with completion.

Hooks wird der absolute Pfad zum Verzeichnis übergeben, das das Wurzelverzeichnis des Chroot oder Multistrap-Systems sein wird. Hooks, die nicht mittels Realpath aufgelöst werden können oder die nicht ausführbar sind, werden ignoriert.

Alle Hooks eines Typs werden vor dem Ausführen alphabetisch sortiert.

Beachten Sie, dass "Multistrap" im Fehlerfall die Auswirkungen von Hooks nicht ungeschehen machen kann. "Multistrap" wird jedoch die angesammelten Fehler als Warnungen ausgeben. Falls ein Hook mit einem Fehlercode ungleich Null beendet wird, wird der Exit-Wert in eine positive Zahl umgewandelt, zur Anzahl der gesamten Warnungen hinzuaddiert und am Ende der Operation ausgegeben.

Ausgabe

"Multistrap" kann viele Ausgaben erzeugen – informative Nachrichten erscheinen auf der Standardausgabe, Fehler und Warnungen auf der Standardfehlerausgabe. Aufrufe von "Apt" und "Dpkg" folgen dem gleichen Muster, daher ist es einfach, falls gewünscht, die kombinierte Ausgabe von "Multistrap" auf reine Fehler zu kürzen.

"Multistrap" sammelt Fehlerstati von nicht fatalen Prozessen innerhalb der Operation und gibt diese Warnungen sowohl auf der Standardfehlerausgabe als auch am Ende als kumulierte Fehleranzahl aus. Dies schließt Hooks ein, die Exit-Werte ungleich Null ausgeben.

Fehler

Da "Multistrap" immer komplexer wird, werden sich Fehler in das Paket einschleichen. Bitte berichten Sie alle Fehler mit der Werkzeug "Reportbug" an die Debian-Fehlerdatenbank. Hängen Sie bitte alle Konfigurationsdateien an. Falls Ihre Konfiguration Zugriff auf lokale oder private Apt-Depots erfordert, überprüfen Sie Ihre Konfiguration mit der letzten Version von "Multistrap" in Debian. Benutzen Sie die Option "--simulate" und fügen Sie deren Bericht in Ihren Fehlerbericht ein.

Die Ausgabe der Option "--simulate" wird regelmäßig expandiert, um Anwendern bei der Fehlersuche in Konfigurationsdateien zu helfen.

Bitte prüfen (und aktualisieren) Sie das Multistrap-Wiki unter http://wiki.debian.org/Multistrap und den Inhalt der Web-Seite unter http://www.emdebian.org/multistrap/ bevor Sie Fehlerberichte einreichen. Außerdem können mehrere Leute auf der Mailingliste [email protected] und dem IRC-Kanal #emdebian auf irc.oftc.net helfen, falls Ihre Konfigurationsdatei nicht korrekt ausgewertet wird. Würden Sie die Ausgabe von "--simulate" auf eine Pastebin-Website ablegen und in Ihrer Nachricht die URL angeben.

Multiarch-Unterstützung

Multiarch-Unterstützung ist experimentell – bitte melden Sie Probleme und Dateifehler mit vollständigen Einzelheiten Ihrer Einrichtung, der vollständigen Konfigurationsdatei und gemeldeten Fehlern.

"Multistrap" setzt die existierende Multiarch-Unterstützung des externen Systems außer Kraft, so dass ein System, das Multiarch kennt, immer noch eine Nicht-Multiarch-Chroot aus Depots erstellen kann, die nicht alle durch das externe Dpkg unterstützten Architekturen unterstützen.

Falls Multiarch innerhalb der Multiarch-Chroot aktiviert ist, fertigt "Multistrap" die Liste in /var/lib/dpkg/arch innerhalb der Chroot aus.

Geben Sie die Option für mehrere Architekturen einmal an und benutzen Sie eine durch Kommas getrennte Liste für die Architekturen. Stellen Sie sicher, dass Sie diejenige einbeziehen, die die Host-Architektur der Chroot sein wird.

Siehe auch: http://wiki.debian.org/Multiarch/

 [General]
 ...
 multiarch=i386 armel armhf

Jeder Abschnitt wird Pakete von der Basisarchitektur installieren, es sei denn, für spezielle Abschnitte ist die Option "Architecture" angegeben.

 [Foreign]
 packages=libgcc1 libc6
 architecture=armel
 source=http://ftp.uk.debian.org/debian
 keyring=debian-archive-keyring
 suite=sid

In der Ausgabe von "--simulate" werden die in der Option MultiArch angegebenen Architekturen unter der Auflistung »Fremde Architekturen« aufgeführt. Pakete für eine besondere Architektur werden als der Paketname, gefolgt von einem Doppelpunkt, gefolgt von der Architektur aufgelistet.

 libgcc1:armel libc6:armel