File: sitecopy.fr.1

package info (click to toggle)
sitecopy 1:0.16.6-7
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, jessie, jessie-kfreebsd, sid, stretch
  • size: 5,668 kB
  • ctags: 5,783
  • sloc: ansic: 48,856; sh: 3,820; makefile: 774; yacc: 291; awk: 58; sed: 27
file content (840 lines) | stat: -rw-r--r-- 26,992 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
.\" Copyright 1999-2001 Joe Orton
.\" Relecture G�rard Delafond
.TH sitecopy 1 "June 2001" sitecopy "User Manuals"
.SH NOM
sitecopy \- Maintient � jour des copies distantes de sites web
.SH SYNOPSIS
.B sitecopy [options] [mode op�ratoire] 
.I nomdusite
.B ...
.SH DESCRIPTION
.I sitecopy
sert � copier des sites web stock�s localement vers des serveurs web
distants. Une simple commande va mettre � jour sur le serveur les
fichiers modifi�s localement, et supprimer du serveur les fichiers
supprim�s localement, maintenant ainsi le site distant � jour avec le
site local. L'objectif est de supprimer l'�tape tr�s p�nible de mise �
jour et de suppression de fichiers individuels avec un client FTP.
\fBsitecopy\fP peut �galement rep�rer les fichiers que vous avez
d�plac�s localement pour les d�placer sur le site distant.

FTP, WebDAV et autres serveurs de publication bas�s sur HTTP (comme
par exemple AOLserver et Netscape Enterprise) sont �galement g�r�s.

.SH POUR COMMENCER

Cette section explique comment mettre en place la maintenance d'un
site web � l'aide de \fBsitecopy\fP. Apr�s avoir pr�sent� les
rudiments, on examinera deux situations\ : d'abord celle o� vous avez
d�j� plac� votre site sur le serveur distant, puis celle o� vous ne
l'avez pas encore fait.

.SS Rudiments

Si vous ne l'avez pas d�j� fait, il vous faut cr�er un fichier de
configuration qui contiendra les informations relatives aux sites que
vous d�sirer administrer. Vous devez �galement cr�er un r�pertoire
dans lequel \fBsitecopy\fP stockera l'�tat des fichiers de chacun
des sites distants. Le fichier de configuration ainsi que le
r�pertoire de stockage de l'�tat des fichiers doivent n'�tre
accessibles que par vous-m�me -- sans quoi \fBsitecopy\fP refusera de
d�marrer. Pour cr�er le r�pertoire de stockage avec les permissions
ad�quates, utilisez la commande
.br
.B "	mkdir -m 700 .sitecopy"
.br
depuis votre r�pertoire personnel. Pour cr�er le fichier de
configuration, utilisez les commandes
.br
.B "	touch .sitecopyrc"
.br
.B "	chmod 600 .sitecopyrc"
.br
depuis votre r�pertoire personnel. Ceci fait, �ditez le fichier de
configuration pour ajouter les d�tails relatifs � votre site comme
indiqu� � la section CONFIGURATION.

.SS Si le site distant existe d�j�

Si vous aviez d�j� plac� votre site sur le serveur distant,
assurez-vous que vos fichiers locaux soient synchronis�s avec les
fichiers distants. Ensuite, lancez
.br
.B "	sitecopy --catchup nomdusite"
.br
o� nomdusite est le nom du site que vous avez indiqu� apr�s le mot-cl�
.B site
dans le fichier de configuration.

Si vous n'avez pas de copie locale du site distant, vous pouvez
utiliser le
.B mode r�cup�ration
pour d�couvrir le contenu du site distant, et le
.B mode synchronisation
pour le t�l�charger. Le mode r�cup�ration marche bien avec les
serveurs WebDAV, et peut marcher avec les serveurs FTP. Tapez
.br
.B "	sitecopy --fetch nomdusite"
.br
pour r�cup�rer les informations sur les fichiers du site\ ; en cas de
succ�s, tapez
.br
.B "	sitecopy --synch nomdusite"
.br
pour t�l�charger une copie locale. N'effectuez PAS ces op�rations si
vous avez d�j� une copie locale de votre site.

.SS Si le site distant n'existe pas encore

