BEZEICHNUNG¶
debclean - bereinigt einen Quellcodeverzeichnisbaum
ÜBERSICHT¶
debclean [
Optionen]
BESCHREIBUNG¶
debclean durchläuft den Verzeichnisbaum, beginnend mit dem
Verzeichnisbaum, aus dem es aufgerufen wurde und führt
debian/rules
clean für jedes gefundene Debian-Quellverzeichnis aus. Diese
Verzeichnisse werden daran erkannt, dass sie eine debian/changelog-Datei
für ein Paket enthalten, dessen Name zu dem des Verzeichnisses passt.
Wann Namen passen, wird im Folgenden beschrieben.
Falls die Option
--cleandebs angegeben ist, werden außerdem alle
Dateien mit Namen *.deb, *.changes und *.build in jedem Verzeichnis, das einen
Debian-Quellverzeichnisbaum enthält, entfernt. Die .dsc-, .diff.gz- und
die (.orig).tar.gz-Dateien werden nicht angefasst, so dass die
Veröffentlichung, falls nötig, rekonstruiert werden kann und die
.upload-Dateien behalten werden, so dass die
debchange-Funktionen
korrekt funktionieren. Die Option
--nocleandebs verhindert dieses
zusätzliche Bereinigungsverhalten und die Option
--cleandebs
erzwingt sie. Standardmäßig werden diese Dateien nicht bereinigt.
debclean verwendet
debuild(1), um den Quellverzeichnisbaum zu
bereinigen.
Prüfung von Verzeichnisnamen¶
Ebenso wie mehrere andere Skripte im Paket
devscripts wird
debclean den Verzeichnisbaum durchlaufen, um
debian/changelog-Dateien zu suchen. 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 ihren 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.
OPTIONEN¶
- --cleandebs
- entfernt außerdem alle .deb-, .changes- und
.build-Dateien aus dem übergeordneten Verzeichnis.
- --nocleandebs
- entfernt die .deb-, .changes- und .build-Dateien aus dem
übergeordneten Verzeichnis nicht; dies ist das
Standardverhalten.
- --check-dirname-level N
- Die Erklärung dieser Option finden Sie im
vorhergehenden Abschnitt Prüfung von
Verzeichnisnamen.
- --check-dirname-regex regulärer
Ausdruck
- Die Erklärung dieser Option finden Sie im
vorhergehenden Abschnitt Prüfung von
Verzeichnisnamen.
- --no-conf, --noconf
- keine Konfigurationsdateien lesen, Dies kann nur als erste
auf der Befehlszeile angegebene Option benutzt werden.
- -d
- führt dpkg-checkbuilddeps nicht aus, um die
Bauabhängigkeiten zu prüfen.
- --help
- zeigt eine Hilfenachricht an und endet erfolgreich
- --version
- zeigt Versions- und Copyright-Informationen an und endet
erfolgreich.
KONFIGURATIONSVARIABLEN¶
Die beiden Konfigurationsdateien
/etc/devscripts.conf und
~/.devscripts werden in dieser Reihenfolge eingelesen, um
Konfigurationsvariablen zu setzen. Befehlszeilenoptionen können benutzt
werden, um Einstellungen in Konfigurationsdateien zu setzen. Einstellungen in
Umgebungsvariablen werden zu diesem Zweck ignoriert. Die derzeit bekannten
Variablen sind:
- DEBCLEAN_CLEANDEBS
- Falls dies auf yes gesetzt ist, ist es so, als ob
der Befehlszeilenparameter --cleandebs benutzt würde.
- DEVSCRIPTS_CHECK_DIRNAME_LEVEL,
DEVSCRIPTS_CHECK_DIRNAME_REGEX
- Die Erklärung dieser Variablen finden Sie im
vorhergehenden Abschnitt Prüfung von Verzeichnisnamen.
Beachten Sie, dass dies paketweite Konfigurationsvariablen sind und daher
alle devscripts-Skripte beeinflussen, die ihren Wert prüfen.
Dies wird in ihren jeweiligen Handbuchseiten und in
devscripts.conf(5) beschrieben.
SIEHE AUCH¶
debuild(1) und
devscripts.conf(5)
AUTOR¶
Christoph Lameter <clameter@debian.org>; Änderungen durch Julian
Gilbey <jdg@debian.org>.
Ü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«.