NetBSD Problem Report #34277

From bad@atsec.com  Thu Aug 24 20:46:39 2006
Return-Path: <bad@atsec.com>
Received: from mail.netbsd.org (mail.netbsd.org [204.152.190.11])
	by narn.NetBSD.org (Postfix) with ESMTP id 4251363B8F2
	for <gnats-bugs@gnats.netbsd.org>; Thu, 24 Aug 2006 20:46:39 +0000 (UTC)
Message-Id: <20060824170208.DE71BA678@limiting-factor.atsec.com>
Date: Thu, 24 Aug 2006 19:02:08 +0200 (MEST)
From: bad@bsd.de
Reply-To: bad@bsd.de
To: gnats-bugs@NetBSD.org
Subject: incomplete documentation about VLAN handling
X-Send-Pr-Version: 3.95

>Number:         34277
>Category:       kern
>Synopsis:       the documentation invlan(4) and ifconfig(8) about VLANs in incomplete
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Thu Aug 24 20:50:00 +0000 2006
>Last-Modified:  Sun Aug 27 14:55:00 +0000 2006
>Originator:     Christoph Badura
>Release:        NetBSD 3.0_STABLE
>Organization:

>Environment:


System: NetBSD limiting-factor 3.0_STABLE NetBSD 3.0_STABLE (GENERIC_LAPTOP) #1: Fri Aug 11 00:20:07 MEST 2006 root@limiting-factor:/u/2/obj/u/1/src/sys/arch/i386/compile/GENERIC_LAPTOP i386
Architecture: i386
Machine: i386
>Description:

vlan(4) doesn't describe what happens with untagged frames and frames with
an unknown tag.
ifconfig(8) fails to describe how a vlan interface is deconfigured.

>How-To-Repeat:

read the man pages.
>Fix:


>Audit-Trail:
From: Pavel Cahyna <pavel@NetBSD.org>
To: gnats-bugs@NetBSD.org
Cc: 
Subject: Re: kern/34277: incomplete documentation about VLAN handling
Date: Thu, 24 Aug 2006 23:16:44 +0200

 > ifconfig(8) fails to describe how a vlan interface is deconfigured.

 "destroy" is described right after "create".

From: Christoph Badura <bad@bsd.de>
To: gnats-bugs@NetBSD.org
Cc: 
Subject: Re: kern/34277: incomplete documentation about VLAN handling
Date: Sun, 27 Aug 2006 16:53:10 +0200

 On Thu, Aug 24, 2006 at 09:20:04PM +0000, Pavel Cahyna wrote:
 > Subject: Re: kern/34277: incomplete documentation about VLAN handling
 > 
 >  > ifconfig(8) fails to describe how a vlan interface is deconfigured.
 >  "destroy" is described right after "create".

 I know that.  Now I remember.  Them man page says (under the "vlanif"
 item): "To change the association to another physical interface, the
 existing association must be cleared first."

 This implies that the association can be cleared without destroying the
 vlan(4) interface.  Only it doesn't describe how the association can
 actually be cleared.

 --chris

>Unformatted:

NetBSD Home
NetBSD PR Database Search

(Contact us) $NetBSD: query-full-pr,v 1.39 2013/11/01 18:47:49 spz Exp $
$NetBSD: gnats_config.sh,v 1.8 2006/05/07 09:23:38 tsutsui Exp $
Copyright © 1994-2007 The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.