Bug 209231 - fdescfs(5) man page: Fix examples for fstab(5) and mount(8) command
Summary: fdescfs(5) man page: Fix examples for fstab(5) and mount(8) command
Status: Closed Not A Bug
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: freebsd-doc (Nobody)
URL: https://forums.freebsd.org/threads/50...
Keywords: patch
Depends on:
Blocks:
 
Reported: 2016-05-03 11:01 UTC by Ben Woods
Modified: 2016-06-10 16:41 UTC (History)
4 users (show)

See Also:


Attachments
Patch to fix examples in fdescfs(5) man page (681 bytes, patch)
2016-05-03 11:01 UTC, Ben Woods
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Ben Woods freebsd_committer freebsd_triage 2016-05-03 11:01:26 UTC
Created attachment 169917 [details]
Patch to fix examples in fdescfs(5) man page

The fdescfs(5) man page provides examples of how to mount the file system using mount(8) or by putting an entry in the fstab(5) file.

The attached patch corrects these examples, as noticed by SirDice on the FreeBSD forums [1].

fstab(5) example:
Old: fdescfs /dev/fd fdescfs rw	0 0
New: fdesc   /dev/fd fdescfs rw	0 0

mount(8) example:
Old: mount -t fdescfs null  /dev/fd
New: mount -t fdescfs fdesc /dev/fd


  [1] https://forums.freebsd.org/threads/50214/#post-319005
Comment 1 Ben Woods freebsd_committer freebsd_triage 2016-06-09 08:50:04 UTC
Has anyone got time to look at this minor manpage fix?
Comment 2 Maxim Konovalov freebsd_committer freebsd_triage 2016-06-09 09:00:57 UTC
(In reply to Ben Woods from comment #1)

Why?  It works just fine for me currently:

# mount | grep fd
# mount -t fdescfs null  /dev/fd 
# mount | grep fd
fdescfs on /dev/fd (fdescfs)

# umount /dev/fd
# grep dev/fd /etc/fstab
fdescfs /dev/fd fdescfs rw	0 0
# mount /dev/fd
# mount | grep fd               
fdescfs on /dev/fd (fdescfs)
Comment 3 Sergey Kandaurov freebsd_committer freebsd_triage 2016-06-09 10:08:03 UTC
Synthetic filesystems, such as nullfs and fdescfs,
ignore the mount "from" option so that it looks correct.
I barely think that there is anything to fix.
Comment 4 Ben Woods freebsd_committer freebsd_triage 2016-06-10 16:41:21 UTC
Agreed. Indeed, the mount command ignores the fs_spec field whether it was determined from fstab(5) or from the command line directly.

$ mount | grep fd
$ sudo mount -t fdescfs wildgoosechase /dev/fd
$ mount | grep fd
fdescfs on /dev/fd (fdescfs)
$ sudo umount /dev/fd
$ grep fd /etc/fstab
wildgoosechase          /dev/fd         fdescfs rw              0       0
$ sudo mount /dev/fd
$ mount | grep fd
fdescfs on /dev/fd (fdescfs)
$ sudo umount /dev/fd


Sorry for the noise. Agree there is nothing to fix.