Subject: kern/33672: sl(4) manpage does not document link[0-2]
To: None <kern-bug-people@netbsd.org, gnats-admin@netbsd.org,>
From: Hauke Fath <hauke@Espresso.Rhein-Neckar.DE>
List: netbsd-bugs
Date: 06/08/2006 23:10:00
>Number: 33672
>Category: kern
>Synopsis: sl(4) manpage does not document link[0-2]
>Confidential: no
>Severity: serious
>Priority: low
>Responsible: kern-bug-people
>State: open
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Thu Jun 08 23:10:00 +0000 2006
>Originator: Hauke Fath <hauke@Espresso.Rhein-Neckar.DE>
>Release: NetBSD 3.0_STABLE
>Organization:
Falling Raindrops
>Environment:
System: NetBSD pizza.causeuse.org 3.0_STABLE NetBSD 3.0_STABLE (PIZZA) #0: Tue May 30 22:25:30 CEST 2006 hf@Gstoder.nt.e-technik.tu-darmstadt.de:/var/obj/netbsd-builds/3_0/sparc/sys/arch/sparc/compile/PIZZA sparc
Architecture: sparc
Machine: sparc
>Description:
`man 8 ifconfig` points to the interface manpage for further
documentation of the link level processing options link[0-2].
For SLIP, sys/net/if_slvar.h has
/* visible flags */
#define SC_COMPRESS IFF_LINK0 /* compress TCP traffic */
#define SC_NOICMP IFF_LINK1 /* supress ICMP traffic */
#define SC_AUTOCOMP IFF_LINK2 /* auto-enable TCP compression */
but this information has not made it to the sl(4) manpage where
you'd expect it.
>How-To-Repeat:
Look for the exact meaning of link[0-2] for a SLIP link.
Find you need to UTS because the high-praised NetBSD man pages
have no information.
>Fix:
Please add a chapter that explains the functionality of link[0-2]
for sl(4). Explain what happens when you (link0) compress TCP traffic,
why you'd want to (link1) suppress icmp traffic, and what (link2)
auto-enabling TCP compression means.
>Unformatted: