63 lines
1.6 KiB
Text
63 lines
1.6 KiB
Text
|
cdist-type__rsyncer(7)
|
||
|
======================
|
||
|
Daniel Maher <phrawzty+cdist at gmail.com>
|
||
|
|
||
|
|
||
|
NAME
|
||
|
----
|
||
|
cdist-type__rsyncer - Use rsync to copy files.
|
||
|
|
||
|
|
||
|
DESCRIPTION
|
||
|
-----------
|
||
|
This type is used to trigger rsync to copy files from the machine running cdist
|
||
|
(source) to the target machine in question (destination). The likely usage is
|
||
|
the rapid deployment of full directory trees, the cohorency of which can be
|
||
|
guarunteed with the optional --delete argument, which will remove any files
|
||
|
from the destination which are not present on the source.
|
||
|
|
||
|
|
||
|
REQUIRED PARAMETERS
|
||
|
-------------------
|
||
|
source::
|
||
|
The full path of the source from which to copy. This is passed directly
|
||
|
to rsync.
|
||
|
|
||
|
|
||
|
OPTIONAL PARAMETERS
|
||
|
-------------------
|
||
|
destination::
|
||
|
The full path of the destination. This is passed directly to rsync.
|
||
|
Default: object_id
|
||
|
|
||
|
delete::
|
||
|
If true, remove files from destination which are not in source. This is
|
||
|
effectively the --delete argument of rsync.
|
||
|
Default: false
|
||
|
|
||
|
rsyncbin::
|
||
|
Specify the full path to the rsync binary.
|
||
|
Default: `which rsync`
|
||
|
|
||
|
EXAMPLES
|
||
|
--------
|
||
|
|
||
|
--------------------------------------------------------------------------------
|
||
|
# Basic example
|
||
|
__rsyncer '/home/foo' --source '/opt/dist/foo'
|
||
|
|
||
|
# Fancier example
|
||
|
__rsyncer FOO --source '/opt/dist/foo' --destination '/home/foo/' --delete true
|
||
|
--------------------------------------------------------------------------------
|
||
|
|
||
|
|
||
|
SEE ALSO
|
||
|
--------
|
||
|
- cdist-type(7)
|
||
|
|
||
|
|
||
|
COPYING
|
||
|
-------
|
||
|
Copyright \(C) 2011 Daniel Maher. Free use of this software is granted under
|
||
|
the terms of the GNU General Public License version 3 (GPLv3).
|