misc/141032: misleading documentation for rtadvd.conf's raflags
viktor.stujber at gmail.com
Mon Nov 30 17:20:02 UTC 2009
>Synopsis: misleading documentation for rtadvd.conf's raflags setting
>Arrival-Date: Mon Nov 30 17:20:01 UTC 2009
>Originator: Viktor Štujber
FreeBSD poring.netvor.sk 8.0-STABLE FreeBSD 8.0-STABLE #1: Fri Nov 27 15:12:20 CET 2009 umage at poring.netvor.sk:/usr/obj/usr/src/sys/PORING i386
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 doesn't work:
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.
In my case, I just needed to set the bit 0x40. So I took the example, which says raflags#0, and used
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'.
More information about the freebsd-bugs