From khera@kciLink.com  Thu Sep 13 11:14:20 2001
Return-Path: <khera@kciLink.com>
Received: from yertle.kciLink.com (yertle.kcilink.com [216.194.193.105])
	by hub.freebsd.org (Postfix) with ESMTP id CE58E37B408
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 13 Sep 2001 11:14:19 -0700 (PDT)
Received: from onceler.kciLink.com (onceler.kciLink.com [216.194.193.106])
	by yertle.kciLink.com (Postfix) with ESMTP id 899BA2E45F
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 13 Sep 2001 14:14:18 -0400 (EDT)
Received: (from khera@localhost)
	by onceler.kciLink.com (8.11.4/8.11.4) id f8DIEIK38047;
	Thu, 13 Sep 2001 14:14:18 -0400 (EDT)
	(envelope-from khera)
Message-Id: <200109131814.f8DIEIK38047@onceler.kciLink.com>
Date: Thu, 13 Sep 2001 14:14:18 -0400 (EDT)
From: <khera@kciLink.com>
Reply-To: khera@kciLink.com
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: first few vnconfig man page examples are quite broken
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         30556
>Category:       docs
>Synopsis:       vnconfig man page incorrect; functionality seems to be missing too
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Sep 13 11:20:01 PDT 2001
>Closed-Date:    Tue Aug 20 13:01:55 PDT 2002
>Last-Modified:  Tue Aug 20 13:01:55 PDT 2002
>Originator:     Vivek Khera
>Release:        FreeBSD 4.3-STABLE i386
>Organization:
>Environment:
System: FreeBSD onceler.kciLink.com 4.3-STABLE FreeBSD 4.3-STABLE #13: Thu Jul 5 16:49:55 EDT 2001 khera@onceler.kciLink.com:/u/onceler1/usr/src/sys/compile/ONCELER i386


	
>Description:
	

The vnconfig man page gives these examples:

EXAMPLES
           vnconfig vn0c /tmp/diskimage

     Configures the vnode disk vn0c.

           vnconfig -e vn0c /var/swapfile swap

     Configures vn0c and enables swapping on it.


Trying the first one gives an error.  Apparently you can only vnconfig
the base device, vn0, not vn0c.  This leads us to the problem that the
feature mount=/path is useless, since you cannot do

 vnconfig vn0 /tmp/diskimage mount=/mnt

nor

 vnconfig -e vn0c /tmp/diskimage mount=/mnt

since the former is attempting to mount /dev/vn0 and the latter attempts to
vnconfig vn0c, both of which are not allowed.


>How-To-Repeat:
	
see above

>Fix:

	
change the docs, and remove the mount=XX options since they are useless, it
seems.
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: ceri 
State-Changed-When: Tue Aug 20 13:00:48 PDT 2002 
State-Changed-Why:  
The examples in the manual work perfectly. 
/tmp/diskimage is assumed to be a diskimage, and therefore should 
exist before attempting to follow the examples. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=30556 
>Unformatted:
