cvs [GLOBALE_OPTIONEN] KOMMANDO [OPTIONEN] [DATEIEN]

Der zweite Satz von Optionen wird bisweilen »Kommandooptionen« genannt. Weil es aber so viele davon gibt, werden sie hier üblicherweise nur »Optionen« genannt, um etwas Platz zu sparen.

Viele Kommandos sind dazu gedacht, in einer Arbeitskopie angewendet zu werden, und können daher ohne Dateiargument ausgeführt werden. Diese Kommandos beziehen sich dann standardmäßig auf das derzeitige Verzeichnis und alle darin enthaltenen Verzeichnisse. Wenn ich mich also im Text auf die »Datei« oder »Dateien« beziehe, dann ist die Rede von den Dateien, auf denen CVS-Operationen ausführt. Je nachdem, wie Sie CVS aufgerufen haben, können diese Dateien also in der Kommandozeile aufgeführt sein oder auch nicht.

Datumsformate

Viele Optionen benötigen ein Datumsargument. CVS akzeptiert eine große Menge an unterschiedlichen Datumsformaten - zu viele, um sie hier aufzulisten. Im Zweifelsfall halten Sie sich an das ISO 8601-Format:

 

:METHODE:BENUTZER@RECHNER:PFAD_ZUM_ARCHIV

Hier ein paar Beispiele zu den üblichen Verbindungsarten:

:ext:jrandom@floss.red-bean.com:/usr/local/archiv - Baut eine Verbindung unter Verwendung von rsh, ssh oder eines anderen externen Programmes auf. Falls die CVS_RSH-Umgebungsvariable nicht gesetzt ist, ist die Standardeinstellung rsh, ansonsten wird der Wert dieser Variablen verwendet.

:server:jrandom@floss.red-bean.com:/usr/local/archiv - Wie :ext:, nutzt aber die interne rsh-Variante von CVS. (Diese Option ist möglicherweise nicht auf allen Plattformen verfügbar.)

:pserver:jrandom@floss.red-bean.com:/usr/local/archiv - Baut mit Hilfe des Passwortauthentifizierungs-Servers eine Verbindung auf (siehe »Der Passwortauthentifizierungs-Server« in Kapitel 4; siehe auch das login-Kommando).

:kserver:jrandom@floss.red-bean.com:/usr/local/archiv - Baut eine Verbindung mit Hilfe der Kerberos-Authentifizierung auf.

:gserver:jrandom@floss.red-bean.com:/usr/local/archiv - Baut eine Verbindung unter Verwendung der GSSAPI-Authentifizierung auf.

:fork:jrandom@floss.red-bean.com:/usr/local/archiv - Baut eine Verbindung zu einem lokalen Archiv auf, benutzt aber das Client/Server-Protokoll, anstatt direkt auf die Dateien zuzugreifen. Dies kann nützlich sein, um das Verhalten einer CVS-Konfiguration im Netz auf dem eigenen Rechner zu testen und Fehler zu suchen.

:local:jrandom@floss.red-bean.com:/usr/local/newrepos - Greift direkt auf ein lokales Archiv zu, so als wäre nur der absolute Pfad angegeben worden.

• - e EDITOR
  Startet EDITOR für Ihre commit-Mitteilung, falls diese nicht auf der Kommandozeile mit der -m-Option angegeben wurde. Normalerweise startet CVS den Editor abhängig vom Inhalt der Umgebungsvariablen CVSEDITOR, VISUAL oder EDITOR (in dieser Reihenfolge), falls keine Mitteilung mit -m angegeben wird. Falls alles schief geht, versucht CVS, den verbreiteten Unix-Editor »vi« zu starten.
  Wenn Sie sowohl -e also auch -m mit commit verwenden, wird das -e zu Gunsten der bei -m angegebenen Mitteilung ignoriert. (Daher ist es unproblematisch, -e in einer .cvsrc-Datei zu verwenden.)
• -f
  Diese globale Option unterbindet das Lesen der .cvsrc-Datei.
• --help [KOMMANDO]
• -H [KOMMANDO]
  Diese beiden Optionen bewirken dasselbe. Sollte kein KOMMANDO angegeben sein, dann wird in einer kurzen Ausgabe die Bedienung der Grundfunktionen erläutert.
• --help-options
  Gibt eine Liste aller verfügbaren Optionen für CVS samt kurzer Erklärung aus.
• --help-synonyms
  Gibt eine Liste aller CVS-Kommandos und ihrer Kurzformen (»up« für »update« usw.) aus.
• -l
  Unterdrückt das Mitschneiden dieses Kommandos in die CVSROOT/history-Datei im Archiv. Das Kommando wird zwar ausgeführt, aber es wird kein Eintrag in der History-Datei erzeugt.
• -n
  Ändert keine Datei in der Arbeitskopie oder im Archiv. Mit anderen Worten, diese Option führt zu einer Art Testlauf, in dem CVS zwar fast alle Kommandos abarbeitet, aber nichts wirklich verändert.
  Das kann nützlich sein, wenn Sie sehen wollen, was ein Kommando bewirkte, wenn Sie es tatsächlich anwenden würden. Ein übliches Szenario ist, wenn Sie sehen möchten, welche Dateien in Ihrem Arbeitsverzeichnis inzwischen verändert wurden, diese aber noch nicht aktualisieren möchten (was die Veränderungen aus dem Archiv in Ihre Dateien übertragen würde). Durch die Ausführung des Kommandos cvs -n update können Sie so eine Zusammenfassung der Veränderungen angezeigt bekommen, ohne Ihre Arbeitskopie der Daten anzutasten.
• -q
  Diese Option befiehlt CVS, etwas »leiser« zu arbeiten und unnötige Informationen nicht auszugeben. Was als notwendig angesehen wird, hängt hierbei von dem Kommando ab. Zum Beispiel werden bei der Aktualisierung die Nachrichten unterdrückt, die CVS normalerweise ausgibt, wenn es in ein neues Unterverzeichnis der Arbeitskopie eintritt - die einzeiligen Statusmeldungen über veränderte oder aktualisierte Dateien werden jedoch trotzdem angezeigt.
• -Q
  Wie -q, nur dass CVS hier lediglich die allernötigsten Informationen ausgibt. Kommandos, deren einziger Zweck es ist, Ausgaben zu erzeugen (wie z.B. diff und annotate), werden davon natürlich nicht beeinflusst. Hingegen geben Befehle, die unabhängig von irgendwelchen Ausgaben ihre Aufgabe erfüllen können (wie z.B. update und commit), nichts aus.
• -r
  Bewirkt, dass neue Arbeitsdateien ohne Schreibzugriff erzeugt werden (hat also dieselbe Wirkung wie die CVSREAD-Umgebungsvariable).
  Wenn Sie diese Option verwenden, werden bei Dateneinspielungen und -aktualisierungen die Dateien in Ihrer Arbeitskopie als nur lesbar markiert (sofern Ihr Betriebssystem diese Option unterstützt). Genau genommen habe ich keine Ahnung, warum je jemand diese Option verwenden sollte.
• -s VARIABLE=WERT
  Hiermit wird die interne CVS-Variable namens VARIABLE auf den Wert WERT gesetzt. Auf der Seite des Archivs können die CVSROOT/*info-Kontrolldateien solche Variablen in Werte übersetzen, die mit der -s-Option gesetzt wurden. Wenn zum Beispiel die Datei CVSROOT/loginfo eine Zeile wie diese enthält

 

myproj /usr/local/bin/foo.pl ${=FISCH}

und dann jemand ein commit von myproj wie folgt startet

 

floss$ cvs -s FISCH=Karpfen commit -m "Köder-Bug behoben"

dann wird das Skript foo.pl mit »Karpfen« als Argument gestartet. Man beachte jedoch die schräge Syntax: Das Dollarzeichen, die geschweifte Klammer und das Gleichheitszeichen - fehlt eines der drei, dann funktioniert die Zuweisung nicht korrekt. Variablennamen dürfen lediglich Buchstaben, Zahlen und Unterstriche enthalten. Obwohl es nicht unbedingt erforderlich ist, dass alle Buchstaben groß geschrieben werden, scheinen sich doch die meisten Leute an diese Konvention zu halten. Das -s-Flag kann in einem Kommando beliebig oft hintereinander verwendet werden. Falls sich jedoch eines der Kontrollskripten auf Variablen bezieht, die nicht beim Aufruf gesetzt wurden, dann wird zwar das Skript ausgeführt, aber eine Warnung an den Benutzer ausgegeben und keiner einzigen Variablen ihr Wert zugewiesen. Wenn zum Beispiel in loginfo Folgendes steht

 

myproj /usr/local/bin/foo.pl ${=FISCH} ${=VOGEL}

aber derselbe Befehl wie vorhin ausgeführt wird

 

floss$ cvs -s FISCH=Karpfen commit -m "Köder-Bug behoben"

dann bekommt der Benutzer, der den Befehl gestartet hat, eine Warnung wie

 

loginfo:31: no such user variable {$=BIRD}

und das Skript foo.pl wird ohne Argumente ausgeführt. Wenn das Kommando jedoch so aussieht:

 

floss$ cvs -s FISCH=Karpfen -s VOGEL=Geier commit -m "Köder-Bug behoben"

dann wird keine Warnung ausgegeben, und foo.pl wird wie erwartet mit den Argumenten Karpfen und Geier aufgerufen. In beiden Fällen würde der Commit selbst korrekt durchgeführt.

Bemerkung:

Obwohl all diese Beispiele commit verwenden, kann die Zuweisung von Variablen mit jedem CVS-Kommando geschehen, das eine CVSROOT/ Kontrolldatei auslöst - darum ist -s eine globale Option.

(Siehe auch den Abschnitt Archivverwaltungsdateien weiter hinten in diesem Kapitel zur Expansion von Variablen in Kontrolldateien.)

• -T DIR
  Speichert alle temporären Dateien in DIR anstatt da, wo CVS sie normalerweise ablegt. (Dies überschreibt im Besonderen den Wert der Umgebungsvariablen TMPDIR, falls sie existiert.) DIR sollte ein absoluter Pfad sein.
  Diese Option ist nützlich, falls Sie als Benutzer keinen Schreibzugriff auf die üblichen temporären Verzeichnisse besitzen.
• -t
  Verfolgt die Durchführung eines CVS-Kommandos. Dies veranlasst CVS genau alle Schritte anzuzeigen, die es durchführt, um einen Befehl auszuführen. Das kann sich besonders im Zusammenhang mit der Option -n als nützlich erweisen, damit Sie sich so im Detail die Effekte eines ungewöhnlichen Befehles im Voraus ansehen können, ohne ihn wirklich auszuführen. Die Option ist ebenfalls praktisch, um herauszufinden, warum ein Kommando nicht funktioniert.
• -v --version
  Veranlasst CVS, seine vollständige Version und Urheberrechtsangaben auszugeben.
• -w
  Bewirkt, dass neue Arbeitsdateien mit Schreibzugriff ausgestattet werden (überschreibt damit jeden Wert, den eventuell die Umgebungsvariable CVSREAD haben könnte). Weil normalerweise sowieso alle Dateien mit Schreibzugriff versehen werden, wird diese Option nur selten benutzt.
  
  Werden beide Optionen, -r und -w, angegeben, so gilt die -w-Option.
• -x
  Verschlüsselt jede Kommunikation mit dem Server. Diese Option hat keine Wirkung, solange nicht eine Verbindung via GSSAPI zum Server (gserver) besteht. GSSAPI-Verbindungen werden in diesem Buch nicht behandelt, weil sie immer noch eher selten benutzt werden - obwohl sich das ändern könnte). (Siehe auch die Abschnitte »Global Options« und »GSSAPI Authenticated« im Cederqvist mit mehr Informationen zu dieser Thematik.)
• -z GZIPLEVEL
  Stellt die Stärke der Datenkompression für die Verbindungen zum Server ein. Das Argument GZIPLEVEL muss eine Zahl zwischen eins und neun sein. Eins steht für minimale Kompression (dafür schnell); neun hingegen hat nur auf sehr schnellen Rechnern oder sehr langsamen Verbindungen Sinn (komprimiert sehr stark, braucht aber viel Rechenzeit). Die meisten Benutzer dürften Werte zwischen drei und fünf praktikabel finden. Das Leerzeichen zwischen -z und seinem Argument ist optional.

add [OPTIONS] FILES

Alternativen: ad, new
Erfordert: Arbeitskopie, Archiv
Ändert: Arbeitskopie

Fügt eine neue Datei einem existierenden Projekt hinzu. Obwohl das Archiv zur Bestätigung kontaktiert wird, wird die Datei dem Archiv nicht wirklich hinzugefügt, bis später commit ausgeführt wird. (Siehe auch remove und import.)

Optionen:

-kMETHODE
Spezifiziert, dass die Datei mit der angegebenen Methode zur Schlüsselwortersetzung abgespeichert werden soll. Zwischen -k und dem Argument ist kein Leerzeichen. (Für eine Liste gültiger Methoden und Beispiele siehe auch den Abschnitt »Schlüsselwortersetzung« weiter hinten in diesem Kapitel.)

-m MITTEILUNG
Vermerkt MITTEILUNG als ersten Eintrag zur Entstehung bzw. Beschreibung der Datei. Diese unterscheidet sich von dem Log-Eintrag bei späteren Revisionen - jede Datei hat nur genau eine Beschreibung. Die Beschreibung ist optional.

Bemerkung:

In Version 1.10.7 gibt es einen Fehler in CVS, der zum Verlust der Beschreibung führt, wenn eine Datei mittels Client/Server CVS hinzugefügt wird. Alle anderen Funktionen des add-Kommandos werden trotzdem einwandfrei ausgeführt, falls das ein Trost sein sollte.

admin [OPTIONEN] [DATEIEN]

Alternativen: adm, rcs
Erfordert: Arbeitskopie, Archiv
Ändert: Archiv

Dieses Kommando fungiert als Schnittstelle zu diversen administrativen Aufgaben - um genau zu sein Aufgaben, die sich auf einzelne RCS-Dateien innerhalb des Archivs beziehen, wie zum Beispiel die Veränderung der Schlüsselwortersetzungs-Methode oder die Veränderung einer Log-Mitteilung, nachdem diese bereits per commit gespeichert wurden.

Obwohl admin rekursiv arbeitet, sofern keine Dateiargumente übergeben wurden, ist es in den meisten Fällen sinnvoller, Dateien konkret zu spezifizieren. Es hat nur selten Sinn, einen admin-Befehl auf alle Dateien eines Projektes oder auch nur eines ganzen Verzeichnisses anzuwenden. Dementsprechend beziehen sich alle Erklärungen, die mit einer »Datei« zu tun haben, im Folgenden auf die im Befehl angegebene Datei, manchmal Dateien.

Bemerkung:

Falls es auf dem Rechner mit dem Archiv eine Benutzergruppe namens »cvsadmin« gibt, so dürfen nur zu dieser Gruppe gehörige Benutzer das admin-Kommando ausführen. (Ausnahme: cvs admin -k ist für alle erlaubt.) So können Sie admin für alle Benutzer sperren, indem Sie diese Gruppe leer lassen.

Optionen:

-AALTE_DATEI (Überholt)
Hängt die RCS-Zugriffsliste der Datei ALTE_DATEI an die Zugriffsliste der behandelten Datei an. CVS ignoriert RCS-Zugriffslisten, daher ist diese Option nutzlos.

-a BENUTZER1 [,BENUTZER2...] (Überholt)
Hängt die BENUTZER in der durch Kommata separierten Liste der Zugriffsliste der behandelten Datei an. Wie -A ist auch diese Option wirkungslos.

-bREV
Setzt die Revision des Standardverzeichnisbaumes der Datei (üblicherweise des Wurzelverzeichnisses) auf REV. Normalerweise werden Sie diese Option nicht benötigen, da Sie die Revisionen, die Sie benötigen, über bindende Markierungen erhalten, aber Sie könnten Sie verwenden, um zu einer Vertriebsversion zurückzukehren, falls Sie entsprechende Archivbereiche führen. Es sollte sich zwischen -b und seinem Argument kein Leerzeichen befinden.

-cKOMMENTAR_PREFIX (Überholt)
Setzt das Kommentarzeichen der Datei auf KOMMENTAR_PREFIX. Dieses wird weder von CVS noch von aktuellen RCS-Versionen verwendet. Diese Option ist daher wirkungslos.

-eBENUTZER1 [,BENUTZER2...] (Überholt)
Gegenstück zu -a: Entfernt Benutzernamen aus der Zugriffsliste. Ebenso wirkungslos wie -a und -A.

-i oder -I (Überholt)
Diese beiden sind so alt und überholt, dass ich nicht einmal auf ihre frühere Bedeutung eingehe. Neugierige mögen das Cederqvist befragen.

-kMETHODE
Setzt die Methode der Schlüsselwortersetzung für die Datei auf METHODE. Diese Option verhält sich wie die -k-Option des add-Befehls, nur dass man hier die Methode ändern kann, nachdem die Datei dem Archiv hinzugefügt wurde. (Siehe auch den Abschnitt zur Schlüsselwortersetzung weiter hinten in diesem Kapitel.) Zwischen -k und seinem Argument darf sich kein Leerzeichen befinden.

-L
Setzt das Locking der Datei auf »strikt« (siehe -l).

-l[REV]
Legt die Revision der Datei auf REV fest. Fehlt REV, so wird die neueste verfügbare Revision auf dem Hauptentwicklungszweig gehalten. Wenn REV ein Zweig des Archivs ist, so wird die aktuellste Revision in diesem Zweig des Archivs festgehalten (»Locking«).
Der Zweck dieser Option ist, Ihnen eine Möglichkeit zu geben, »reservierte Checkouts« zu machen, bei denen nur ein Benutzer auf einmal die Datei bearbeiten kann. Ich bin nicht sicher, wie nützlich diese Option wirklich ist, aber wenn Sie sie ausprobieren möchten, sollten Sie das eventuell in Verbindung mit dem rcslock.pl-Skript aus dem contrib/-Verzeichnis der CVS Quelltextdistribution machen. Siehe auch die Kommentare in jener Datei für weitere Informationen. Unter anderem weisen diese Kommentare darauf hin, dass das Locking auf strikt gesetzt werden muss (siehe -L). Zwischen -l und dem Argument ist kein Leerzeichen.

-mREV:MITTEILUNG
Ändert die Log-Mitteilung für die Revision REV auf MITTEILUNG. Sehr praktisch - neben -k ist dies die wohl meist genutzte Option zu admin. Es sind keine Leerzeichen vor dem Argument oder um den Doppelpunkt herum gestattet. Natürlich darf MITTEILUNG trotzdem Leerzeichen enthalten (dann aber bitte die MITTEILUNG in Anführungszeichen setzen, damit die Shell nicht durcheinander kommt!).

-NNAME[:[REV]]
Wie -n, nur dass es das Überschreiben jeder existierenden Zuweisung des symbolischen Namens NAME erzwingt, anstatt mit einer Fehlermeldung auszusteigen.

-nNAME[:[REV]]
Es handelt sich hier um eine allgemeine Schnittstelle zur Zuweisung, Umbenennung und zum Löschen von Markierungen. Soweit ich das beurteilen kann, gibt es keinen Grund, diese Option dem tag-Kommando und seinen vielfältigen Optionen vorzuziehen (-d, -r, -b, -f usw.). Ich empfehle daher die Benutzung des tag-Befehls. Der NAME und die Optionale REV können sich auf folgende Arten zusammensetzen:

• Falls nur das NAME-Argument angegeben wurde, wird der symbolische Name (tag) namens NAME gelöscht.
• Falls NAME: angegeben wurde, aber kein REV, so wird NAME der aktuellsten Revision des Standardverzeichnisbaumes (üblicherweise der Hauptentwicklungslinie) zugewiesen.
• Falls NAME:REV gegeben ist, wird NAME der Revision zugeordnet. REV kann wiederum ein symbolischer Name sein, dann wird es zunächst in eine Revisionsnummer übersetzt (kann auch die Nummer einer abgezweigten Version sein).
• Falls REV die Nummer einer abgezweigten Version ist und ein Punkt folgt (».«), dann wird NAME der aktuellsten Revision auf dieser abgezweigten Version zugewiesen. Ist REV nur $, dann wird NAME den Revisionsnummern zugeordnet, die in den Schlüsselwörtern der behandelten Datei(en) gefunden werden.

In allen Fällen, in denen ein Name zugewiesen wird, beendet sich CVS mit einer Fehlermeldung, sofern schon eine Marke namens NAME in der Datei existiert. (Ausnahme: siehe -N.) Es sind keine Leerzeichen zwischen -n und seinen Argumenten.

-oBEREICH
Löscht die Revisionen, die durch BEREICH spezifiziert werden (auch bekannt als »Outdating«, daher -o). BEREICH kann wie folgt angegeben werden:

REV1::REV2 - Vernichtet alle Revisionen zwischen REV1 und REV2, sodass in der Revisionshistorie REV2 direkt auf REV1 folgt. Nach dieser Aktion sind alle Versionen dazwischen nicht mehr existent, und es gibt einen Sprung in der Folge der Revisionen.

::REV - Löscht alle Revisionen vom Anfang dieser abgezweigten Version (die auch die Hauptentwicklungslinie sein kann) bis hin zu REV, natürlich nicht inklusive REV. Danach ist REV die erste Revision in diesem Bereich.

REV:: - Schreddert alle Revisionen, die in dieser abgezweigten Version (die auch die Hauptentwicklungslinie sein kann) auf REV folgen. REV ist dann die letzte Revision in diesem Bereich.

REV - Löscht Revision REV. (-o1.8 wäre äquivalent zu -o1.7::1.9.)

REV1:REV2 - Löscht von REV1 bis REV2 inklusive! Sie müssen im selben Entwicklungszweig sein. Danach ist es unmöglich, auf REV1, REV2 und alle Revisionen dazwischen zuzugreifen.

:REV - Löscht Revisionen vom Anfang des Entwicklungszweiges bis REV inklusive. (Siehe vorhergehende Warnung.)

REV: - Löscht beginnend mit REV bis zum Ende der abgezweigten Version inklusive. (Siehe vorhergehende Warnung.)

Bemerkung:

Keine der zu löschenden Revisionen darf Entwicklungszweige oder Locks haben. Sollten irgendwelchen der betroffenen Revisionen symbolische Namen zugewiesen sein, müssen diese zunächst mit tag -d oder admin -n gelöscht werden. (Genau genommen schützt CVS momentan nur dann gegen das Löschen symbolisch benannter Revisionen, wenn die »::«-Notation verwendet wird, aber die »:«-Notation könnte sich diesem Verhalten bald anpassen.)

Anstatt diese Option zu nutzen, um ein fehlerhaftes Commit zu löschen, sollten Sie eine neue Version per Commit in das Archiv bringen, welche die fehlerhafte Änderung wieder in Ordnung bringt. Es gibt keine Leerzeichen zwischen -o und seinen Argumenten.

-q
Stellt CVS ruhig - keine unnötigen Mitteilungen werden generiert (genau wie mit der globalen Option -q).

-sSTATUS[:REV]
Setzt das Statusattribut der Revision REV auf STATUS. Wird REV weggelassen, so wird die aktuellste Revision des Hauptentwicklungszweiges angenommen. Ist REV eine Markierung oder Nummer einer abgezweigten Version, dann wird die aktuellste Revision auf dieser abgezweigten Version verwendet. Beliebige Buchstaben- oder Nummernfolgen für STATUS werden akzeptiert. Einige übliche Statusbezeichnungen sind Exp für experimentell, Stab für stabil und Rel für released (veröffentlicht). (Tatsächlich setzt CVS den Status automatisch auf Exp, wenn eine Datei neu erzeugt wird.) Beachten Sie, dass CVS die Statusbezeichnung dead für eigene Zwecke verwendet, also geben Sie diese bitte nicht an. Statusinformationen werden in der cvs log-Ausgabe sowie in den $Log- und $State-RCS-Schlüsselwörtern in Dateien ausgegeben. Zwischen -s und seinem Argument sind keine Leerzeichen.

-t[BESCHREIBUNGSDATEI]
Ersetzt die Beschreibung (den Log-Eintrag zur Entstehung) für die Datei durch den Inhalt von BESCHREIBUNGSDATEI oder liest diesen von der Standardeingabe, falls keine BESCHREIBUNGSDATEI angegeben wurde.
Diese nützliche Option funktioniert - leider - momentan nicht im Client/Server-CVS. Außerdem wird jede existierende Beschreibung einer Datei gelöscht und durch einen leeren String ersetzt, falls man versucht, diese Option im Client/Server-CVS ohne Angabe von BESCHREIBUNGSDATEI zu verwenden. Wenn Sie die Beschreibung einer Datei erneuern müssen, dann tun Sie dies bitte nur lokal auf der Maschine mit dem Archiv, oder benutzen Sie die Option -t-BESCHREIBUNG. BESCHREIBUNGSDATEI darf nicht mit einem Bindestrich (»-«) beginnen (siehe -t-BESCHREIBUNG).

-t-BESCHREIBUNG
Wie -t, nur dass hier BESCHREIBUNG direkt als Beschreibung verwendet wird. BESCHREIBUNG darf Leerzeichen enthalten, wenn sie mit Anführungszeichen eingeschlossen wird. Diese Variante funktioniert im Client/Server-CVS und auch lokal ohne Probleme.

-U
Setzt das Locking auf »nicht strikt«. (Siehe auch -l und -L weiter oben.)

-u[REV]
Hebt die Sperrung der Revision REV auf (siehe -l.) Wird REV weggelassen, so entsperrt CVS die aktuellste durch den Aufrufer gesperrte Revision. Ist REV ein Entwicklungszweig, dann entsperrt CVS die aktuellste gesperrte Revision in dieser abgezweigten Version. Wenn jemand anders als der Sperrer einer Revision die Sperre wieder aufhebt, so wird an denjenigen, der die Sperrung vorgenommen hat, eine E-Mail verschickt. Die Person, welche die Sperre aufhebt, wird auf der Kommandozeile um eine Stellungnahme für die E-Mail gebeten. Zwischen -u und seinem Argument ist kein Leerzeichen.

-VRCS_VERSIONSNUMMER (Überholt)
Dies war einmal ein Weg, um CVS zur Erzeugung von RCS-Dateien zu bewegen, die zu früheren RCS-Versionen kompatibel waren. Inzwischen weicht das RCS-Format, das CVS benutzt, zunehmend von dem RCS-Format, das RCS verwendet, ab, sodass diese Option nutzlos geworden ist. Die Angabe dieser Option führt zu einer Fehlermeldung.

-xENDUNG (Überholt)
Theoretisch kann man mittels dieser Option die Dateiendung der RCS-Dateien bestimmen. Leider verlassen sich CVS und seine Werkzeuge darauf, dass diese Endung standardmäßig ist (»,v«), daher bewirkt diese Option nichts.

annotate [OPTIONEN] [DATEIEN]

Alternativen: ann
Erfordert: Arbeitskopie, Archiv
Ändert: Nichts

Zeigt Informationen darüber an, wer zuletzt welche Zeile jeder Datei geändert hat und wann. Jede Ausgabezeile entspricht einer Zeile der Datei. Von links nach rechts beinhaltet die Zeile die Revisionsnummer der letzten Modifikation der Zeile, einen in Klammern stehenden Ausdruck, der den Benutzer und das Datum der letzten Änderung beinhaltet, einen Doppelpunkt und den Inhalt der Zeile in der Datei.

Wenn zum Beispiel eine Datei so aussieht:

checkout [OPTIONEN] PROJEKT(E)

Alternativen: co, get
Erfordert: Archiv
Ändert: Aktuelles Verzeichnis

Extrahiert ein Modul aus dem Archiv in eine lokale Arbeitskopie. Die Arbeitskopie wird neu erzeugt, falls sie nicht existiert, und aktualisiert, falls sie bereits existiert (siehe auch »update«.)

Optionen:

-A
Setzt alle bindenden Markierungen (Sticky Tags), Datumsangaben oder Schlüsselwortersetzungs-Modi zurück. Diese Option entspricht der -A-Option für den update-Befehl und wird dort wahrscheinlich häufiger genutzt als hier bei checkout.

-c
Bewirkt, dass praktisch kein Checkout stattfindet; nur die CVSROOT/modules-Datei wird sortiert auf die Standardausgabe ausgegeben. Dies ist eine gute Methode, um einen Überblick darüber zu bekommen, welche Projekte sich in einem Archiv befinden. Projekte ohne Eintrag in der modules-Datei werden jedoch nicht aufgelistet. (Das ist ganz normal, weil der Name des Hauptverzeichnisses eines Projektes im Archiv standardmäßig als der Modulname des Projektes dient.)

-D DATUM
Führt einen Checkout der letzten Revisionen bis DATUM aus. Diese Option ist bindend, d.h. Sie können anschließend aus der Arbeitskopie keinen Commit mehr durchführen, ohne das gebundene Datum zurückzusetzen (siehe -A). Diese Option impliziert -P, siehe unten.

-d VERZ
Erzeugt die Arbeitskopie in einem Verzeichnis VERZ, anstatt ein Verzeichnis mit dem Namen des vom Checkout betroffenen Moduls zu erzeugen. Wenn Sie nur einen Teil eines Projektes behandeln und dieser Teil irgendwo unterhalb des Wurzelverzeichnisses des Projektes liegt, werden die lokalen leeren Zwischenverzeichnisse weggelassen. Sie können -N benutzen, um diese Sparmaßnahme zu unterbinden.

-f
Erzwingt einen Checkout der ersten Revision, falls die angegebene Marke oder das angegebene Datum nicht gefunden wurde. Wird häufig in Verbindung mit -D oder -r verwendet, um sicherzustellen, dass der Checkout in jedem Fall erfolgreich ist.

-j REV[:DATUM] oder -j REV1[:DATUM] -j REV2[:DATUM]
Führt zwei Entwicklungslinien zu einer zusammen. Diese Option entspricht der -j-Option zu update, die wesentlich häufiger Verwendung findet (siehe update für weitere Details).

-k METHODE
Setzt die Methode zur Schlüsselwortersetzung für RCS auf METHODE (so kann die standardmäßig eingestellte Methode für die behandelten Dateien verändert werden). Siehe auch den Abschnitt zur Schlüsselwortersetzung weiter hinten in diesem Kapitel. Die gewählte Methode wird permanent an die betroffenen Dateien gebunden - spätere Updates der Arbeitskopie werden sie beibehalten.

-l
Lokal; führt lediglich einen Checkout auf die Hauptentwicklungslinie des Projektes aus. Unterverzeichnisse werden nicht behandelt.

-N
Unterdrückt das Weglassen leerer Unterverzeichnisse mit der -d-Option.

-n
Führt keines der Checkout-Programme aus, die in CVSROOT/modules mit der -o-Option angegeben sind. (Siehe auch den Abschnitt »Archivverwaltungsdateien« weiter hinten in diesem Kapitel für weitere Informationen.)

-P
Löscht leere Verzeichnisse in der Arbeitskopie (entsprechend der -P-Option zu update).

-p
Führt einen Checkout auf die Standardausgabe durch, nicht in Dateien (entsprechend der -p-Option zu update).

-R
Behandelt auch rekursiv Unterverzeichnisse (dies ist der Normalfall). Siehe auch die -f-Option.

-r MARKE
Führt einen Checkout der mit MARKE bezeichneten Revision durch. (Es würde kaum Sinn haben, hier eine numerische Revision (REV) zu verwenden, möglich ist es dennoch!) Diese Option bindet die mit MARKE bezeichnete Revision und impliziert -P.

-s
Wie -c, zeigt aber den Status jedes Moduls und sortiert nach Status. (Siehe auch »CVSROOT/modules« im Abschnitt »Archivverwaltungsdateien«.)

commit [OPTIONEN] [DATEIEN]

Alternativen: ci, comm
Erfordert: Arbeitskopie, Archiv
Ändert: Archiv (und Verwaltungsdateien der Arbeitskopie)

Überträgt Änderungen einer Arbeitskopie in das Archiv.

Optionen:

-F MITTEILUNGSDATEI
Benutzt den Inhalt der MITTEILUNGSDATEI für den Log-Eintrag, anstatt einen Editor zu aktivieren. Diese Option kann nicht mit -m kombiniert werden.

-f
Erzwingt die Aktualisierung des Archivs mit einer neuen Revision, auch wenn keinerlei Änderungen in der Arbeitskopie gemacht wurden. Commit arbeitet mit dieser Option nicht rekursiv (d.h. es impliziert -l). Rekursion kann mit der Option -R erzwungen werden.

diff [OPTIONEN] [DATEIEN]

Alternativen: di, dif
Erfordert: Arbeitskopie, Archiv
Ändert: Nichts

Zeigt die Unterschiede zwischen zwei Revisionen (im Unix diff-Format) an. Wenn diff ohne weitere Optionen aufgerufen wird, dann zeigt CVS die (möglicherweise noch nicht durch einen Commit abgeglichenen) Unterschiede zwischen den Basisrevisionen im Archiv und der Arbeitskopie an. Die »Basis«-Revisionen bezeichnen dabei die letzten Revisionen, die aus dieser Arbeitkopie heraus vom Archiv bezogen wurden. Beachten Sie, dass es durchaus neuere Revisionen im Archiv geben könnte, nämlich dann, wenn jemand anderes zwischenzeitlich einen Commit irgendwelcher Änderungen vorgenommen hat, die noch nicht mit einem Update in diese Arbeitskopie übernommen wurden.

Optionen:

-D DATUM
Erzeugt ein Diff gegen die neueste Revision, die nicht älter als DATUM ist. Diese Option verhält sich wie -r REV, außer dass statt der Revision ein Datum Verwendung findet.

-k METHODE
Expandiert RCS-Schlüsselwörter in den Diffs unter Verwendung der angegebenen METHODE. (Siehe auch den Abschnitt »Schlüsselwortersetzung« weiter hinten in diesem Kapitel.)

-l
Lokal; vergleicht nur Dateien aus dem aktuellen Verzeichnis. Unterverzeichnisse werden nicht berücksichtigt.

-r REV oder -r REV1 -r REV2
Vergleicht entweder die aktuelle mit der angegebenen oder die beiden angegebenen Revisionen miteinander. Mit einer -r-Option wird die mit REV bezeichnete Revision aus dem Archiv mit der aktuellen Arbeitskopie verglichen. Bei Angabe zweier -r-Argumente wird der Unterschied zwischen den jeweils angegebenen Revisionen aus dem Archiv ermittelt. Im letzteren Fall spielt die Arbeitskopie keine Rolle, und die Revisionen können in beliebiger Reihenfolge angegeben werden - die Ausgabe spiegelt dann die »Richtung« des Vergleichsvorganges wider. Wird -r ganz weggelassen, so wird zwischen der Arbeitskopie und der Revision, worauf letztere basiert, verglichen.

Diff-Kompatibilitätsoptionen

Zusätzlich zu den angegebenen Optionen verwendet cvs diff noch einige Optionen, die mit der GNU-Version des normalen Kommandozeilenprogrammes diff übereinstimmen. Es folgt eine komplette Liste dieser Optionen, zusammen mit einer Erklärung einiger der üblicherweise am häufigsten verwendeten. (Für weitere Informationen siehe auch die GNU diff-Dokumentation.)

History-Ausgabe

Die Ausgabe des history-Befehls ist eine Folge von Zeilen; jede Zeile stellt ein Ereignis aus der History-Datei dar und beginnt mit einem einzelnen Symbolbuchstaben, der die Art des Ereignisses signalisiert. Zum Beispiel:

 

$Revision$

in einer Datei zu einem Ausdruck wie

 

$Revision: 1.5 $

und CVS wird bei jedem Commit einer neuen Revision diese Textstelle auf dem neuesten Stand halten.

Schlüsselwort-Expansion kontrollieren

Normalerweise expandiert CVS Schlüsselwörter, solange Sie ihm nicht befehlen, das nicht zu tun. Sie können die Schlüsselwortersetzung für eine Datei permanent verhindern, indem Sie die -k-Option angeben, wenn Sie die Datei dem Projekt hinzufügen, oder Sie können sie später deaktivieren, indem Sie den Befehl admin mit der Option -k aufrufen. Die -k-Option bietet mehrere verschiedene Methoden der Schlüsselwortkontrolle; üblicherweise werden Sie o oder b benötigen, wie zum Beispiel:

Gemeinsame Syntax

In allen Verwaltungsdateien markiert ein # am Zeilenbeginn einen Kommentar; diese Zeile wird von CVS nicht beachtet. Ein Backslash »\« vor einem Zeilenende bewirkt das Ignorieren des Zeilenumbruchs.

Einige der Dateien (commitinfo, loginfo, taginfo und rcsinfo) haben weitere syntaktische Konventionen gemeinsam. Innerhalb dieser Dateien befindet sich am linken Rand jeder Zeile ein regulärer Ausdruck (der mit einem Datei- oder Verzeichnisnamen verglichen wird), und der Rest der Zeile ist ein Programmaufruf, eventuell mit Argumenten, der ausgeführt wird, sobald irgendetwas mit der Datei geschieht, auf die der reguläre Ausdruck passt. Das Programm wird mit dem Hauptverzeichnis des Archivs als Arbeitsverzeichnis gestartet.

In diesen Dateien dürfen zwei spezielle reguläre Ausdrücke verwendet werden: ALL und DEFAULT. Der Ausdruck ALL passt für jeden beliebigen Datei- oder Verzeichnisnamen, egal ob noch andere Ausdrücke dafür passen oder nicht, und DEFAULT wird nur verwendet, falls keiner der anderen Ausdrücke passt.

Gemeinsame Variablen

Die Info-Dateien erlauben des Weiteren die Expansion gewisser Variablen zur Laufzeit. Um eine Variable zu expandieren, muss ihr ein Dollarzeichen vorangestellt sein (und setzen Sie sie in geschweifte Klammern, um sicherzugehen). Es folgen die Variablen, die CVS bekannt sind:

${CVSROOT}
Das Hauptverzeichnis des Archivs

${RCSBIN} (Überholt)
Benutzen Sie diese Variable nicht. Sie findet nur noch in alten CVS-Versionen (1.9.18 und älter) Verwendung.

${CVSEDITOR} ${VISUAL} ${EDITOR}
Alle diese Variablen expandieren zu dem Editor, den CVS für Log-Mitteilungen verwendet.

${USER}
Der Benutzer, der CVS laufen lässt (auf der Serverseite).

Liste der Archivverwaltungsdateien

Es folgt eine Liste aller Archivverwaltungsdateien:

.cvsrc

Enthält Optionen, die Sie automatisch bei jedem Aufruf von CVS-Kommandos verwenden möchten. Das Format jeder Zeile ist

.cvsignore

Definiert zusätzliche Muster zum Ignorieren von Dateien. (Siehe »cvsignore« im Abschnitt »Archivverwaltungsdateien« in diesem Kapitel zur Syntax.)

Sie können eine .cvsignore-Datei in Ihrem Home-Verzeichnis haben, die stets verwendet werden wird, wenn Sie CVS benutzen. Sie können zudem verzeichnisspezifische Dateien in jedem Projektverzeichnis einer Arbeitskopie haben. Letztere wirken dann nur auf das Verzeichnis, in dem sie abgelegt sind, und nicht in dessen Unterverzeichnissen. (Siehe auch $CVSIGNORE im Abschnitt »Umgebungsvariablen« in diesem Kapitel.)

.cvspass

Speichert Passwörter für jedes Archiv, auf das Sie mit der pserver-Methode zugreifen. Jede Zeile hat die Form:

.cvswrappers

Hierbei handelt es sich um eine client-seitige Version der cvswrappers-Datei. (Siehe den Abschnitt »Archivverwaltungsdateien« in diesem Kapitel.) Eine .cvswrappers-Datei darf sich in Ihrem Home-Verzeichnis sowie in jedem Verzeichnis der Arbeitskopie befinden, genau wie bei .cvsignore.

CVS/Base/ (Verzeichnis)

Sollten »Watches« (siehe Kapitel 6) aktiviert sein, speichert cvs edit die Originalversion der Datei in diesem Verzeichnis. So kann cvs unedit auch dann funktionieren, wenn der Server gerade nicht erreichbar ist.

CVS/Baserev

Liste der Revisionen jeder Datei in Base/. Jede Zeile sieht so aus:

CVS/Baserev.tmp

Die temporäre Datei zur vorhergehenden. (Siehe »CVS/Notify.tmp« oder »CVS/Entries.Backup« später in diesem Abschnitt zur Erklärung.)

CVS/Checkin.prog

Nimmt den Namen des Programmes auf, das zu der -i-Option in der Datei modules angegeben ist. (Siehe auch den Abschnitt »Archivverwaltungsdateien« in diesem Kapitel.)

CVS/Entries

Speichert die Revisionen für die Dateien in diesem Verzeichnis. Jede Zeile hat die Form:

CVS/Entries.Backup

Das ist nur eine temporäre Datei. Wenn Sie irgendein Programm schreiben, das die Datei Entries modifizieren soll, dann lassen Sie es das Ergebnis zunächst in die Datei Entries.Backup schreiben, und sie danach automatisch in »Entries« umbenennen.

CVS/Entries.Log

Hierbei handelt es sich im Grunde um einen Patch, der Entries hinzugefügt wird, nachdem Entries gelesen wurde (ein Hack aus Effizienzgründen, um nicht wegen jeder Kleinigkeit die ganze Entries-Datei neu schreiben zu müssen). Das Format ist im Grunde dasselbe wie bei Entries, nur dass hier jede Zeile mit einem Kürzel beginnen muss: Ein »A« (add) bedeutet, dass diese Zeile dem Inhalt von Entries hinzugefügt werden muss; »R« (remove), dass sie dem Inhalt von Entries abgezogen werden soll. Andere Buchstaben werden ignoriert, um zukünftige Erweiterungen zu erlauben.

CVS/Entries.Static

Wenn diese Datei existiert, so wurde nur ein Teil des Verzeichnisses aus dem Archiv übertragen, und CVS wird keine weiteren Dateien in diesem Verzeichnis erzeugen. Dieser Zustand kann normalerweise durch ein update -d behoben werden.

CVS/Notify

Speichert Benachrichtigungen, die noch nicht an den Server geschickt wurden.

CVS/Notify.tmp

Die temporäre Datei zu Notify. Die übliche Vorgehensweise zur Modifikation von Notify ist Notify.tmp zu schreiben und dann in »Notify« umzubenennen.

CVS/Repository

Der Pfad zu dem projektspezifischen Unterverzeichnis im Archiv. Das kann eine absolute Angabe sein oder eine relativ zu dem Pfad, der in Root angegeben ist.

Diese Datei ist immer vorhanden.

CVS/Root

Dies ist das Archiv; d.h. der Wert der CVSROOT-Umgebungsvariablen oder des Arguments zu der globalen Option -d.

Diese Datei ist immer vorhanden.

CVS/Tag

Ist eine Markierung oder ein Datum an dieses Verzeichnis gebunden, so wird das in der ersten Zeile dieser Datei vermerkt. Das erste Zeichen ist ein einzelner Buchstabe, der den Typ der Bindung bestimmt: »T«, »N«, oder »D« bezeichnen, ob es sich um die Bezeichnung eines Zweiges, einen symbolischen Namen (Marke) oder ein Datum handelt. Der Rest der Zeile ist die Markierung respektive das Datum selbst.

CVS/Template

Enthält eine Vorlage für Log-Mitteilungen entsprechend der Vorgabe durch die rcsinfo-Datei. (Siehe den Abschnitt »Archivverwaltungsdateien« weiter vorn in diesem Kapitel.) Diese Datei ist nur für externe Arbeitskopien von Bedeutung; lokale Arbeitskopien auf demselben Rechner wie das Archiv lesen rcsinfo direkt aus dem Archiv.

CVS/Update.prog

Enthält den Namen des Programmes, das mittels der -u-Option in der Datei modules angegeben wurde. (Siehe den Abschnitt »Archivverwaltungsdateien« in diesem Kapitel.)

$COMSPEC

Wird nur in OS/2 verwendet; sie enthält den Namen des Kommando-Interpreters. Standardwert ist: »CMD.EXE«.

$CVS_CLIENT_LOG

Wird zur Fehlerbeseitigung im Client/Server-Protokoll verwendet. Wenn Sie in diese Variable einen Dateinamen schreiben, bevor Sie CVS starten, so wird der gesamte eingehende Datenverkehr in Dateiname.in, der ausgehende in Dateiname.out abgespeichert.

$CVS_CLIENT_PORT

Wird für Kerberos-authentisierten Client/Server-Zugriff benötigt.

$CVSEDITOR

Enthält den Namen des Editors, der zum Erstellen von Log-Mitteilungen genutzt werden soll. Diese Variable hebt eventuelle Definitionen in $EDITOR oder $VISUAL auf.

$CVSIGNORE

Eine durch Leerzeichen getrennte Liste von Namen und Wildcards, die von CVS ignoriert werden sollen. (Siehe auch die -I-Option des import-Kommandos.) Der Inhalt dieser Variablen wird jeder Ignore-Liste eines Kommandos als Letztes angehängt. Letztere Liste wird in der folgenden Reihenfolge aufgebaut: CVSROOT/cvsignore, die Datei .cvsignore in Ihrem Home-Verzeichnis, die $CVSIGNORE-Umgebungsvariable, möglicherweise per -I angegebene Optionen und zuletzt der Inhalt der .cvignore-Dateien in den jeweils bearbeiteten Unterverzeichnissen der Arbeitskopie. Ein »!« als Ignore-Muster an einem beliebigen Punkt dieser Liste löscht die gesamte Liste bis zu diesem Punkt.

$CVS_IGNORE_REMOTE_ROOT

Seit kurzem überholt.

$CVS_PASSFILE

Weist CVS an, eine andere Datei als .cvspass im Home-Verzeichnis für Authentisierungsdaten zu benutzen. (Siehe ».cvspass« im Abschnitt »Laufzeit-Kontrolldateien« in diesem Kapitel.)

$CVS_RCMD_PORT

Spezifiziert die Port-Nummer, auf welcher der rcmd-Daemon auf dem Server kontaktiert werden kann. (Diese Variable wird momentan von Unix CVS-Clients ignoriert.)

$CVSREAD

Setzt Dateien in der Arbeitskopie beim Checkout und Update nach Möglichkeit auf »nur lesbar«. Die Standardeinstellung ist »lesen und schreiben«. (Siehe auch die globale Option -r.)

$CVSROOT

Diese Variable enthält den Pfad zum Archiv und kann durch die globale Option -d oder durch das innerhalb einer Arbeitskopie gespeicherte Archiv aufgehoben werden. Dem Pfad kann gemäß folgender Syntax eine Zugriffsmethode, ein Benutzer- und ein Rechnername vorangestellt werden:

$CVS_RSH

Enthält den Namen des externen Programmes, das zur Verbindung mit dem Server für die Zugriffsmethode :ext: verwendet wird. Normaler Wert ist rsh, aber ssh ist eine übliche Alternative dazu.

$CVS_SERVER

Enthält den Namen des Programms zum Aufruf von CVS auf der Serverseite. Ist natürlich standardmäßig auf cvs gesetzt.

$CVS_SERVER_SLEEP

Verzögert den Start des Serverprozesses beim Aufruf um die in dieser Variablen angegebene Zahl an Sekunden. Wird nur bei der Fehlersuche benötigt, damit der Debugger Zeit hat, die Kontrolle zu übernehmen.

$CVSUMASK

Enthält die Standardeinstellung für Schreib-/Lesezugriffe auf Dateien im Archiv. (Am besten gar nicht benutzen - es funktioniert sowieso nicht mit Client/Server-CVS.)

$CVSWRAPPERS

Eine durch Leerzeichen separierte Liste von Dateinamen, Wildcards und Argumenten, die CVS für so genannte Wrapper verwenden soll. (Siehe »cvswrappers« im Abschnitt »Archivverwaltungsdateien« in diesem Kapitel für mehr Informationen).

$EDITOR

(siehe »$CVSEDITOR«)

$HOME $HOMEDRIVE $HOMEPATH

Der Ort, wo Dateien wie .cvsrc, .cvspass gefunden werden können (unter Unix wird nur HOME beachtet). In Windows NT sollten HOMEDRIVE und HOMEPATH gesetzt sein, unter Windows 95 kann es sein, dass sie noch von Hand eingestellt werden müssen.

Bemerkung:

In Windows 95 müssen Sie evtl. auch HOME setzen. Stellen Sie dabei sicher, dass der Pfad nicht in einem Schrägstrich endet; benutzen Sie set HOME=C: oder einen ähnlichen Ausdruck.

$PATH

Überholt.

$TEMP $TMP $TMPDIR

Der Ort, an dem temporäre Dateien gespeichert werden sollen. (Der Server benutzt TMPDIR; Windows NT benutzt TMP). Das Setzen dieser Variablen auf der Client-Seite beeinflusst den Server nicht. Generell beeinflusst das Setzen dieser Variablen nicht den Ort, an dem temporäre Locks abgespeichert werden. (Siehe auch den Abschnitt »config« im Abschnitt »Archivverwaltungsdateien« in diesem Kapitel für mehr Informationen.)

$VISUAL

siehe »$CVSEDITOR«