# Utilisation avancée de cvsup

### Salvo Bartolotta

`<bartequi@neomedia.it>`

$FreeBSD: doc/fr_FR.ISO8859-1/articles/cvsup-advanced/article.sgml,v 1.7 2007/01/20 13:34:48 blackend Exp $

FreeBSD est une marque déposée de Wind River Systems, Inc. Il est prévu qu'elle change rapidement.

CVSup est une marque déposée de John D. Polstra.

Plusieurs désignations utilisées par les constructeurs et vendeurs pour distinguer leurs produits sont mentionnées comme des marques enregistrées. Lorsqu'elles apparaissent dans ce document et que le projet FreeBSD est au courant de cette mention, la désignation est suivie du symbole “™” ou du symbole “®”.

Le présent article suppose une compréhension de base de l'utilisation de CVSup. Il expose plusieurs problèmes délicats liés à la synchronisation des sources à l'aide de CVSup, c'est à dire des solutions efficaces aux problèmes des fichiers obsolètes aussi bien qu'aux cas spéciaux de mise à jour des sources, ces problèmes sont susceptibles de causer des désagréments apparemment inexplicables.

La redistribution du code source (SGML), modifié ou non, et compilé (HTML, PostScript, etc.) est soumise aux conditions suivantes :

1. Le copyright ci-dessus, la présente liste de conditions et l'avertissement qui la suit doivent figurer dans le code source.

2. Le code source distribué sous forme compilée doit faire apparaître le copyright ci-dessus, la présente liste de conditions et l'avertissement qui la suit.

CE DOCUMENT EST FOURNI ``TEL QU'EN L'ÉTAT'' PAR LE PROJET DE DOCUMENTATION FRANÇAISE DE FreeBSD ET IL N'EST DONNÉ AUCUNE GARANTIE, IMPLICITE OU EXPLICITE, QUANT À SON UTILISATION COMMERCIALE, PROFESSIONNELLE OU AUTRE. LES COLLABORATEURS DU PROJET DE DOCUMENTATION FRANÇAISE DE FreeBSD NE PEUVENT EN AUCUN CAS ÊTRE TENUS POUR RESPONSABLES DE QUELQUE DOMMAGE OU PRÉJUDICE DIRECT, INDIRECT, SECONDAIRE OU ACCESSOIRE (Y COMPRIS LES PERTES FINANCIèRES DUES AU MANQUE À GAGNER, À L'INTERRUPTION D'ACTIVITÉS, OU LA PERTE D'INFORMATIONS ET AUTRES) DÉCOULANT DE L'UTILISATION DE LA DOCUMENTATION OU DE L'IMPOSSIBILITÉ D'UTILISER CELLE-CI, ET DONT L'UTILISATEUR ACCEPTE L'ENTIÈRE RESPONSABILITÉ.

Version française de Marc Fonvieille `<blackend@FreeBSD.org>`.

[ Multiples pages HTML / Page HTML unique ]

## 1. Préface

Ce document est le fruit des tentatives de l'auteur de comprendre les finesses de CVSup et de la mise à jour des sources. :-) Bien que l'auteur ait fait de nombreux efforts pour rendre ces pages aussi instructives et correctes que possible, il n'est qu'un être humain et a pu avoir commis toutes sortes de coquilles, d'erreurs, etc... Il sera vraiment reconnaissant pour tous les commentaires et/ou suggestions que vous enverrez à son adresse électronique `<bartequi@neomedia.it>`.

## 2. Introduction

Si vous avez consulté le site de John Polstra et lu sa FAQ, vous avez pu avoir remarqué les questions 12 et 13.

En mettant à jour n'importe quelle ``catalogue'' - collection de sources (e.g. `/usr/ports`), cvsup(1) se sert des fichiers de ``checkouts'' relatifs afin d'effectuer le processus de mise à jour de la manière la plus efficace et la plus correcte possible. Dans cet exemple (`/usr/ports`), le fichiers de ``checkouts'' relatif est `/usr/sup/ports-all/checkouts.cvs:.` si votre répertoire de base est `/usr`.

