Mon Nov 13 09:10:47 2017 UTC ()
Bump space for previous. Formatting fix.


(wiz)
diff -r1.7 -r1.8 src/share/man/man9/mb.9
cvs diff -r1.7 -r1.8 src/share/man/man9/Attic/mb.9 (expand / switch to unified diff)

--- src/share/man/man9/Attic/mb.9 2017/11/12 21:20:20 1.7
+++ src/share/man/man9/Attic/mb.9 2017/11/13 09:10:47 1.8
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: mb.9,v 1.7 2017/11/12 21:20:20 riastradh Exp $ 1.\" $NetBSD: mb.9,v 1.8 2017/11/13 09:10:47 wiz Exp $
2.\" 2.\"
3.\" Copyright (c) 2007 The NetBSD Foundation, Inc. 3.\" Copyright (c) 2007 The NetBSD Foundation, Inc.
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation 6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Andrew Doran. 7.\" by Andrew Doran.
8.\" 8.\"
9.\" Redistribution and use in source and binary forms, with or without 9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions 10.\" modification, are permitted provided that the following conditions
11.\" are met: 11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright 12.\" 1. Redistributions of source code must retain the above copyright
13.\" notice, this list of conditions and the following disclaimer. 13.\" notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright 14.\" 2. Redistributions in binary form must reproduce the above copyright
@@ -17,49 +17,49 @@ @@ -17,49 +17,49 @@
17.\" 17.\"
18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 18.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 19.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 22.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 23.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 24.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 25.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28.\" POSSIBILITY OF SUCH DAMAGE. 28.\" POSSIBILITY OF SUCH DAMAGE.
29.\" 29.\"
30.Dd January 2, 2011 30.Dd November 12, 2017
31.Dt MB 9 31.Dt MB 9
32.Os 32.Os
33.Sh NAME 33.Sh NAME
34.Nm mb , 34.Nm mb ,
35.Nm mb_memory , 35.Nm mb_memory ,
36.Nm mb_read , 36.Nm mb_read ,
37.Nm mb_write 37.Nm mb_write
38.Nd memory barriers 38.Nd memory barriers
39.Sh SYNOPSIS 39.Sh SYNOPSIS
40.In sys/lock.h 40.In sys/lock.h
41.Ft void 41.Ft void
42.Fn mb_memory "void" 42.Fn mb_memory "void"
43.Ft void 43.Ft void
44.Fn mb_read "void" 44.Fn mb_read "void"
45.Ft void 45.Ft void
46.Fn mb_write "void" 46.Fn mb_write "void"
47.Sh DESCRIPTION 47.Sh DESCRIPTION
48.Em The 48.Em The
49.Nm 49.Nm
50.Em API is deprecated; use 50.Em API is deprecated; use
51.Xr membar_ops 3 51.Xr membar_ops 3
52.Em instead. 52.Em instead .
53.Pp 53.Pp
54Many types of processor can execute instructions in a different order 54Many types of processor can execute instructions in a different order
55than issued by the compiler or assembler. 55than issued by the compiler or assembler.
56On a uniprocessor system, out of order execution is transparent 56On a uniprocessor system, out of order execution is transparent
57to the programmer, operating system and applications, as the processor 57to the programmer, operating system and applications, as the processor
58must ensure that it is self consistent. 58must ensure that it is self consistent.
59.Pp 59.Pp
60On multiprocessor systems, out of order execution can present a 60On multiprocessor systems, out of order execution can present a
61problem where locks are not used to guarantee atomicity of 61problem where locks are not used to guarantee atomicity of
62access, because loads and stores issued by any given processor 62access, because loads and stores issued by any given processor
63can appear on the system bus (and thus appear to other processors) 63can appear on the system bus (and thus appear to other processors)
64in an unpredictable order. 64in an unpredictable order.
65.Pp 65.Pp