---
name: "tomahawk-rsync3"
section: "1"
platform: "linux"
package: "python3-tomahawk"
version: "0.7.1-2.1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/tomahawk-rsync3"
---

# tomahawk-rsync3(1)

enables to copy files to many hosts

## 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.

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

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

```
$ 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'.

### rsync

tomahawk-rsync3 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*

## 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.

## SEE ALSO

- •

  *[tomahawk3(1)](/tomahawk3/1.md)*

- •

  *[ssh(1)](/ssh/1.md)*

- •

  *[rsync(1)](/rsync/1.md)*

## AUTHOR

Kazuhiro Oinuma, Kohei Maeda

## COPYRIGHT

2011-2014, Kazuhiro Oinuma