Un fichier ``checkouts'' contient l'information sur l'état actuel de vos sources -- d'une certaine manière, une sorte de ``photographie''. Cette information permet à cvsup de rechercher les mises à jour le plus efficacement. De plus, et c'est peut-être plus important, il permet à cvsup de gérer correctement vos sources en effaçant localement tout fichier qui n'est plus présent sur l'archive centrale, et de ce fait ne pas laisser de fichiers obsolètes sur votre système. En fait, sans un fichier ``checkouts'', cvsup ne saurait PAS de quels fichiers votre catalogue est composé (Cf cvsup(1) pour plus de détails), et en conséquence, il ne pourrait PAS effacer de votre système ces fichiers qui ne sont plus présents sur l'archive centrale. Ils resteraient sur votre système (les fichiers obsolètes), et pourraient vous causer de subtiles échecs de compilation ou tout autre désagrément. Par exemple, ce problème est susceptible de se produire si vous mettez à jour votre catalogue de logiciels portés plusieurs semaines après que vous ayez eu vos CDROMs d'installation.

Il est donc recommandé que vous adoptiez la procédure en deux temps décrite dans la FAQ de CVSup (Cf Q12, Q13); dans les sections suivantes, on vous présentera des exemples concrets intéressant et instructifs.

## 3. Une procédure python utile: cvsupchk

Alternativement, afin d'examiner les sources pour les inconsistences, vous pouvez souhaiter utiliser la procédure python `cvsupchk`, procédure qui se trouve actuellement dans `/usr/ports/net/cvsup/work/cvsup-16.1/contrib/cvsupchk`, avec un sympathique `README`. Prérequis:

1. `/usr/ports/net/cvsup` `#` `make extract`

