From des@niobe.ewox.org Sat Mar 13 16:35:18 1999
Return-Path: <des@niobe.ewox.org>
Received: from niobe.ewox.org (ppp059.uio.no [129.240.240.60])
	by hub.freebsd.org (Postfix) with ESMTP id D9EAE14F91
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 13 Mar 1999 16:35:10 -0800 (PST)
	(envelope-from des@niobe.ewox.org)
Received: (from des@localhost)
	by niobe.ewox.org (8.9.3/8.9.1) id BAA84040;
	Sun, 14 Mar 1999 01:35:22 +0100 (CET)
	(envelope-from des)
Message-Id: <199903140035.BAA84040@niobe.ewox.org>
Date: Sun, 14 Mar 1999 01:35:22 +0100 (CET)
From: des@flood.ping.uio.no
Sender: des@niobe.ewox.org
Reply-To: des@flood.ping.uio.no
To: FreeBSD-gnats-submit@freebsd.org
Subject: multiple bugs in tun(4) man page
X-Send-Pr-Version: 3.2

>Number:         10576
>Category:       docs
>Synopsis:       multiple bugs in tun(4) man page
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Mar 13 16:40:00 PST 1999
>Closed-Date:    Wed Mar 24 14:19:01 PST 1999
>Last-Modified:  Wed Mar 24 14:19:43 PST 1999
>Originator:     Dag-Erling Smrgrav
>Release:        FreeBSD 4.0-CURRENT i386
>Organization:
>Environment:

All FreeBSD versions since the dawn of time.

>Description:

The tun(4) man page describes inexistant ioctl requests: TUNSIFMODE
and TUNSLMODE. These ioctls have never been defined or implemented
on FreeBSD - there is no trace of them anywhere in the CVS repository.

Also, parts of the man page end up looking very wierd; for instance,
the following paragraph:

On the last close of the data device, by default, the interface is
brought down
.Po as if with
.Dq ifconfig tun Ns Sy n No down
.Pc .
All queued packets are thrown away.
.Po If the interface is up when the data device is not open
output packets are always
thrown away rather than letting them pile up
.Pc .

is formatted as follows:

     On the last close of the data device, by default, the interface is
     brought down (as if with``ifconfig tunn down''). All queued packets are
     thrown away.  pile up  (If the interface is up when the data deviceoutput
     packets  are  always thrown away rather than letting them).

I don't know enough *roff to be able to determine if this is a bug in
*roff or a bug in the man page.

>How-To-Repeat:

$ man 4 tun

>Fix:
	
Remove the bogus ioctl descriptions, and add a paragraph about the
TUNSIFINFO ioctl.


>Release-Note:
>Audit-Trail:

From: Dag-Erling Smorgrav <des@flood.ping.uio.no>
To: FreeBSD-gnats-submit@FreeBSD.ORG
Cc:  
Subject: Re: docs/10576: multiple bugs in tun(4) man page
Date: 14 Mar 1999 21:38:48 +0100

 des@flood.ping.uio.no writes:
 > Remove the bogus ioctl descriptions, and add a paragraph about the
 > TUNSIFINFO ioctl.
 
 After closer examination, I believe the correct solution is to
 implement the missing ioctls. I'm working on it.
 
 DES
 -- 
 Dag-Erling Smorgrav - des@flood.ping.uio.no
 
State-Changed-From-To: open->closed 
State-Changed-By: des 
State-Changed-When: Wed Mar 24 14:19:01 PST 1999 
State-Changed-Why:  
The missing ioctls have been implemented in -current. 
>Unformatted:
