Man page - sitecopy(1)
Packages contains this manual
Available languages:
en frManual
sitecopy
NOMSYNOPSIS
DESCRIPTION
POUR COMMENCER
Rudiments
Si le site distant existe dĂ©jĂ
Si le site distant nâexiste pas encore
Maintenance du site
ProblĂšmes de synchronisation
INVOCATION
MODES OPĂRATOIRES
OPTIONS
CONCEPTS
CONFIGURATION
DĂ©finition dâun site
Options pour le serveur distant
Ătat des fichiers
Mode Sécurisé
Emplacements de stockage des fichiers du site
Traitement des permissions des fichiers
Traitement des liens symboliques
Maintenance des liens symboliques
Suppression et déplacememnt des fichiers distants
Exclure des fichiers
Ignorer les changements des fichiers locaux
Mode de transfert par FTP
VALEURS DE RETOUR
Pour le mode mise Ă jour
Pour le mode liste (mode par défaut)
CONTENU DU FICHIER DE CONFIGURATION DâEXEMPLE
Serveur FTP, usage simple
Serveur FTP, usage avancé
Serveur WebDAV, usage simple
FICHIERS
BOGUES
VOIR AUSSI
STANDARDS
ĂBAUCHES DE STANDARDS
AUTEURS
TRADUCTION
AVERTISSEMENT SUR LA TRADUCTION
NOM
sitecopy - Maintient Ă jour des copies distantes de sites web
SYNOPSIS
sitecopy [options] [mode opératoire] nomdusite ...
DESCRIPTION
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. sitecopy 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.
POUR COMMENCER
Cette section explique comment mettre en place la maintenance dâun site web Ă lâaide de sitecopy . 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.
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 sitecopy 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 sitecopy refusera de dĂ©marrer. Pour crĂ©er le rĂ©pertoire de stockage avec les permissions adĂ©quates, utilisez la commande
|
mkdir -m 700 .sitecopy |
depuis votre répertoire personnel. Pour créer le fichier de configuration, utilisez les commandes
|
touch .sitecopyrc |
|
|
chmod 600 .sitecopyrc |
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.
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
|
sitecopy --catchup nomdusite |
oĂč nomdusite est le nom du site que vous avez indiquĂ© aprĂšs le mot-clĂ© site dans le fichier de configuration.
Si vous nâavez pas de copie locale du site distant, vous pouvez utiliser le mode rĂ©cupĂ©ration pour dĂ©couvrir le contenu du site distant, et le 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
|
sitecopy --fetch nomdusite |
pour récupérer les informations sur les fichiers du site ; en cas de succÚs, tapez
|
sitecopy --synch nomdusite |
pour tĂ©lĂ©charger une copie locale. Nâeffectuez PAS ces opĂ©rations si vous avez dĂ©jĂ une copie locale de votre site.
Si le site distant nâexiste pas encore
Assurez-vous que lâadministrateur ait bien créé la racine du site distant. Tapez
|
sitecopy --init nomdusite |
oĂč nomdusite est le nom du site que vous avez indiquĂ© aprĂšs le mot-clĂ© site dans le fichier de configuration.
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
|
sitecopy --update nomdusite |
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 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 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
|
sitecopy nomdusite |
qui affichera la liste des différences.
ProblĂšmes de synchronisation
Dans certaines circonstances, les fichiers qui constituent rĂ©ellement le site distant diffĂšrent 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 Ă jour. Dans cette situation, vous devriez utiliser le mode rĂ©cupĂ©ration pour retrouver du serveur distant la liste des fichier qui constitue le site.
INVOCATION
Pour une opération normale, spécifiez un simple mode opératoire, suivi par les options que vous avez choisies, puis un ou plusieurs nom de sites. Par exemple,
|
sitecopy --update --quiet siteprincipal autresite |
mettra à jour silencieusement les sites appelés « siteprincipal » et « autresite ».
MODES OPĂRATOIRES
-l, --list
Mode Liste - produit une liste de toutes les différences entre les fichiers locaux et leur copie distante pour les sites spécifiés.
-ll, --flatlist
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, changes.awk. produit par exemple une page HTML depuis une sortie produite par ce mode.
-u, --update
Mode Mise à jour - Met à jour la copie distante des sites spécifiés.
-f, --fetch
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 MDTM , et utiliser un programme « ls » de type Unix comme implĂ©mentation de la commande LIST.
-s, --synchronize
Mode Synchronisation - Met à jour la copie locale du site à partir de la copie distante. AVERTISSEMENT : Ce mode écrase les fichiers locaux. à utiliser avec précaution.
-i, --initialize
Mode Initialisation - initialise les sites spĂ©cifiĂ©s, sitecopy pensant alors quâil nây a AUCUN fichier sur le serveur distant.
-c, --catchup
Mode Rendre identique - amĂšne sitecopy Ă penser que les copies locale et distante du site sont identiques.
-e, --verify
VĂ©rifier que lâĂ©tat enregistrĂ© du site est conforme Ă lâĂ©tat rĂ©el du site distant
-v, --view
Mode Voir configuration - Affiche toutes les définitions de sites du fichier de configuration.
-h, --help
Affiche un message dâaide.
-V, --version
Affiche le numéro de version.
OPTIONS
-y, --prompting
Valable seulement pour le 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.).
-g, --logfile=FICHIER
Ajouter les messages de dĂ©bogage au FICHIER (stderr est utilisĂ©e si cette option nâest pas indiquĂ©e)
-x, --create-remote
Créer la racine du site distant
-n, --dry-run
Afficher ce qui serait rĂ©alisĂ© sans effectuer rĂ©ellement lâaction
-r FICHIER, --rcfile=FICHIER
SpĂ©cifie un fichier de configuration alternatif pour lâexĂ©cution en cours.
-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.
-q, --quiet
Sortie discrĂšte - nâaffiche que le nom du fichier pour chaque mise Ă jour effectuĂ©e.
-qq, --silent
Sortie silencieuse - nâaffiche aucune information lors des mises Ă jour.
-o, --show-progress
Valable seulement pour le Mode Mise à jour , affiche la progression (sous forme de pourcentage effectué) du transfert de données.
-g, --logfile=FICHIER
Ajouter les messages de dĂ©bogage au FICHIER (stderr est utilisĂ©e si cette option nâest pas indiquĂ©e)
-x, --create-remote
Créer la racine du site distant
-n, --dry-run
Afficher ce qui serait rĂ©alisĂ© sans effectuer rĂ©ellement lâaction
-k, --keep-going
Passe outre les erreurs en Mode Mise Ă jour ou en Mode Synchronisation
-a, --allsites
ExĂ©cute lâopĂ©ration donnĂ©e pour tous les sites - valable pour tous les modes, sauf le Mode Voir configuration , pour lequel cette option est sans effet.
-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 :
socket Manipulation des sockets
files Manipulation des fichiers
rcfile Analyseur du fichier de configuration
http Pilote HTTP
httpbody Affiche le corps des réponses 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 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 :
|
sitecopy --debug=ftp,socket --fetch nomdusite |
CONCEPTS
Lâ Ă©tat stockĂ© dâun site est un instantanĂ© de lâĂ©tat du site, conservĂ© dans le rĂ©pertoire de stockage (Ë/.sitecopy/). Le fichier de stockage sert Ă conserver cet Ă©tat entre deux invocations du programme. En mode mise Ă jour, sitecopy construit une 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.
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.
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.
DĂ©finition dâun site
La dĂ©finition dâun site est constituĂ©e dâune sĂ©rie de lignes :
site
nom-du-site
server
nom-du-serveur
remote
répertoire-racine-distant
local
répertoire-racine-local
[
port
numéro-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 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â exclusion *#, utilisez la ligne suivante:
|
exclude "*#" |
Options pour le serveur distant
La clĂ© 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Ă© port. sitecopy gĂšre les protocoles WebDAV ou FTP -- le mot-clĂ© protocol spĂ©cifie lequel utiliser, en prenant comme valeur webdav ou ftp respectivement. Le protocole par dĂ©faut est FTP.
Les mots-clĂ©s proxy-server et 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 ftp nopasv. Pour afficher le message retournĂ© par le serveur Ă la fermeture de la connexion, utilisez lâoption ftp showquit. Si le serveur ne permet la remontĂ©e des fichiers que dans le rĂ©pertoire courant, utilisez le mot-clĂ© ftp usecwd (un symptĂŽme possible est le message : "overwrite permission denied"). Notez que le rĂ©pertoire racine distant (mot-clĂ© remote ) doit ĂȘtre un chemin absolu (qui commence par â/â), sans quoi 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Ă© 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 username et password. Si le mot de passe nâest pas spĂ©cifiĂ©, il sera recherchĂ© 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 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Ă© 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 pas se terminer par une barre oblique (/) ; un exemple valide est
|
url http://www.site.com/monsite |
Si vous spĂ©cifiez lâoption 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.
Ă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Ă© state , avec comme paramĂštre timesize (par dĂ©faut), ou checksum.
timesize utilise la date de derniĂšre modification et la taille du fichier pour dĂ©tecter sâil a changĂ©. 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Ă©.
Mode Sécurisé
Vous pouvez passer en Mode Sécurisé grùce au mot-clé
safe. Dans ce mode, chaque fois quâun fichier est remontĂ© sur le serveur, la date de modification du fichier 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.
Note Le mode sĂ©curisĂ© ne peut ĂȘtre utilisĂ© conjointement avec lâoption nooverwrite (voir plus bas).
Emplacements de stockage des fichiers du site
Le mot-clĂ© 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 :
|
remote /www/monsite/ |
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 :
|
remote Ë/public_html/ |
Le mot-clĂ© 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 « Ë/ ».
|
local Ë/html/lesite/ |
|
|
local /home/fred/html/lesite/ |
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.
Traitement des permissions des fichiers
Le traitement des permissions des fichiers est contrÎlé par le mot-clé permissions , qui peut prendre une de ces trois valeurs :
|
ignore |
pour ignorer complĂštement les permissions des fichiers, |
||
|
exec |
pour propager les permissions des fichiers exécutables uniquement, |
||
|
all |
pour propager les permissions de tous les fichiers. |
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 chmod est exécuté cÎté serveur pour modifier les permissions.
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Ă© symlinks , qui peut prendre la valeur ignore, follow ou maintain.
Le mode par défaut est ignore, i.e. les liens symboliques trouvés sur la copie locale du site sont ignorés.
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 :
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.
Suppression et déplacememnt des fichiers distants
Vous pouvez utiliser lâoption 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 nooverwrite. Dans ce cas, avant de remonter un fichier, sitecopy supprimera au prĂ©alable la copie distante.
Si vous utilisez lâoption checkmoved, sitecopy 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 checkmoved renames, sitecopy cherchera si des fichiers ont Ă©tĂ© localement dĂ©placĂ©s ou renommĂ©s. Cette option nâest utilisable quâen conjonction avec lâoption state checksum.
AVERTISSEMENT
Si vous nâutilisez pas de somme de contrĂŽle MD5 pour dĂ©terminer lâĂ©tat des fichiers (i.e. avec lâoption state checksum ) NâUTILISEZ PAS non plus lâoption 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.
Exclure des fichiers
Certains
fichiers peuvent ĂȘtre ignorĂ©s de
sitecopy
par lâemploi du mot-clĂ©
exclude,
qui accepte des motifs dâexpressions
rationnelles Ă la maniĂšre 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 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,
exclude
/docs/*.m4
exclude
/files/*.gz
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,
exclude
/quelque/part
exclude
/autre/part
excluera les sous-répertoires du site
« quelque/part » et
« autre/part ».
Les motifs dâexclusion sont examinĂ©s lorsque sitecopy 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.
Ignorer les changements des fichiers locaux
Utilisez lâoption ignore pour indiquer Ă sitecopy 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 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 ignore sâutilise de la mĂȘme maniĂšre que lâoption exclude.
Notez que le mode synchronisation écrasera les changements apportés aux fichiers ignorés.
Mode de transfert par FTP
Pour
spécifier le mode de transfert des fichiers par FTP,
utilisez le mot-clé
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
ascii
*.pl
pour remonter tous les fichiers Ă lâextension
.pl comme des fichiers texte ASCII. Ce mot-clé est
actuellement sans effet avec les serveurs WebDAV.
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.
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
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
CONTENU DU FICHIER DE CONFIGURATION DâEXEMPLE
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/
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 *Ë
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 /
FICHIERS
Ë/.sitecopyrc
Emplacement par défaut du fichier de configuration.
Ë/.sitecopy/
Répertoire de stockage des
informations sur les fichiers du site distant.
Ë/.netrc
Informations relatives aux comptes sur des
serveurs distants.
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.
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.
VOIR AUSSI
rsync(1), ftp(1), mirror(1)
STANDARDS
[CitĂ©s seulement pour rĂ©fĂ©rence, lâauteur ne revendique aucune conformitĂ© Ă 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
ĂBAUCHES 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 périmée. En cas de doute, veuillez vous reporter au document original en langue anglaise fourni avec le programme.