1SALT-CALL(1) Salt SALT-CALL(1)
2
6 salt-call - salt-call Documentation
7
9 salt-call [options]
10
12 The salt-call command is used to run module functions locally on a min‐
13 ion instead of executing them from the master. Salt-call is used to run
14 a Standalone Minion, and was originally created for troubleshooting.
15 The Salt Master is contacted to retrieve state files and other
17 resources during execution unless the --local option is specified.
18 NOTE:
20 salt-call commands execute from the current user's shell context,
21 while salt commands execute from the system's default context.
22
24 --version
25 Print the version of Salt that is running.
26 --versions-report
28 Show program's dependencies and version number, and then exit
29 -h, --help
31 Show the help message and exit
32 -c CONFIG_DIR, --config-dir=CONFIG_dir
34 The location of the Salt configuration directory. This directory
35 contains the configuration files for Salt master and minions.
36 The default location on most systems is /etc/salt.
37 --hard-crash
39 Raise any original exception rather than exiting gracefully
40 Default: False
41 -g, --grains
43 Return the information generated by the Salt grains
44 -m MODULE_DIRS, --module-dirs=MODULE_DIRS
46 Specify an additional directory to pull modules from. Multiple
47 directories can be provided by passing -m /--module-dirs multi‐
48 ple times.
49 -d, --doc, --documentation
51 Return the documentation for the specified module or for all
52 modules if none are specified
53 --master=MASTER
55 Specify the master to use. The minion must be authenticated with
56 the master. If this option is omitted, the master options from
57 the minion config will be used. If multi masters are set up the
58 first listed master that responds will be used.
59 --return RETURNER
61 Set salt-call to pass the return data to one or many returner
62 interfaces. To use many returner interfaces specify a comma
63 delimited list of returners.
64 --local
66 Run salt-call locally, as if there was no master running.
67 --file-root=FILE_ROOT
69 Set this directory as the base file root.
70 --pillar-root=PILLAR_ROOT
72 Set this directory as the base pillar root.
73 --retcode-passthrough
75 Exit with the salt call retcode and not the salt binary retcode
76 --metadata
78 Print out the execution metadata as well as the return. This
79 will print out the outputter data, the return code, etc.
80 --id=ID
82 Specify the minion id to use. If this option is omitted, the id
83 option from the minion config will be used.
84 --skip-grains
86 Do not load grains.
87 --refresh-grains-cache
89 Force a refresh of the grains cache
90 Logging Options
92 Logging options which override any settings defined on the configura‐
93 tion files.
94 -l LOG_LEVEL, --log-level=LOG_LEVEL
96 Console logging log level. One of all, garbage, trace, debug,
97 info, warning, error, quiet. Default: warning.
98 --log-file=LOG_FILE
100 Log file path. Default: /var/log/salt/minion.
101 --log-file-level=LOG_LEVEL_LOGFILE
103 Logfile logging log level. One of all, garbage, trace, debug,
104 info, warning, error, quiet. Default: warning.
105 Output Options
107 --out Pass in an alternative outputter to display the return of data.
108 This outputter can be any of the available outputters:
109 grains, highstate, json, key, overstatestage, pprint, raw,
110 txt, yaml
111 Some outputters are formatted only for data returned from spe‐
113 cific functions; for instance, the grains outputter will not
114 work for non-grains data.
115 If an outputter is used that does not support the data passed
117 into it, then Salt will fall back on the pprint outputter and
118 display the return data using the Python pprint standard library
119 module.
120 NOTE:
122 If using --out=json, you will probably want --static as well.
123 Without the static option, you will get a separate JSON
124 string per minion which makes JSON output invalid as a whole.
125 This is due to using an iterative outputter. So if you want
126 to feed it to a JSON parser, use --static as well.
127 --out-indent OUTPUT_INDENT, --output-indent OUTPUT_INDENT
129 Print the output indented by the provided value in spaces. Nega‐
130 tive values disable indentation. Only applicable in outputters
131 that support indentation.
132 --out-file=OUTPUT_FILE, --output-file=OUTPUT_FILE
134 Write the output to the specified file.
135 --out-file-append, --output-file-append
137 Append the output to the specified file.
138 --no-color
140 Disable all colored output
141 --force-color
143 Force colored output
144 NOTE:
146 When using colored output the color codes are as follows:
147 green denotes success, red denotes failure, blue denotes
149 changes and success and yellow denotes a expected future
150 change in configuration.
151 --state-output=STATE_OUTPUT, --state_output=STATE_OUTPUT
153 Override the configured state_output value for minion output.
154 One of 'full', 'terse', 'mixed', 'changes' or 'filter'. Default:
155 'none'.
156 --state-verbose=STATE_VERBOSE, --state_verbose=STATE_VERBOSE
158 Override the configured state_verbose value for minion output.
159 Set to True or False. Default: none.
160
162 salt(1) salt-master(1) salt-minion(1)
163
165 Thomas S. Hatch <thatch45@gmail.com> and many others, please see the
166 Authors file
1672019.2.0 Jan 08, 2019 SALT-CALL(1)