salt/doc/man/salt-cp.1

.TH "SALT-CP" "1" "February 12, 2013" "0.13.0" "Salt"
.SH NAME
salt-cp \- salt-cp Documentation
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.\" Man page generated from reStructuredText.
.
.sp
Copy a file to a set of systems
.SH SYNOPSIS
.sp
.nf
.ft C
salt\-cp \(aq*\(aq [ options ] SOURCE DEST

salt\-cp \-E \(aq.*\(aq [ options ] SOURCE DEST

salt\-cp \-G \(aqos:Arch.*\(aq [ options ] SOURCE DEST
.ft P
.fi
.SH DESCRIPTION
.sp
Salt copy copies a local file out to all of the Salt minions matched by the
given target.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-h, \-\-help
Print a usage message briefly summarizing these command\-line options
.UNINDENT
.INDENT 0.0
.TP
.B \-t TIMEOUT, \-\-timeout=TIMEOUT
The timeout in seconds to wait for replies from the Salt minions.
.UNINDENT
.INDENT 0.0
.TP
.B \-E, \-\-pcre
The target expression will be interpreted as a PCRE regular expression
rather than a shell glob.
.UNINDENT
.INDENT 0.0
.TP
.B \-L, \-\-list
The target expression will be interpreted as a comma delimited list,
example: server1.foo.bar,server2.foo.bar,example7.quo.qux
.UNINDENT
.INDENT 0.0
.TP
.B \-G, \-\-grain
The target expression matches values returned by the Salt grains system on
the minions. The target expression is in the format of \(aq<grain value>:<glob
expression>\(aq; example: \(aqos:Arch*\(aq
.UNINDENT
.INDENT 0.0
.TP
.B \-\-grain\-pcre
The target expression matches values returned by the Salt grains system on
the minions. The target expression is in the format of \(aq<grain value>:<pcre
regular expression>\(aq; example: \(aqos:Arch.*\(aq
.UNINDENT
.INDENT 0.0
.TP
.B \-R, \-\-range
Instead of using shell globs to evaluate the target use a range expression
to identify targets. Range expressions look like %cluster.
.sp
Using the Range option requires that a range server is set up and the
location of the range server is referenced in the master configuration
file.
.UNINDENT
.INDENT 0.0
.TP
.B \-C, \-\-compound
Utilize many target definitions to make the call very granular. This option
takes a group of targets separated by and or or. The default matcher is a
glob as usual, if something other than a glob is used preface it with the
letter denoting the type, example: \(aqwebserv* and \fI\%G@os\fP:Debian or \fI\%E@db*\fP\(aq
make sure that the compound target is encapsulated in quotes.
.UNINDENT
.INDENT 0.0
.TP
.B \-c CONFIG, \-\-config=CONFIG
The location of the Salt master configuration file, the Salt master
settings are required to know where the connections are;
default=/etc/salt/master
.UNINDENT
.SH SEE ALSO
.sp
\fIsalt(1)\fP
\fIsalt\-master(1)\fP
\fIsalt\-minion(1)\fP
.SH AUTHOR
Thomas S. Hatch <thatch45@gmail.com> and many others, please see the Authors file
.SH COPYRIGHT
2013, Thomas S. Hatch
.\" Generated by docutils manpage writer.
.
update man pages for 0.13.0 2013-02-12 19:02:51 +00:00			`.TH "SALT-CP" "1" "February 12, 2013" "0.13.0" "Salt"`
Add a manpage for salt-cp 2011-05-14 04:43:58 +00:00			`.SH NAME`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`salt-cp \- salt-cp Documentation`
			`.`
			`.nr rst2man-indent-level 0`
			`.`
			`.de1 rstReportMargin`
			`\\$1 \\n[an-margin]`
			`level \\n[rst2man-indent-level]`
			`level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]`
			`-`
			`\\n[rst2man-indent0]`
			`\\n[rst2man-indent1]`
			`\\n[rst2man-indent2]`
			`..`
			`.de1 INDENT`
			`.\" .rstReportMargin pre:`
			`. RS \\$1`
			`. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]`
			`. nr rst2man-indent-level +1`
			`.\" .rstReportMargin post:`
			`..`
			`.de UNINDENT`
			`. RE`
			`.\" indent \\n[an-margin]`
			`.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]`
			`.nr rst2man-indent-level -1`
			`.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]`
			`.in \\n[rst2man-indent\\n[rst2man-indent-level]]u`
			`..`
update man pages for 0.13.0 2013-02-12 19:02:51 +00:00			`.\" Man page generated from reStructuredText.`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.`
			`.sp`
			`Copy a file to a set of systems`
Add a manpage for salt-cp 2011-05-14 04:43:58 +00:00			`.SH SYNOPSIS`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.sp`
			`.nf`
			`.ft C`
			`salt\-cp \(aq*\(aq [ options ] SOURCE DEST`
Add a manpage for salt-cp 2011-05-14 04:43:58 +00:00
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`salt\-cp \-E \(aq.*\(aq [ options ] SOURCE DEST`
Add a manpage for salt-cp 2011-05-14 04:43:58 +00:00
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`salt\-cp \-G \(aqos:Arch.*\(aq [ options ] SOURCE DEST`
			`.ft P`
			`.fi`
Add a manpage for salt-cp 2011-05-14 04:43:58 +00:00			`.SH DESCRIPTION`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.sp`
Man pages for 0.10.0 2012-06-16 22:25:22 +00:00			`Salt copy copies a local file out to all of the Salt minions matched by the`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`given target.`
Add a manpage for salt-cp 2011-05-14 04:43:58 +00:00			`.SH OPTIONS`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.INDENT 0.0`
Add a manpage for salt-cp 2011-05-14 04:43:58 +00:00			`.TP`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.B \-h, \-\-help`
			`Print a usage message briefly summarizing these command\-line options`
			`.UNINDENT`
			`.INDENT 0.0`
Add a manpage for salt-cp 2011-05-14 04:43:58 +00:00			`.TP`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.B \-t TIMEOUT, \-\-timeout=TIMEOUT`
Man pages for 0.10.0 2012-06-16 22:25:22 +00:00			`The timeout in seconds to wait for replies from the Salt minions.`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.UNINDENT`
			`.INDENT 0.0`
Add a manpage for salt-cp 2011-05-14 04:43:58 +00:00			`.TP`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.B \-E, \-\-pcre`
Man pages for 0.10.0 2012-06-16 22:25:22 +00:00			`The target expression will be interpreted as a PCRE regular expression`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`rather than a shell glob.`
			`.UNINDENT`
			`.INDENT 0.0`
Add a manpage for salt-cp 2011-05-14 04:43:58 +00:00			`.TP`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.B \-L, \-\-list`
update man pages for 0.9.7 2012-02-15 16:54:37 +00:00			`The target expression will be interpreted as a comma delimited list,`
Typos, white-space, unused/missing imports, wrapping, PEP-8. 2011-05-26 11:17:02 +00:00			`example: server1.foo.bar,server2.foo.bar,example7.quo.qux`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.UNINDENT`
			`.INDENT 0.0`
Add a manpage for salt-cp 2011-05-14 04:43:58 +00:00			`.TP`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.B \-G, \-\-grain`
Man pages for 0.10.0 2012-06-16 22:25:22 +00:00			`The target expression matches values returned by the Salt grains system on`
Update live manpages for 0.9.8 2012-03-19 19:02:36 +00:00			`the minions. The target expression is in the format of \(aq<grain value>:<glob`
			`expression>\(aq; example: \(aqos:Arch*\(aq`
			`.UNINDENT`
			`.INDENT 0.0`
			`.TP`
			`.B \-\-grain\-pcre`
Man pages for 0.10.0 2012-06-16 22:25:22 +00:00			`The target expression matches values returned by the Salt grains system on`
Debian/Ubuntu package for upstream acceptance Applying latest changes for packaging Fixed typos in man pages Latest round of changes More packaging fixups Fixed salt-common typo Fixed wildcarding in install files Removed extra man pages Removed trailing slash Fixed links Moved binaries to proper packages Fixed man pages Pathing Perms tweak Missing files Fixed spacing Fixed another lintian error build the msgpack stuff Updating rules and install files Fixed shebang Control updates Fixed copyright file Fixed lintian Fixed overrides cmd.retcode no longer uses subprocess.call since it is broken fix issue with source_hash and trailing whitespace Bye-bye pickle, hello msgpack Add docs for new source powers Add support for source_hash to be a source hash string add pure python template type add return clarifying that no states were found if no states are found change some strings to use format add code to cache jobs on the minion if option is set serialize cache data was caching the wrong line data Add cache_jobs to the minion config template add docs for new config param cache_jobs make the minions return to the master in addition to returning to returners Add capability to designate multiple returns only run the apache module if apachectl is installed only load solr module if solr is installed Debug statement used the wrong variable. Only load nginx on machines that have nginx installed Make it more like the apache module 2012-01-16 23:36:59 +00:00			`the minions. The target expression is in the format of \(aq<grain value>:<pcre`
			`regular expression>\(aq; example: \(aqos:Arch.*\(aq`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.UNINDENT`
			`.INDENT 0.0`
Add a manpage for salt-cp 2011-05-14 04:43:58 +00:00			`.TP`
Update live manpages for 0.9.8 2012-03-19 19:02:36 +00:00			`.B \-R, \-\-range`
update the man pages for 0.9.9 2012-04-27 22:43:55 +00:00			`Instead of using shell globs to evaluate the target use a range expression`
Update live manpages for 0.9.8 2012-03-19 19:02:36 +00:00			`to identify targets. Range expressions look like %cluster.`
			`.sp`
			`Using the Range option requires that a range server is set up and the`
			`location of the range server is referenced in the master configuration`
			`file.`
			`.UNINDENT`
			`.INDENT 0.0`
			`.TP`
			`.B \-C, \-\-compound`
			`Utilize many target definitions to make the call very granular. This option`
			`takes a group of targets separated by and or or. The default matcher is a`
			`glob as usual, if something other than a glob is used preface it with the`
			`letter denoting the type, example: \(aqwebserv* and \fI\%G@os\fP:Debian or \fI\%E@db*\fP\(aq`
			`make sure that the compound target is encapsulated in quotes.`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.UNINDENT`
			`.INDENT 0.0`
Add a manpage for salt-cp 2011-05-14 04:43:58 +00:00			`.TP`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.B \-c CONFIG, \-\-config=CONFIG`
Man pages for 0.10.0 2012-06-16 22:25:22 +00:00			`The location of the Salt master configuration file, the Salt master`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`settings are required to know where the connections are;`
			`default=/etc/salt/master`
			`.UNINDENT`
Add 'See also' section to man pages 2012-05-10 22:10:39 +00:00			`.SH SEE ALSO`
			`.sp`
			`\fIsalt(1)\fP`
			`\fIsalt\-master(1)\fP`
			`\fIsalt\-minion(1)\fP`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.SH AUTHOR`
generate fresh manpages for 0.10.2 2012-07-28 00:04:56 +00:00			`Thomas S. Hatch <thatch45@gmail.com> and many others, please see the Authors file`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.SH COPYRIGHT`
update manpages for 0.12.0 2013-01-16 03:49:54 +00:00			`2013, Thomas S. Hatch`
Merge the rendered spinx man pages into the deployment dir 2011-05-30 22:24:23 +00:00			`.\" Generated by docutils manpage writer.`
			`.`