[src/trunk]: src/share/man/man9 update manpage with reality WRT BUS_SPACE_BAR...

[jdolecek <jdolecek%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/09d9308816b4
branches:  trunk
changeset: 817908:09d9308816b4
user:      jdolecek <jdolecek%NetBSD.org@localhost>
date:      Thu Sep 15 21:47:26 2016 +0000

description:
update manpage with reality WRT BUS_SPACE_BARRIER_SYNC and
BUS_SPACE_BARRIER_X_BEFORE_Y flags

diffstat:

 share/man/man9/bus_space.9 |  39 +++++++++++++--------------------------
 1 files changed, 13 insertions(+), 26 deletions(-)

diffs (71 lines):

diff -r f5b7280fb680 -r 09d9308816b4 share/man/man9/bus_space.9
--- a/share/man/man9/bus_space.9        Thu Sep 15 21:45:37 2016 +0000
+++ b/share/man/man9/bus_space.9        Thu Sep 15 21:47:26 2016 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: bus_space.9,v 1.48 2016/06/01 08:17:33 wiz Exp $
+.\" $NetBSD: bus_space.9,v 1.49 2016/09/15 21:47:26 jdolecek Exp $
 .\"
 .\" Copyright (c) 1997 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -1360,22 +1360,17 @@
 .Fa flags
 argument controls what types of operations are to be ordered.
 Supported flags are:
-.Bl -tag -width BUS_SPACE_BARRIER_WRITE_BEFORE_WRITE -offset indent
-.It Dv BUS_SPACE_BARRIER_READ_BEFORE_READ
-Force all reads before the barrier to complete before any reads
-after the barrier may be issued.
-.It Dv BUS_SPACE_BARRIER_READ_BEFORE_WRITE
-Force all reads before the barrier to complete before any writes
+.Bl -tag -width BUS_SPACE_BARRIER_WRITE -offset indent
+.It Dv BUS_SPACE_BARRIER_READ
+Force all
+.Xr bus_space 9
+operations before the barrier to complete before any reads
 after the barrier may be issued.
-.It Dv BUS_SPACE_BARRIER_WRITE_BEFORE_READ
-Force all writes before the barrier to complete before any reads
+.It Dv BUS_SPACE_BARRIER_WRITE
+Force all
+.Xr bus_space 9
+operations before the barrier to complete before any writes
 after the barrier may be issued.
-.It Dv BUS_SPACE_BARRIER_WRITE_BEFORE_WRITE
-Force all writes before the barrier to complete before any writes
-after the barrier may be issued.
-.It Dv BUS_SPACE_BARRIER_SYNC
-Force all memory operations and any pending exceptions to be
-completed before any instructions after the barrier may be issued.
 .El
 .Pp
 Those flags can be combined (or-ed together) to enforce ordering on
@@ -1400,11 +1395,11 @@
  * space.
  */
 bus_space_write_1(t, h, 0, data0);
-bus_space_barrier(t, h, 0, 1, BUS_SPACE_BARRIER_WRITE_BEFORE_WRITE); /* 1 */
+bus_space_barrier(t, h, 0, 1, BUS_SPACE_BARRIER_WRITE); /* 1 */
 bus_space_write_1(t, h, 0, data1);
-bus_space_barrier(t, h, 0, 2, BUS_SPACE_BARRIER_WRITE_BEFORE_READ);  /* 2 */
+bus_space_barrier(t, h, 0, 2, BUS_SPACE_BARRIER_WRITE);  /* 2 */
 ndata1 = bus_space_read_1(t, h, 1);
-bus_space_barrier(t, h, 1, 1, BUS_SPACE_BARRIER_READ_BEFORE_READ);   /* 3 */
+bus_space_barrier(t, h, 1, 1, BUS_SPACE_BARRIER_READ);   /* 3 */
 ndata0 = bus_space_read_1(t, h, 1);
 /* data0 == ndata0, data1 == ndata1 */
 .Ed
@@ -1429,14 +1424,6 @@
 It is correct (and often easier) to make barrier operations cover the
 device's whole range of bus space, that is, to specify an offset of zero
 and the size of the whole region.
-.Pp
-The following barrier operations are obsolete and should be removed
-from existing code:
-.Bl -tag -width BUS_SPACE_BARRIER_WRITE -offset indent
-.It Dv BUS_SPACE_BARRIER_READ
-Synchronize read operations.
-.It Dv BUS_SPACE_BARRIER_WRITE
-Synchronize write operations.
 .El
 .El
 .Sh REGION OPERATIONS