Re: mount(8) manpage and filesystem-specific options

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Nov 26, 2008, at 3:05 PM, Andreas Dilger wrote:
On Nov 26, 2008  11:54 +0100, Karel Zak wrote:
On Tue, Nov 25, 2008 at 11:15:58PM -0500, Christoph Hellwig wrote:
Currently the mount(8) manpages which is contained inside util-linux
has a list of mount options for various filesystem. Now the filesystems
are in the kernel tree and can change options without affecting the
mount binary, and of course do so frequently. This means these options
are frequently out of date.  All these options also make the manpage

Yes, you're right.

quite large and harder to read.  What do peope think about adding a
(section 4?) manpage for every common filesystem in the man-pages

Something like this is on my wish list for long time ;-)

I see on my system that there are already mount.nfs(8) and mount.cifs(8) man pages, but this is because /sbin/mount.{nfs,cifs} are separate binaries.

NFS mount options are documented in nfs(5) of all places. mount.nfs(8) documents only the command-line options for /sbin/ mount.nfs, but not NFS mount options. Kind of confusing.

I DO think that it makes sense to have separate mount.{fstype} man pages to clean up the mount(8) man page. I've also thought that this page is
a huge mess.

...especially because support for individual file systems can often be separately installed on most distributions I commonly use. XFS has been treated this way, for example, until just recently. nfs(5) and mount.nfs(8) come from nfs-utils, not from util-linux.

<aside>
I never know what man section to put a new man page in, because the
descriptions of the section numers isn't given in the man(1) man page
itself, nor in any document in SEE ALSO.
</aside>

+1

Just as an example of what could be done, Solaris uses mount_nfs(1M) to document NFS mount options (and mount_zfs(1M) and so on), but the administrative command interface is always "mount." The subcommands are hidden, and I'm not aware of any visible documentation for them. The man pages describing mount options for individual file systems are referenced in mount(1M)'s SEE ALSO section.

--
Chuck Lever
chuck[dot]lever[at]oracle[dot]com
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux