doc: Add more missing commands to control.

This is too unstructured, that will have to be fixed later.

Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>

1 files changed, 81 insertions, 0 deletions

diff --git a/doc/control.rst b/doc/control.rst
index 387bfa29117..d7cd8c02b3b 100644
--- a/doc/control.rst
+++ b/doc/control.rst
@@ -239,3 +239,84 @@ Enables debug messages. ::
 Displays the status of all metadata servers.
 
 .. todo:: ``ceph mds`` subcommands missing docs: set_max_mds, dump, getmap, stop, setmap
+
+
+Mon subsystem
+-------------
+
+Show monitor stats::
+
+	$ ceph mon stat
+	2011-12-14 10:40:59.044395 mon <- [mon,stat]
+	2011-12-14 10:40:59.057111 mon.1 -> 'e3: 5 mons at {a=10.1.2.3:6789/0,b=10.1.2.4:6789/0,c=10.1.2.5:6789/0,d=10.1.2.6:6789/0,e=10.1.2.7:6789/0}, election epoch 16, quorum 0,1,2,3' (0)
+
+The ``quorum`` list at the end lists monitor nodes that are part of the current quorum.
+
+This is also available more directly::
+
+	$ ./ceph quorum_status
+	2011-12-14 10:44:20.417705 mon <- [quorum_status]
+	2011-12-14 10:44:20.431890 mon.0 -> '{ "election_epoch": 10,
+	  "quorum": [
+	        0,
+	        1,
+	        2],
+	  "monmap": { "epoch": 1,
+	      "fsid": "444b489c-4f16-4b75-83f0-cb8097468898",
+	      "modified": "2011-12-12 13:28:27.505520",
+	      "created": "2011-12-12 13:28:27.505520",
+	      "mons": [
+	            { "rank": 0,
+	              "name": "a",
+	              "addr": "127.0.0.1:6789\/0"},
+	            { "rank": 1,
+	              "name": "b",
+	              "addr": "127.0.0.1:6790\/0"},
+	            { "rank": 2,
+	              "name": "c",
+	              "addr": "127.0.0.1:6791\/0"}]}}' (0)
+
+The above will block until a quorum is reached.
+
+For a status of just the monitor you connect to (use ``-m HOST:PORT``
+to select)::
+
+	$ ./ceph mon_status
+	2011-12-14 10:45:30.644414 mon <- [mon_status]
+	2011-12-14 10:45:30.644632 mon.0 -> '{ "name": "a",
+	  "rank": 0,
+	  "state": "leader",
+	  "election_epoch": 10,
+	  "quorum": [
+	        0,
+	        1,
+	        2],
+	  "outside_quorum": [],
+	  "monmap": { "epoch": 1,
+	      "fsid": "444b489c-4f16-4b75-83f0-cb8097468898",
+	      "modified": "2011-12-12 13:28:27.505520",
+	      "created": "2011-12-12 13:28:27.505520",
+	      "mons": [
+	            { "rank": 0,
+	              "name": "a",
+	              "addr": "127.0.0.1:6789\/0"},
+	            { "rank": 1,
+	              "name": "b",
+	              "addr": "127.0.0.1:6790\/0"},
+	            { "rank": 2,
+	              "name": "c",
+	              "addr": "127.0.0.1:6791\/0"}]}}' (0)
+
+A dump of the monitor state::
+
+	$ ceph mon dump
+	2011-12-14 10:43:08.015333 mon <- [mon,dump]
+	2011-12-14 10:43:08.015567 mon.0 -> 'dumped monmap epoch 1' (0)
+	epoch 1
+	fsid 444b489c-4f16-4b75-83f0-cb8097468898
+	last_changed 2011-12-12 13:28:27.505520
+	created 2011-12-12 13:28:27.505520
+	0: 127.0.0.1:6789/0 mon.a
+	1: 127.0.0.1:6790/0 mon.b
+	2: 127.0.0.1:6791/0 mon.c
+