From owner-cvs-src@FreeBSD.ORG Sat Jun 14 10:30:21 2003 Return-Path: Delivered-To: cvs-src@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0481C37B401; Sat, 14 Jun 2003 10:30:21 -0700 (PDT) Received: from aslan.scsiguy.com (mail.scsiguy.com [63.229.232.106]) by mx1.FreeBSD.org (Postfix) with ESMTP id 039A343FE0; Sat, 14 Jun 2003 10:30:20 -0700 (PDT) (envelope-from gibbs@scsiguy.com) Received: from localhost (aslan.scsiguy.com [63.229.232.106]) by aslan.scsiguy.com (8.12.9/8.12.8) with ESMTP id h5EHUHvl020760; Sat, 14 Jun 2003 11:30:18 -0600 (MDT) (envelope-from gibbs@scsiguy.com) Date: Sat, 14 Jun 2003 11:30:20 -0600 From: "Justin T. Gibbs" To: Maxime Henrion , src-committers@FreeBSD.org, cvs-src@FreeBSD.org, cvs-all@FreeBSD.org Message-ID: <113730000.1055611820@caspian.scsiguy.com> In-Reply-To: <200306132007.h5DK7nFw084898@repoman.freebsd.org> References: <200306132007.h5DK7nFw084898@repoman.freebsd.org> X-Mailer: Mulberry/3.0.3 (Linux/x86) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Content-Disposition: inline Subject: Re: cvs commit: src/share/man/man9 bus_dma.9 X-BeenThere: cvs-src@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 14 Jun 2003 17:30:21 -0000 > mux 2003/06/13 13:07:49 PDT > > FreeBSD src repository > > Modified files: > share/man/man9 bus_dma.9 > Log: > - Document the fact that you can specify several DMA operations to > bus_dmamap_sync() by OR'ing them together. > - Don't document what BUS_DMASYNC_PREREAD|BUS_DMASYNC_PREWRITE and > BUS_DMASYNC_POSTREAD|BUS_DMASYNC_POSTWRITE is supposed to do when > passed to bus_dmamap_sync(). There are other possible combinations > and the reader just needs to know what the individual flags do and > that he can combine different DMA operations. I purposely documented the only combinations that make sense. This would also allow us to change back to using an enum in the future since the combinations are limited just by changing the names of the operations. It simply does not make sense to combine pre and post sync ops since doing so implies that you will lose data if your buffers are being bounced. In other words, any update from the CPU that you expect your device to see must occur after you have POST'ed any PRE'ed operation so that the buffer contents updated by the CPU are synced. -- Justin