Linux Manpages Online - man.cx manual pages

ÜBERSICHT

debuild [Debuild-Optionen] [Dpkg-Buildpackage-Optionen] [--lintian-opts Lintian-Optionen]
debuild [Debuild-Optionen] -- binary|binary-arch|binary-indep|clean …

debuild erstellt alle Dateien, die zum Hochladen eines Debian-Pakets nötig sind. Zuerst führt es dpkg-buildpackage aus, dann lintian für die erstellte .changes-Datei (unter der Annahme, dass lintian installiert ist) und signiert schließlich die zugehörigen Dateien (mittels debsign(1) anstelle von dpkg-buildpackage(1) selbst; alle passenden Schlüsselsignierungsoptionen werden übergeben). Das Signieren wird übersprungen, falls die Distribution UNRELEASED ist, außer es wird die Option --force-sign von dpkg-buildpackage benutzt. An dpkg-buildpackage und lintian können Parameter übergeben werden, wobei letztere mit der Option --lintian-opts angegeben werden. Die in diesem Fall erlaubten Optionen sind --lintian und --no-lintian, um den Lintian-Schritt zu erzwingen beziehungsweise zu überspringen. Standardmäßig wird lintian ausgeführt. Außerdem sind verschiedene Optionen für das Setzen und Erhalten von Umgebungsvariablen verfügbar, wie nachfolgend im Abschnitt »Umgebungsvariablen« beschrieben. Bei dieser Methode debuild auszuführen wird außerdem das Bauprotokoll ../<Paket>_<Version>_<Architektur>.build sichern.

Eine alternative Möglichkeit, debuild zu benutzen, besteht darin, einen oder mehrere der Parameter binary, binary-arch, binary-indep und clean zu verwenden. In diesem Fall wird debuild versuchen, Root-Rechte zu bekommen und dann debian/rules mit den angegebenen Parametern auszuführen. Um Root-Rechte zu bekommen, kann eine der Optionen --rootcmd=Befehl_um_Root_zu_werden oder -rBefehl_um_Root_zu_werden benutzt werden. Befehl_um_Root_zu_werden ist wahrscheinlich entweder fakeroot, sudo oder super. Eine weitere Erörterung dieses Punkts finden Sie nachfolgend. Wieder können die Optionen zum Erhalten der Umgebung verwendet werden. In diesem Fall wird debuild außerdem versuchen, zuerst dpkg-checkbuilddeps auszuführen; dies kann explizit mittels der Optionen -D beziehungsweise -d angefordert oder abgeschaltet werden. Beachten Sie außerdem, dass wenn entweder eine dieser beiden oder eine -r-Option in der Konfigurationsdateioption DEBUILD_DPKG_BUILDPACKAGE_OPTS angegeben wurde, dies dann sogar in dieser Aufrufmethode von debuild erkannt wird.

debuild liest außerdem, wie nachfolgend beschrieben, die devscripts-Konfigurationsdateien. Dies ermöglicht die Angabe von Standardoptionen.

Prüfung von Verzeichnisnamen

Ebenso wie mehrere andere Skripte im Paket devscripts wird debuild den Verzeichnisbaum emporsteigen, bis es eine debian/changelog-Datei findet. Als eine Schutzmaßnahme gegen verirrte Dateien, die potenziell Probleme bereiten, wird es den Namen des übergeordneten Verzeichnisses untersuchen, sobald es eine debian/changelog-Datei findet und prüfen, ob der Verzeichnisname dem Paketnamen entspricht. Wie dies genau geschieht, wird durch die beiden Konfigurationsdateivariablen DEVSCRIPTS_CHECK_DIRNAME_LEVEL und DEVSCRIPTS_CHECK_DIRNAME_REGEX sowie ihre entsprechenden Befehlszeilenoptionen --check-dirname-level und --check-dirname-regex geregelt.

DEVSCRIPTS_CHECK_DIRNAME_LEVEL kann die folgenden Werte annehmen:

	0		prüft den Verzeichnisnamen nie.
	1		prüft den Verzeichnisnamen nur, falls in der Suche nach debian/changelog das Verzeichnis gewechselt werden muss. Dies ist das Standardverhalten.
	2		prüft den Verzeichnisnamen immer.

Der Verzeichnisname wird geprüft, indem getestet wird, ob der aktuelle Verzeichnisname (wie er durch pwd(1) bestimmt wurde) zum regulären Ausdruck passt, der durch die Konfigurationsdateioption DEVSCRIPTS_CHECK_DIRNAME_REGEX oder die Befehlszeilenoption --check-dirname-regex regulärer_Ausdruck angegeben wurde. Hierbei ist regulärer_Ausdruck ein regulärer Perl-Ausdruck (siehe perlre(3perl)), der an den Anfang und das Ende verankert wird. Falls regulärer_Ausdruck ein »/« enthält, muss er auf den vollständigen Verzeichnispfad passen. Wenn nicht, dann muss er auf den vollständigen Verzeichnisnamen passen. Falls regulärer_Ausdruck die Zeichenkette »PACKAGE« beinhaltet, wird diese durch den Namen des Quellpakets ersetzt, wie er aus dem Changelog bestimmt wird. Der vorgegebene Wert für den regulären Ausdruck ist: »PACKAGE(-.+)?«, daher entspricht er Verzeichnisnamen wie PACKAGE und PACKAGE-Version.

