Provided by: sitecopy_0.16.6-3_i386 bug

NOM

       sitecopy - Maintient a jour des copies distantes de sites web

SYNOPSIS

       sitecopy [options] [mode op'eratoire] nomdusite ...

DESCRIPTION

       sitecopy  sert  a  copier  des  sites  web  stockes localement vers des
       serveurs web distants. Une simple commande va  mettre  a  jour  sur  le
       serveur  les  fichiers modifies localement, et supprimer du serveur les
       fichiers supprimes localement, maintenant ainsi le site distant a  jour
       avec le site local. L'objectif est de supprimer l'etape tres penible de
       mise a jour et de suppression de fichiers individuels  avec  un  client
       FTP.   sitecopy  peut  egalement  reperer  les  fichiers  que vous avez
       deplaces localement pour les deplacer sur le site distant.

       FTP, WebDAV et autres serveurs de publication bases sur HTTP (comme par
       exemple AOLserver et Netscape Enterprise) sont egalement geres.

POUR COMMENCER

       Cette section explique comment mettre en place la maintenance d'un site
       web a l'aide de  sitecopy.  Apres  avoir  presente  les  rudiments,  on
       examinera deux situations : d'abord celle ou vous avez deja place votre
       site sur le serveur distant, puis celle ou vous ne  l'avez  pas  encore
       fait.

   Rudiments
       Si  vous  ne  l'avez  pas  deja  fait, il vous faut creer un fichier de
       configuration qui contiendra les informations relatives aux  sites  que
       vous desirer administrer. Vous devez egalement creer un repertoire dans
       lequel sitecopy stockera  l'etat  des  fichiers  de  chacun  des  sites
       distants.  Le  fichier  de  configuration  ainsi  que  le repertoire de
       stockage de l'etat des fichiers  doivent  n'etre  accessibles  que  par
       vous-meme  --  sans  quoi  sitecopy refusera de demarrer. Pour creer le
       repertoire de stockage avec  les  permissions  adequates,  utilisez  la
       commande
            mkdir -m 700 .sitecopy
       depuis   votre   repertoire   personnel.   Pour  creer  le  fichier  de
       configuration, utilisez les commandes
            touch .sitecopyrc
            chmod 600 .sitecopyrc
       depuis votre repertoire personnel. Ceci  fait,  editez  le  fichier  de
       configuration  pour  ajouter  les  details  relatifs a votre site comme
       indique a la section CONFIGURATION.

   Si le site distant existe d'ej`a
       Si vous aviez deja place votre site sur le  serveur  distant,  assurez-
       vous  que  vos  fichiers  locaux  soient synchronises avec les fichiers
       distants. Ensuite, lancez
            sitecopy --catchup nomdusite
       ou nomdusite est le nom du site que vous avez indique apres le  mot-cle
       site dans le fichier de configuration.

       Si  vous  n'avez  pas  de  copie  locale  du  site distant, vous pouvez
       utiliser le  mode  r'ecup'eration  pour  decouvrir  le  contenu  du  site
       distant,  et  le  mode  synchronisation  pour  le  telecharger. Le mode
       recuperation marche bien avec les serveurs WebDAV, et peut marcher avec
       les serveurs FTP. Tapez
            sitecopy --fetch nomdusite
       pour  recuperer  les  informations sur les fichiers du site ; en cas de
       succes, tapez
            sitecopy --synch nomdusite
       pour telecharger une copie locale. N'effectuez PAS  ces  operations  si
       vous avez deja une copie locale de votre site.

   Si le site distant n'existe pas encore
       Assurez-vous  que  l'administrateur  ait  bien  cree  la racine du site
       distant. Tapez
            sitecopy --init nomdusite
       ou nomdusite est le nom du site que vous avez indique apres le  mot-cle
       site dans le fichier de configuration.

   Maintenance du site
       Apres  avoir  mis  en  place  le  site  comme  decrit dans une des deux
       sections ci-dessus, vous pouvez commencer a editer vos fichiers  locaux
       normalement. Lorsque vous en avez fini avec un ensemble de changements,
       et que vous voulez mettre a jour la copie distante de votre site, tapez
            sitecopy --update nomdusite
       et tous les fichiers modifies seront remontes sur serveur. Tout fichier
       localement  supprime  sera  egalement suppprime sur le serveur, a moins
       que  l'option  nodelete  n'ait  ete  specifiee  dans  le   fichier   de
       configuration.  Si  vous  deplacez  un ou plusieurs fichiers entre deux
       repertoires, leurs copies distantes seront supprimees du serveur,  puis
       remontees  a  nouveau,  a  moins  que  l'option  checkmoved  n'ait  ete
       specifiee dans le fichier de configuration.

       A tout moment, si vous desirez voir la liste des changements  effectues
       au site local depuis la derniere mise a jour, pour pouvez lancer
            sitecopy nomdusite
       qui affichera la liste des differences.

   Probl`emes de synchronisation
       Dans  certaines  circonstances, les fichiers qui constituent reellement
       le site distant different de ce que sitecopy pense qu'il  y  a  sur  le
       site.  Cela  peut  arriver, par exemple, si la connexion au serveur est
       interrompue durant une mise a jour. Dans cette situation, vous  devriez
       utiliser  le  mode  r'ecup'eration  pour  retrouver du serveur distant la
       liste des fichier qui constitue le site.

INVOCATION

       Pour une operation normale, specifiez un simple mode operatoire,  suivi
       par  les  options  que  vous avez choisies, puis un ou plusieurs nom de
       sites. Par exemple,
            sitecopy --update --quiet siteprincipal autresite
       mettra a jour silencieusement les sites appeles << siteprincipal >>  et
       << autresite >>.

MODES OP'ERATOIRES

       -l, --list
              Mode  Liste  - produit une liste de toutes les differences entre
              les fichiers locaux  et  leur  copie  distante  pour  les  sites
              specifies.

       -ll, --flatlist
              Mode  Liste  plate  -  similaire  au  mode liste, mais la sortie
              produite convient a une analyse ulterieure par un script externe
              ou un programme. Le script AWK fourni, changes.awk.  produit par
              exemple une page HTML depuis une sortie produite par ce mode.

       -u, --update
              Mode Mise `a jour - Met  a  jour  la  copie  distante  des  sites
              specifies.

       -f, --fetch
              Mode  R'ecup'eration  -  Recupere la liste des fichiers du serveur
              distant. Notez qu'en FTP le support de ce mode est limite --  le
              serveur  doit  accepter  la  commande  MDTM  ,  et  utiliser  un
              programme << ls >> de  type  Unix  comme  implementation  de  la
              commande LIST.

       -s, --synchronize
              Mode  Synchronisation  -  Met  a  jour la copie locale du site a
              partir de la copie distante.  AVERTISSEMENT : Ce mode ecrase les
              fichiers locaux. A utiliser avec precaution.

       -i, --initialize
              Mode  Initialisation  - initialise les sites specifies, sitecopy
              pensant alors qu'il n'y a AUCUN fichier sur le serveur distant.

       -c, --catchup
              Mode Rendre identique - amene sitecopy a penser que  les  copies
              locale et distante du site sont identiques.

       -e, --verify
              Verifier  que  l'etat  enregistre  du site est conforme a l'etat
              reel du site distant

       -v, --view
              Mode Voir configuration -  Affiche  toutes  les  definitions  de
              sites du fichier de configuration.

       -h, --help
              Affiche un message d'aide.

       -V, --version
              Affiche le numero de version.

OPTIONS

       -y, --prompting
              Valable  seulement  pour  le  Mode  Mise  `a  jour  ,  demande  a
              l'utilisateur de confirmer chaque mise a  jour  (i.e.,  creation
              d'un  repertoire,  remontee  d'un  fichier  sur le site distant,
              etc.).

       -g, --logfile=FICHIER
              Ajouter les messages de debogage au FICHIER (stderr est utilisee
              si cette option n'est pas indiquee)

       -x, --create-remote
              Creer la racine du site distant

       -n, --dry-run
              Afficher   ce  qui  serait  realise  sans  effectuer  reellement
              l'action

       -r FICHIER, --rcfile=FICHIER
              Specifie un fichier de configuration alternatif pour l'execution
              en cours.

       -p REPERTOIRE, --storepath=REPERTOIRE
              Specifie  un  chemin  d'acces alternatif au repertoire contenant
              les  informations  sur  les  fichiers  du  site  distant,   pour
              l'execution en cours.

       -q, --quiet
              Sortie  discrete  -  n'affiche que le nom du fichier pour chaque
              mise a jour effectuee.

       -qq, --silent
              Sortie silencieuse - n'affiche aucune information lors des mises
              a jour.

       -o, --show-progress
              Valable  seulement  pour  le  Mode  Mise  `a  jour  ,  affiche la
              progression (sous forme de pourcentage effectue) du transfert de
              donnees.

       -g, --logfile=FICHIER
              Ajouter les messages de debogage au FICHIER (stderr est utilisee
              si cette option n'est pas indiquee)

       -x, --create-remote
              Creer la racine du site distant

       -n, --dry-run
              Afficher  ce  qui  serait  realise  sans  effectuer   reellement
              l'action

       -k, --keep-going
              Passe  outre  les  erreurs  en  Mode  Mise  `a  jour  ou  en Mode
              Synchronisation

       -a, --allsites
              Execute l'operation donnee pour tous les sites  -  valable  pour
              tous  les  modes,  sauf le Mode Voir configuration , pour lequel
              cette option est sans effet.

       -d MASQUE, --debug=CLE[,CLE...]
              Affiche des informations de  debogage.  Vous  devez  donner  une
              liste  de mots-cles separes par une virgule. Chaque mot-cle peut
              etre, au choix :
                socket    Manipulation des sockets
                files     Manipulation des fichiers
                rcfile    Analyseur du fichier de configuration
                http      Pilote HTTP
                httpbody  Affiche le corps des reponses HTTP
                ftp       Pilote FTP
                xml       Informations d'analyse syntaxique XML
                xmlparse  Informations d'analyse syntaxique XML de bas niveau
                httpauth  Informations d'authentification HTTP
                cleartext Affiche les mots de passe en clair

              Les mots de passe seront masques dans l'affichage de debogage, a
              moins  que  le  mot-cle cleartext ne soit utilise. Un exemple de
              l'utilisation des informations de debogage est  de  deboguer  le
              mode recuperation FTP :

                   sitecopy --debug=ftp,socket --fetch nomdusite

CONCEPTS

       L'  'etat stock'e d'un site est un instantane de l'etat du site, conserve
       dans le repertoire de stockage (~/.sitecopy/). Le fichier  de  stockage
       sert  a conserver cet etat entre deux invocations du programme. En mode
       mise a jour, sitecopy construit une liste de fichiers pour chaque  site
       en  parcourant le repertoire local, prend connaissance de l'etat stocke
       et, en  comparant  les  deux,  determine  quels  fichiers  ont  change,
       lesquels ont ete deplaces, et ainsi de suite.

CONFIGURATION

       La  configuration  est assuree par le fichier de configuration (fc). Ce
       fichier contient une ou plusieurs definitions de sites. Un  nom  unique
       est  attribue  a  chaque definition de site ; c'est par ce nom qu'on se
       refere a un site en ligne de commande.

       Chaque definition de site contient les details du  serveur  sur  lequel
       est  stocke  le  site,  la  maniere  dont on peut acceder a ce serveur,
       l'emplacement local et distant du site, ainsi que des options  pour  ce
       site si necessaire.

   D'efinition d'un site
       La definition d'un site est constituee d'une serie de lignes :

       site nom-du-site
          server nom-du-serveur
          remote repertoire-racine-distant
          local repertoire-racine-local
        [ port numero-de-port ]
        [ username utilisateur ]
        [ password mot-de-passse ]
        [ proxy-server nom-du-proxy
          proxy-port numero-port-proxy ]
        [ url URL-du-site ]
        [ protocol { ftp | webdav } ]
        [ ftp nopasv ]
        [ ftp showquit ]
        [ ftp { usecwd | nousecwd } ]
        [ http expect ]
        [ safe ]
        [ state { checksum | timesize } ]
        [ permissions { ignore | exec | all } ]
        [ symlinks { ignore | follow | maintain } ]
        [ nodelete ]
        [ nooverwrite ]
        [ checkmoved [renames] ]
        [ tempupload ]
        [ exclude motif ]...
        [ ignore motif ]...
        [ ascii motif ]...

       Tout  ce  qui  suit le caractere # sur une ligne est considere comme un
       commentaire et est ignore.  Les valeurs peuvent etre entourees par  des
       guillemets,  et  les  caracteres  peuvent etre echappes par une contre-
       oblique (\).  Par exemple, pour utiliser  le  motif  d'  exclusion  *#,
       utilisez la ligne suivante:
            exclude "*#"

   Options pour le serveur distant
       La cle server est utilisee pour specifier le serveur distant sur lequel
       est stocke le site distant. Cela peut etre un nom DNS  ou  une  adresse
       IP.  La  connexion  au  serveur  se fera sur le port par defaut pour le
       protocole utilise, ou bien par le numero indique par le  mot-cle  port.
       sitecopy  gere  les  protocoles  WebDAV  ou  FTP -- le mot-cle protocol
       specifie lequel  utiliser,  en  prenant  comme  valeur  webdav  ou  ftp
       respectivement. Le protocole par defaut est FTP.

       Les  mots-cles  proxy-server  et  proxy-port peuvent etre utilises pour
       specifier un serveur de proxy. Les serveurs  de  proxy  ne  sont  geres
       qu'avec le protocole webDAV.

       Si  le serveur FTP ne gere pas le mode passif (PASV), utilisez l'option
       ftp nopasv.  Pour afficher le message retourne  par  le  serveur  a  la
       fermeture  de  la  connexion,  utilisez  l'option  ftp showquit.  Si le
       serveur ne permet la remontee  des  fichiers  que  dans  le  repertoire
       courant,  utilisez  le  mot-cle ftp usecwd (un symptome possible est le
       message : "overwrite permission  denied").   Notez  que  le  repertoire
       racine  distant  (mot-cle  remote)  doit  etre  un  chemin  absolu (qui
       commence par '/'), sans quoi usecwd sera ignore.

       Si  le  serveur  WebDAV  utilise  correctement  le  message   d'attente
       100-continue,  comme  par  exemple  Apache version 1.3.9 et superieure,
       utilisez le mot-cle http expect.  Cela  peut  economiser  de  la  bande
       passante ainsi que reduire le temps necessaire a une mise a jour.

       Pour  authentifier l'utilisateur sur le serveur, utilisez les mots-cles
       username et password.  Si le mot de passe n'est pas specifie,  il  sera
       recherche  dans  le  fichier ~/.netrc s'il existe. Voyez ftp(1) pour la
       syntaxe de ce fichier.

       Pour le protocole WebDAV, l'authentification basique  et  par  condense
       (digest  authentication)  sont  gerees.  Notez  que vous ne devriez pas
       utiliser l'authentification basique, a moins que vous ne consideriez la
       connexion au serveur comme digne de confiance.

       Vous  pouvez specifier l'URL complete pour acceder au site avec le mot-
       cle url.  Elle n'est utilisee qu'en  mode  liste  plate,  afin  qu'elle
       puisse  figurer  dans les pages<< Changements recents >>. L'URL ne doit
       pas se terminer par une barre oblique (/) ; un exemple valide est
            url http://www.site.com/monsite

       Si vous specifiez  l'option  tempupload,  les  fichiers  modifies  sont
       transmis  au  serveur distant avec un prefixe << .in. >>, puis renommes
       (par deplacement) en leur nom d'origine une fois remontes completement.

   'Etat des fichiers
       L'etat d'un fichier est conserve dans le fichier  de  stockage  associe
       (dans  ~/.sitecopy/*),  et  sert  a  determiner  quand le fichier a ete
       modifie. Il y a deux methodes possibles, qui peuvent etre choisies  via
       le  mot-cle  state  ,  avec  comme  parametre timesize (par defaut), ou
       checksum.

       timesize utilise la date de  derniere  modification  et  la  taille  du
       fichier  pour  detecter  s'il  a change.  checksum utilise une somme de
       controle MD5 pour  detecter  toute  modification  dans  le  contenu  du
       fichier.

       Notez  que  calculer  une somme de controle implique de lire le contenu
       entier du fichier ; et est plus lent que d'utiliser simplement la  date
       de derniere modification et la taille. Cela peut etre utile par exemple
       si vous utilisez un systeme de gestion de versions qui change  la  date
       de  derniere  modification des fichiers a chaque extraction d'une copie
       de travail (<< checkout >>), alors que le contenu des fichiers n'est en
       realite pas modifie.

   Mode S'ecuris'e
       Vous pouvez passer en Mode S'ecuris'e grace au mot-cle

       safe.   Dans  ce  mode,  chaque  fois  qu'un fichier est remonte sur le
       serveur, la date de modification du fichier telle qu'elle appara^it  sur
       le serveur est conservee. Par la suite, lorsque le fichier a ete change
       localement et doit etre a nouveau remonte sur le serveur,  la  date  de
       modification  actuellement  conservee  cote  serveur est recuperee puis
       comparee avec la date locale. En cas de difference, cela  signifie  que
       la  copie  sur  le  serveur  a  ete  changee par une tierce partie ; un
       message d'avertissement est produit, et votre copie  locale  n'ecrasera
       pas  la  copie  distante,  prevenant  ainsi  la  suppression  de  toute
       modification.

       Le mode securise peut etre utilise avec des  serveurs  FTP  ou  WebDAV,
       mais  si  Apache/mod_dav est utilise, il faut une version de mod_dav au
       moins egale a 0.9.11.

       Note Le mode securise ne peut etre utilise conjointement avec  l'option
       nooverwrite (voir plus bas).

   Emplacements de stockage des fichiers du site
       Le mot-cle remote specifie le repertoire racine de la copie distante du
       site. Vous pouvez le donner sous la forme d'un chemin absolu, comme :
            remote /www/monsite/

       Si vous utilisez le protocole FTP, vous pouvez egalement  specifier  le
       repertoire   sous  la  forme  d'un  chemin  relatif  au  repertoire  de
       connexion ; il doit etre dans ce cas prefixe par  << ~/ >>,  comme  par
       exemple :
            remote ~/public_html/

       Le mot-cle local specifie le repertoire qui sert localement de stockage
       aux fichiers du site. Cela peut etre un  chemin  absolu  ou  relatif  a
       votre  repertoire  personnel  (donne  par  la  variable d'environnement
       $HOME), encore une fois en usant du prefixe << ~/ >>.
            local ~/html/lesite/
            local /home/fred/html/lesite/
       sont equivalents, si $HOME est fixe a << /home/fred >>.

       Pour les deux mots-cles local et remote, le  chemin  specifie  peut  se
       terminer par une barre oblique, mais ca n'est pas obligatoire.

   Traitement des permissions des fichiers
       Le  traitement des permissions des fichiers est controle par le mot-cle
       permissions , qui peut prendre une de ces trois valeurs :

       ignore pour ignorer completement les permissions des fichiers,

       exec   pour  propager  les   permissions   des   fichiers   executables
              uniquement,

       all    pour propager les permissions de tous les fichiers.

       Vous  pouvez  utiliser ce mot-cle par exemple pour vous assurer que les
       permissions de vos scripts CGI soient correctes. Cette option est  pour
       le  moment ignoree des serveurs WebDAV. Avec les serveurs FTP, un chmod
       est execute cote serveur pour modifier les permissions.

   Traitement des liens symboliques
       Les liens symboliques trouves sur le site local peuvent etre  au  choix
       ignores,   suivis  ou  maintenus.  En  mode  << follow >>,  le  fichier
       reference par un lien symbolique sera remonte a l'emplacement  du  lien
       sur  le  site  distant. En mode << maintain >>, le lien sera aussi cree
       sur le site distant (voir ci-dessous). Le mode utilise pour chaque site
       est  specifie  par  le  mot-cle  symlinks  , qui peut prendre la valeur
       ignore, follow ou maintain.

       Le mode par defaut est ignore, i.e. les liens symboliques  trouves  sur
       la copie locale du site sont ignores.

   Maintenance des liens symboliques
       Ce  mode  est  n'actuellement  supporte  que  par  les  serveurs WebDAV
       implementant  WebDAV  Advanced  Collections,  qui  est  en   cours   de
       developpement.  Dans  ce  mode,  la  cible  du  lien sur le serveur est
       litteralement copie a partir de la cible du lien  symbolique.  Astuce :
       vous pouvez utiliser des URL si vous le desirez :
            ln -s "http://www.quelquepart.org/" quelquepart

       De  cette  facon  , un ordre "302 Redirect" peut etre facilement mis en
       place depuis le client, sans alterer la configuration du serveur.

   Suppression et d'eplacememnt des fichiers distants
       Vous pouvez utiliser  l'option  nodelete  pour  empecher  les  fichiers
       distants  d'etre  jamais  supprimes.  Cela  peut  etre  utile  si  vous
       conservez de grosses quantites de donnees sur le serveur, dont vous  ne
       voudriez pas pour autant conserver de copie locale.

       Si  votre  serveur ne permet pas l'ecrasement de fichiers existants par
       ceux que vous remontez, utilisez l'option nooverwrite.   Dans  ce  cas,
       avant de remonter un fichier, sitecopy supprimera au prealable la copie
       distante.

       Si  vous  utilisez  l'option  checkmoved,  sitecopy  cherchera  si  des
       fichiers  ont ete deplaces localement. Si c'est le cas, lors de la mise
       a jour du site, ces fichiers seront aussi deplaces sur le site distant.

       Avec l'option checkmoved renames, sitecopy cherchera  si  des  fichiers
       ont  ete localement deplaces ou renommes. Cette option n'est utilisable
       qu'en conjonction avec l'option state checksum.

       AVERTISSEMENT

       Si vous n'utilisez pas de somme de controle MD5 pour determiner  l'etat
       des  fichiers  (i.e.  avec l'option state checksum ) N'UTILISEZ PAS non
       plus l'option checkmoved si  vous  avez  tendance  a  mettre  dans  des
       repertoires  differents  des  fichiers  de  meme nom, taille et date de
       modification. Le risque d'ecrasement est improbable, mais ne dites  pas
       que vous n'aviez pas ete prevenu.

   Exclure des fichiers
       Certains fichiers peuvent etre ignores de sitecopy par l'emploi du mot-
       cle exclude, qui accepte des motifs  d'expressions  rationnelles  a  la
       maniere du shell. Par exemple, utilisez
            exclude *.bak
            exclude *~
            exclude "#*#"
       pour  exclure  tous  les  fichiers  qui  portent  l'extension  .bak, se
       terminent par un tilde (~) ou qui commencent et  se  terminent  par  un
       diese.  N'oubliez  pas  d'echapper ou d'entourer de guillemets le motif
       s'il inclut un diese !

       Pour  exclure  des  fichiers  d'un  repertoire  particulier,   prefixez
       simplement  le  motif par le nom du repertoire -- en commencant par une
       barre oblique. Par exemple,
            exclude /docs/*.m4
            exclude /files/*.gz
       excluera tous les fichiers a l'extension .m4  dans  le  sous-repertoire
       << docs >>,  et  tous  les  fichiers  a  l'extension  .gz dans le sous-
       repertoire << files >>.

       Un repertoire entier peut egalement etre exclu -- en omettant la  barre
       oblique a la fin du nom du repertoire. Par exemple,
            exclude /quelque/part
            exclude /autre/part
       excluera   les   sous-repertoires   du   site   << quelque/part >>   et
       << autre/part >>.

       Les motifs d'exclusion  sont  examines  lorsque  sitecopy  parcourt  le
       repertoire  local.  Un  fichier  qui  correspond a n'importe lequel des
       motifs ne sera pas ajoute a la liste des fichiers. Cela signifie  qu'un
       fichier  deja  remonte  sur  le  serveur  qui  correspond  a  un  motif
       d'exclusion sera supprime du serveur.

   Ignorer les changements des fichiers locaux
       Utilisez l'option ignore pour indiquer a sitecopy  qu'il  doit  ignorer
       les  modifications  locales  apportees  aux  fichiers  du  site.  Si un
       changement est fait au contenu d'un fichier ignore, le fichier ne  sera
       pas  remonte  sur  le serveur en mode mise a jour. Les fichiers ignores
       seront toutefois crees, deplaces et supprimes comme en temps normal.

       L'option ignore s'utilise de la meme maniere que l'option exclude.

       Notez que le mode synchronisation 'ecrasera les changements apportes aux
       fichiers ignores.

   Mode de transfert par FTP
       Pour  specifier  le mode de transfert des fichiers par FTP, utilisez le
       mot-cle ascii.  Tout fichier transfere en utilisant le mode ASCII verra
       ses   caracteres  de  fin  de  ligne  (CRLF/LF)  interpretes  de  facon
       appropriee. Par exemple, utilisez
            ascii *.pl
       pour remonter tous les fichiers a l'extension .pl  comme  des  fichiers
       texte  ASCII.  Ce mot-cle est actuellement sans effet avec les serveurs
       WebDAV.

VALEURS DE RETOUR

       Les valeurs de  retour  possibles  dependent  du  mode  operatoire.  Si
       plusieurs  sites  sont  specifies  en  ligne  de commande, la valeur de
       retour correspondra aux operations effectuees pour le dernier des sites
       specifies.

   Pour le mode mise `a jour
        -1 ... la mise a jour n'a pas pu demarrer - probleme de configuration
         0 ... la mise a jour s'est parfaitement effectuee.
         1 ... il y a eu un probleme pendant la mise a jour
         2 ... impossible de se connecter ou s'authentifier aupres du serveur

   Pour le mode liste (mode par d'efaut)
        -1 ... impossible de former la liste - probleme de configuration
         0 ... le site distant n'a pas besoin de mise a jour
         1 ... le site distant necessite une mise a jour

CONTENU DU FICHIER DE CONFIGURATION D'EXEMPLE

   Serveur FTP, usage simple
       Le   site   de   Fred   est   remonte   sur   un   serveur   FTP  nomme
       << my.server.com >> et maintenu dans  le  repertoire  << public_html >>
       situe  dans  le  repertoire de connexion. Le site est conserve en local
       dans le repertoire /home/fred/html.

       site mysite
         server my.server.com
         url http://www.server.com/fred
         username fred
         password juniper
         local /home/fred/html/
         remote ~/public_html/

   Serveur FTP, usage avanc'e
       Ici,  le  site  de  Freda  est  remonte  sur  un  serveur   FTP   nomme
       << ftp.elsewhere.com >>  et  maintenu dans le repertoire /www/freda. Le
       site    est    conserve     en     local     dans     le     repertoire
       /home/freda/sites/elsewhere/

       site anothersite
         server ftp.elsewhere.com
         username freda
         password blahblahblah
         local /home/freda/sites/elsewhere/
         remote /www/freda/
         # Freda veut ignorer les fichiers a l'extension .bak ou
         # se terminant par un ~:
         exclude *.bak
         exclude *~

   Serveur WebDAV, usage simple
       Cet exemple montre comment definir un site avec un serveur WebDAV.

       site supersite
         server dav.wow.com
         protocol webdav
         username pow
         password zap
         local /home/joe/www/super/
         remote /

FICHIERS

       ~/.sitecopyrc Emplacement par defaut du fichier de configuration.
       ~/.sitecopy/  Repertoire  de stockage des informations sur les fichiers
       du site distant.
       ~/.netrc Informations relatives aux comptes sur des serveurs distants.

BOGUES

       Problemes connus : Les modes recuperation et  synchronisation  ne  sont
       PAS  fiables  avec  le  protocole FTP. Si vous avez besoin d'operations
       atomiques de  recuperation  d'informations  et  de  synchronisation  de
       fichiers, n'utilisez pas sitecopy ; essayez plutot rsync.

       Veuillez envoyer vos rapports d'anomalies et demandes d'ameliorations a
       <sitecopy@lyra.org> plutot qu'a l'auteur lui-meme, puisque la liste  de
       diffusion  archive  ses messages et les votres pourraient etre utiles a
       d'autres utilisateurs.

VOIR AUSSI

       rsync(1), ftp(1), mirror(1)

STANDARDS

       [Cites  seulement  pour  reference,  l'auteur  ne   revendique   aucune
       conformite a aucun de ces standards.]

       RFC 959 - File Transfer Protocol (FTP)
       RFC 1521 - Multipurpose Internet Mail Extensions Part One
       RFC 1945 - Hypertext Transfer Protocol -- HTTP/1.0
       RFC 2396 - Uniform Resource Identifiers: Generic Syntax
       RFC 2518 - HTTP Extensions for Distributed Authoring -- WEBDAV
       RFC 2616 - Hypertext Transfer Protocol -- HTTP/1.1
       RFC 2617 - HTTP Authentication
       REC-XML - Extensible Markup Language (XML) 1.0
       REC-XML-NAMES - Namespaces in XML

'EBAUCHES DE STANDARDS

       draft-ietf-ftpext-mlst-05.txt - Extensions to FTP
       draft-ietf-webdav-collections-protocol-03.txt    -    WebDAV   Advanced
       Collections Protocol

AUTEURS

       Joe Orton et d'autres.
       e-mail: sitecopy@lyra.org
       www: http://www.lyra.org/sitecopy/

TRADUCTION

       Nicolas Girard <girard_nicolas at yahoo.fr>, 2004.

AVERTISSEMENT SUR LA TRADUCTION

       Il est possible que cette traduction soit imparfaite ou perimee. En cas
       de  doute,  veuillez  vous  reporter  au  document  original  en langue
       anglaise fourni avec le programme.