From lars+lister.freebsd@adventuras.no  Thu Feb 24 22:10:21 2005
Return-Path: <lars+lister.freebsd@adventuras.no>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 7779D16A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 24 Feb 2005 22:10:21 +0000 (GMT)
Received: from mail.adventuras.no (mail.adventuras.no [194.63.250.215])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 62C0043D3F
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 24 Feb 2005 22:10:20 +0000 (GMT)
	(envelope-from lars+lister.freebsd@adventuras.no)
Received: from mail.adventuras.no (seven [127.0.0.1])
	by mail.adventuras.no (8.12.10/8.12.10) with ESMTP id j1OMA9vH002351
	(version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=NO);
	Thu, 24 Feb 2005 23:10:09 +0100
Received: (from apache@localhost)
	by mail.adventuras.no (8.12.10/8.12.10/Submit) id j1OMA9Ar002349;
	Thu, 24 Feb 2005 23:10:09 +0100
Received: from 213.236.228.129
        (SquirrelMail authenticated user lars)
        by mail.adventuras.no with HTTP;
        Thu, 24 Feb 2005 23:10:09 +0100 (CET)
Message-Id: <55421.213.236.228.129.1109283009.squirrel@mail.adventuras.no>
Date: Thu, 24 Feb 2005 23:10:09 +0100 (CET)
From: "Lars Kristiansen" <lars+lister.freebsd@adventuras.no>
To: FreeBSD-gnats-submit@freebsd.org
Cc: "Lars Kristiansen" <lars+lister.freebsd@adventuras.no>
Subject: docs for md need further explanation of type swap

>Number:         78041
>Category:       docs
>Synopsis:       [patch] docs for md(4) need further explanation of type swap
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Feb 24 22:20:21 GMT 2005
>Closed-Date:    Sat May 12 15:33:36 GMT 2007
>Last-Modified:  Sat May 12 15:40:04 GMT 2007
>Originator:     Lars Kristiansen <lars+lister.freebsd@adventuras.no>
>Release:        FreeBSD 5.3-RELEASE i386
>Organization:
Adventuras
>Environment:
System: FreeBSD ladyda.master.local 5.3-RELEASE FreeBSD 5.3-RELEASE #1:
Fri Nov 12 20:41:58 CET 2004
root@ladyda.master.local:/usr/obj/usr/src/sys/GENERIC i386



>Description:
Documentation describes memory disks of type swap as allocated from swap
space which leads to believe they are diskbound.

This description in a mail from Scott Long to freebsd-fs explains otherwise:
 ( http://docs.freebsd.org/cgi/mid.cgi?41E01905.3040200 )
"With the swap option, pages are allocated from the buffer/cache and
held there.  They are only swapped to disk when the system is under
memory pressure, otherwise they stay in RAM."

or this one in a mail from Poul-Henning Kamp:
 ( http://docs.freebsd.org/cgi/mid.cgi?45044.1105365790 )
"Swap-backing is very different from RAM disks in that things get
pushed out of RAM if better use can be made of the pages."



>How-To-Repeat:

>Fix:

############### suggested patch from Lowell Gilbert: ###############
--- src/share/man/man4/md.4.ORIG   Thu Feb 24 11:51:37 2005
+++ src/share/man/man4/md.4        Thu Feb 24 11:51:51 2005
@@ -50,7 +50,7 @@
 This allows for mounting ISO images without the tedious
 detour over actual physical media.
 .It Cm swap
-Backing store is allocated from swap space.
+Backing store is allocated from virtual memory space.
 .El
 .Pp
 For more information, please see
############### end of patch ###############



Note:
Documents which could use corresponding changes includes
 the manpages for md, mdconfig and mdmfs,
and also in this chapter of the handbook:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/disks-virtual.html#DISKS-MD-FREEBSD5




>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: pav 
State-Changed-When: Sat May 12 14:33:44 UTC 2007 
State-Changed-Why:  
Extended text committed, thank you! 

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/78041: commit references a PR
Date: Sat, 12 May 2007 15:33:25 +0000 (UTC)

 pav         2007-05-12 15:33:19 UTC
 
   FreeBSD src repository (doc,ports committer)
 
   Modified files:
     share/man/man4       md.4 
   Log:
   Talk more about swap backing
   
   PR:             docs/78041 (inspired by)
   Submitted by:   Lars Kristiansen <lars+lister.freebsd@adventuras.no>
   MFC after:      1 week
   
   Revision  Changes    Path
   1.13      +8 -1      src/share/man/man4/md.4
 _______________________________________________
 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:
