Annexe F. Dépôt CVS

Table des matières
F.1. Obtenir les sources via CVS anonyme
F.2. Organisation de l'arbre CVS
F.3. Obtenir les sources via CVSup

Le code source de PostgreSQL est stocké et géré en utilisant le système de gestion de codes CVS.

Au moins deux méthodes, CVS anonyme et CVSup, permettent d'extraire de CVS l'arborescence du code source du serveur PostgreSQL vers votre serveur local.

F.1. Obtenir les sources via CVS anonyme

Si vous voulez mettre régulièrement à jour vos sources, vous pouvez les prendre de notre serveur CVS, puis utiliser CVS pour récupérer les mises à jour de temps en temps.

CVS anonyme

  1. Vous aurez besoin d'une copie locale de CVS (Concurrent Version Control System), que vous pouvez obtenir depuis http://www.cyclic.com/ ou depuis n'importe quel site d'archive GNU. Nous utilisons actuellement la version 1.10 (la plus récente au moment de l'écriture de cet article). Beaucoup de systèmes ont une version récente de cvs installé par défaut.

  2. Connectez-vous une première fois au serveur CVS :

    cvs -d :pserver:anoncvs@anoncvs.postgresql.org:/projects/cvsroot login
         

    Un mot de passe vous est demandé. Vous pouvez entrer ce que vous voulez, sauf une chaîne vide.

    Vous n'avez besoin de faire ceci qu'une seule fois car le mot de passe est sauvegardé dans le fichier .cvspass de votre répertoire personnel.

  3. Récupérez les sources de PostgreSQL :

    cvs -z3 -d :pserver:anoncvs@anoncvs.postgresql.org:/projects/cvsroot co -P pgsql
         

    Ceci installe les sources de PostgreSQL dans un sous-répertoire pgsql de votre répertoire courant.

    Note : Si vous avez une connexion rapide à Internet, vous n'avez peut-être pas besoin de l'option -z3, qui demande à CVS de compresser les données à transférer avec gzip. À la vitesse d'un modem, cela permet un gain de temps substantiel.

    Cette extraction initiale est un peu plus lente que de simplement télécharger un fichier tar.gz; attendez vous à ce qu'elle prenne 40 minutes environ si vous avez un modem à 28,8 Kbps. L'avantage de CVS n'apparaîtra que plus tard, lorsque vous voudrez mettre à jour les fichiers.

  4. Lorsque vous voulez mettre à jour vos sources CVS avec la dernière version, faites cd dans le sous-répertoire pgsql et lancez la commande

    $ cvs -z3 update -d -P
         

    Ceci ne récupère que les modifications qui ont eu lieu depuis la dernière fois que vous avez fait une mise à jour. La mise à jour ne dure généralement que quelques minutes, même avec un simple modem.

  5. Vous pouvez économiser quelques saisies en vous faisant un fichier .cvsrc dans votre répertoire personnel ($HOME) en lui ajoutant :

    cvs -z3
    update -d -P
         

    Ceci ajoute l'option -z3 à toutes les commandes cvs, et les options -d et -P aux mises à jour par cvs. Vous n'avez plus qu'à lancer

    $ cvs update
         

    pour mettre à jour vos fichiers.

Attention

Certaines versions anciennes de CVS ont un problème qui fait que tous les fichiers extraits ont des droits en écriture pour tout le monde. Si vous vous apercevez que cela vous arrive, vous pouvez faire quelque chose comme :

$ chmod -R go-w pgsql
    

pour remettre les droits d'aplomb. Ce problème a été corrigé dans la version 1.9.28 de CVS.

CVS peut faire de nombreuses autres choses, comme retrouver des versions antérieures des sources de PostgreSQL plutôt que les dernières versions de développement. Pour plus d'informations, consultez le manuel de CVS ou bien lisez la documentation en ligne à http://www.cyclic.com/.