PARSYNCFP2(1)

πŸ“¦
version 2.59+git20250602.e687b9f Β· 2 versions
, in ubuntu resolute, ubuntu stonking

πŸ’– PARSYNCFP2 πŸ’–

okay bestie, gather round, because parsyncfp2 is literally the manual page you've been waiting for β€” it's a MultiHost parallel rsync wrapper and it's giving main character energy for your big transfers. let's get into it 🫢


✨ SYNOPSIS ✨

parsyncfp2 [OPTION]... SRC... DEST

🌸 DESCRIPTION 🌸

so here's the tea: parsyncfp2 wraps rsync and gives you load balancing plus parallel operation across network connections, which substantially increases the amount of data it can send simultaneously. the way it does this is by exploiting parallel operation to decrease the impact of the TCP Round Trip Time (rtt), which significantly increases the total bandwidth of data across networks. even on low-latency networks, it can speed large transfers by 4-10x. πŸ”₯

but bestie, listen β€” it is not effective for small transfers, because the startup overhead will slow the effective throughput. tiny transfer? this is not the moment. πŸ’€

parsyncfp2 uses fpart to split the source data into chunks of a specified size (default: 10 GB), and then starts parallel instances of rsync to transfer those chunks. the slay part? it only needs to be installed on the source machine. it can optionally monitor the system's load average and limit the impact of the data transfer. and there's a multi-host mode too (several senders and receivers). iconic. πŸ‘‘


πŸŽ€ MAIN OPTIONS πŸŽ€

  • --np|NP=processes β€” number of parallel rsync processes to start. Default: sqrt(#CPUs) ✨
  • --chunksize|cs=size β€” aggregate size of files allocated to one rsync process. you can specify it using human-readable suffixes (100M, 1G). Default: 10G πŸ’…
  • --ro=options β€” options to pass to rsync. Default: -asl
  • --help β€” show more detailed information about parsyncfp2 usage πŸ¦‹

πŸ’€ IMPORTANT NOTES πŸ’€

rsync --delete options will not work with --ro, because the multiple parallel rsyncs that parsyncfp launches are independent and therefore don't know about each other (and so cannot exchange info about what should be deleted or not). use a final, separate rsync --delete to clean up the transfer if that's your need. periodt. πŸ™ˆ

parsyncfp2 only works on dirs and files that originate from the current dir (or specified via "--startdir"). you cannot include dirs and files from discontinuous or higher-level dirs. no cap. 🚫


🌈 EXAMPLE 🌈

use 4 rsync processes and a chunksize of 1G, and change rsync options to enable compression:

parsyncfp2 --np=4 --chunksize=1G --ro="-az" source_dir
host:target_dir

⭐ ADDITIONAL DOCUMENTATION ⭐

the parsyncfp2 manual lives right here bestie:

file:///usr/share/doc/parsyncfp2/parsyncfp2.html

and that's the whole vibe check, my love πŸ’– this was PARSYNCFP2 from section 1 of the manual, source/version PARSYNCFP2, dated 2025-11-13 β€” go forth and transfer your data in parallel, you absolute icon πŸ‘‘βœ¨πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from