From owner-freebsd-doc@FreeBSD.ORG Wed Aug 22 14:40:02 2007 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 515C616A47F for ; Wed, 22 Aug 2007 14:40:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 29CFE13C45A for ; Wed, 22 Aug 2007 14:40:02 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.1/8.14.1) with ESMTP id l7MEe2gh084346 for ; Wed, 22 Aug 2007 14:40:02 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.1/8.14.1/Submit) id l7MEe2pt084345; Wed, 22 Aug 2007 14:40:02 GMT (envelope-from gnats) Resent-Date: Wed, 22 Aug 2007 14:40:02 GMT Resent-Message-Id: <200708221440.l7MEe2pt084345@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Stefan Lambrev Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4BE5716A417 for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/115721: misleading manual X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 22 Aug 2007 14:40:02 -0000 >Number: 115721 >Category: docs >Synopsis: misleading manual >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Wed Aug 22 14:40:01 GMT 2007 >Closed-Date: >Last-Modified: >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: >Unformatted: