[Bug 207625] mount_smbfs(8): missing description of option "-n opt"

From: <bugzilla-noreply_at_freebsd.org>
Date: Sun, 10 Mar 2024 14:48:55 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=207625

Chris Davidson <Christopher.davidson@gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |Christopher.davidson@gmail.
                   |                            |com

--- Comment #3 from Chris Davidson <Christopher.davidson@gmail.com> ---
The -n option is also not documented in the latest -CURRENT (FreeBSD
current.home 15.0-CURRENT FreeBSD 15.0-CURRENT #6 main-n268726-32c7350beb82:
Thu Mar  7 21:25:02 EST 2024    
chrisdavidson@current.home:/usr/obj/usr/src/amd64.amd64/sys/GENERIC amd64)

I did take a look at the source code dig a little deeper and checked out the
soruce code (contrib/smbfs/mount_smbfs/mount_smbfs.c). This option does exist
in the source code but it has comments around it, that it is never reached.

Evidence: The case option for 'n' exists on line 180 but on line 179 it has a
comment: /*NOTREACHED*/.

Looking through other distribution manual pages they are NOT mentioning this
option at all, example: 

https://www.illumos.org/man/8/mount_smbfs

I can not find a reference to it online but the mac os ventura manual pages
also do NOT reference this option.

My conclusion is two options:
1. Remove the reference in the manual page
2. Update the source code for mount_smbfs.c to make the case reachable.

Option 2 "looks" to be resolved by adding a break line to the case above and
then testing it out a little.

Hope this information is helpful for resolution of this manual page
discrepancy.

-- 
You are receiving this mail because:
You are the assignee for the bug.