Fix error printing
[ganeti-local] / man / gnt-debug.rst
index d426b7d..c6a637d 100644 (file)
@@ -19,13 +19,13 @@ The **gnt-debug** is used for debugging the Ganeti system.
 COMMANDS
 --------
 
-ALLOCATOR
-~~~~~~~~~
+IALLOCATOR
+~~~~~~~~~~
 
-**allocator** [--debug] [--dir *DIRECTION*] {--algorithm
-*ALLOCATOR* } [--mode *MODE*] [--mem *MEMORY*] [--disks *DISKS*]
-[--disk-template *TEMPLATE*] [--nics *NICS*] [--os-type *OS*]
-[--vcpus *VCPUS*] [--tags *TAGS*] {*instance*}
+**iallocator** [\--debug] [\--dir *DIRECTION*] {\--algorithm
+*ALLOCATOR* } [\--mode *MODE*] [\--mem *MEMORY*] [\--disks *DISKS*]
+[\--disk-template *TEMPLATE*] [\--nics *NICS*] [\--os-type *OS*]
+[\--vcpus *VCPUS*] [\--tags *TAGS*] {*instance*}
 
 Executes a test run of the *iallocator* framework.
 
@@ -46,7 +46,7 @@ this framework, see the HTML or PDF documentation.
 DELAY
 ~~~~~
 
-**delay** [--debug] [--no-master] [-n *NODE*...] {*duration*}
+**delay** [\--debug] [\--no-master] [-n *NODE*...] {*duration*}
 
 Run a test opcode (a sleep) on the master and on selected nodes
 (via an RPC call). This serves no other purpose but to execute a
@@ -62,8 +62,8 @@ number.
 SUBMIT-JOB
 ~~~~~~~~~~
 
-**submit-job** [--verbose] [--timing-stats] [--job-repeat ``N``]
-[--op-repeat ``N``] {opcodes_file...}
+**submit-job** [\--verbose] [\--timing-stats] [\--job-repeat *N*]
+[\--op-repeat *N*] [\--each] {opcodes_file...}
 
 This command builds a list of opcodes from files in JSON format and
 submits a job per file to the master daemon. It can be used to test
@@ -82,6 +82,9 @@ passing the arguments N times) while op-repeat will cause N copies
 of each of the opcodes in the file to be executed (equivalent to
 each file containing N copies of the opcodes).
 
+The ``each`` option allow to submit each job separately (using ``N``
+SubmitJob LUXI requests instead of one SubmitManyJobs request).
+
 TEST-JOBQUEUE
 ~~~~~~~~~~~~~
 
@@ -93,8 +96,8 @@ failed jobs deliberately.
 LOCKS
 ~~~~~
 
-| **locks** [--no-headers] [--separator=*SEPARATOR*]
-| [-o *[+]FIELD,...*] [--interval=*SECONDS*]
+| **locks** [\--no-headers] [\--separator=*SEPARATOR*] [-v]
+| [-o *[+]FIELD,...*] [\--interval=*SECONDS*]
 
 Shows a list of locks in the master daemon.
 
@@ -103,26 +106,24 @@ The ``--no-headers`` option will skip the initial header line. The
 used between the output fields. Both these options are to help
 scripting.
 
+The ``-v`` option activates verbose mode, which changes the display of
+special field states (see **ganeti**\(7)).
+
 The ``-o`` option takes a comma-separated list of output fields.
 The available fields and their meaning are:
 
-name
-    Lock name
-
-mode
-    Mode in which the lock is currently acquired (exclusive or shared)
-
-owner
-    Current lock owner(s)
-
-pending
-    Threads waiting for the lock
-
+@QUERY_FIELDS_LOCK@
 
 If the value of the option starts with the character ``+``, the new
-fields will be added to the default list. This allows to quickly
+fields will be added to the default list. This allows one to quickly
 see the default list plus a few other fields, instead of retyping
 the entire list of fields.
 
 Use ``--interval`` to repeat the listing. A delay specified by the
 option value in seconds is inserted.
+
+.. vim: set textwidth=72 :
+.. Local Variables:
+.. mode: rst
+.. fill-column: 72
+.. End: