From owner-freebsd-geom@FreeBSD.ORG  Tue Dec 16 15:01:27 2008
Return-Path: <owner-freebsd-geom@FreeBSD.ORG>
Delivered-To: freebsd-geom@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id BDCC51065676
	for <freebsd-geom@freebsd.org>; Tue, 16 Dec 2008 15:01:27 +0000 (UTC)
	(envelope-from gpalmer@freebsd.org)
Received: from noop.in-addr.com (mail.in-addr.com [IPv6:2001:470:8:162::1])
	by mx1.freebsd.org (Postfix) with ESMTP id 950D08FC14
	for <freebsd-geom@freebsd.org>; Tue, 16 Dec 2008 15:01:27 +0000 (UTC)
	(envelope-from gpalmer@freebsd.org)
Received: from gjp by noop.in-addr.com with local (Exim 4.54 (FreeBSD))
	id 1LCbQM-0004h6-CF; Tue, 16 Dec 2008 10:01:26 -0500
Date: Tue, 16 Dec 2008 10:01:26 -0500
From: Gary Palmer <gpalmer@freebsd.org>
To: Geoff Fritz <gfritz@gmail.com>
Message-ID: <20081216150126.GA1072@in-addr.com>
References: <20081216040633.GA17495@dev.null>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20081216040633.GA17495@dev.null>
Cc: freebsd-geom@freebsd.org
Subject: Re: GCACHE -- what's it for?
X-BeenThere: freebsd-geom@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: GEOM-specific discussions and implementations
	<freebsd-geom.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-geom>,
	<mailto:freebsd-geom-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-geom>
List-Post: <mailto:freebsd-geom@freebsd.org>
List-Help: <mailto:freebsd-geom-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-geom>,
	<mailto:freebsd-geom-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 16 Dec 2008 15:01:27 -0000

On Mon, Dec 15, 2008 at 09:06:33PM -0700, Geoff Fritz wrote:
> I noticed the presence of the geom_cache module recently.  Very little
> available in the archives on what it's used for.
> 
> Found a post by pjd@ with a link to a tarball containing a man page:
> 
> "The gcache utility is used for setting up a clean cache in front of the IDE
> controller on one disk."
> 
> (btw, where do I post to get this man page included in the release?
> freebsd-doc?  I'm running 7.1-RC1 and the man page is absent.)
> 
> I set up a test device with it, and noticed that the disk did a lot of
> thrashing when it was being written to, moreso than normal.  Is the purpose of
> this module to ensure that when the gcache provdider says the write was made
> it was in fact 100% written to the physical disk (or at least accepted by the
> next layer down)?
> 
> Thanks for the info.

The commit message may be of some value to answer the "what" question:

http://www.freebsd.org/cgi/cvsweb.cgi/src/sys/geom/cache/g_cache.c#rev1.1

Regarding the missing manpage, I'd recommand filing a PR (if one
does not already exist).

Regards,

Gary