From owner-freebsd-doc  Sat Mar 13 16:40:15 1999
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
	by hub.freebsd.org (Postfix) with ESMTP id 2E21314CD1
	for <doc@FreeBSD.ORG>; Sat, 13 Mar 1999 16:40:14 -0800 (PST)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.2/8.9.2) id QAA15174;
	Sat, 13 Mar 1999 16:40:01 -0800 (PST)
	(envelope-from gnats@FreeBSD.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
Reply-To: des@flood.ping.uio.no
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.2
Subject: docs/10576: multiple bugs in tun(4) man page
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         10576
>Category:       docs
>Synopsis:       multiple bugs in tun(4) man page
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Mar 13 16:40:00 PST 1999
>Closed-Date:
>Last-Modified:
>Originator:     Dag-Erling Smørgrav
>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:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message