Revision 7ba19f39 man/ganeti.rst

b/man/ganeti.rst
158 158
    stopped during the job execution.
159 159

  
160 160

  
161
Common options
162
--------------
161
Common command line features
162
----------------------------
163

  
164
Options
165
~~~~~~~
163 166

  
164 167
Many Ganeti commands provide the following options. The
165 168
availability for a certain command can be checked by calling the
......
173 176
The option ``--priority`` sets the priority for opcodes submitted
174 177
by the command.
175 178

  
176

  
177
Common daemon functionality
178
---------------------------
179

  
180
All Ganeti daemons re-open the log file(s) when sent a SIGHUP signal.
181
**logrotate**(8) can be used to rotate Ganeti's log files.
182

  
183
Common field formatting
184
-----------------------
179
Field formatting
180
----------------
185 181

  
186 182
Multiple ganeti commands use the same framework for tabular listing of
187 183
resources (e.g. **gnt-instance list**, **gnt-node list**, **gnt-group
......
214 210
    are using a field that the running Ganeti master daemon doesn't
215 211
    know. This result is persistent, re-running the command won't
216 212
    change it.
213

  
214
Key-value parameters
215
~~~~~~~~~~~~~~~~~~~~
216

  
217
Multiple options take parameters that are of the form
218
``key=value,key=value,...`` or ``category:key=value,...``. Examples
219
are the hypervisor parameters, backend parameters, etc. For these,
220
it's possible to use values that contain commas by escaping with via a
221
backslash (which needs two if not single-quoted, due to shell
222
behaviour)::
223

  
224
  # gnt-instance modify -H kernel_path=an\\,example instance1
225
  # gnt-instance modify -H kernel_path='an\,example' instance1
226

  
227
Common daemon functionality
228
---------------------------
229

  
230
All Ganeti daemons re-open the log file(s) when sent a SIGHUP signal.
231
**logrotate**(8) can be used to rotate Ganeti's log files.

Also available in: Unified diff