From nobody@FreeBSD.org  Wed Aug 22 14:37:34 2007
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 4BE5716A417
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 22 Aug 2007 14:37: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 3988613C474
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 22 Aug 2007 14:37:34 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.1/8.14.1) with ESMTP id l7MEbXQ7070093
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 22 Aug 2007 14:37:33 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.1/8.14.1/Submit) id l7MEbXLm070092;
	Wed, 22 Aug 2007 14:37:33 GMT
	(envelope-from nobody)
Message-Id: <200708221437.l7MEbXLm070092@www.freebsd.org>
Date: Wed, 22 Aug 2007 14:37:33 GMT
From: Stefan Lambrev <stefan.lambrev@moneybookers.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: misleading manual
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         115721
>Category:       docs
>Synopsis:       misleading manual
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    remko
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Aug 22 14:40:01 GMT 2007
>Closed-Date:    Sun Dec 02 09:11:07 UTC 2007
>Last-Modified:  Sun Dec 02 09:11:07 UTC 2007
>Originator:     Stefan Lambrev
>Release:        FreeBSD 7-current
>Organization:
>Environment:
FreeBSD hater.cmotd.com 7.0-CURRENT FreeBSD 7.0-CURRENT #0: Tue Jul 10 21:01:38 EEST 2007     root@hater.cmotd.com:/usr/obj/usr/src/sys/CORE64-SMP  amd64

>Description:
From MDCONFIG(8)

             swap     Swap space is used to back this memory disk.

From MD(4)

     swap     Backing store is allocated from buffer memory.  Pages get pushed
              out to the swap when the system is under memory pressure, other-
              wise they stay in the operating memory.  Using swap backing is
              generally preferable over malloc backing.

So I suggest to change the text in mdconfig to:

              Storage for this type of memory disk is allocated from buffer
              memory.  Pages get pushed out to the swap when the system is
              under memory pressure, otherwise they stay in the operating
              memory.  Using swap backing is generally preferable over malloc
              backing.
>How-To-Repeat:
man mdconfig
man md
>Fix:


Patch attached with submission follows:

--- src/sbin/mdconfig/mdconfig.8.orig	2007-08-22 17:26:02.000000000 +0300
+++ src/sbin/mdconfig/mdconfig.8	2007-08-22 17:31:44.000000000 +0300
@@ -98,7 +98,14 @@
 .Fl f Ar file
 becomes the backingstore for this memory disk.
 .It Cm swap
-Swap space is used to back this memory disk.
+Storage for this type of memory disk is allocated from buffer
+memory. Pages get pushed out to the swap when the system is
+under memory pressure, otherwise they stay in the operating
+memory. Using 
+.Cm swap
+backing is generally preferable over 
+.Cm malloc
+backing.
 .El
 .It Fl f Ar file
 Filename to use for the vnode type memory disk. Options


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->remko 
Responsible-Changed-By: remko 
Responsible-Changed-When: Wed Aug 22 14:49:02 UTC 2007 
Responsible-Changed-Why:  
I'll take it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=115721 
State-Changed-From-To: open->patched 
State-Changed-By: remko 
State-Changed-When: Wed Nov 28 12:12:07 UTC 2007 
State-Changed-Why:  
Patched in current 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/115721: commit references a PR
Date: Wed, 28 Nov 2007 12:11:43 +0000 (UTC)

 remko       2007-11-28 12:11:37 UTC
 
   FreeBSD src repository
 
   Modified files:
     sbin/mdconfig        mdconfig.8 
   Log:
   Sync with md(4)'s information regarding the swap backend.
   
   PR:             docs/115721
   Submitted by:   Stefan Lambrev <stefan.lambrev@moneybookers.com>
   MFC After:      3 days
   
   Revision  Changes    Path
   1.41      +9 -2      src/sbin/mdconfig/mdconfig.8
 _______________________________________________
 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"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/115721: commit references a PR
Date: Sun,  2 Dec 2007 08:47:32 +0000 (UTC)

 remko       2007-12-02 08:47:28 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_7)
     sbin/mdconfig        mdconfig.8 
   Log:
   MFC rev 1.41, 1.42 mdconfig.8
   
     Sync with md(4)'s information regarding the swap backend.
   
     PR:             docs/115721
     Submitted by:   Stefan Lambrev <stefan.lambrev@moneybookers.com>
     MFC After:      3 days
   
     Every newline should start on it's own line. I didn't do that in the
     previous commit, so make it happen now.
   
     Prodded by:     brueffer
   
   Approved by:    re (hrs)
   
   Revision  Changes    Path
   1.37.2.1  +10 -2     src/sbin/mdconfig/mdconfig.8
 _______________________________________________
 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"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/115721: commit references a PR
Date: Sun,  2 Dec 2007 08:58:52 +0000 (UTC)

 remko       2007-12-02 08:58:46 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_6)
     sbin/mdconfig        mdconfig.8 
   Log:
   MFC rev 1.41, 1.42 mdconfig.8
   
     Sync with md(4)'s information regarding the swap backend.
   
     PR:             docs/115721
     Submitted by:   Stefan Lambrev <stefan.lambrev@moneybookers.com>
     MFC After:      3 days
   
     Every newline should start on it's own line. I didn't do that in the
     previous commit, so make it happen now.
   
     Prodded by:     brueffer
   
   Approved by:    re (hrs)
   
   Revision  Changes    Path
   1.33.2.4  +10 -2     src/sbin/mdconfig/mdconfig.8
 _______________________________________________
 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"
 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/115721: commit references a PR
Date: Sun,  2 Dec 2007 09:07:53 +0000 (UTC)

 remko       2007-12-02 09:07:48 UTC
 
   FreeBSD src repository
 
   Modified files:        (Branch: RELENG_6_3)
     sbin/mdconfig        mdconfig.8 
   Log:
   MFC rev 1.41, 1.42 mdconfig.8
   
     Sync with md(4)'s information regarding the swap backend.
   
     PR:             docs/115721
     Submitted by:   Stefan Lambrev <stefan.lambrev@moneybookers.com>
     MFC After:      3 days
   
     Every newline should start on it's own line. I didn't do that in the
     previous commit, so make it happen now.
   
     Prodded by:     brueffer
   
   Approved by:    re (hrs)
   
   Revision      Changes    Path
   1.33.2.3.2.1  +10 -2     src/sbin/mdconfig/mdconfig.8
 _______________________________________________
 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"
 
State-Changed-From-To: patched->closed 
State-Changed-By: remko 
State-Changed-When: Sun Dec 2 09:11:06 UTC 2007 
State-Changed-Why:  
Committed. Thanks! 

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