From nobody Sun Mar 10 14:48:55 2024 X-Original-To: doc@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Tt2pv65H8z5D0Sg for ; Sun, 10 Mar 2024 14:48:55 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Tt2pv3Hy7z4svH for ; Sun, 10 Mar 2024 14:48:55 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1710082135; a=rsa-sha256; cv=none; b=O0xPgrACFFpekEOIy6tlp1XTq1y5U96LpjtKRnJMtBI/PgFVQT2Dz3xTK3QJZZbyyZaKrI VsUs2aG1X81aMv4jtf49PB/i2WnXDCwGCNTkzNm9Va8bZl5A8CP7lu3xwBUx3wSq42xBvR MQssNEtMIgtAXYUU6bIDuRtqB9KNSVZavE9QZGiPVvdYjDojqbImqdTvpi2JOWFYwKdL5d uHkxvFB7/kswwFkkijoUyxLln7srosnn+wpaH+IP2P/GHLYC9o2+sIslp4OyXyE/CJimw5 4srztnn68TpoPLTRPBSiNGf5qUwTWNv7/wYPHsSaOIpEgbbBQCe9EEr+R5XGEw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1710082135; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=bsmdvPFazS+H38Jzu6TziSMiPJbspF7fT1m+xqne8AA=; b=d8G6GUoWKFz7gS8bDWaGBQVpSbgKuBP+KEHJs6rat1OMsah2JcyGJfG7c3f8tskp8dSldT uVlcDJCWxGANvwEL2DBCCSlO8Ak6FZMh43Zs4UcUgU4zwNQj355F/ojOyh9rwInUwpX24j 7WsRyWMlw1AkV+9ixUmCe6fI3ICfg+MJ0qS9TEERDYKMQ0BFAa5NwgY4kTDVSOBLRi2b4U U9hghDKbMAsFjvkpagsRiNI0XIAUir8+YIPNMLvs1ASZHqz4qpdNtVTdgpIpUY4s7kYSEY vqfHlfUWqyaxZFLe1TrUYK3E3vl0eGxDXI0JD8WcB3jiSYRVqGfwdgtsKg0jCw== Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Tt2pv2nhYzqqM for ; Sun, 10 Mar 2024 14:48:55 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 42AEmtHI005836 for ; Sun, 10 Mar 2024 14:48:55 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 42AEmtCA005835 for doc@FreeBSD.org; Sun, 10 Mar 2024 14:48:55 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 207625] mount_smbfs(8): missing description of option "-n opt" Date: Sun, 10 Mar 2024 14:48:55 +0000 X-Bugzilla-Reason: CC X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Manual Pages X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Many People X-Bugzilla-Who: Christopher.davidson@gmail.com X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: bugs@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: cc Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D207625 Chris Davidson changed: What |Removed |Added ---------------------------------------------------------------------------- CC| |Christopher.davidson@gmail. | |com --- Comment #3 from Chris Davidson --- 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=20=20=20=20 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 exi= st 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:=20 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. --=20 You are receiving this mail because: You are on the CC list for the bug.=