doc: add ceph-volume inventory sections

Signed-off-by: Jan Fajerski <[email protected]>

doc/ceph-volume/index.rst

@@ -11,12 +11,18 @@ follow a predictable, and robust way of preparing, activating, and starting OSDs
 
 
 **Command Line Subcommands**
+
 There is currently support for ``lvm``, and plain disks (with GPT partitions)
 that may have been deployed with ``ceph-disk``.
 
 * :ref:`ceph-volume-lvm`
 * :ref:`ceph-volume-simple`
 
+**Node inventory**
+
+The :ref:`ceph-volume-inventory` subcommand provides information and metadata
+about a nodes physical disk inventory.
+
 
 Migrating
 ---------
@@ -55,6 +61,7 @@ and ``ceph-disk`` is fully disabled. Encryption is fully supported.
 
    intro
    systemd
+   inventory
    lvm/index
    lvm/activate
    lvm/batch

doc/ceph-volume/inventory.rst

@@ -0,0 +1,17 @@
+.. _ceph-volume-inventory:
+
+``inventory``
+=============
+The ``inventory`` subcommand queries a host's disc inventory and provides
+hardware information and metadata on every physical device.
+
+By default the command returns a short, human-readable report of all physical disks.
+
+For programmatic consumption of this report pass ``--format json`` to generate a
+JSON formatted report. This report includes extensive information on the
+physical drives such as disk metadata (like model and size), logical volumes
+and whether they are used by ceph, and if the disk is usable by ceph and
+reasons why not.
+
+A device path can be specified to report extensive information on a device in
+both plain and json format.

doc/man/8/ceph-volume.rst

@@ -1,8 +1,8 @@
 :orphan:
 
-========================================
- ceph-volume -- Ceph OSD deployment tool
-========================================
+=======================================================
+ ceph-volume -- Ceph OSD deployment and inspection tool
+=======================================================
 
 .. program:: ceph-volume
 
@@ -12,6 +12,8 @@ Synopsis
 | **ceph-volume** [-h] [--cluster CLUSTER] [--log-level LOG_LEVEL]
 |                 [--log-path LOG_PATH]
 
+| **ceph-volume** **inventory**
+
 | **ceph-volume** **lvm** [ *trigger* | *create* | *activate* | *prepare*
 | *zap* | *list* | *batch*]
 
@@ -34,6 +36,27 @@ them.
 Commands
 ========
 
+inventory
+---------
+
+This subcommand provides information about a host's physical disc inventory and
+reports metadata about these discs. Among this metadata one can find disc
+specific data items (like model, size, rotational or solid state) as well as
+data items specific to ceph using a device, such as if it is available for
+use with ceph or if logical volumes are present.
+
+Examples::
+
+    ceph-volume inventory
+    ceph-volume inventory /dev/sda
+    ceph-volume inventory --format json-pretty
+
+Optional arguments:
+
+* [-h, --help]          show the help message and exit
+* [--format]            report format, valid values are ``plain`` (default),
+                        ``json`` and ``json-pretty``
+
 lvm
 ---