NetBSD Problem Report #57736
From he@smistad.uninett.no Thu Nov 30 09:08:53 2023
Return-Path: <he@smistad.uninett.no>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
by mollari.NetBSD.org (Postfix) with ESMTPS id EDE021A9238
for <gnats-bugs@gnats.NetBSD.org>; Thu, 30 Nov 2023 09:08:52 +0000 (UTC)
Message-Id: <20231130090847.2F2DA43ED12@smistad.uninett.no>
Date: Thu, 30 Nov 2023 10:08:47 +0100 (CET)
From: he@NetBSD.org
Reply-To: he@NetBSD.org
To: gnats-bugs@NetBSD.org
Subject: rtsold(8) compat man page is both imprecise and unhelpful
X-Send-Pr-Version: 3.95
>Number: 57736
>Category: bin
>Synopsis: rtsold(8) compat man page is both imprecise and unhelpful
>Confidential: no
>Severity: serious
>Priority: medium
>Responsible: bin-bug-people
>State: open
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Thu Nov 30 09:10:00 +0000 2023
>Last-Modified: Fri Dec 01 19:20:01 +0000 2023
>Originator: he@NetBSD.org
>Release: NetBSD 10.0_BETA
>Organization:
I Try...
>Environment:
System: NetBSD smistad.uninett.no 10.0_BETA NetBSD 10.0_BETA (GENERIC) #5: Thu Jan 12 20:52:28 CET 2023 he@smistad.uninett.no:/usr/obj/sys/arch/amd64/compile/GENERIC amd64
Architecture: x86_64
Machine: amd64
>Description:
Several issues with the man page as it stands
(inspected/verified via https://man.netbsd.org/):
1. It is not supplying information which provides a good
replacement for the old "rtsol" command. The old "rtsol"
command sent a router solicitation command *and acted on
the returned result* to configure an IPv6 address on the
interface *and* configure an IPv6 default route. None of
the commands quoted in this compatibility man page appear
to do this(!)
2. "To quietly send a router solicitation message:" Why on
earth would one want to do that?!? "Quietly" means no
debug output is provided, and "send ..." implies that such
a message is just sent, but does *not* imply any processing
of any returned message. Or is this just clumsily or
imprecisely worded?
3. The previous example in the man page which adds debug
prinout isn't much better in the explanation: it just says
"to send a router solicitation message and print
information about the response without changing the actual
routing table:" says nothing about whether the interface
address is changed (probably it isn't). As such, this also
does not provide any replacement functionality to the
original "rtsol" command, where one typically want both an
IPv6 address configured on the interface *and* setting up
an IPv6 default route.
4. This leaves just the "add the rtsol keyword (on a line by
itself?) in /etc/ifconfig.<if>" and using /etc/rc.d/network
to fully reconfigure the network as the only option
provided via this man page to get the equivalent action as
that with "rtsol(d)=yes" in /etc/rc.conf.
Also, doing "sh /etc/rc.d/network restart" might disrupt
connectivity of ongoing sessions, so is perhaps best done
as part of a full reboot / bring-up of the system.
No method is given in the man page to do a one-shot
configuration of IPv6, something one might want to do for
testing before turning it on permanently.
>How-To-Repeat:
Inspect the rtsold(8) man page in -current or netbsd-10.
>Fix:
Yes, please.
>Audit-Trail:
From: Martin Husemann <martin@duskware.de>
To: gnats-bugs@netbsd.org
Cc:
Subject: Re: bin/57736: rtsold(8) compat man page is both imprecise and
unhelpful
Date: Thu, 30 Nov 2023 10:25:15 +0100
On Thu, Nov 30, 2023 at 09:10:01AM +0000, he@NetBSD.org wrote:
> 2. "To quietly send a router solicitation message:" Why on
> earth would one want to do that?!? "Quietly" means no
> debug output is provided, and "send ..." implies that such
> a message is just sent, but does *not* imply any processing
> of any returned message. Or is this just clumsily or
> imprecisely worded?
I need this in one of my setups. I have fixed prefixes and adresses,
but the (stupid, provider enforced) external router will not route
traffic to additional prefixes unless I ask it for a prefix delegation
first. I know the answer (it is all fixed) and don't do anything with the
result.
Not sure if this should or need to be part of this man page, just noting that
there are cases to use something similar.
Martin
From: Havard Eidnes <he@NetBSD.org>
To: gnats-bugs@netbsd.org, martin@duskware.de
Cc: netbsd-bugs@netbsd.org
Subject: Re: bin/57736: rtsold(8) compat man page is both imprecise and
unhelpful
Date: Fri, 01 Dec 2023 20:18:12 +0100 (CET)
> On Thu, Nov 30, 2023 at 09:10:01AM +0000, he@NetBSD.org wrote:
> > 2. "To quietly send a router solicitation message:" Why on
> > earth would one want to do that?!? "Quietly" means no
> > debug output is provided, and "send ..." implies that such
> > a message is just sent, but does *not* imply any processing
> > of any returned message. Or is this just clumsily or
> > imprecisely worded?
>
> I need this in one of my setups. I have fixed prefixes and adresses,=
> but the (stupid, provider enforced) external router will not route
> traffic to additional prefixes unless I ask it for a prefix delegati=
on
> first. I know the answer (it is all fixed) and don't do anything wit=
h the
> result.
You're perhaps alluding to it, but let me expicitly suggest that
this is perhaps a somewhat "fringe" use case?
> Not sure if this should or need to be part of this man page,
> just noting that there are cases to use something similar.
I would not have anything aginst the use case being documented as
long as the more "common" use cases are covered.
Regards,
- H=E5vard
(Contact us)
$NetBSD: query-full-pr,v 1.47 2022/09/11 19:34:41 kim Exp $
$NetBSD: gnats_config.sh,v 1.9 2014/08/02 14:16:04 spz Exp $
Copyright © 1994-2023
The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.