Bug 209231

Summary: fdescfs(5) man page: Fix examples for fstab(5) and mount(8) command
Product: Documentation Reporter: Ben Woods <woodsb02>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed Not A Bug    
Severity: Affects Only Me CC: maxim, mpp, pluknet, woodsb02
Priority: --- Keywords: patch
Version: Latest   
Hardware: Any   
OS: Any   
URL: https://forums.freebsd.org/threads/50214/#post-319005
Attachments:
Description Flags
Patch to fix examples in fdescfs(5) man page none

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.