2014-06-30 21:04:53 +00:00
|
|
|
.\" Man page generated from reStructuredText.
|
|
|
|
.
|
2015-05-06 17:08:46 +00:00
|
|
|
.TH "SALT-CP" "1" "May 06, 2015" "2015.5.0" "Salt"
|
2011-05-14 04:43:58 +00:00
|
|
|
.SH NAME
|
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
|
|
|
|
..
|
|
|
|
.sp
|
|
|
|
Copy a file to a set of systems
|
2011-05-14 04:43:58 +00:00
|
|
|
.SH SYNOPSIS
|
2014-06-30 21:04:53 +00:00
|
|
|
.INDENT 0.0
|
|
|
|
.INDENT 3.5
|
2011-05-30 22:24:23 +00:00
|
|
|
.sp
|
|
|
|
.nf
|
|
|
|
.ft C
|
|
|
|
salt\-cp \(aq*\(aq [ options ] SOURCE DEST
|
2011-05-14 04:43:58 +00:00
|
|
|
|
2011-05-30 22:24:23 +00:00
|
|
|
salt\-cp \-E \(aq.*\(aq [ options ] SOURCE DEST
|
2011-05-14 04:43:58 +00:00
|
|
|
|
2011-05-30 22:24:23 +00:00
|
|
|
salt\-cp \-G \(aqos:Arch.*\(aq [ options ] SOURCE DEST
|
|
|
|
.ft P
|
|
|
|
.fi
|
2014-06-30 21:04:53 +00:00
|
|
|
.UNINDENT
|
|
|
|
.UNINDENT
|
2011-05-14 04:43:58 +00:00
|
|
|
.SH DESCRIPTION
|
2011-05-30 22:24:23 +00:00
|
|
|
.sp
|
2012-06-16 22:25:22 +00:00
|
|
|
Salt copy copies a local file out to all of the Salt minions matched by the
|
2011-05-30 22:24:23 +00:00
|
|
|
given target.
|
2011-05-14 04:43:58 +00:00
|
|
|
.SH OPTIONS
|
2011-05-30 22:24:23 +00:00
|
|
|
.INDENT 0.0
|
2011-05-14 04:43:58 +00:00
|
|
|
.TP
|
2013-09-17 23:58:01 +00:00
|
|
|
.B \-\-version
|
|
|
|
Print the version of Salt that is running.
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
|
|
|
.TP
|
|
|
|
.B \-\-versions\-report
|
|
|
|
Show program\(aqs dependencies and version number, and then exit
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
|
|
|
.TP
|
2011-05-30 22:24:23 +00:00
|
|
|
.B \-h, \-\-help
|
2013-09-17 23:58:01 +00:00
|
|
|
Show the help message and exit
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
|
|
|
.TP
|
|
|
|
.B \-c CONFIG_DIR, \-\-config\-dir=CONFIG_dir
|
|
|
|
The location of the Salt configuration directory. This directory contains
|
|
|
|
the configuration files for Salt master and minions. The default location
|
2014-06-30 21:04:53 +00:00
|
|
|
on most systems is \fB/etc/salt\fP\&.
|
2011-05-30 22:24:23 +00:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2011-05-14 04:43:58 +00:00
|
|
|
.TP
|
2011-05-30 22:24:23 +00:00
|
|
|
.B \-t TIMEOUT, \-\-timeout=TIMEOUT
|
2013-09-17 23:58:01 +00:00
|
|
|
The timeout in seconds to wait for replies from the Salt minions. The
|
|
|
|
timeout number specifies how long the command line client will wait to
|
|
|
|
query the minions and check on running jobs. Default: 5
|
|
|
|
.UNINDENT
|
|
|
|
.SS Logging Options
|
|
|
|
.sp
|
|
|
|
Logging options which override any settings defined on the configuration files.
|
|
|
|
.INDENT 0.0
|
|
|
|
.TP
|
|
|
|
.B \-l LOG_LEVEL, \-\-log\-level=LOG_LEVEL
|
|
|
|
Console logging log level. One of \fBall\fP, \fBgarbage\fP, \fBtrace\fP,
|
2014-06-30 21:04:53 +00:00
|
|
|
\fBdebug\fP, \fBinfo\fP, \fBwarning\fP, \fBerror\fP, \fBquiet\fP\&. Default:
|
|
|
|
\fBwarning\fP\&.
|
2011-05-30 22:24:23 +00:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2011-05-14 04:43:58 +00:00
|
|
|
.TP
|
2013-09-17 23:58:01 +00:00
|
|
|
.B \-\-log\-file=LOG_FILE
|
2014-06-30 21:04:53 +00:00
|
|
|
Log file path. Default: /var/log/salt/master\&.
|
2013-09-17 23:58:01 +00:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
|
|
|
.TP
|
|
|
|
.B \-\-log\-file\-level=LOG_LEVEL_LOGFILE
|
|
|
|
Logfile logging log level. One of \fBall\fP, \fBgarbage\fP, \fBtrace\fP,
|
2014-06-30 21:04:53 +00:00
|
|
|
\fBdebug\fP, \fBinfo\fP, \fBwarning\fP, \fBerror\fP, \fBquiet\fP\&. Default:
|
|
|
|
\fBwarning\fP\&.
|
2013-09-17 23:58:01 +00:00
|
|
|
.UNINDENT
|
|
|
|
.SS Target Selection
|
|
|
|
.INDENT 0.0
|
|
|
|
.TP
|
2011-05-30 22:24:23 +00:00
|
|
|
.B \-E, \-\-pcre
|
2012-06-16 22:25:22 +00:00
|
|
|
The target expression will be interpreted as a PCRE regular expression
|
2011-05-30 22:24:23 +00:00
|
|
|
rather than a shell glob.
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2011-05-14 04:43:58 +00:00
|
|
|
.TP
|
2011-05-30 22:24:23 +00:00
|
|
|
.B \-L, \-\-list
|
2013-09-17 23:58:01 +00:00
|
|
|
The target expression will be interpreted as a comma\-delimited list;
|
2011-05-26 11:17:02 +00:00
|
|
|
example: server1.foo.bar,server2.foo.bar,example7.quo.qux
|
2011-05-30 22:24:23 +00:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2011-05-14 04:43:58 +00:00
|
|
|
.TP
|
2011-05-30 22:24:23 +00:00
|
|
|
.B \-G, \-\-grain
|
2012-06-16 22:25:22 +00:00
|
|
|
The target expression matches values returned by the Salt grains system on
|
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
|
2013-09-17 23:58:01 +00:00
|
|
|
.sp
|
|
|
|
This was changed in version 0.9.8 to accept glob expressions instead of
|
|
|
|
regular expression. To use regular expression matching with grains, use
|
|
|
|
the \-\-grain\-pcre option.
|
2012-03-19 19:02:36 +00:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
|
|
|
.TP
|
|
|
|
.B \-\-grain\-pcre
|
2012-06-16 22:25:22 +00:00
|
|
|
The target expression matches values returned by the Salt grains system on
|
2013-09-17 23:58:01 +00:00
|
|
|
the minions. The target expression is in the format of \(aq<grain value>:<
|
2012-01-16 23:36:59 +00:00
|
|
|
regular expression>\(aq; example: \(aqos:Arch.*\(aq
|
2011-05-30 22:24:23 +00:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2011-05-14 04:43:58 +00:00
|
|
|
.TP
|
2013-09-17 23:58:01 +00:00
|
|
|
.B \-N, \-\-nodegroup
|
|
|
|
Use a predefined compound target defined in the Salt master configuration
|
|
|
|
file.
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
|
|
|
.TP
|
2012-03-19 19:02:36 +00:00
|
|
|
.B \-R, \-\-range
|
2013-09-17 23:58:01 +00:00
|
|
|
Instead of using shell globs to evaluate the target, use a range expression
|
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
|
2012-05-10 22:10:39 +00:00
|
|
|
.SH SEE ALSO
|
|
|
|
.sp
|
|
|
|
\fIsalt(1)\fP
|
|
|
|
\fIsalt\-master(1)\fP
|
|
|
|
\fIsalt\-minion(1)\fP
|
2011-05-30 22:24:23 +00:00
|
|
|
.SH AUTHOR
|
2012-07-28 00:04:56 +00:00
|
|
|
Thomas S. Hatch <thatch45@gmail.com> and many others, please see the Authors file
|
2011-05-30 22:24:23 +00:00
|
|
|
.SH COPYRIGHT
|
2015-03-10 00:36:38 +00:00
|
|
|
2015 SaltStack, Inc.
|
2011-05-30 22:24:23 +00:00
|
|
|
.\" Generated by docutils manpage writer.
|
|
|
|
.
|