tomahawk-rsync manual page¶
SYNOPSIS¶
tomahawk-rsync [options] source destination
DESCRIPTION¶
tomahawk-rsync is a program that enables to copy files <into/from> many hosts.
$ tomahawk-rsync -h host1,host2,host3 test.py /tmp/test.py
—> ‘test.py’ is copied to host1, host2 and host3.
$ tomahawk-rsync -f web.list /usr/local/apache2/conf/httpd.conf /tmp/httpd.conf
—> ‘httpd.conf’ is copied to hosts which listed in ‘web.list’.
$ tomahawk-rsync -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’.
rsync¶
tomahawk-rsync copies files via ‘rsync’. You can specify options for rsync with -o/–rsync-ooptions.
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 by a configuration file.
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, tomahawk or tomahawk-rsync prompt as “command “%s” will be executed %s hosts. Are you sure? [yes/NO]: ”. The environment variable exists for mis-execution of a command.
SEE ALSO¶
- tomahawk(1)
- ssh(1)
- rsync(1)