other versions
- wheezy 2.12.6+deb7u2
- wheezy-backports 2.14.11~bpo70+1
- jessie 2.15.3+deb8u1
- jessie-backports 2.17.5~bpo8+1
- testing 2.17.6
- unstable 2.17.6
COWPOKE(1) | General Commands Manual | COWPOKE(1) |
BEZEICHNUNG¶
cowpoke - baut ein Debian-Quellpaket in einer fernen Cowbuilder-InstanzÜBERSICHT¶
cowpoke [Optionen] Paketname.dscBESCHREIBUNG¶
lädt ein Debian-Quellpaket auf einen cowbuilder-Rechner hoch und baut es, wahlweise signiert es außerdem das Ergebnis und lädt es in eine »incoming«-Warteschlange hoch.OPTIONEN¶
Die folgenden Optionen sind verfügbar:- --arch=Architektur
- gibt die Debian-Architektur(en) an, für die gebaut
wird. Es kann eine durch Leerzeichen getrennte Liste von Architekturen
benutzt werden, um für alle in einem einzigen Durchgang zu bauen.
Gültige Architekturnamen sind jene, die durch
dpkg-architecture(1) für DEB_BUILD_ARCH
zurückgegeben werden.
- --dist=Distribution
- gibt die Debian-Distribution(en) an, für die gebaut
wird. Es kann eine durch Leerzeichen getrennte Liste von Distributionen
benutzt werden, um für alle in einem einzigen Durchgang zu bauen. Es
können entweder Codenamen (wie sid oder squeeze) oder
Distributionsnamen (wie unstable oder experimental)
verwendet werden, aber Sie sollten üblicherweise durchgehend dabei
bleiben, den einen oder anderen zu benutzen, da dieser Name in Dateipfaden
benutzt wird und um alte Pakete für Vergleichsberichte zu orten.
- --buildd=Rechner
- gibt den fernen Rechner an, auf dem gebaut werden soll.
- --buildd-user=Name
- gibt den fernen Benutzernamen an, unter dem gebaut wird.
- --create
- erstellt das ferne cowbuilder-Wurzelverzeichnis,
falls es noch nicht existiert. Falls diese Option nicht übergeben
wird, ist es für die angegebene --dist oder --arch ein
Fehler, über kein existierendes cowbuilder-Wurzelverzeichnis
an der erwarteten Stelle zu verfügen.
- --return=[Pfad
- kopiert Ergebnisse des Bauens nach Pfad. Falls
Pfad nicht angegeben wurde, dann werden sie an das aktuelle
Verzeichnis zurückgegeben. Der angegebene Pfad muss existieren, er
wird nicht erstellt.
- --no-return
- kopiert Ergebnisse des Bauens nicht nach RETURN_DIR
(setzt eine Pfadeinstellung hierfür in den Konfigurationsdateien
außer Kraft).
- --dpkg-opts='Option1 Option2 …'
- gibt zusätzliche Optionen an, die an
dpkg-buildpackage(1) übergeben werden. Mehrere Optionen werden
durch Leerzeichen getrennt. Dies wird alle in DEBBUILDOPTS
angegebenen Optionen in der pbuilderrc des Baurechners außer
Kraft setzen.
- --create-opts='Cowbuilder-Option'
- gibt zusätzliche Argumente an, die unverändert an
Cowbuilder weitergereicht werden, wenn eine Chroot zum ersten Mal
(mittels der obigen Option --create) erstellt wird. Falls mehrere
Optionen weitergereicht werden müssen, sollte diese Option separat
für jede einzelne angegeben werden.
- --update-opts='Cowbuilder-Option'
- gibt zusätzliche Argumente an, die unverändert an
Cowbuilder weitergereicht werden, wenn die Chroot aktualisiert
wird. Falls mehrere Optionen weitergereicht werden müssen, sollte
diese Option separat für jede einzelne angegeben werden.
- --build-opts='Cowbuilder-Option'
- gibt zusätzliche Argumente an, die unverändert an
Cowbuilder weitergereicht werden, wenn ein Paket gebaut wird. Falls
mehrere Optionen weitergereicht werden müssen, sollte diese Option
separat für jede einzelne angegeben werden.
- --sign=Schlüsselkennung
- Specify the key to sign packages with. This will override
any SIGN_KEYID specified for a chroot in the cowpoke configuration
files.
- --upload=queue
- Specify the dput queue to upload signed packages to. This
will override any UPLOAD_QUEUE specified for a chroot in the
cowpoke configuration files.
- --help
- zeigt eine kurze Zusammenfassung der verfügbaren
Optionen und der aktuellen Konfiguration.
- --version
- zeigt die aktuelle Versionsinformation.
KONFIGURATIONSOPTIONEN¶
Wenn cowpoke ausgeführt wird, werden die folgenden Optionen von globalen, benutzer- und objektbezogenen Konfigurationsdateien gelesen, falls vorhanden. Dateipfade können absolut oder relativ sein, letztere sind zum BUILDD_USER-Home-Verzeichnis relativ. Da die Pfade bei der Benutzung typischerweise in Anführungszeichen stehen, wird darauf keine Tilde-Expandierung durchgeführt.Globale Vorgaben¶
Dies gilt für jede Architektur und Distribution in einem einzelnen Cowpoke-Aufruf.- BUILDD_HOST
- die Netzwerkadresse oder FQDN der Baumaschine auf der cowbuilder konfiguriert ist. Dies könnte durch die Befehlszeilenoption --buildd außer Kraft gesetzt werden.
- BUILDD_USER
- der nicht privilegierte Benutzername für Operationen auf der Baumaschine. Dies ist standardmäßig der lokale Name des Benutzers, der cowpoke ausführt (oder ein Benutzername, der in der SSH-Konfiguration für BUILDD_HOST angegeben wurd), und kann durch die Befehlszeilenoption --buildd-user außer Kraft gesetzt werden.
- BUILDD_ARCH
- die Debian-Architektur(en), für die gebaut wird. Dies muss zu DEB_BUILD_ARCH der benutzten Bau-Chroot passen. Standardmäßig ist es die Architektur des lokalen Rechners, auf der cowpoke ausgeführt wird. Sie könnte durch die Befehlszeilenoption --arch außer Kraft gesetzt werden. Hier könnte eine durch Kommas getrennte Liste (in Anführungszeichen) verwendet werden, um um für alle hieraus in einem einzigen Durchgang zu bauen.
- BUILDD_DIST
- die Debian-Distribution(en), für die gebaut wird. Eine
durch Leerzeichen getrennte Liste von Distributionen (in
Anführungszeichen) kann benutzt werden, um alle in einem einzigen
Durchgang zu bauen. Dies könnte durch die Befehlszeilenoption
--dist außer Kraft gesetzt werden.
- INCOMING_DIR
- der Installationspfad auf der Baumaschine, in der das Quellpaket anfangs platziert wird. Dies muss durch den BUILDD_USER schreibbar sein.
- PBUILDER_BASE
- die Wurzel des Dateisystems für alle Pbuilder-COW- und
Ergebnisdateien. Architektur- und distributionsspezifische
Unterverzeichnisse werden normalerweise darunter erstellt. Der
APT-Zwischenspeicher und die temporären Bauverzeichnisse werden
ebenso unterhalb dieses Pfads liegen.
- SIGN_KEYID
- If this option is set, it is expected to contain the gpg
key ID to pass to debsign(1) if the packages are to be remotely
signed. You will be prompted to confirm whether you wish to sign the
packages after all builds are complete. If this option is unset or an
empty string, no attempt to sign packages will be made. It may be
overridden on an arch and dist specific basis using the
arch _dist_SIGN_KEYID option described below,
or per-invocation with the --sign command line option.
- UPLOAD_QUEUE
- If this option is set, it is expected to contain a 'host'
specification for dput(1) which will be used to upload them after
they are signed. You will be prompted to confirm whether you wish to
upload the packages after they are signed. If this option is unset or an
empty string, no attempt to upload packages will be made. If
SIGN_KEYID is not set, this option will be ignored entirely. It may
be overridden on an arch and dist specific basis using the
arch_dist_UPLOAD_QUEUE option described below,
or per-invocation with the --upload command line option.
- BUILDD_ROOTCMD
- der Befehl, der zum Erlangen von Root-Rechten auf der fernen Baumaschine benutzt wird. Falls nicht gesetzt, ist die Vorgabe sudo(8). Dies ist nur nötig, um cowbuilder aufzurufen und ihm zu erlauben, in seine Chroot zu gelangen, daher könnten Sie diesen Nutzer darauf beschränken, diesen Befehl mit ausgeweiteten Rechten auszuführen. Ein Eintrag wie der folgende in »sudoers« wird es ermöglichen, cowbuilder ohne einen zusätzlich nötigen Passworteintrag aufzurufen:
Ihrbenutzer ALL = NOPASSWD:
/usr/sbin/cowbuilder
- Alternativ könnten Sie SSH mit einem weitergeleiteten
Schlüssel oder irgendeinem anderen Mechanismus, der Ihrer lokalen
Zugriffsrichtlinie entspricht, verwenden. Die Benutzung von su -c
ist hier nicht wirklich passend, da seine Maskierungsanforderungen sich
etwas vom Rest unterscheiden.
- DEBOOTSTRAP
- das Hilfswerkzeug, das beim Erstellen einer neuen Chroot
benutzt wird. Alternativen sind debootstrap oder
cdebootstrap.
- RETURN_DIR
- Falls gesetzt, werden Paketdateien, die Ergebnis des Bauens
sind, in den Pfad (lokal oder in der Ferne) kopiert, auf den dies gesetzt
ist. Der Pfad muss existieren, er wird nicht angelegt. Diese Option ist
standardmäßig nicht gesetzt und kann mit --return oder
--no-return überschrieben werden.
Architekur- und distributionsspezifische Optionen¶
Dies sind Variablen der Form $arch_$dist _VAR, die nur für ein bestimmtes Architektur-/Distributions-Bauziel gelten.- Architektur_Distribution_RESULT_DIR
- Der Verzeichnispfad auf der Baumaschine, in dem die
resultierenden (Quell- und Binär-)Pakete abgelegt werden und wo
ältere Versionen der Pakete, die vorher gebaut wurden, gefunden
werden können. Falls irgendwelche derartigen älteren Pakete
existieren, wird debdiff benutzt, um das neue Paket mit der
vorhergehenden Version zu vergleichen, nachdem das Bauen abgeschlossen
ist. Das Ergebnis wird in das Bauprotokoll eingefügt. Dateien darin
müssen für den BUILDD_USER für
Plausibilitätsprüfungen mit lintian(1) und
debdiff(1) und das Hochladen mit dput(1) lesbar sein. Falls
diese Option für irgendwelche Architektur- und
Distributionskombinationen nicht angegeben ist, dann wird
$PBUILDER_BASE/$arch/$dist/result vorgegeben.
- Architektur_Distribution_BASE_PATH
- das Verzeichnis, in dem die CoW-Master-Dateien vorliegen
werden (oder erzeugt werden, falls die Befehlszeilenoption --create
übergeben wurde). Falls diese Option für irgendwelche
Architekturen und Distributionen nicht angegeben wurde, dann wird
$PBUILDER_BASE/$arch/$dist/base.cow vorgegeben.
- Architektur_Distribution_BASE_DIST
- der Codename, der anstelle von Distribution als
Option --distribution an Cowbuilder übergeben wird. Dies ist
nötig, wenn Distribution ein lokal bedeutsamer Name ist, der
irgendeiner speziell konfigurierten Bau-Chroot wie
»wheezy_backports« zugewiesen wurde und nicht der Debootstrap
bekannte offizielle Suite-Name einer Distributionsveröffentlichung
ist. Diese Option kann nicht auf der Befehlszeile außer Kraft gesetzt
werden, da dies selten, wenn nicht sogar nie, für einzelne Aufrufe
von Cowpoke sinnvoll wäre. Falls diese Option nicht für
eine Architektur- und Distributionskombination angegeben wurde, wird als
Voreinstellung Distribution genommen.
- Architektur_Distribution_CREATE_OPTS
- ein Bash-Feld, das zusätzliche Optionen enthält,
die unverändert an Cowbuilder weitergegeben werden, wenn diese
Chroot zum ersten Mal (mittels der Option --create) erstellt wird.
Dies ist nützlich, wenn Optionen wie --othermirror zum
Erstellen spezialisierter Chroots wie »wheezy_backports«
erwünscht werden. Standardmäßig ist dies nicht gesetzt.
Alle darin gesetzten Werte werden außer Kraft gesetzt, falls auf der
Befehlszeile die Option --create-opts übergeben wird.
OPTS=( "Arg1" "Arg 2" "--option" "Wert" "--opt=Wert" "etc. etc." )
- Architektur_Distribution_UPDATE_OPTS
- ein Bash-Feld, das zusätzliche Optionen enthält,
die jedesmal, wenn die Basis dieser Chroot aktualisiert wird,
unverändert an Cowbuilder weitergereicht werden. Es
verhält sich ähnlich der oben beschriebenen
CREATE_OPTS-Optionen, außer dass es beim Aktualisieren der
Chroot tätig wird.
- Architektur_Distribution_BUILD_OPTS
- ein Bash-Feld, das zusätzliche Optionen enthält,
die jedesmal, wenn in dieser Chroot ein Paket gebaut wird,
unverändert an Cowbuilder weitergereicht werden. Dies ist
nützlich, wenn Sie Optionen wie --twice verwenden, um die sich
Cowpoke nicht direkt kümmern muss. In anderen Fällen
verhält es sich ähnlich der oben beschriebenen
CREATE_OPTS, außer dass es während der Bauphase von
Cowbuilder tätig wird.
- Architektur_Distribution_SIGN_KEYID
- ein optionales Architektur- und ein
distributionsspezifisches Außer-Kraft-Setzen für die globale
Option SIGN_KEYID.
- Architektur_Distribution_UPLOAD_QUEUE
- ein optionales Architektur- und ein
distributionsspezifisches Außer-Kraft-Setzen für die globale
Option UPLOAD_QUEUE
KONFIGURATIONSDATEIEN¶
- /etc/cowpoke.conf
- globale Konfigurationsoptionen; setzen die fest kodierten Vorgaben außer Kraft
- ~/.cowpoke
- Konfigurationsoptionen pro Benutzer; werden jede globale Konfiguration ignorieren
- .cowpoke
- Konfigurationsoptionen pro Projekt; werden jede
Konfiguration pro Benutzer oder globale Konfiguration überstimmen,
falls cowpoke aus dem Verzeichnis aufgerufen wird, in dem sie
existieren.
COWBUILDER-KONFIGURATION¶
Um eine cowbuilder-Instanz zu konfigurieren. die mit cowpoke benutzt wird, wird nichts sonderlich Spezielles benötigt. Erstellen Sie sie einfach in der Variante, die Sie mit » cowbuilder --create« gemäß der cowbuilder-Dokumentation benötigen. Dann konfigurieren Sie cowpoke mit dem Benutzer, der Architektur und den zum Zugriff benötigten Pfadinformationen auf den Rechnern, von denen Sie es aufrufen wollen (oder konfigurieren Sie cowpoke alternativ mit dem Pfad, der Architektur und der Distributionsinformation und übergeben Sie ihm beim ersten Aufruf die Option --create). Der Baurechner, der cowbuilder ausführt, benötigt kein lokal installiertes cowpoke.ANMERKUNGEN¶
Da cowbuilder eine Chroot erstellt und Sie, um dies zu tun, Root-Rechte benötigen, erfordert cowpoke außerdem zu einem bestimmten Grad Root-Zugriff. Daher ist es denkbar, dass all die schrecklichen Dinge, die dabei schiefgehen können, auch bei Ihnen schiefgehen. cowbuilder war bekannt dafür, versehentlich Dateisysteme, die mit der Option »bind« außerhalb der Chroot eingehängt sind, zu vernichten und es ist leicht möglich, dass noch Schlimmeres passiert. Seien Sie daher vorsichtig, bewahren Sie gute Sicherheitskopien der Dinge auf, die Sie nicht auf Ihrer Baumaschine verlieren möchten und verwenden Sie cowpoke, um alles auf einem Rechner zu verwahren, die nicht Ihre modernste Entwicklerkiste mit Ihren letzten paar Stunden nicht übergebener Arbeit ist.SIEHE AUCH¶
cowbuilder(1), pbuilder(1), ssh-agent(1), sudoers(5)AUTOR¶
cowpoke wurde von Ron <ron@debian.org> geschrieben.ÜBERSETZUNG¶
Diese Übersetzung wurde mit dem Werkzeug po4a <URL:https://po4a.alioth.debian.org/> durch Chris Leick c.leick@vollbio.de im Juli 2012 erstellt und vom deutschen Debian-Übersetzer-Team korrekturgelesen. Bitte melden Sie alle Fehler in der Übersetzung an debian-l10n-german@lists.debian.org oder als Fehlerbericht an das Paket devscripts. Sie können mit dem folgenden Befehl das englische Original anzeigen »man -L C Abschnitt deutsche_Handbuchseite«.28. April 2008 |