Assurez-vous que l'administrateur ait bien cr�� la racine du site
distant. Tapez
.br
.B "	sitecopy --init nomdusite"
.br
o� nomdusite est le nom du site que vous avez indiqu� apr�s le mot-cl�
.B site
dans le fichier de configuration.

.SS Maintenance du site

Apr�s avoir mis en place le site comme d�crit dans une des deux
sections ci-dessus, vous pouvez commencer � �diter vos fichiers locaux
normalement. Lorsque vous en avez fini avec un ensemble de
changements, et que vous voulez mettre � jour la copie distante de
votre site, tapez
.br
.B "	sitecopy --update nomdusite"
.br
et tous les fichiers modifi�s seront remont�s sur serveur. Tout
fichier localement supprim� sera �galement suppprim� sur le serveur, �
moins que l'option
.B nodelete 
n'ait �t� sp�cifi�e dans le fichier de configuration. Si vous d�placez
un ou plusieurs fichiers entre deux r�pertoires, leurs copies
distantes seront supprim�es du serveur, puis remont�es � nouveau, �
moins que l'option
.B checkmoved
n'ait �t� sp�cifi�e dans le fichier de configuration.

� tout moment, si vous d�sirez voir la liste des changements effectu�s
au site local depuis la derni�re mise � jour, pour pouvez lancer
.br
.B "	sitecopy nomdusite"
.br
qui affichera la liste des diff�rences.

.SS Probl�mes de synchronisation

Dans certaines circonstances, les fichiers qui constituent r�ellement
le site distant diff�rent de ce que \fBsitecopy\fP
.I pense
qu'il y a sur
le site. Cela peut arriver, par exemple, si la connexion au serveur
est interrompue durant une mise � jour. Dans cette situation, vous
devriez utiliser le
.B mode r�cup�ration
pour retrouver du serveur distant la liste des fichier qui constitue
le site.

.SH INVOCATION

Pour une op�ration normale, sp�cifiez un
.I simple
mode op�ratoire, suivi par les options que vous avez choisies, puis un
ou plusieurs nom de sites. Par exemple,
.br
.B "	sitecopy --update --quiet siteprincipal autresite"
.br
mettra � jour silencieusement les sites appel�s �\ siteprincipal\ �
et �\ autresite\ �.

