From owner-freebsd-bugs@FreeBSD.ORG Mon Nov 30 17:20:02 2009 Return-Path: Delivered-To: freebsd-bugs@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 63846106568F for ; Mon, 30 Nov 2009 17:20:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 272308FC1F for ; Mon, 30 Nov 2009 17:20:02 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id nAUHK1QM067772 for ; Mon, 30 Nov 2009 17:20:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id nAUHK1du067771; Mon, 30 Nov 2009 17:20:01 GMT (envelope-from gnats) Resent-Date: Mon, 30 Nov 2009 17:20:01 GMT Resent-Message-Id: <200911301720.nAUHK1du067771@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-bugs@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, "Viktor Štujber" Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 067761065676 for ; Mon, 30 Nov 2009 17:11:08 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id E9E828FC49 for ; Mon, 30 Nov 2009 17:11:07 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id nAUHB7i3097889 for ; Mon, 30 Nov 2009 17:11:07 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id nAUHB7dI097888; Mon, 30 Nov 2009 17:11:07 GMT (envelope-from nobody) Message-Id: <200911301711.nAUHB7dI097888@www.freebsd.org> Date: Mon, 30 Nov 2009 17:11:07 GMT From: "Viktor Štujber" To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: misc/141032: misleading documentation for rtadvd.conf's raflags setting X-BeenThere: freebsd-bugs@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Bug reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 30 Nov 2009 17:20:02 -0000 >Number: 141032 >Category: misc >Synopsis: misleading documentation for rtadvd.conf's raflags setting >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-bugs >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Nov 30 17:20:01 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Viktor Štujber >Release: 8.0 >Organization: >Environment: FreeBSD poring.netvor.sk 8.0-STABLE FreeBSD 8.0-STABLE #1: Fri Nov 27 15:12:20 CET 2009 umage@poring.netvor.sk:/usr/obj/usr/src/sys/PORING i386 >Description: The documentation for rtadvd.conf (ipv6 router advertisement daemon) contains a section on 'raflags'. This setting controls a bitfield in the RA packet. The doc explains all of the bits, and to each one it assigns a letter and a hexadecimal value, 0x??. However, this is very misleading, because as it turns out, the code parsing this config file does not understand hexadecimal numbers. This works: :raflags#64: :raflags="o": This doesn't work: :raflags#0x40: I am not familiar with the syntax, and didn't feel like trying all of the possible variations of #,=,o and 0x40, so I'm only listing the ones above. >How-To-Repeat: In my case, I just needed to set the bit 0x40. So I took the example, which says raflags#0, and used fxp0:\ :raflags#0x40: >Fix: I suggest either adding support for hexadecimal numbers to the parser (a code change), or improving/amending the documentation to make it more clear. It would also be useful if the example used a value more complex than '0'. >Release-Note: >Audit-Trail: >Unformatted: