CVS-Nutzung

Autor: Kay Schützler
Letztes Update: Uli Sacklowski, 17.11.03

Inhalt

1. Allgemeines

Das CVS-System wurde in unserem Projekt für die Verwaltung der allgemein zugänglichen Quellen gewählt, da es bei vergleichsweise geringem Nutzungsaufwand alle nötige Funktionalität beinhaltet und sich in anderen Projekten an unserem Institut bereits bewährt hat.

Der Kern des CVS-Systems ist das so genannte Repository, das alle gemeinsam zu nutzenden Dateien zentral verwaltet und die Zugriffe auf diese kapselt.

Zur Bearbeitung von Dateien müssen diese daher vom Anwender erst als lokale Kopien angelegt werden. Im Anschluss an die Bearbeitung müssen die Dateien natürlich auch wieder im Repository aktualisiert werden.

Für diese Zwecke steht eine Reihe von Befehlen zur Verfügung, deren Bedeutung jedem Nutzer geläufig sein sollte.

2. Befehlsübersicht

• cvs checkout modulname

  Mit diesem Befehl werden lokale Kopien aller zentral verwalteten Dateien des Moduls modulname angelegt. In unserem Projekt wurde der modulname auf
  
    - XCTL_32 für 32-Bit und auf
    - XC010701 für 16-Bit
  
  festgelegt. Für die lokalen Kopien sollte man sich ein Arbeitsverzeichnis im eigenen Home-Verzeichnis anlegen.

Da CVS die Quellen zentral verwaltet, muss vor einem checkout dieser zentrale Speicherort über die Variable CVSROOT bekannt gemacht werden. Bei einer C-Shell geschieht das in unserem Projekt über den Befehl setenv CVSROOT /vol/baal-vol3/projekt98/quellen.

• cvs commit [-m"Log-Mitteilung"] [Dateien]

  Dieser Befehl ist zum Einspielen von lokalen Änderungen vorgesehen. Wenn die Log-Mitteilung länger sein soll, kann auch auf den Parameter verzichtet werden; es wird dann automatisch der vi gestartet.

• cvs update

  Mit diesem Befehl werden die lokalen Kopien mit den zentral gehaltenen Dateien synchronisiert. Dabei gibt es u.U. folgende Ausschriften:

  • U Dateiname
    Die lokale Kopie wurde durch die aktuellere Version aus dem Repository ersetzt.
  • M Dateiname
    Die lokale Kopie ist aktueller als die Version im Repository.
  • C Dateiname
    Im Repository war eine neuere Version der Datei als die, die der lokalen (mittlerweile veränderten) Kopie als Grundlage diente. Bei der Zusammenfügung der Dateien traten Konflikte auf, die in der lokalen Kopie an den entsprechenden Stellen markiert sind. Diese Konflikte sind durch geeignete Maßnahmen aufzulösen. Vorher ist kein "cvs commit" möglich.
  • ? Dateiname
    Die so gekennzeichnete Datei befindet sich nicht unter CVS-Verwaltung. Dies ist zum Beispiel bei temporären und Objektdateien der Fall.

  Wenn zahlreiche Änderungen im Repository erfolgt sind, kann es durchaus sein, dass die Ausschriften nicht mehr komplett auf das Terminal passen. Daher sollte der Update-Befehl folgendermaßen mit dem More-Befehl kombiniert werden: cvs update ¦ more.

• cvs add Datei[en]

  Mittels "cvs add" können neu erstellte Dateien in die CVS-Verwaltung aufgenommen werden.

• cvs remove Datei[en]

  Dieser Befehl entfernt Dateien aus der CVS-Verwaltung. Die physische Datei muss vor der Ausführung dieses Befehls gelöscht sein

3. Probleme

Das Kernproblem unserer Verwendung von CVS besteht in der parallelen Nutzung von Windows (zur Entwicklung) und UNIX (zur Archivierung). Daher muss jeder, der eigene Entwicklungen vornimmt, folgendes beachten:

• Ab dem Zeitpunkt der Entwicklung unter Windows kein "cvs update" mehr durchführen!
• Nach Abschluss der Arbeiten zuerst die eigenen Neuentwicklungen ins lokale UNIX-Verzeichnis kopieren.
• Wenn die Quellen nach der Bearbeitung im DOS-Format sind (erkennbar an den eigenartigen "Control-Ms", die (zum Beispiel) in "nedit" oder "xemacs" sichtbar sind...) müssen diese Dateien zunächst per dos2unix -ascii alte_datei neue_datei ins UNIX-Format umgewandelt werden.
• Danach ein "cvs update" durchführen und in allen Dateien, die von CVS mit einem "C" gekennzeichnet wurden, die Konflikte bereinigen.
• Als letztes "cvs commit" durchführen und eine aussagekräftige Log-Meldung verfassen.

4. Veranschaulichung

5. Konfliktbereinigung

Konflikte sind Quelltextstellen, die von mehreren Entwicklern (aus Sicht des CVS-Systems) "gleichzeitig" bearbeitet wurden. Bei einem "cvs update" werden Konflikte durch CVS in der betroffenen Datei folgendermaßen markiert:

<<<<<<< DATEINAME
Neuer Text.
=======
Bisheriger Text im CVS.
>>>>>>> AKTUELLE CVS-REVISIONSNUMMER
    

Um den Konflikt zu bereinigen, muss entschieden werden, in welcher Reihenfolge die beiden Dateiteile zu stehen haben. Nachdem jene entsprechend sortiert sind, müssen die Markierungen (spitze Klammern, Gleichheitszeichen und der dazu gehörige Text) entfernt werden. Danach ist der Konflikt bereinigt.