TOMAHAWK-RSYNC3(1)

📦 version 0.7.1, in debian bookworm

💖 TOMAHAWK-RSYNC3(1) 💖

okay bestie, welcome to tomahawk-rsync3 — it lives in the tomahawk3 manual family, and it's literally the girl who copies your files to a whole squad of hosts at once. no cap. 🦋

✨ NAME ✨

tomahawk-rsync3 — enables to copy files to many hosts 🌸

🎀 SYNOPSIS 🎀

tomahawk-rsync3 [options] source destination

💅 DESCRIPTION 💅

tomahawk-rsync3 is a program that enables to copy files <into/from> many hosts. like, many many. it's giving "one command, whole fleet". 👑

$ tomahawk-rsync3 -h host1,host2,host3 test.py /tmp/test.py

---> 'test.py' is copied to host1, host2 and host3. slay. 💫

$ tomahawk-rsync3 -f web.list /usr/local/apache2/conf/httpd.conf /tmp/httpd.conf

---> 'httpd.conf' is copied to hosts which listed in 'web.list'.

$ tomahawk-rsync3 -h host1,host2 -m pull /usr/local/apache2/conf/httpd.conf /tmp/conf/

---> 'httpd.conf' is copied from host1 and host2 to local directory /tmp/conf as 'host1__httpd.conf' and 'host2__httpd.conf'. yes she names them like that, it's iconic, don't question it. 🎀

🌈 rsync 🌈

tomahawk-rsync3 copies files via 'rsync'. You can specify options for rsync with -o/--rsync-ooptions.

ok so heads up: the flag is spelled --rsync-ooptions in the manpage and we are keeping it EXACTLY, no fixing, no renaming, periodt. 💀

🌸 OPTIONS 🌸

These programs follow the usual GNU command line syntax, with long options starting with two dashes ('--'). A summary of options is included below. For a complete description, see the Info files.

🫶 -H, --hosts

Specifies host names for sending commands. You can specify multiple hosts with ','.

🫶 -f, --hosts-files

Specifies hosts files which listed host names for sending commands. You can specify multiple hosts files with ','.

Format of hosts file is below.

web01
web02
#web03
web04

A line of starting with '#' disables a host.

🫶 -l, --prompt-login-password

Prompts a password for ssh authentication of rsync at first. If the password is all the same between target hosts, you'll input a password just once.

🫶 -c, --continue-on-error

Continues to send commands even if any errors. The default behavior is fail-safe, means that tomahawk will stop if any errors.

🫶 -p, --parallel

Specifies a number of processes for parallel command execution. (default: 1) If your machine has many cpu cores, --parallel 2 .. N might be faster.

🫶 -t, --timeout

Specifies timeout seconds for a command.

🫶 -F, --output-format

Specifies command output format. The default is '${user}@${host} % ${command}n${output}n'

🫶 -u, --rsync-user

Specifies rsync user. The default is a current logged in user.

🫶 -o, --rsync-options

Specifies rsync options. The default is '-av'

🫶 -m, --mirror-mode

Selection of 'push' or 'pull'. 'pull' means copy files from remote to local. The default is 'push'.

🫶 -C, --conf

Specifies configuration file path. For additional information, see omit-command-line-options

💜 ENVIRONMENT VARIABLES 💜

tomahawk's behavior is affected by the following environment variables.

🌟 TOMAHAWK_ENV

This variable specifies an environment of 'production', 'testing' or 'development'. If TOMAHAWK_ENV=production specified, tomahawk3 or tomahawk-rsync3 prompt as "command "%s" will be executed %s hosts. Are you sure? [yes/NO]: ". The environment variable exists for mis-execution of a command.

fr fr, that prompt is your bestie grabbing your wrist before you nuke prod. listen to her. 🙈

🔥 SEE ALSO 🔥

👑 AUTHOR 👑

Kazuhiro Oinuma, Kohei Maeda

2011-2014, Kazuhiro Oinuma

and that's the whole vibe check bestie — this edition is version 0.7.0, dated April 17, 2014, and yes it's lowkey vintage but it still ate. go copy some files. 🧚💜✨

📦 where this page comes from