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: