DOCS-12160: show dbs

Author: Kay Kim

source/mongo.txt

@@ -215,17 +215,20 @@ To display the database you are using, type ``db``:
    db
 
 The operation should return ``test``, which is the default database.
+
 To switch databases, issue the ``use <db>`` helper, as in the
 following example:
 
 .. code-block:: javascript
 
    use <database>
 
-To list the available databases, use the helper ``show dbs``. See also
-:method:`db.getSiblingDB()` method to access a different database from
-the current database without switching your current database context
-(i.e. ``db``).
+See also :method:`db.getSiblingDB()` method to access a
+different database from the current database without switching your
+current database context (i.e. ``db``).
+
+To list the databases available to the user, use the helper ``show
+dbs``. [#access]_
 
 You can switch to non-existing databases. When you first store data in
 the database, such as by creating a collection, MongoDB creates the
@@ -268,6 +271,11 @@ For more documentation of basic MongoDB operations in the
 - :doc:`/tutorial/remove-documents`
 - :doc:`/reference/method`
 
+.. [#access]
+   If the deployment runs with access control, the operation
+   returns different values based on user privileges. See
+   :ref:`listDatabases Behavior <listDatabases-behavior>` for details.
+
 Format Printed Results
 ~~~~~~~~~~~~~~~~~~~~~~
 

source/reference/command/listDatabases.txt

@@ -60,6 +60,20 @@ Behavior
 
 When :doc:`authentication </core/authentication>` is enabled:
 
+.. admonition:: show dbs
+   :class: note
+ 
+   For :binary:`~bin.mongo` shell version 4.0.6+ connected to earlier
+   versions of MongoDB deployment (e.g. 3.6.10), 
+   
+   - If the user has :authaction:`listDatabases` action on the cluster
+     resource, ``show dbs`` returns all databases.
+
+   - If the user does not have :authaction:`listDatabases` action on
+     the cluster resource, ``show dbs`` returns only the databases for
+     which the user has privileges (including those databases for which
+     the user has privileges on specific collections).
+
 .. tabs::
 
    tabs:

source/tutorial/access-mongo-shell-help.txt

@@ -46,7 +46,7 @@ Database Help
 In the :binary:`~bin.mongo` shell:
 
 - To see the list of databases on the server, use the ``show dbs``
-  command:
+  command: [#access]_
 
   .. code-block:: javascript
 
@@ -70,6 +70,12 @@ In the :binary:`~bin.mongo` shell:
 
      db.updateUser
 
+.. [#access]
+   If the deployment runs with access control, the operation
+   returns different values based on user privileges. See
+   :ref:`listDatabases Behavior <listDatabases-behavior>` for details.
+
+
 .. _mongo-shell-help-collection:
 
 Collection Help