Differences

This shows you the differences between two versions of the page.

--- informatique:logiciels:rsync [2009/02/06 11:20] – créée pteu
+++ informatique:logiciels:rsync [2025/07/13 10:35] (current) – [Exemples d'utilisation] rsync parallèles pteu
@@ Line 3: / Line 3: @@
 ======Rsync======
-**Rsync** est un outil de synchronisation de fichiers :
+**Rsync** (remote synchronisation) est un outil de synchronisation de fichiers.
-  * pour envoyer des données de sa machin vers un hôte distant (en [[SSH]]) :
+Syntaxe (comme décrite dans le man) :
+<code>
+rsync [OPTION]... SRC [SRC]... DEST
+</code>
-  rsync -e ssh <SRC> <login>@<remote_host>:<dest>
+En utilisant le protocole SSH :
+<code>
+rsync [OPTION]... SRC [SRC]... [USER@]HOST:DEST
+rsync [OPTION]... [USER@]HOST:SRC [DEST]
+</code>
-  * pour rapatrier les fichiers d'un hôte distant sur sa machine :
+=====Paramètres courants=====
-  rsync -e ssh <login>@<remote_host>:<src> <dest>
+<code bash>
+ -a (archive mode) : équivalent de -rlptgoD
+ -r (recursive) : mode récursif, tient compte des sous-dossiers
+ -z : transfert en compressant les données
+ -n --dry-run : lancer le rsync pour tester, sans transférer aucun fichier
+ -v (verbose) : mode verbeux
+ -q (quiet) : mode moins verbeux
+ -l (links) : copie les liens symboliques comme liens symboliques
+ -L (copy-links) : transforme les liens symboliques par les fichiers référencés
+ -c (checksum) : utilise une sommed e contrôle plutôt que la date et la taille pour comparer les fichiers
+ -e : spécifie un shell distant
+ -g (group) : conserve le groupe du fichier
+ -o (owner) : conserve le propriétaire du fichier
+ -p (permission) : conserve les permissions du fichier
+ -t (time) : conserver la date du fichier
+ -A (acls) : préserve les ACLs
+ -X (xattrs) : préserve les attributs étendus
+ --delete : supprimer dans la dest. les fichiers n''existant pas dans la source
+ --force : force la suppression des répertoires même non-vides
+ --progress : affiche la progression par fichier pendant le transfert (la liste des fichiers traités)
+ --info progress2 : affiche le progression globale de la synchronisation
+ --stats : affiche des stats à la fin de la synchronisation :
+Number of files: 8557
+Number of files transferred: 4
+Total file size: 6074978567 bytes
+Total transferred file size: 17507 bytes
+Literal data: 16107 bytes
+Matched data: 1400 bytes
+File list size: 242295
+File list generation time: 0.001 seconds
+File list transfer time: 0.000 seconds
+Total bytes sent: 281060
+Total bytes received: 27088
+sent 281060 bytes  received 27088 bytes  16656.65 bytes/sec
+total size is 6074978567  speedup is 19714.48
+ --no-<opt> : annule l'option <opt> (ex : --no-o annule l'option -o)
+ --exclude 'REGEX' : exclure de la synchronisation les fichiers matchant la pattern ; peut être invoqué plusieurs fois pour plusieurs motifs, ou utilisé ainsi : --exclude={"/dev/*","/proc/*","/sys/*","/tmp/*","/run/*","/mnt/*","/media/*","/lost found"}
+</code>
+=====Exemples d'utilisation=====
+Différents exemples, en vrac :
+<code bash>
+rsync -progt --stats --exclude '*.load' /mnt/data/* /mnt/data-bck
+# avec 3 répertoires source
+rsync -av --delete --stats /home/dude /etc /var/log /mnt/bck
+# sauvegarder des fichiers vers une machine distante en SSH sur le port SSH non-standard 2222 :
+rsync -ptrzvL -e "ssh -p 2222" --delete /home/dude /var/log/htdocs dude@srv-distant:/home/dude/sync/
+# sauvegarder plusieurs répertoires d'une machine distante vers la machine locale, en SSH :
+rsync -ptrzvL -e ssh \
+	bck_user@machine_distante:'/etc/nagios/conf.d \
+	/usr/lib64/nagios/plugins \
+	/usr/local/nagios/libexec \
+	/opt/pnp4nagios' \
+	/backup_local
+</code>
+Pour lancer des rsync parallèles afin d'accélérer les trasnferts (si les disques suivent le débit réseau):
+<code bash>
+ls /data/bck | xargs -n1 -P4 -I% rsync -Pa % bckserver.com:/data/bck/
+</code>
+(src: [[https://stackoverflow.com/questions/24058544/speed-up-rsync-with-simultaneous-concurrent-file-transfers|https://stackoverflow.com/questions/24058544/speed-up-rsync-with-simultaneous-concurrent-file-transfers]])
+=====Liens=====
+  * [[http://man.developpez.com/man1/rsync.1.php|man traduit en français]]