.SH MODES OP�RATOIRES
.IP "-l, --list"
.B Mode Liste
\- produit une liste de toutes les diff�rences entre les fichiers
locaux et leur copie distante pour les sites sp�cifi�s.
.IP "-ll, --flatlist"
.B Mode Liste plate
\- similaire au mode liste, mais la sortie produite convient � une
analyse ult�rieure par un script externe ou un programme. Le script
AWK fourni,
.B changes.awk.
produit par exemple une page HTML depuis une sortie produite par ce mode.
.IP "-u, --update"
.B Mode Mise � jour
\- Met � jour la copie distante des sites sp�cifi�s.
.IP "-f, --fetch"
.B Mode R�cup�ration
\- R�cup�re la liste des fichiers du serveur distant. Notez qu'en FTP
le support de ce mode est limit� -- le serveur doit accepter la commande
.B MDTM
, et utiliser un programme �\ ls\ � de type Unix comme impl�mentation de
la commande LIST.
.IP "-s, --synchronize"
.B Mode Synchronisation
\- Met � jour la copie
.I locale
du site � partir de la copie distante.
.B AVERTISSEMENT\ :
Ce mode �crase les fichiers locaux. � utiliser avec pr�caution.
.IP "-i, --initialize"
.B Mode Initialisation
\- initialise les sites sp�cifi�s, \fBsitecopy\fP pensant alors qu'il
n'y a AUCUN fichier sur le serveur distant. 
.IP "\-c, \-\-catchup"
.B Mode Rendre identique
\- am�ne \fBsitecopy\fP � penser que les copies locale et distante du
site sont identiques.
.IP "-e, --verify"
V�rifier que l'�tat enregistr� du site est conforme � l'�tat r�el du site distant
.IP "-v, --view"
.B Mode Voir configuration
\- Affiche toutes les d�finitions de sites du fichier de configuration.
.IP "-h, --help"
Affiche un message d'aide.
.IP "-V, --version"
Affiche le num�ro de version.
.SH OPTIONS
.IP "-y, --prompting"
Valable seulement pour le
.B Mode Mise � jour
, demande � l'utilisateur de confirmer chaque mise � jour (i.e.,
cr�ation d'un r�pertoire, remont�e d'un fichier sur le site distant, etc.).
.IP "-g, --logfile=FICHIER"
Ajouter les messages de d�bogage au FICHIER (stderr est utilis�e si cette option n'est pas indiqu�e)
.IP "-x, --create-remote"
Cr�er la racine du site distant
.IP "-n, --dry-run"
Afficher ce qui serait r�alis� sans effectuer r�ellement l'action
.IP "-r FICHIER, --rcfile=FICHIER"
Sp�cifie un fichier de configuration alternatif pour l'ex�cution en cours.
.IP "-p R�PERTOIRE, --storepath=R�PERTOIRE"
Sp�cifie un chemin d'acc�s alternatif au r�pertoire contenant les
informations sur les fichiers du site distant, pour l'ex�cution en cours.
.IP "-q, --quiet"
Sortie discr�te - n'affiche que le nom du fichier pour chaque mise
� jour effectu�e.
.IP "-qq, --silent"
Sortie silencieuse - n'affiche aucune information lors des mises � jour.
.IP "-o, --show-progress"
Valable seulement pour le
.B Mode Mise � jour
, affiche la progression (sous forme de pourcentage effectu�) du
transfert de donn�es.
.IP "-g, --logfile=FICHIER"
Ajouter les messages de d�bogage au FICHIER (stderr est utilis�e si cette option n'est pas indiqu�e)
.IP "-x, --create-remote"
Cr�er la racine du site distant
.IP "-n, --dry-run"
Afficher ce qui serait r�alis� sans effectuer r�ellement l'action
.IP "-k, --keep-going"
Passe outre les erreurs en
.B Mode Mise � jour
ou en
.B Mode Synchronisation

.IP "-a, --allsites"
Ex�cute l'op�ration donn�e pour tous les sites - valable pour tous les
modes, sauf le
.B Mode Voir configuration
, pour lequel cette option est sans effet.
.IP "-d MASQUE, --debug=CL�[,CL�...]"
Affiche des informations de d�bogage. Vous devez donner une liste de
mots-cl�s s�par�s par une virgule. Chaque mot-cl� peut �tre, au choix\ :
.br
  socket    Manipulation des sockets
.br
  files     Manipulation des fichiers
.br
  rcfile    Analyseur du fichier de configuration
.br
  http      Pilote HTTP
.br
  httpbody  Affiche le corps des r�ponses HTTP
.br
  ftp       Pilote FTP
.br
  xml       Informations d'analyse syntaxique XML
.br
  xmlparse  Informations d'analyse syntaxique XML de bas niveau
.br
  httpauth  Informations d'authentification HTTP
.br
  cleartext Affiche les mots de passe en clair

Les mots de passe seront masqu�s dans l'affichage de d�bogage, �
moins que le mot-cl� cleartext ne soit utilis�. Un exemple de
l'utilisation des informations de d�bogage est de d�boguer le mode
r�cup�ration FTP\ :

.br
.B "	sitecopy --debug=ftp,socket --fetch nomdusite"
.br

.SH CONCEPTS
L'
.B �tat stock�
d'un site est un instantan� de l'�tat du site, conserv� dans le
r�pertoire de stockage (~/.sitecopy/). Le
.B fichier de stockage
sert � conserver cet �tat entre deux invocations du programme. En mode
mise � jour, \fBsitecopy\fP construit une
.B liste de fichiers
pour chaque site en parcourant le r�pertoire local, prend connaissance
de l'�tat stock� et, en comparant les deux, d�termine quels fichiers
ont chang�, lesquels ont �t� d�plac�s, et ainsi de suite.

.SH CONFIGURATION

La configuration est assur�e par le fichier de configuration (fc). Ce
fichier contient une ou plusieurs d�finitions de sites. Un nom unique
est attribu� � chaque d�finition de site\ ; c'est par ce nom qu'on se
r�f�re � un site en ligne de commande.
.PP
Chaque d�finition de site contient les d�tails du serveur sur lequel
est stock� le site, la mani�re dont on peut acc�der � ce serveur,
l'emplacement local et distant du site, ainsi que des options pour ce
site si n�cessaire.

.SS D�finition d'un site

La d�finition d'un site est constitu�e d'une s�rie de lignes\ :


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

Tout ce qui suit le caract�re # sur une ligne est consid�r� comme un
commentaire et est ignor�.
Les valeurs peuvent �tre entour�es par des guillemets, et les
caract�res peuvent �tre �chapp�s par une contre-oblique (\\).
Par exemple, pour utiliser le motif d'
.B exclusion
*#, utilisez la ligne suivante:
.br
.BR "	exclude " """*#"""

.SS Options pour le serveur distant
La cl�
.B server
est utilis�e pour sp�cifier le serveur distant sur lequel est stock�
le site distant. Cela peut �tre un nom DNS ou une adresse IP. La
connexion au serveur se fera sur le port par d�faut pour le protocole
utilis�, ou bien par le num�ro indiqu� par le mot-cl�
.B port.
\fBsitecopy\fP g�re les protocoles WebDAV ou FTP -- le mot-cl�
.B protocol
sp�cifie lequel utiliser, en prenant comme valeur
.B webdav
ou 
.B ftp
respectivement. Le protocole par d�faut est FTP.

Les mots-cl�s
.B proxy-server
et
.B proxy-port
peuvent �tre utilis�s pour sp�cifier un serveur de proxy. Les serveurs
de proxy ne sont g�r�s qu'avec le protocole webDAV.

Si le serveur FTP ne g�re pas le mode passif (PASV), utilisez l'option
.B ftp nopasv.
Pour afficher le message retourn� par le serveur � la fermeture de la
connexion, utilisez l'option
.B ftp showquit.
Si le serveur ne permet la remont�e des fichiers que dans le
r�pertoire courant, utilisez le mot-cl�
.B ftp usecwd
(un sympt�me possible est le message\ : "overwrite permission
denied"). 
Notez que le r�pertoire racine distant (mot-cl� 
.B remote\fP)
doit �tre un chemin absolu (qui commence par '/'), sans quoi
.B usecwd
sera ignor�.

Si le serveur WebDAV utilise correctement le message d'attente
100-continue, comme par exemple Apache version 1.3.9 et sup�rieure,
utilisez le mot-cl� 
.B http expect.
Cela peut �conomiser de la bande passante ainsi que r�duire le temps
n�cessaire � une mise � jour.

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

Pour le protocole WebDAV, l'authentification basique et par condens�
(digest authentication) sont g�r�es. Notez que vous ne devriez pas
utiliser l'authentification basique, � moins que vous ne consid�riez la
connexion au serveur comme digne de confiance.

Vous pouvez sp�cifier l'URL compl�te pour acc�der au site
avec le mot-cl�
.B url.
Elle n'est utilis�e qu'en mode liste plate, afin qu'elle puisse
figurer dans les pages�\ Changements r�cents\ �. L'URL ne doit
.I pas
se terminer par une barre oblique (/)\ ; un exemple valide est 
.br
.BR "	url " http://www.site.com/monsite

Si vous sp�cifiez l'option
.B tempupload,
les fichiers modifi�s sont transmis au serveur distant avec un
pr�fixe �\ .in.\ �, puis renomm�s (par d�placement) en leur nom d'origine
une fois remont�s compl�tement. 

.SS �tat des fichiers

L'�tat d'un fichier est conserv� dans le fichier de stockage associ�
(dans ~/.sitecopy/*), et sert � d�terminer quand le fichier a �t�
modifi�. Il y a deux m�thodes possibles, qui peuvent �tre choisies via
le mot-cl� 
.B state
, avec comme param�tre 
.B timesize
(par d�faut), ou
.B checksum.

.B timesize
utilise la date de derni�re modification et la taille du fichier
pour d�tecter s'il a chang�.
.B checksum
utilise une somme de contr�le MD5 pour d�tecter toute modification
dans le contenu du fichier.

Notez que calculer une somme de contr�le implique de lire le contenu
entier du fichier\ ; et est plus lent que d'utiliser simplement la date
de derni�re modification et la taille. Cela peut �tre utile par
exemple si vous utilisez un syst�me de gestion de versions qui change
la date de derni�re modification des fichiers � chaque extraction
d'une copie de travail (�\ checkout\ �), alors que le contenu des fichiers
n'est en r�alit� pas modifi�.


.SS Mode S�curis�

Vous pouvez passer en 
.B Mode S�curis�
gr�ce au mot-cl� 

.B safe.
Dans ce mode, chaque fois qu'un fichier est remont� sur le serveur, la
date de modification du fichier
.B telle qu'elle appara�t sur le serveur
est conserv�e. Par la suite, lorsque le fichier a �t� chang�
localement et doit �tre � nouveau remont� sur le serveur, la date de
modification actuellement conserv�e c�t� serveur est r�cup�r�e puis
compar�e avec la date locale. En cas de diff�rence, cela signifie que
la copie sur le serveur a �t� chang�e par une tierce partie\ ; un
message d'avertissement est produit, et votre copie locale n'�crasera
pas la copie distante, pr�venant ainsi la suppression de toute
modification.

Le mode s�curis� peut �tre utilis� avec des serveurs FTP ou WebDAV,
mais si Apache/mod_dav est utilis�, il faut une version de mod_dav au
moins �gale � 0.9.11.


.B Note
Le mode s�curis� ne peut �tre utilis� conjointement avec l'option
.B nooverwrite
(voir plus bas).

.SS Emplacements de stockage des fichiers du site

Le mot-cl� 
.B remote
sp�cifie le r�pertoire racine de la copie distante du site. Vous
pouvez le donner sous la forme d'un chemin absolu, comme\ :
.br
.BR "	remote " /www/monsite/
.br

Si vous utilisez le protocole FTP, vous pouvez �galement sp�cifier le
r�pertoire sous la forme d'un chemin relatif au r�pertoire de
connexion\ ; il doit �tre dans ce cas pr�fix� par �\ ~/\ �, comme par
exemple\ :
.br
.BR "	remote " ~/public_html/
.PP
Le mot-cl�
.B local
sp�cifie le r�pertoire qui sert localement de stockage aux fichiers du
site. Cela peut �tre un chemin absolu ou relatif � votre
r�pertoire personnel (donn� par la variable d'environnement $HOME),
encore une fois en usant du pr�fixe �\ ~/\ �.
.br
.BR "	local " "~/html/lesite/"
.br
.BR "	local " "/home/fred/html/lesite/"
.br
sont �quivalents, si $HOME est fix� � �\ /home/fred\ �.

Pour les deux mots-cl�s local et remote, le chemin sp�cifi� peut se
terminer par une barre oblique, mais �a n'est pas obligatoire.

.SS Traitement des permissions des fichiers
Le traitement des permissions des fichiers est contr�l� par le mot-cl�
.B permissions
, qui peut prendre une de ces trois valeurs\ :
.TP 
.B ignore
pour ignorer compl�tement les permissions des fichiers,
.TP
.B exec
pour propager les permissions des fichiers ex�cutables uniquement,
.TP
.B all
pour propager les permissions de tous les fichiers.
.PP
Vous pouvez utiliser ce mot-cl� par exemple pour vous assurer que les
permissions de vos scripts CGI soient correctes. Cette option est pour
le moment ignor�e des serveurs WebDAV. Avec les serveurs FTP, un
.B chmod
est ex�cut� c�t� serveur pour modifier les permissions.

.SS Traitement des liens symboliques

Les liens symboliques trouv�s sur le site local peuvent �tre au choix
ignor�s, suivis ou maintenus. En mode �\ follow\ �, le fichier
r�f�renc� par un lien symbolique sera remont� � l'emplacement
du lien sur le site distant. En mode �\ maintain\ �, le lien sera aussi
cr�� sur le site distant (voir ci-dessous). Le mode utilis� pour
chaque site est sp�cifi� par le mot-cl�
.B symlinks
, qui peut prendre la valeur
.B ignore,
.B follow
ou
.B maintain.

Le mode par d�faut est
.B ignore,
i.e. les liens symboliques trouv�s sur la copie locale du site sont ignor�s.

.SS Maintenance des liens symboliques

Ce mode est n'actuellement support� que par les serveurs WebDAV
impl�mentant WebDAV Advanced Collections, qui est en cours de
d�veloppement. Dans ce mode, la cible du lien sur le serveur est
litt�ralement copi� � partir de la cible du lien symbolique. Astuce\ :
vous pouvez utiliser des URL si vous le d�sirez\ :
.br
.B "	ln -s" """http://www.quelquepart.org/""" quelquepart

De cette fa�on , un ordre "302 Redirect" peut �tre facilement mis en
place depuis le client, sans alt�rer la configuration du serveur.

.SS Suppression et d�placememnt des fichiers distants
Vous pouvez utiliser l'option 
.B nodelete
pour emp�cher les fichiers distants d'�tre jamais supprim�s. Cela peut
�tre utile si vous conservez de grosses quantit�s de donn�es sur le
serveur, dont vous ne voudriez pas pour autant conserver de copie
locale.

Si votre serveur ne permet pas l'�crasement de fichiers existants par
ceux que vous remontez, utilisez l'option
.B nooverwrite.
Dans ce cas, avant de remonter un fichier, \fBsitecopy\fP supprimera
au pr�alable la copie distante.

Si vous utilisez l'option
.B checkmoved,
\fBsitecopy\fP cherchera si des fichiers ont �t� d�plac�s
localement. Si c'est le cas, lors de la mise � jour du site, ces
fichiers seront aussi d�plac�s sur le site distant.

Avec l'option
.B checkmoved renames,
\fBsitecopy\fP cherchera si des fichiers ont �t� localement d�plac�s
ou renomm�s. Cette option n'est utilisable qu'en conjonction avec l'option
.B state checksum.

.B AVERTISSEMENT

Si vous n'utilisez pas de somme de contr�le MD5 pour d�terminer l'�tat
des fichiers (i.e. avec l'option
.B state checksum
) N'UTILISEZ PAS non plus l'option 
.B checkmoved
si vous avez tendance � mettre dans des r�pertoires diff�rents des
fichiers de m�me nom, taille et date de modification. Le risque
d'�crasement est improbable, mais ne dites pas que vous n'aviez pas
�t� pr�venu.

.SS Exclure des fichiers

Certains fichiers peuvent �tre ignor�s de \fBsitecopy\fP par l'emploi
du mot-cl�
.B exclude,
qui accepte des motifs d'expressions rationnelles � la mani�re du
shell. Par exemple, utilisez
.br
.BR "	exclude " "*.bak"
.br
.BR "	exclude " *~
.br
.BR "	exclude " """#*#"""
.br
pour exclure tous les fichiers qui portent l'extension .bak, se
terminent par un tilde (~) ou qui commencent et se terminent par un
di�se. N'oubliez pas d'�chapper ou d'entourer de guillemets le motif
s'il inclut un di�se !

Pour exclure des fichiers d'un r�pertoire particulier, pr�fixez
simplement le motif par le nom du r�pertoire -- en commen�ant par une
barre oblique. Par exemple,
.br
.BR "	exclude " "/docs/*.m4"
.br
.BR "	exclude " "/files/*.gz"
.br
excluera tous les fichiers � l'extension .m4 dans le sous-r�pertoire 
�\ docs\ �, et tous les fichiers � l'extension .gz dans le sous-r�pertoire
�\ files\ �.

Un r�pertoire entier peut �galement �tre exclu -- en omettant la barre
oblique � la fin du nom du r�pertoire. Par exemple,
.br
.BR "	exclude " "/quelque/part"
.br
.BR "	exclude " "/autre/part"
.br
excluera les sous-r�pertoires du site �\ quelque/part\ � et �\ autre/part\ �.

Les motifs d'exclusion sont examin�s lorsque \fBsitecopy\fP parcourt
le r�pertoire local. Un fichier qui correspond � n'importe lequel
des motifs ne sera pas ajout� � la liste des fichiers. Cela signifie
qu'un fichier d�j� remont� sur le serveur qui correspond � un motif
d'exclusion sera supprim� du serveur.

.SS Ignorer les changements des fichiers locaux

Utilisez l'option
.B ignore
pour indiquer � \fBsitecopy\fP qu'il doit ignorer les modifications
locales apport�es aux fichiers du site. Si un changement est fait au
contenu d'un fichier ignor�, le fichier ne sera
.B pas
remont� sur le serveur en mode mise � jour. Les fichiers ignor�s
seront toutefois cr��s, d�plac�s et supprim�s comme en temps normal.

L'option
.B ignore
s'utilise de la m�me mani�re que l'option
.B exclude.

Notez que le mode synchronisation
.B �crasera
les changements apport�s aux fichiers ignor�s.

.SS Mode de transfert par FTP

Pour sp�cifier le mode de transfert des fichiers par FTP, utilisez le mot-cl�
.B ascii.
Tout fichier transf�r� en utilisant le mode ASCII verra ses caract�res
de fin de ligne (CRLF/LF) interpr�t�s de fa�on appropri�e. Par
exemple, utilisez
.br
.BR "	ascii " "*.pl"
.br
pour remonter tous les fichiers � l'extension .pl comme des fichiers
texte ASCII. Ce mot-cl� est actuellement sans effet avec les serveurs WebDAV.

.SH VALEURS DE RETOUR

Les valeurs de retour possibles d�pendent du mode op�ratoire. Si
plusieurs sites sont sp�cifi�s en ligne de commande, la valeur de
retour correspondra aux op�rations effectu�es pour le dernier des
sites sp�cifi�s.

.SS Pour le mode mise � jour
 \-1 ... la mise � jour n'a pas pu d�marrer - probl�me de configuration
  0 ... la mise � jour s'est parfaitement effectu�e.
  1 ... il y a eu un probl�me pendant la mise � jour
  2 ... impossible de se connecter ou s'authentifier aupr�s du serveur

.SS Pour le mode liste (mode par d�faut)
 \-1 ... impossible de former la liste - probl�me de configuration
  0 ... le site distant n'a pas besoin de mise � jour
  1 ... le site distant n�cessite une mise � jour

.SH CONTENU DU FICHIER DE CONFIGURATION D'EXEMPLE

.SS Serveur FTP, usage simple

Le site de Fred est remont� sur un serveur FTP nomm� �\ my.server.com\ �
et maintenu dans le r�pertoire �\ public_html\ � situ� dans le r�pertoire
de connexion. Le site est conserv� en local dans le r�pertoire
/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/

.SS Serveur FTP, usage avanc�

Ici, le site de Freda est remont� sur un serveur FTP nomm� �\ ftp.elsewhere.com\ �
et maintenu dans le r�pertoire /www/freda. Le site
est conserv� en local dans le r�pertoire /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 � l'extension .bak ou 
  # se terminant par un ~:
  exclude *.bak
  exclude *~

.SS Serveur WebDAV, usage simple

Cet exemple montre comment d�finir un site avec un serveur WebDAV.

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

.SH FICHIERS
.I ~/.sitecopyrc
Emplacement par d�faut du fichier de configuration. 
.br
.I ~/.sitecopy/
R�pertoire de stockage des informations sur les fichiers du site distant.
.br
.I ~/.netrc
Informations relatives aux comptes sur des serveurs distants.
.br

.SH BOGUES
Probl�mes connus\ : Les modes r�cup�ration et synchronisation ne sont
PAS fiables avec le protocole FTP. Si vous avez besoin d'op�rations
atomiques de r�cup�ration d'informations et de synchronisation de
fichiers, n'utilisez pas sitecopy\ ; essayez plut�t rsync.

.PP
Veuillez envoyer vos rapports d'anomalies et demandes d'am�liorations
� <sitecopy@lyra.org> plut�t qu'� l'auteur lui-m�me, puisque la liste
de diffusion archive ses messages et les v�tres pourraient �tre utiles �
d'autres utilisateurs.

.SH VOIR AUSSI
rsync(1), ftp(1), mirror(1)

.SH STANDARDS

[Cit�s seulement pour r�f�rence, l'auteur ne revendique aucune
conformit� � aucun de ces standards.]

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

.SH �BAUCHES DE STANDARDS
.BR "draft-ietf-ftpext-mlst-05.txt" " - Extensions to FTP"
.br
.BR "draft-ietf-webdav-collections-protocol-03.txt" " - WebDAV Advanced Collections Protocol"
.SH AUTEURS
Joe Orton et d'autres.
.br
e-mail: sitecopy@lyra.org
.br
www: http://www.lyra.org/sitecopy/

.SH TRADUCTION
Nicolas Girard <\fIgirard_nicolas at yahoo.fr\fR>, 2004.
.SH AVERTISSEMENT SUR LA TRADUCTION
Il est possible que cette traduction soit imparfaite ou p�rim�e. En cas de doute, veuillez vous reporter
au document original en langue anglaise fourni avec le programme.