From 20de64eb71fe5bf07e4d5867d78e20aeb115c339 Mon Sep 17 00:00:00 2001 From: jhb Date: Sun, 7 Oct 2012 18:25:48 +0000 Subject: [PATCH] MFC 239906: Clarify that bus_dma does not stall future load requests once a load is deferred. The caller is required to enforce that if that is desired. git-svn-id: svn://svn.freebsd.org/base/stable/8@241319 ccf9f872-aa2e-dd11-9fc8-001c23d0bc1f --- share/man/man9/bus_dma.9 | 9 +++++++-- 1 file changed, 7 insertions(+), 2 deletions(-) diff --git a/share/man/man9/bus_dma.9 b/share/man/man9/bus_dma.9 index 7886b1487..08fbc0de5 100644 --- a/share/man/man9/bus_dma.9 +++ b/share/man/man9/bus_dma.9 @@ -580,8 +580,13 @@ The status of the mapping has been delivered to the callback. The mapping has been deferred for lack of resources. The callback will be called as soon as resources are available. Callbacks are serviced in FIFO order. -To ensure that ordering is guaranteed, all subsequent load requests will also -be deferred until all callbacks have been processed. +.Pp +Note that subsequent load operations for the same tag that do not require +extra resources will still succeed. +This may result in out-of-order processing of requests. +If the caller requires the order of requests to be preserved, +then the caller is required to stall subsequent requests until a pending +request's callback is invoked. .It Er ENOMEM The load request has failed due to insufficient resources, and the caller specifically used the -- 2.45.0