RE: [PATCH] mount: (manpage) add CephFS kernel client mount options

On Tue, 2026-01-13 at 20:14 +0100, Karel Zak wrote:
> On Mon, Jan 12, 2026 at 12:58:38PM -0800, Viacheslav Dubeyko wrote:
> > From: Viacheslav Dubeyko <[email protected]>
> > 
> > Currently, manpage for generic mount tool doesn't contain
> > explanation of CephFS kernel client mount options. This patch
> > adds the description of CephFS mount options into
> > file system specific mount options section.
> > 
> > Signed-off-by: Viacheslav Dubeyko <[email protected]>
> > ---
> >  sys-utils/mount.8.adoc | 86 ++++++++++++++++++++++++++++++++++++++++++
> >  1 file changed, 86 insertions(+)
> > 
> > diff --git a/sys-utils/mount.8.adoc b/sys-utils/mount.8.adoc
> > index 4571bd2bfd16..191a3fabf501 100644
> > --- a/sys-utils/mount.8.adoc
> > +++ b/sys-utils/mount.8.adoc
> > @@ -853,6 +853,7 @@ This section lists options that are specific to particular filesystems. Where po
> >  |===
> >  |*Filesystem(s)* |*Manual page*
> >  |btrfs |*btrfs*(5)
> > +|cephfs |*mount.ceph*(8)
> 
> It seems that all we need is this change.
> 
> >  |cifs |*mount.cifs*(8)
> >  |ext2, ext3, ext4 |*ext4*(5)
> >  |fuse |*fuse*(8)
> > @@ -913,6 +914,91 @@ Give blocksize. Allowed values are 512, 1024, 2048, 4096.
> >  **grpquota**|**noquota**|**quota**|*usrquota*::
> >  These options are accepted but ignored. (However, quota utilities may react to such strings in _/etc/fstab_.)
> >  
> > +=== Mount options for ceph
> 
> If mount.ceph(8) exists, we do not need to repeat the mount option in
> mount(8). The ideal solution is to keep filesystem-specific mount
> options in the filesystem-specific man page maintained by the
> filesystem developer :-)  See btrfs, extN, XFS, etc.
> 

My assumption was that if other file systems have description of specific mount
options in this man page, then CephFS should have too. :) But if it is not right
strategy, then you are correct here.

Let me shrink my patch then.

Thanks,
Slava.