.\" -*- nroff -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH USCAN 1 Debian\-Hilfswerkzeuge DEBIAN .SH BEZEICHNUNG uscan \- durchsucht/beobachtet Quellen der Ursprungsautoren nach neuen Veröffentlichungen der Software .SH ÜBERSICHT \fBuscan\fP [\fIOptionen\fP] [\fIPfad\-zu\-Debian\-Quellpaketen\fP …] .SH BESCHREIBUNG \fBuscan\fP durchsucht die angegebenen Verzeichnisse (oder das aktuelle Verzeichnis, falls keine angegeben wurden) und sämtliche Unterverzeichnisse nach Paketen, die eine Steuerdatei \fIdebian/watch\fP enthalten. Parameter werden dann aus diesen Steuerdateien gelesen und FTP\- oder HTTP\-Sites der Ursprungsautoren werden auf neue verfügbare Aktualisierungen geprüft (indem sie mit der Versionsnummer der Ursprungsautoren verglichen werden, die wiederum aus der Datei \fIdebian/changelog\fP im gleichen Verzeichnis geholt wird). Die neusten Aktualisierungen werden heruntergeladen (wie durch ihre Versionsnummer bestimmt) und falls in der \fIwatch\fP\-Datei angegeben, könnte ein Programm mit dem neu heruntergeladenen Quellcode ausgeführt werden. .PP Die herkömmlichen \fIdebian/watch\fP\-Dateien können immer noch benutzt werden, aber das aktuelle Format ist sowohl einfacher als auch flexibler. Hier wird das alte Format nicht beschrieben; dessen Dokumentation finden Sie im Quellcode von Uscan. .SH "FORMAT der debian/watch\-Dateien" Im Folgenden wird vorgeführt, welche Typen von Einträgen in einer \fIdebian/watch\fP\-Datei erscheinen können. Offensichtlich würden nicht alle davon in einer solchen Datei auftauchen; üblicherweise würde sie eine Zeile für das aktuelle Paket enthalten. .PP .nf # Format der Versionsnummer, derzeit 3; diese Zeile ist vorgeschrieben! version=3 # Zeilen werden mit \fB\e\fP fortgesetzt # Dies ist das Format für eine FTP\-Site: # Vollständige\-Site\-mit\-Mustern [Version [Aktion]] ftp://ftp.tex.ac.uk/tex\-archive/web/c_cpp/cweb/cweb\-(.+)\e.tar\e.gz \e debian uupdate # Dies ist das Format einer FTP\-Site mit Metazeichen regulärer Ausdrücke im # Dateinamensteil. ftp://ftp.worldforge.org/pub/worldforge/libs/Atlas\-C++/transitional/Atlas\-C\e+\e+\-(.+)\e.tar\e.gz # Dies ist das Format für eine FTP\-Site mit Verzeichnismusterabgleich ftp://ftp.nessus.org/pub/nessus/nessus\-([\ed\e.]+)/src/nessus\-core\-([\ed\e.]+)\e.tar\e.gz # Dies kann benutzt werden, falls Sie die PASV\-Einstellung für eine # spezielle Site außer Kraft setzen möchten. # opts=pasv ftp://…/… # Dies ist ein Format für eine HTTP\-Site, das dem Format einer FTP\-Site # entspricht. \fBuscan\fP startet mit dem Herunterladen der Homepage, die es # durch Entfernen des letzten URL\-Bestandteils erhält, in diesem Fall # \fIhttp://www.cpan.org/modules/by\-module/Text/\fP http://www.cpan.org/modules/by\-module/Text/Text\-CSV_XS\-(.+)\e.tar\e.gz # Dies ist ein abweichendes HTTP\-Format, das die direkte Angabe der Homepage # gestattet: # Homepage Muster [Version [Aktion]] http://www.dataway.ch/~lukasl/amph/amph.html \e files/amphetamine\-([\ed\e.]*).tar.bz2 # Dies zeigt, dass rekursives Durchsuchen von Verzeichnissen in beiden # Formen funktioniert, solange die Website Anfragen der Form # \fIhttp://site/inter/mediate/dir/\fP handhaben kann http://tmrc.mit.edu/mirror/twisted/Twisted/(\ed\e.\ed)/ \e Twisted\-([\ed\e.]*)\e.tar\e.bz2 http://tmrc.mit.edu/mirror/twisted/Twisted/(\ed\e.\ed)/Twisted\-([\ed\e.]*)\e.tar\e.bz2 # Um bei Tarballs der Ursprungsautoren maximale Flexibilität zu erreichen, # nutzen Sie dies: http://example.com/example\-(\ed[\ed.]*)\e.(?:zip|tgz|tbz2|txz|tar\e.(?:gz|bz2|xz)) # qa.debian.org führt eine Weiterleitung aus, die eine einfachere Form für # eine URL Sourceforge\-basierter Projekte bietet. Das nachfolgende Format # wird automatisch umgeschrieben, um den Weiterleitungsdienst zu verwenden. http://sf.net/audacity/audacity\-src\-(.+)\e.tar\e.gz # Für GitHub\-Projekte können Sie die Markierungs\- oder Veröffentlichungsseite # verwenden. Da die Archiv\-URLs nur die Version als Name benutzen, wird # empfohlen, ein Filenamemangle zum Anpassen des Namens der heruntergeladenen # Datei zu verwenden: opts="filenamemangle=s/(?:.*\/)?v?(\ed[\ed\e.]*)\e.tar\e.gz/\-$1.tar.gz/" \e https://github.com///tags (?:.*/)?v?(\ed[\ed\e.]*)\e.tar\e.gz # Für Google\-Code\-Projekte sollten Sie die Downloads\-Seite wie folgt benutzen: https://code.google.com/p//downloads/list?can=1 \e .*/\-(\ed[\ed.]*)\e.tar\e.gz # Dies ist das Format für eine Site, die komische Versionsnummern hat; # die Klammergruppen werden mit Punkten verbunden, um eine bereinigte # Versionsnummer zu erzeugen http://www.site.com/pub/foobar/foobar_v(\ed+)_(\ed+)\e.tar\e.gz # Dies ist eine weitere Art, eine Site mit komischen Versionsnummern zu # handhaben, diesmal mittels Mangling (Anpassen von Paketnamen). (Beachten # Sie, dass mehrere Gruppen vor dem Mangling zusammengefügt werden und dass # dieses Mangling nur für die Versionsnummer des Basispfads und nicht für # die Versionsnummern aller Pfade durchgeführt wird.) opts="uversionmangle=s/^/0.0./" \e ftp://ftp.ibiblio.org/pub/Linux/ALPHA/wine/development/Wine\-(.+)\e.tar\e.gz # Genauso kann ein Mangling des Teils der Debian\-Versionsnummer der # Ursprungsautoren durchgeführt werden: opts=dversionmangle=s/\e+dfsg\ed*$// \e http://some.site.org/some/path/foobar\-(.+)\e.tar\e.gz # Der Dateiname wird ermittelt, indem der letzte Bestandteil der URL # genommen und alles nach einem »\fB?\fP« entfernt wird. Falls dies nicht zu # einem brauchbaren Dateinamen führt, soll Filenamemangle verwendet werden. # Zum Beispiel könnte # # gehandhabt werden wie # opts=filenamemangle=s/.*=(.*)/$1/ \e # http://foo.bar.org/download/\e?path=&download=foo\-(.+)\e.tar\e.gz. # # # könnte wie # opts=filenamemangle=s/.*=(.*)/foo\-$1\e.tar\e.gz/ \e # http://foo.bar.org/download/\e?path=&download_version=(.+) # gehandhabt werden. # Die Option »downloadurlmangle« kann benutzt werden, um ein Mangling der # URL der Datei durchzuführen, die heruntergeladen werden soll. Dies kann # nur mit http://\-URLs benutzt werden. Dies kann nötig sein, falls der auf # der Webseite angegebene Verweis automatisch auf irgendeine Weise in einen # umgewandelt werden muss, der funktioniert, zum Beispiel: # opts=downloadurlmangle=s/prdownload/download/ \e # http://developer.berlios.de/project/showfiles.php?group_id=2051 \e # http://prdownload.berlios.de/softdevice/vdr\-softdevice\-(.+).tgz .fi .PP Kommentarzeilen können mit einem »\fB#\fP«\-Zeichen eingeleitet werden. Zeilen können mit einem abschließenden Rückwärtsschrägstrich fortgesetzt werden. .PP Die erste (Nicht\-Kommentar\-)Zeile der Datei muss mit »version=3« beginnen. Dies ermöglicht zukünftige Erweiterungen, ohne dass der Name der Datei geändert werden muss. .PP Es gibt zwei Möglichkeiten für die Syntax einer HTTP\-\fIwatch\fP\-Dateizeile und nur eine für eine FTP\-Zeile. Wir beginnen mit dem üblichen (und einfacheren) Format. Nachfolgend wird das optionale erste Feld »opts=…« beschrieben und im Folgenden ignoriert. .PP Das erste Feld gibt das vollständige Muster der URLs an, nach denen gesucht wird. Im Fall einer FTP\-Site wird der Inhalt des abgefragten Verzeichnisses angefordert und dieser wird nach Dateien mit passendem Basisnamen durchsucht (alles nach dem letzten »\fB/\fP«). Im Falle einer HTTP\-Site wird alles nach dem letzten Schrägstrich weggelassen und die so erhaltene URL heruntergeladen und nach Hrefs durchsucht (Verweise der Form ), entweder nach dem vollständigen angegebenen URL\-Muster oder nach dem absoluten Teil (alles ohne den http://Rechner.Name/\-Teil) oder dem Basisnamen (nur dem Teil nach dem \fB/\fP am Ende). Alles bis zum Schrägstrich am Ende wird als wortgetreue URL genommen, solange in diesem Teil der URL keine Klammern (»\fB(\fP« und »\fB)\fP«) vorkommen: falls doch, wird der Verzeichnisname auf die selbe Weise abgeglichen, wie es nachfolgend für den letzten Bestandteil der URL beschrieben wird. (Beachten Sie, dass Zeichen mit Sonderbedeutung für reguläre Ausdrücke wie »\fB+\fP« buchstäblich betrachtet werden, außer wenn sie in einem Pfadbestandteil vorkommen, der Klammern enthält; siehe das vorhergehende Atlas\-C++\-Beispiel. Außerdem müssen die Klammern in jedem Pfadbestandteil paarweise vorkommen.) .PP Das Muster (nach dem Schrägstrich am Ende) ist ein regulärer Perl\-Ausdruck (Einzelheiten darüber sind unter \fBperlre\fP(1) zu finden). Sie müssen das Muster so streng gestalten, dass es nur auf die Software der Ursprungsautoren passt, an der Sie interessiert sind und auf nichts anderes. Außerdem wird das Muster an den Anfang und das Ende verankert, so dass es zum vollständigen Namen passen muss. (Beachten sie, dass die Href für HTTP\-URLs den absoluten Pfad oder die vollständige Site und den Pfad enthalten kann und immer noch akzeptiert wird.) Das Muster muss mindestens eine Perl\-Gruppe enthalten, wie im nächsten Absatz erläutert. .PP Ist eine Liste von »Dateien« mit passendem Muster vorhanden, werden ihre Versionsnummern extrahiert, indem der Teil, der zu den Gruppen regulärer Perl\-Ausdrücke passt, gekennzeichnet durch »\fB(...)\fP«, durch Punkte »\fB.\fP« zusammengesetzt wird. Das Ergebnis wird als Versionsnummer der Datei verwendet. Dann wird ein Verwürfeln der Versionsnummer durchgeführt, falls dies von der nachfolgend beschriebenen Option »uversionmangle« benötigt wird. Am Ende werden die Dateiversionen verglichen, um diejenige mit der größten Versionsnummer zu finden, wie durch \fBdpkg \-\-compare\-versions\fP festgelegt. Beachten Sie, falls Sie Perl\-Gruppen benötigen, die nicht in der Versionsnummer verwendet werden, dass Sie entweder »\fB(?:...)\fP« oder die Option »uversionmangle« verwenden, um die Unordnung zu beseitigen. .PP Die aktuelle Version (der Ursprungsautoren) kann als zweiter Parameter in der \fIwatch\fP\-Dateizeile angegeben werden. Falls dies \fIdebian\fP ist oder fehlt, wird die aktuelle Debian\-Version (wie durch \fIdebian/changelog\fP bestimmt) benutzt, um die aktuelle Version der Ursprungsautoren zu bestimmen. Die aktuelle Version der Ursprungsautoren kann außerdem als Befehlszeilenoption \fB\-\-upstream\-version\fP angegeben werden, die die Versionsnummer der Ursprungsautoren des aktuell installierten Pakets angibt (d.h. die Debian\-Versionsnummer ohne Epoche und Debian\-Revision). Für die Versionsnummer der Ursprungsautoren wird dann mittels der Option »dversionmangle«, falls angegeben, ein Mangling durchgeführt, wie nachfolgend beschrieben. Falls die neuste verfügbare Version neuer ist als die aktuelle Version, wird sie in das übergeordnete Verzeichnis heruntergeladen, es sei denn, die Optionen \fB\-\-report\fP oder \fB\-\-report\-status\fP werden verwendet. Sobald die Datei heruntergeladen wurde, wird ein symbolischer Verweis zur Datei von \fI_.orig.tar.{gz|bz2|lzma|xz}\fP erstellt, wie in der Hilfe für die Option \fB\-\-symlink\fP beschrieben. .PP Falls schlussendlich ein dritter Parameter (eine Aktion) in der \fIwatch\fP\-Dateizeile angegeben wurde, wird dieser als Name des Befehls genommen und der Befehl .nf \fIBefehl \fP\fB\-\-upstream\-version\fP\fI Version Dateiname\fP .fi wird ausgeführt, entweder mit der Originaldatei oder des Namens des symbolischen Verweises. Ein üblicher derartiger Befehl wäre \fBuupdate\fP(1). (Beachten Sie, dass sich die Aufrufsyntax geringfügig unterscheidet, wenn die \fIwatch\fP\-Datei ohne eine »\fBversion=\fP…«\-Zeile benutzt wird; der dort ausgeführte Befehl war »\fIBefehl Dateiname Version\fP«.) Falls der Befehl \fBuupdate\fP ist, wird die Option \fB\-\-no\-symlink\fP als erste Option an \fBuupdate\fP übergeben, da das angefragte Erstellen eines symbolischen Verweises bereits durch \fBuscan\fP erledigt wurde. .PP Die alternative Variante der \fIwatch\fP\-Dateisyntax für HTTP\-URLs ist wie folgt: Das erste Feld ist die Homepage, die heruntergeladen und dann nach Hrefs durchsucht werden soll, die dem im zweiten Feld übergebenen Muster entsprechen. (Dieses Muster wird wieder an den Anfang und das Ende verankert, so dass es der ganzen Href entsprechen muss. Falls Sie nur den Basisnamen der Href vergleichen möchten, können Sie ein Muster wie ».*/Name\-(.+)\e.tar\e.gz« verwenden, falls Sie wissen, dass dort eine vollständige URL vorliegt oder besser immer noch: »(?:.*/)?Name\-(.+)\e.tar\e.gz«, falls dies der Fall ist oder nicht. Beachten Sie, (?:...) zu benutzen, um einen Rückwärtsbezug zu vermeiden.) Falls irgendwelche der Hrefs auf der Homepage, die zum (verankerten) Muster passen, relative URLs sind, werden sie als relativ zur Basis\-URL der Homepage betrachtet (d.h. mit allem nach dem abschließenden Schrägstrich entfernt) oder relativ zur auf der Homepage selbst mit einer als \-Markierung angegebenen Basis\-URL. Das dritte und vierte Feld sind die Felder Versionsnummer und Aktion wie vorher. .SH "OPTIONEN JE SITE" Einer \fIwatch\fP\-Dateizeile kann »\fBopts=\fP\fIOptionen\fP« vorangestellt werden, wobei \fIOptionen\fP eine durch Kommas getrennte Liste von Optionen ist. Die ganze \fIOptionen\fP\-Zeichenkette kann in doppelte Anführungszeichen eingeschlossen werden, was nötig ist, wenn \fIOptionen\fP irgendwelche Leerzeichen enthalten. Folgende Optionen werden erkannt: .TP \fBactive\fP und \fBpassive\fP (oder \fBpasv\fP) Falls dies auf einer FTP\-Zeile verwendet wird, setzt es die Wahl außer Kraft, ob der PASV\-Modus verwendet wird oder nicht, und erzwingt die Benutzung des angegebenen Modus für diese Site. .TP \fBuversionmangle=\fP\fIRegeln\fP Dies wird für das Mangling der Versionsnummer der Ursprungsautoren verwendet, wie sie durch die ftp://…\- oder http://\-Regeln wie folgt abgeglichen wird. Zuerst wird die \fIRegel\fP\-Zeichenkette bei jedem »\fB;\fP« in mehrere Regeln unterteilt. Dann wird ein Mangling der Versionsnummer der Ursprungsautoren durchgeführt, indem \fIRegel\fP auf die Version in ähnlicher Weise wie für das Ausführen des Perl\-Befehls .nf $version =~ \fIRegel\fP; .fi auf jede Regel angewandt wird. Daher könnten geeignete Regeln »\fBs/^/0./\fP« sein, um \fB0.\fP an die Versionsnummer anzuhängen und »\fBs/_/./g\fP«, um Unterstriche in Punkte zu ändern. Beachten Sie, dass die \fIRegel\fP\-Zeichenkette keine Kommas enthalten darf; dies sollte kein Problem sein. \fIRegel\fP kann nur die Operationen »\fBs\fP«, »\fBtr\fP« und »\fBy\fP« verwenden. Wenn die Operation »\fBs\fP« benutzt wird, sind nur die Schalter »\fBg\fP«, »\fBi\fP« und »\fBx\fP« verfügbar und \fIRegel\fP kann keine Ausdrücke enthalten, die die Möglichkeit haben, Code auszuführen (d.h. die Gebilde (?{}) und (??{}) werden nicht unterstützt. Falls die Operation »\fBs\fP« benutzt wird, kann die Ersetzung Rückwärtsbezüge auf Ausdrücke innerhalb von Klammern im passenden regulären Ausdruck wie »\fBs/\-alpha(\ed*)/.a$1/\fP« enthalten. Diese Rückwärtsbezüge müssen die »\fB$1\fP«\-Syntax verwenden, da die »\fB\e1\fP«\-Syntax nicht unterstützt wird. .TP \fBdversionmangle=\fP\fIRegeln\fP Dies wird für das Mangling der Debian\-Versionsnummer des aktuell installierten Pakets auf die gleiche Art wie bei der Option \fBuversionmangle\fP benutzt. Daher könnte eine geeignete Regel »\fBs/\e+dfsg\ed*$//\fP« lauten, um eine »\fB+dfsg1\fP«\-Endung von der Debian\-Versionsnummer zu entfernen oder Versionsnummern des Typs »\fB.pre6\fP« zu handhaben. Die \fIRegeln\fP\-Zeichenkette darf wieder Kommas enthalten; dies sollte kein Problem sein. .TP \fBversionmangle=\fP\fIRegeln\fP Dies ist eine syntaktisches Abkürzung für \fBuversionmangle=\fP\fIRegeln\fP\fB,dversionmangle=\fP\fIRegeln\fP, es wendet die selben Regeln sowohl auf die Versionsnummern der Ursprungsautoren als auch auf die von Debian an. .TP \fBfilenamemangle=\fP\fIRegeln\fP Dies wird für das Mangling des Dateinamens benutzt, unter dem die heruntergeladene Datei gespeichert wird und auf die selbe Weise ausgewertet wie die Option \fBuversionmangle\fP. Beispiele für die Verwendung finden sich im vorhergehenden Beispielabschnitt. .TP \fBdownloadurlmangle=\fP\fIRegeln\fP Dies wird für das Mangling der URL verwendet, die zum Herunterladen benutzt wird. Die URL wird zuerst basierend auf der heruntergeladenen Homepage und des passenden Musters berechnet, dann wird die Versionsnummer aus dieser URL bestimmt. Am Ende werden alle durch diese Option angegebenen Regeln angewandt, bevor tatsächlich versucht wird, sie herunterzuladen. Ein Beispiel für die Verwendung findet sich im vorhergehenden Beispielabschnitt. .TP \fBpgpsigurlmangle=\fP\fIRegeln\fP Falls vorhanden, werden die mitgelieferten Regeln auf die heruntergeladene URL angewandt (nach irgendwelchen Downloadurlmangle\-Regeln), um eine neue URL zu erstellen, die zum Abholen der separaten OpenPGP\-Signaturdatei für den Tarball der Ursprungsautoren benutzt wird. Einige gebräuchliche Regeln könnten »\fBs/$/.asc/\fP«, »\fBs/$/.pgp/\fP« oder »\fBs/$/.gpg/\fP« lauten. Diese Signatur muss durch einen Schlüssel erstellt worden sein, der im Schlüsselbund \fBdebian/upstream\-signing\-key.pgp\fP oder im gehärteten Schlüsselbund \fBdebian/upstream/signing\-key.asc\fP zu finden ist. Falls sie ungültig ist oder nicht durch einen der aufgeführten Schlüssel erstellt wurde, wird Uscan einen Fehler melden. .TP \fBrepacksuffix=\fP\fIEndung\fP Falls die Quellen der Originalautoren verändert wurden, weil \fIdebian/copyright\fP das Feld \fBFiles\-Excluded\fP enthält, wird \fIEndung\fP an die Version der Originalautoren des neu gepackten Tar\-Archivs gehängt. Gebräuchliche Endungen könnten \fB+dfsg1\fP zum Anzeigen von Nicht\-DFSG\-Code oder \fB+ds1\fP sein, das anzeigt, dass eingebettete (DFSG\-)Kopien des Codes entfernt wurden. .SH "Prüfung von Verzeichnisnamen" Ähnlich wie viele andere Skripte im Paket \fBdevscripts\fP, erkundet \fBuscan\fP die abgefragten Verzeichnisbäume nach \fIdebian/changelog\fP\- und \fIdebian/watch\fP\-Dateien. Als eine Schutzmaßnahme gegen verirrte Dateien, die potenziell Probleme bereiten und um die Leistung zu steigern, wird es den Namen des übergeordneten Verzeichnisses untersuchen, sobald es eine \fIdebian/changelog\fP\-Datei findet, und prüfen, ob der Verzeichnisname dem Paketnamen entspricht. Es wird nur versuchen, neuere Versionen des Pakets herunterzuladen und dann jede angefragte Aktion durchführen, falls der Verzeichnisname zum Paketnamen passt. Wie dies genau geschieht, wird durch die beiden Konfigurationsdateivariablen \fBDEVSCRIPTS_CHECK_DIRNAME_LEVEL\fP und \fBDEVSCRIPTS_CHECK_DIRNAME_REGEX\fP sowie ihre entsprechenden Befehlszeilenoptionen \fB\-\-check\-dirname\-level\fP und \fB\-\-check\-dirname\-regex\fP geregelt. .PP \fBDEVSCRIPTS_CHECK_DIRNAME_LEVEL\fP kann die folgenden Werte annehmen: .TP \fB0\fP prüft den Verzeichnisnamen nie. .TP \fB1\fP prüft nur den Verzeichnisnamen, falls bei der Suche nach \fIdebian/changelog\fP das Verzeichnis geändert werden muss, das heißt, das Verzeichnis, das \fIdebian/changelog\fP enthält, nicht das Verzeichnis ist, aus dem \fBuscan\fP aufgerufen wurde. Dies ist das Standardverhalten. .TP \fB2\fP prüft den Verzeichnisnamen immer. .PP Der Verzeichnisname wird geprüft, indem getestet wird, ob der aktuelle Verzeichnisname (wie er durch \fBpwd\fP(1) bestimmt wurde) zum regulären Ausdruck passt, der durch die Konfigurationsdateioption \fBDEVSCRIPTS_CHECK_DIRNAME_REGEX\fP oder die Befehlszeilenoption \fB\-\-check\-dirname\-regex\fP \fIregulärer Ausdruck\fP angegeben wurde. Hierbei ist \fIregulärer Ausdruck\fP ein regulärer Perl\-Ausdruck (siehe \fBperlre\fP(3perl)), der an den Anfang und das Ende verankert wird. Falls \fIregulärer Ausdruck\fP ein »/« enthält, muss er auf den vollständigen Verzeichnispfad passen. Wenn nicht, dann muss er auf den vollständigen Verzeichnisnamen passen. Falls \fIregulärer Ausdruck\fP die Zeichenkette »PACKAGE« beinhaltet, wird diese durch den Namen des Quellpakets ersetzt, wie er aus dem \fIChangelog\fP bestimmt wird. Der vorgegebene Wert für den regulären Ausdruck ist: »PACKAGE(\-.+)?«, daher entspricht er Verzeichnisnamen wie PACKAGE und PACKAGE\-Version. .SH BEISPIEL Dieses Skript wird eine vollautomatische Aktualisierung aus den Ursprungsquellen durchführen. .nf #!/bin/sh \-e # wird aufgerufen mit »\-\-upstream\-version« uupdate "$@" package=`dpkg\-parsechangelog | sed \-n 's/^Source: //p'` cd ../$package\-$2 debuild .fi Beachten Sie, dass \fBdupload\fP oder \fBdput\fP nicht automatisch aufgerufen werden, da der Betreuer Plausibilitätsprüfungen für die Software durchführen sollte, bevor sie nach Debian hochgeladen wird. .SH OPTIONEN .TP \fB\-\-report\fP, \fB\-\-no\-download\fP berichtet nur über neue verfügbare Versionen, lädt aber nichts herunter. .TP \fB\-\-report\-status\fP berichtet über den Zustand aller Pakete, sogar von denen, die aktuell sind, lädt aber nichts herunter. .TP \fB\-\-download\fP berichtet und lädt herunter. (Dies ist das Standardverhalten.) .TP \fB\-\-destdir\fP Pfad des Verzeichnisses in das heruntergeladen werden soll. Falls der angegebene Pfad nicht absolut ist, wird er entweder relativ zum aktuellen Verzeichnis oder, falls Verzeichnisauswertung aktiviert ist, zum Quellverzeichnis des Pakets sein. .TP \fB\-\-force\-download\fP lädt von der Ursprungsquelle sogar dann herunter, wenn es aktuell ist (wird jedoch keine lokalen Dateien überschreiben). .TP \fB\-\-pasv\fP erzwingt bei FTP\-Verbindungen den PASV\-Modus. .TP \fB\-\-no\-pasv\fP verwendet bei FTP\-Verbindungen nicht den PASV\-Modus. .TP \fB\-\-timeout\fP \fIN\fP setzt die Zeitüberschreitung auf N Sekunden (Vorgabe 20 Sekunden). .TP \fB\-\-no\-symlink\fP ruft nicht \fBmk\-origtargz\fP auf. .P Die folgenden Optionen werden an \fBmk\-origtargz\fP übergeben: .RS .TP \fB\-\-symlink\fP erstellt symbolische \fIorig.tar.gz\fP\-Verweise (mit passender Endung) auf die heruntergeladenen Dateien. (Dies ist das Standardverhalten.) .TP \fB\-\-copy\fP kopiert die heruntergeladenen Dateien, statt, wie oben beschrieben, symbolische Verweise darauf zu erstellen. .TP \fB\-\-rename\fP benennt die heruntergeladenen Dateien um, statt, wie oben beschrieben, symbolische Verweise darauf zu erstellen. .TP \fB\-\-repack\fP Nachdem ein LZMA\-Tar\-, Xz\-Tar, Bzip\-Tar oder Zip\-Archiv heruntergeladen wurde, wird es neu als Gzip\-Tar\-Archiv gepackt, fall nötig. Um die \&.zip\-Archive neu zu packen, muss das Paket \fBunzip\fP installiert sein, um LZMA\- oder XZ\-Archive neu zu packen, muss das Paket \fBxz\-utils\fP installiert sein. .TP \fB\-\-compression\fP [ \fBgzip\fP | \fBbzip2\fP | \fBlzma\fP | \fBxz\fP ] Falls die Quellen der Originalautoren neu gepackt wurden (entweder weil die Option \fB\-\-repack\fP angegeben wurde oder \fIdebian/copyright\fP das Feld \fBFiles\-Excluded\fP enthält), ist es möglich, die Komprimierungsmethode über diesen Parameter zu steuern (Voreinstellung ist \fBgzip\fP). .TP \fB\-\-copyright\-file\fP \fICopyright\-Datei\fP schließt Dateien aus, die in \fBFiles\-Excluded\fP in der angegebenen Copyright\-Datei erwähnt werden. Dies ist nützlich, wenn Uscan nicht innerhalb eines Quellpaketverzeichnisses ausgeführt wird. .RE .TP \fB\-\-dehs\fP benutzt für die Ausgabe ein XML\-Format, wie es vom DEHS\-System benötigt wird. .TP \fB\-\-no\-dehs\fP verwendet das traditionelle Uscan\-Ausgabeformat. (Dies ist das Standardverhalten.) .TP \fB\-\-package\fP \fIPaket\fP gibt den Namen des zu prüfenden Pakets an, anstatt \fIdebian/changelog\fP zu untersuchen; dies erfordert die Optionen \fB\-\-upstream\-version\fP (es sei denn, in der Datei \fIwatch\fP wurde eine Version angegeben) sowie \fB\-\-watchfile\fP. Zudem wird kein Verzeichnis durchsucht und es wird nichts heruntergeladen. Diese Option ist wahrscheinlich in Verbindung mit dem DEHS\-System (und \fB\-\-dehs\fP) an nützlichsten. .TP \fB\-\-upstream\-version\fP \fIVersion_der_Ursprungsautoren\fP gibt die aktuelle Version der Ursprungsautoren an, statt die \fIwatch\fP\- oder \fIchangelog\fP\-Datei zu untersuchen, um sie zu bestimmen. Dies wird ignoriert, falls ein Verzeichnis\-Scan durchgeführt und mehr als eine \fIwatch\fP\-Datei gefunden wird. .TP \fB\-\-watchfile\fP \fIwatch\-Datei\fP gibt die \fIwatch\-Datei\fP an, statt einen Verzeichnis\-Scan durchzuführen, um sie zu bestimmen. Falls diese Option ohne \fB\-\-package\fP benutzt wird, muss \fBuscan\fP aus dem Debian\-Paketquellenverzeichnisbaum aufgerufen werden (so dass \fIdebian/changelog\fP einfach beim Hochlaufen des Verzeichnisbaums gefunden werden kann). .TP \fB\-\-download\-version\fP \fIVersion\fP gibt die Version an, zu der die Veröffentlichung der Ursprungsautoren passen muss, um anstelle der Veröffentlichung mit der höchsten Versionsnummer berücksichtigt zu werden. .TP \fB\-\-download\-current\-version\fP lädt die aktuelle paketierte Version herunter. .TP \fB\-\-verbose\fP erzeugt eine detaillierte Ausgabe. .TP \fB\-\-no\-verbose\fP erzeugt keine detaillierte Ausgabe. (Dies ist das Standardverhalten.) .TP \fB\-\-no\-exclusion\fP schließt Dateien, die in \fIdebian/copyright\fP im Feld \fBFiles\-Excluded\fP erwähnt wurden, nicht automatisch aus. .TP \fB\-\-debug\fP gibt die heruntergeladenen Webseiten auf der Standardausgabe (Stdout) für die Fehlersuche in Ihrer Watch\-Datei aus. .TP \fB\-\-check\-dirname\-level\fP \fIN\fP Die Erklärung dieser Option finden Sie im vorhergehenden Abschnitt \fBPrüfung von Verzeichnisnamen\fP. .TP \fB\-\-check\-dirname\-regex\fP \fIregulärer Ausdruck\fP Die Erklärung dieser Option finden Sie im vorhergehenden Abschnitt \fBPrüfung von Verzeichnisnamen\fP. .TP \fB\-\-user\-agent\fP, \fB\-\-useragent\fP setzt die vorgegebene User\-Agent\-Kopfzeile außer Kraft. .TP \fB\-\-no\-conf\fP, \fB\-\-noconf\fP keine Konfigurationsdateien lesen, Dies kann nur als erste auf der Befehlszeile angegebene Option benutzt werden. .TP \fB\-\-help\fP gibt eine kurze Gebrauchsinformation. .TP \fB\-\-version\fP zeigt Versionsinformationen. .SH KONFIGURATIONSVARIABLEN Die beiden Konfigurationsdateien \fI/etc/devscripts.conf\fP und \fI~/.devscripts\fP werden durch eine Shell in dieser Reihenfolge eingelesen, um Konfigurationsvariablen zu setzen. Diese können durch Befehlszeilenoptionen außer Kraft gesetzt werden. Zu diesem Zweck werden Umgebungsvariablen ignoriert. Falls die erste angegebene Befehlszeilenoption \fB\-\-noconf\fP ist, werden diese Dateien nicht gelesen. Die derzeit bekannten Variablen sind: .TP \fBUSCAN_DOWNLOAD\fP Falls dies auf \fIno\fP gesetzt ist, werden neuere Dateien der Ursprungsautoren nicht heruntergeladen; dies entspricht den Optionen \fB\-\-report\fP oder \fB\-\-no\-download\fP. .TP \fBUSCAN_PASV\fP Falls dies auf \fIyes\fP oder \fIno\fP gesetzt ist, wird dies erzwingen, dass FTP\-Verbindungen den PASV\-Modus verwenden beziehungsweise nicht verwenden. Falls dies auf \fIdefault\fP gesetzt ist, wird \fBNet::FTP\fP(3) eine Auswahl treffen (basiert hauptsächlich auf der Umgebungsvariable \fBFTP_PASSIVE\fP). .TP \fBUSCAN_TIMEOUT\fP Falls dies auf eine Zahl \fIN\fP gesetzt ist, wird eine Zeitüberschreitung nach \fIN\fP Sekunden eingestellt. Dies entspricht der Option \fB\-\-timeout\fP. .TP \fBUSCAN_SYMLINK\fP Falls dies auf \fIno\fP gesetzt ist, wird kein symbolischer Verweis für Paket_Version.orig.tar.{gz|bz2|lzma|xz} erstellt (entspricht der Option \fB\-\-no\-symlink\fP). Falls es auf \fIyes\fP oder \fIsymlink\fP gesetzt ist, dann werden symbolische Verweise erstellt. Falls es auf \fIrename\fP gesetzt ist, werden die Dateien umbenannt (entspricht der Option \fB\-\-rename\fP). .TP \fBUSCAN_DEHS_OUTPUT\fP Falls dies auf \fIyes\fP gesetzt ist, wird eine Ausgabe im DEHS\-Stil verwendet. Dies entspricht der Option \fB\-\-dehs\fP. .TP \fBUSCAN_VERBOSE\fP Falls dies auf \fIyes\fP gesetzt ist, wird eine detaillierte Ausgabe erzeugt. Dies entspricht der Option \fB\-\-verbose\fP. .TP \fBUSCAN_USER_AGENT\fP Falls gesetzt, wird die angegebene User\-Agent\-Zeichenkette anstelle der vorgegebenen benutzt. Dies entspricht der Option \fB\-\-user\-agent\fP. .TP \fBUSCAN_DESTDIR\fP Falls gesetzt, werden heruntergeladene Dateien in diesem Verzeichnis abgelegt. Dies entspricht der Option \fB\-\-destdir\fP. .TP \fBUSCAN_REPACK\fP Falls dies auf \fIyes\fP gesetzt ist, dann wird \fBuscan\fP nach dem Herunterladen ein Bzip\-Tar\-, LZMA\-Tar, Xz\-Tar\- oder Zip\-Archiv neu zu einem Gzip\-Tar packen. Dies entspricht der Option \fB\-\-repack\fP. .TP \fBUSCAN_EXCLUSION\fP Falls dies auf \fIno\fP gesetzt ist, werden im Feld \fBFiles\-Excluded\fP von \fIdebian/copyright\fP erwähnte Dateien ignoriert und es wird nicht versucht, Dateien auszuschließen. Dies entspricht der Option \fB\-\-no\-exclusion\fP. .SH EXIT\-STATUS Der Exit\-Status gibt einige Hinweise, ob eine neuere Version gefunden wurde oder nicht; es wird geraten, die Ausgabe zu lesen, um genau zu bestimmen, was geschehen ist und ob irgendwelche Warnungen zu beachten sind. .TP 0 Es wurde entweder \fB\-\-help\fP oder \fB\-\-version\fP benutzt oder es wurde für eine untersuchte \fIwatch\fP\-Datei eine neuere Version der Ursprungsautoren gefunden. .TP 1 Es wurde für keine der untersuchten \fIwatch\fP\-Dateien eine neuere Version der Ursprungsautoren gefunden. .SH "CHRONIK UND UPGRADES DURCHFÜHREN" Dieser Abschnitt beschreibt kurz die rückwärtsinkompatiblen \fIwatch\fP\-Dateifunktionalitäten, die in jeder \fIwatch\fP\-Dateiversion hinzugefügt wurden, und die erste Version des Devscripts\-Pakets, das sie verstand. .TP \fIVorversion 2\fP zu jener Zeit war die \fIwatch\fP\-Dateisyntax signifikant anders. Verwenden Sie sie nicht. Falls Sie ein Upgrade von einer \fIwatch\fP\-Datei vor Version 2 durchführen, wird Ihnen empfohlen, diese Handbuchseite zu lesen und von Grund auf neu zu beginnen. .TP \fIVersion 2\fP Devscripts\-Version 2.6.90: die erste Verkörperung des aktuellen \fIwatch\fP\-Dateistils .TP \fIVersion 3\fP Devscripts\-Version 2.8.12 führte das Folgende ein: korrekte Handhabung von Sonderzeichen regulärer Ausdrücke im Pfadteil, Verzeichnis\-/Pfadabgleich, Versionsnummern in mehreren Teilen, Versionsnummer\-Mangling. Neuere Versionen haben außerden URL\-Mangling eingeführt. Falls Sie ein Upgrade von Version 2 durchführen, besteht die Hauptinkomatibilität, wenn Sie mehrere Gruppen im Musterteil haben; während die erste in Version 2 benutzt würde, werden sie alle in Version 3 verwendet. Um dieses Verhalten zu vermeiden, ändern Sie die Nichtversionsnummergruppen so, dass sie (?:...)\- anstelle von einfachen (...)\-Gruppen sind. .SH "SIEHE AUCH" \fBdpkg\fP(1), \fBmk\-origtargz\fP(1), \fBperlre\fP(1), \fBuupdate\fP(1), \fBdevscripts.conf\fP(5) .SH AUTOR Die Originalversion wurde von Christoph Lameter geschrieben. Bedeutende Verbesserungen, Änderungen und Fehlerbehebungen wurden von Julian Gilbey vorgenommen. Piotr Roszatycki fügte HTTP\-Unterstützung hinzu. Das Programm wurde neu in Perl von Julian Gilbey geschrieben. .SH ÜBERSETZUNG Diese Übersetzung wurde mit dem Werkzeug .B po4a durch Chris Leick .I c.leick@vollbio.de im Juli 2012 erstellt und vom deutschen Debian-Übersetzer-Team korrekturgelesen. Bitte melden Sie alle Fehler in der Übersetzung an .I debian-l10n-german@lists.debian.org oder als Fehlerbericht an das Paket .IR devscripts . Sie können mit dem folgenden Befehl das englische Original anzeigen .RB "»" "man -L C" .IR "Abschnitt deutsche_Handbuchseite" "«."