DOCS-2247 add dropAllUsers method

bin/builddata/htaccess.yaml

@@ -3275,4 +3275,12 @@ code: 301
 outputs:
   - 'master'
   - 'manual'
+---
+redirect-path: '/reference/method/db.dropAllUsers'
+url-base: '/reference/security'
+type: 'redirect'
+code: 301
+outputs:
+  - 'manual'
+  - 'before-v2.4'
 ...

source/includes/access-drop-all-users.rst

@@ -0,0 +1,3 @@
+To issue the :dbcommand:`dropAllUsersFromDatabase` command, a user must
+have access that includes the :authaction:`dropUser` action for that
+database.

source/includes/ref-toc-method-user-management.yaml

@@ -13,11 +13,11 @@ description: |
 # description: |
 #   Removes a single user.
 # ---
-# name: :method:`db.dropAllUsers()`
-# file: /reference/method/db.dropAllUsers
-# description: |
-#   Deletes all users associated with a database.
-# ---
+name: :method:`db.dropAllUsers()`
+file: /reference/method/db.dropAllUsers
+description: |
+  Deletes all users associated with a database.
+---
 # name: :method:`db.grantRolesToUser()`
 # file: /reference/method/db.grantRolesToUser
 # description: |

source/reference/command/dropAllUsersFromDatabase.txt

@@ -33,9 +33,7 @@ Definition
 Required Access
 ---------------
 
-To issue the :dbcommand:`dropAllUsersFromDatabase` command, a user must
-have access that includes the :authaction:`dropUser` action for that
-database.
+.. include:: /includes/access-drop-all-users.rst
 
 Example
 -------
@@ -45,7 +43,8 @@ every user from the ``products`` database:
 
 .. code-block:: javascript
 
-   db.getSiblingDB("products").runCommand( { dropAllUsersFromDatabase: 1, writeConcern: { w: "majority" } } )
+   use products
+   db.runCommand( { dropAllUsersFromDatabase: 1, writeConcern: { w: "majority" } } )
 
 The ``n`` field in the results document shows the number of users
 removed:

source/reference/method/db.dropAllUsers-param.yaml

@@ -0,0 +1,4 @@
+file: /reference/command/dropUser-field.yaml
+name: writeConcern
+position: 1
+...

source/reference/method/db.dropAllUsers.txt

@@ -0,0 +1,48 @@
+=================
+db.dropAllUsers()
+=================
+
+.. default-domain:: mongodb
+
+Definition
+----------
+
+.. method:: db.dropAllUsers ( writeConcern )
+
+   Removes all users from the database on which you run the command.
+
+   .. warning::
+
+      The :method:`dropAllUsers` method removes all users from the database.
+
+   The :method:`dropAllUsers` method takes the following arguments:
+
+   .. include:: /reference/method/db.dropAllUsers-param.rst
+
+   The :method:`db.dropAllUsers()` method wraps the
+   :dbcommand:`dropAllUsersFromDatabase` command.
+
+   .. |local-cmd-name| replace:: :method:`db.dropAllUsers()`
+
+Required Access
+---------------
+
+.. include:: /includes/access-drop-all-users.rst
+
+Example
+-------
+
+The following :method:`db.dropAllUsers()` operation drops every user from
+the ``products`` database.
+
+.. code-block:: javascript
+
+   use products
+   db.dropAllUsers( {w: "majority", wtimeout: 5000} )
+
+The ``n`` field in the results document shows the number of users
+removed:
+
+.. code-block:: javascript
+
+   { "n" : 12, "ok" : 1 }