UMGEBUNGSVARIABLEN

Da Umgebungsvariablen den Bau eines Pakets beeinflussen, oft ungewollt, reduziert debuild die Umgebung, indem es alle Umgebungsvariablen außer TERM, HOME, LOGNAME, GNUPGHOME, PGPPATH, GPG_AGENT_INFO, GPG_TTY, DBUS_SESSION_BUS_ADDRESS, FAKEROOTKEY, DEBEMAIL, DEB_*, den FLAGS-Variablen (C, CPP, CXX, LD und F) und ihren _APPEND-Gegenstücken sowie den Locale-Variablen LANG und LC_* entfernt. TERM ist, falls es nicht gesetzt wurde, auf »dumb« gesetzt und PATH ist auf »/usr/sbin:/usr/bin:/sbin:/bin:/usr/bin/X11« gesetzt.

Falls erforderlich ist, dass eine bestimmte Umgebungsvariable unverändert an den Bauprozess durchgeleitet wird, kann dies mittels einer --preserve-envvar-Umgebungsvariablen angegeben werden (dies kann auch als Option -e Umgebungsvariable geschrieben werden). Die Umgebung kann mittels der Option --preserve-env unverändert belassen werden. PATH wird jedoch sogar in diesem Fall auf den oben beschriebenen vernünftigen Wert gesetzt. Die einzige Möglichkeit, PATH vor dem Zurücksetzen zu bewahren, besteht darin, eine --preserve-envvar PATH-Option anzugeben. Seien Sie aber gewarnt, dass die Benutzung von Programmen, die an Nichtstandardorten liegen, leicht dazu führen kann, dass das Paket beschädigt ist, da es nicht auf Standardsystemen gebaut werden kann.

Beachten Sie, dass Verzeichnisse mittels der Option --prepend-path an den Anfang des zurückgesetzten PATH hinzugefügt werden können. Dies ist nützlich, wenn zum Bauen die Verwendung von Werkzeugen wie ccache oder distcc gewünscht wird.

Es ist außerdem möglich, zu verhindern, dass etwas wie FOO=bar debuild -e FOO durch Schreiben von debuild -e FOO=bar oder der Langform debuild --set-envvar FOO=bar getippt werden muss.

SUPERUSER-ANFORDERUNGEN

debuild muss als Superuser ausgeführt werden, um ordnungsgemäß zu funktionieren. Es gibt grundlegend verschiedene Arten, dies zu erreichen. Die erste und bevorzugte Methode besteht in der Benutzung eines Befehls, um Root-Rechte zu erlangen. Es ist wahrscheinlich am besten, fakeroot(1) zu verwenden, da es nicht das Gewähren echter Rechte beinhaltet. super(1) und sudo(1) sind weitere Möglichkeiten. Falls keine -r-Option (oder --rootcmd) angegeben wurde (und erinnern Sie sich daran, dass dpkg-buildpackage eine -r-Option ebenfalls akzeptiert) und keine der folgenden Methoden benutzt wird, dann wird stillschweigend von -rfakeroot ausgegangen.

Die zweite Methode besteht darin, etwas wie su(1) zu verwenden, um Root zu werden, und dann alles als Root zu tun. Beachten Sie jedoch, dass lintian abbrechen wird, falls es als Root oder Setuid-Root ausgeführt wird; dies kann mittels der Option --allow-root von lintian verhindert werden, falls Sie wissen, was Sie tun.

Die dritte mögliche Methode ist, dass debuild als Setuid-Root installiert wurde. Dies ist nicht die Standardmethode und wird dergestalt vom Systemadministrator installiert werden müssen. Es muss außerdem erkannt werden, dass jedermann, der debuild als Root oder Setuid-Root ausführt, vollen Zugriff auf den ganzen Rechner hat. Diese Methode wird daher nicht empfohlen, wird aber funktionieren. debuild könnte mit den Rechten 4754 installiert werden, so dass es nur Mitglieder der besitzenden Gruppe ausführen können. Ein Nachteil dieser Methode wäre, dass andere Benutzer nicht in der Lage wären, dieses Programm zu verwenden. Es gibt viele andere Varianten dieser Option unter Einbeziehung mehrerer Kopien von debuild oder der Verwendung von Programmen wie sudo oder super, um ausgewählten Benutzern Root-Rechte zu gewähren. Falls der Systemadministrator dies tun möchte, sollte er das Programm dpkg-statoverride benutzen, um die Rechte von /usr/bin/debuild zu ändern. Dies wird sicherstellen, dass diese Rechte über Upgrades hinweg erhalten werden.

HOOKS

debuild unterstützt eine Reihe von Hooks, wenn dpkg-buildpackage ausgeführt wird. Beachten Sie, dass die Hooks dpkg-buildpackage bis (einschließlich) lintian an dpkg-buildpackage mittels ihrer zugehörigen Option --hook-name weitergereicht werden. Folgende Hooks sind verfügbar:
dpkg-buildpackage-hook

wird ausgeführt bevor dpkg-buildpackage beginnt, indem dpkg-checkbuilddeps aufgerufen wird.