From: Paul Cuzner <pcuzner@redhat.com>
Date: Fri, 2 Dec 2022 03:37:34 +0000 (+1300)
Subject: orchestrator: update docs for host ls
X-Git-Tag: v17.2.7~483^2
X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F50889%2Fhead;p=ceph.git

orchestrator: update docs for host ls

Signed-off-by: Paul Cuzner <pcuzner@redhat.com>
(cherry picked from commit 166e0fb5d5cb83265577f6538a29f0532173ddbb)
---

diff --git a/doc/cephadm/host-management.rst b/doc/cephadm/host-management.rst
index b2c514c8ca70..2aed8399ee88 100644
--- a/doc/cephadm/host-management.rst
+++ b/doc/cephadm/host-management.rst
@@ -11,9 +11,9 @@ Run a command of this form to list hosts associated with the cluster:
 
 .. prompt:: bash #
 
-   ceph orch host ls [--format yaml] [--host-pattern <name>] [--label <label>] [--host-status <status>]
+   ceph orch host ls [--format yaml] [--host-pattern <name>] [--label <label>] [--host-status <status>] [--detail]
 
-In commands of this form, the arguments "host-pattern", "label" and
+In commands of this form, the arguments "host-pattern", "label", and
 "host-status" are optional and are used for filtering. 
 
 - "host-pattern" is a regex that matches against hostnames and returns only
@@ -25,6 +25,16 @@ In commands of this form, the arguments "host-pattern", "label" and
   against name, label and status simultaneously, or to filter against any
   proper subset of name, label and status.
 
+The "detail" parameter provides more host related information for cephadm based
+clusters. For example:
+
+.. prompt:: bash #
+
+   # ceph orch host ls --detail 
+   HOSTNAME     ADDRESS         LABELS  STATUS  VENDOR/MODEL                           CPU    HDD      SSD  NIC  
+   ceph-master  192.168.122.73  _admin          QEMU (Standard PC (Q35 + ICH9, 2009))  4C/4T  4/1.6TB  -    1    
+   1 hosts in cluster
+
 .. _cephadm-adding-hosts:    
     
 Adding Hosts