1 gnt-job(8) Ganeti | Version @GANETI_VERSION@
2 ============================================
12 **gnt-job** {command} [arguments...]
17 The **gnt-job** is used for examining and manipulating the job
28 This command can be used to archive job by their IDs. Only jobs
29 that have finished execution (i.e either *success*, *error* or
35 **autoarchive** {*age* | ``all``}
37 Archive jobs by their age. This command can archive jobs older than
38 *age* seconds, or alternatively all finished jobs can be archived
39 if the string all is passed.
45 | {[\--force] {\--pending | \--queued | \--waiting} | *job-id* ...}
47 Cancel the job(s) identified by the given *job id*. Only jobs that have
48 not yet started to run can be canceled; that is, jobs in either the
49 *queued* or *waiting* state. To skip a confirmation, pass ``--force``.
50 ``--queued`` and ``waiting`` can be used to cancel all jobs in the
51 respective state, ``--pending`` includes both.
56 | **change-priority** --priority {low | normal | high}
57 | {[\--force] {\--pending | \--queued | \--waiting} | *job-id* ...}
59 Changes the priority of one or multiple pending jobs. Jobs currently
60 running have only the priority of remaining opcodes changed.
61 ``--priority`` must be specified. ``--queued`` and ``waiting`` can be
62 used to re-prioritize all jobs in the respective state, ``--pending``
63 includes both. To skip a confirmation, pass ``--force``.
70 Show detailed information about the given job id(s). If no job id
71 is given, all jobs are examined (warning, this is a lot of
77 | **list** [\--no-headers] [\--separator=*SEPARATOR*]
78 | [-o *[+]FIELD,...*] [\--filter] [job-id...]
80 Lists the jobs and their status. By default, the job id, job
81 status, and a small job description is listed, but additional
82 parameters can be selected.
84 The ``--no-headers`` option will skip the initial header line. The
85 ``--separator`` option takes an argument which denotes what will be
86 used between the output fields. Both these options are to help
89 The ``-o`` option takes a comma-separated list of output fields.
90 The available fields and their meaning are:
94 If the value of the option starts with the character ``+``, the new
95 fields will be added to the default list. This allows one to quickly
96 see the default list plus a few other fields, instead of retyping
97 the entire list of fields.
99 To include archived jobs in the list the ``--archived`` option can be
102 The following options can be used to show only specific jobs:
105 Show only jobs pending execution.
107 Show jobs currently running only.
109 Show failed jobs only.
111 Show finished jobs only.
113 If exactly one argument is given and it appears to be a query filter
114 (see **ganeti(7)**), the query result is filtered accordingly. For
115 ambiguous cases (e.g. a single field name as a filter) the ``--filter``
116 (``-F``) option forces the argument to be treated as a filter.
122 **list-fields** [field...]
124 Lists available fields for jobs.
132 This command follows the output of the job by the given *id* and
135 .. vim: set textwidth=72 :