2. python (que l'on trouve également dans le catalogue des logiciels portés :-)).

3. Un fichier ``checkouts'' pour votre catalogue des sources.

Si vous mettez à jour vos sources pour la toute première fois, naturellement vous n'avez pas de fichier ``checkouts''. Après l'installation de python et la mise à jour de vos sources (e.g. `/usr/ports`), vous pouvez les vérifier ainsi:

    % /path/to/cvsupchk -d /usr -c /usr/sup/ports-all/checkouts.cvs:. | more

Si vous désirez vérifier vos sources RELENG_4:

    % /path/to/cvsupchk -d /usr -c /usr/sup/src-all/checkouts.cvs:RELENG_4 | more

Dans chaque cas, `cvsupchk` inspectera vos sources à la recherche d'inconsistances en utilisant les informations contenues dans le fichier de ``checkouts'' relatif. Des anomalies comme des fichiers effacés, encore présents (aka fichiers obsolètes), fichiers récupérés absents, fichiers RCS supplémentaires, et répertoires vides seront affichés sur la sortie standard.

Dans la section suivante, nous présenterons des exemples typiques de la mise à jour de source, exemples qui vous montreront le rôle des fichiers de ``checkouts'' et les dangers d'une gestion négligée des sources.

## 4. Exemples avancés de gestion des sources

### 4.1. Comment modifier sans risques le champ tag quand vous mettez à jour `src-all`

Si vous spécifiez par exemple `tag=A` dans votre fichier `supfile`, cvsup créera un fichier ``checkouts'' appelé `checkouts.cvs:A`, par exemple avec le champ `tag=RELENG_4`, un fichier de ``checkouts'' `checkouts.cvs:RELENG_4` est généré. Ce fichier sera utilisé pour récupérer et/ou stocker l'information identifiant vos sources 4-STABLE.

En suivant le catalogue `src-all`, si vous souhaitez passer de `tag=A` à `tag=B` (A inférieur/supérieur à B important peu) et si votre fichier ``checkouts'' est `checkouts.cvs:A`, les opérations suivantes devront être effectuées:

1. `#` `mv checkouts.cvs:A checkouts.cvs:B` (ceci fournit à l'étape suivante le fichier ``checkouts'' approprié)

2. Ecrivez un fichier `supfile` dont la ligne désignant le catalogue est:

       src-all tag=B

3. Cvsupez vos sources en utilisant le nouveau `supfile`.

Cvsup recherchera `checkouts.cvs:B` -- dans ce cas la cible est B, c'est à dire que cvsup se servira des informations contenues dans ce fichier pour gérer correctement vos sources.

Les avantages:

- Les sources sont traitées correctement (en particulier aucun fichier obsolète).

- Moins de charge sur le serveur, dans ce cas CVSup agit de la manière la plus efficace.

Par exemple, `A=RELENG_4`, `B=.`, le point dans `B=.` signifie -CURRENT. C'est une mise à jour plutôt typique de la branche 4-STABLE vers la branche -CURRENT. Alors qu'il est simple de revenir à une ancienne version de sources (e.g. -CURRENT vers -STABLE), il n'en va pas de même avec le système. Vous êtes FORTEMENT déconseillé de tenter une telle opération, à moins que vous ne sachiez exactement ce que vous faites.

### 4.2. Mettre à jour en conservant le même champ tag mais pour une date différente

Si vous souhaitez basculer du champ `tag=A` au champ `tag=A` avec une date GMT différente (disons `date=D`) vous exécuterez ce qui suit:

1. Ecrivez un `supfile` dont la ligne désignant le catalogue est:

       src-all tag=A date=D

2. Mettez à jour vos sources en utilisant le nouveau `supfile`.

Que la nouvelle date précède ou non celle de la dernière synchronisation avec le champ `tag=A` est peu important. Par exemple, afin d'indiquer la date du ``27 Août 2000 à 10h00s00 GMT'' vous écrirez la ligne:

    src-all tag=RELENG_4 date=2000.08.27.10.00.00

> Note : Le format de la date est rigide. Vous devez indiquer toutes les composantes de la date: le siècle (“20”, i.e. le vingtième siècle, doit être fourni tandis que “19”, le siècle passé peut être omis), l'année, le mois, le jour, l'heure, les minutes et les secondes -- comme montré dans l'exemple ci-dessus. Pour plus d'information, veuillez consulter la page de manuel cvsup(1).

Qu'une date soit spécifiée ou non, le fichier ``checkouts'' est appelé `checkouts.cvs:A` (e.g. `checkouts.cvs:RELENG_4`). Comme conséquence, aucune action particulière n'est nécessaire afin de retourner à l'état précédent: vous devez modifier la date dans le `supfile` et remettre à jour à nouveau.

### 4.3. Mise à jour de votre catalogue des logiciels portés pour la première fois

Comme les logiciels portés sont étiquetés ``.'' (i.e. -CURRENT), vous pouvez correctement les synchroniser en ajoutant le mot-clé `date` (Cf cvsup(1) pour le format exact), vous devriez spécifier une date aussi proche que possible que celle de ``l'expédition'' de votre catalogue de logiciel porté. Après que CVSup ait créé le fichier ``checkouts'' du catalogue des logiciels portés, qui est précisément le but de cette première opération de synchronisation, le champ `date` doit être retiré, toutes les mises à jour suivantes seront faites en douceur.

Si vous avez voulu chercher la petite bête dans ce texte, vous vous êtes probablement aperçu des problèmes potentiels du processus de mise à jour des sources. Un certain nombre de personnes ont eu réellement des problèmes. Vous avez été avertis. :-)

Ce document, ainsi que d'autres peut être téléchargé sur ftp.FreeBSD.org/pub/FreeBSD/doc/.

Pour toutes questions à propos de FreeBSD, lisez la documentation avant de contacter <questions@FreeBSD.org>.
Pour les questions sur cette documentation, contactez <doc@FreeBSD.org>.