doc: document recover_session= option in mount.ceph manpage

Fixes: https://tracker.ceph.com/issues/40957
Signed-off-by: Jeff Layton <jlayton@redhat.com>

diff --git a/doc/man/8/mount.ceph.rst b/doc/man/8/mount.ceph.rst
index 4f22cd29f733ab4f047b2e98665bfe942be4e86e..b9dd74c45314376d41bbb5d2bad364e157033946 100644 (file)
--- a/doc/man/8/mount.ceph.rst
+++ b/doc/man/8/mount.ceph.rst
@@ -135,6 +135,14 @@ Options
   for autodiscovery of monitor addresses and auth secrets. The default is
   to use the standard search path for ceph.conf files.
 
+:command:`recover_session=<no|clean>`
+  Set auto reconnect mode in the case where the client is blacklisted. The
+  available modes are ``no`` and ``clean``. The default is ``no``.
+
+  - ``no``: never attempt to reconnect when client detects that it has been blacklisted. Blacklisted clients will not attempt to reconnect and their operations will fail too.
+
+  - ``clean``: client reconnects to the ceph cluster automatically when it detects that it has been blacklisted. During reconnect, client drops dirty data/metadata, invalidates page caches and writable file handles.  After reconnect, file locks become stale because the MDS loses track of them. If an inode contains any stale file locks, read/write on the inode is not allowed until applications release all stale file locks.
+
 Mount Secrets
 =============
 If the `secret` and `secretfile` options are not specified on the command-line