From nobody@FreeBSD.org  Sun May  4 18:04:34 2008
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 80ED01065675
	for <freebsd-gnats-submit@FreeBSD.org>; Sun,  4 May 2008 18:04:34 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 885B38FC0A
	for <freebsd-gnats-submit@FreeBSD.org>; Sun,  4 May 2008 18:04:34 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.2/8.14.2) with ESMTP id m44I3kPW074829
	for <freebsd-gnats-submit@FreeBSD.org>; Sun, 4 May 2008 18:03:46 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.2/8.14.1/Submit) id m44I3k9f074827;
	Sun, 4 May 2008 18:03:46 GMT
	(envelope-from nobody)
Message-Id: <200805041803.m44I3k9f074827@www.freebsd.org>
Date: Sun, 4 May 2008 18:03:46 GMT
From: Jed Clear <clear@netaxs.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: gvinum startup in handbook
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         123400
>Category:       docs
>Synopsis:       gvinum startup in handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun May 04 18:10:00 UTC 2008
>Closed-Date:    Mon Dec 22 21:54:06 UTC 2008
>Last-Modified:  Mon Dec 22 22:00:06 UTC 2008
>Originator:     Jed Clear
>Release:        6.3R
>Organization:
dis
>Environment:
Handbook on www.freebsd.org as of this date
>Description:
To decomission my last 4.11R machine I needed to figure out how to bring over my non-root vinum volumes to gvinum.  Turned out to be much easier than I thought it would be, except for I couldn't get gvinum to start at boot time.  Manually it started flawlessly.  After more searching than I'm used to with FreeBSD, I found the the loader.conf knob.  

The reason for the PR is that the critical bit for boot time starting of gvinum is only listed in the handbook in chapter "20.9 Using Vinum for the Root Filesystem", a chapter I thought I had no need to read since I wasn't dealing with the root filesystem.  Chapter 20.8, which was the one I was looking at, does have a section on automatic startup, but only refers to the old vinum rc.conf setting.


>How-To-Repeat:
Ignore the handbook chapter on vinum root filesystems when not dealing with root filesystems.
>Fix:
At a minimum the 20.9.1 paragraphs on gvinum startup need to be copied to 20.8.1.1.      

There is probably some more work that could be done to segregate what is 4.x vinum and 5+ gvinum, but the above seems the most important "fix".

>Release-Note:
>Audit-Trail:

From: Federico Galvez-Durand <federicogalvezdurand@yahoo.com>
To: bug-followup@FreeBSD.org, clear@netaxs.com
Cc:  
Subject: docs/123400: gvinum startup in handbook
Date: Mon, 18 Aug 2008 09:59:10 -0700 (PDT)

 There is a proposal (pending revision) to update Chapter 20:
 http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/122052
 It can be browsed here:
 http://del.ufrj.br/~federico.besnard/FreeBSD/apocrypha/handbook/vinum-vinum.html
 
 also related:
 http://www.freebsd.org/cgi/query-pr.cgi?pr=docs/122053
 
 I hope it helps to alleviate the present situation.
 
 One can see activity here:
 http://lists.freebsd.org/pipermail/freebsd-geom/
 
 So, I guess that part of the manual might change significantly or just disappear.
 
 Fico
 
 
       
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Mon Dec 22 21:51:44 UTC 2008 
State-Changed-Why:  
I have added a bit of extra text in the note so people 
remember to load the module.  Thanks! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Mon Dec 22 21:51:44 UTC 2008 
Responsible-Changed-Why:  
Over to me. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=123400 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/123400: commit references a PR
Date: Mon, 22 Dec 2008 21:51:38 +0000 (UTC)

 trhodes     2008-12-22 21:51:29 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/vinum chapter.sgml 
   Log:
   Fill out a <note> a bit better by mentioning the loader.conf method of
   loading a module in place of just hinting toward it.
   
   PR:     123400
   
   Revision  Changes    Path
   1.46      +4 -1      doc/en_US.ISO8859-1/books/handbook/vinum/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
