Ceph » CephFS

Now that the recover_session= mount option has been added to the testing branch in the kernel, we need to update the mount.ceph manpage to document it. Zheng added this to the kernel ceph.txt file:

+  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. Operations will generally fail after being blacklisted.
+
+       * 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.

We'll want a similar section for mount.ceph(8) (which is generated from doc/man/8/mount.ceph.rst).