Source-Changes-HG archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]
[src/trunk]: src/share/man/man9 Nix obsolete mb(9) man page.
details: https://anonhg.NetBSD.org/src/rev/a3646f9330fb
branches: trunk
changeset: 967090:a3646f9330fb
user: riastradh <riastradh%NetBSD.org@localhost>
date: Fri Nov 29 20:31:35 2019 +0000
description:
Nix obsolete mb(9) man page.
diffstat:
distrib/sets/lists/comp/mi | 8 +-
share/man/man9/Makefile | 4 +-
share/man/man9/mb.9 | 127 ---------------------------------------------
3 files changed, 6 insertions(+), 133 deletions(-)
diffs (185 lines):
diff -r 3eeb430b9024 -r a3646f9330fb distrib/sets/lists/comp/mi
--- a/distrib/sets/lists/comp/mi Fri Nov 29 20:06:44 2019 +0000
+++ b/distrib/sets/lists/comp/mi Fri Nov 29 20:31:35 2019 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: mi,v 1.2292 2019/11/11 22:44:56 joerg Exp $
+# $NetBSD: mi,v 1.2293 2019/11/29 20:31:35 riastradh Exp $
#
# Note: don't delete entries from here - mark them as "obsolete" instead.
./etc/mtree/set.comp comp-sys-root
@@ -11387,7 +11387,7 @@
./usr/share/man/cat9/malloc_type_attach.0 comp-sys-catman .cat
./usr/share/man/cat9/malloc_type_detach.0 comp-sys-catman .cat
./usr/share/man/cat9/malloc_type_setlimit.0 comp-obsolete obsolete
-./usr/share/man/cat9/mb.0 comp-sys-catman .cat
+./usr/share/man/cat9/mb.0 comp-obsolete obsolete
./usr/share/man/cat9/mb_memory.0 comp-sys-catman .cat
./usr/share/man/cat9/mb_read.0 comp-sys-catman .cat
./usr/share/man/cat9/mb_write.0 comp-sys-catman .cat
@@ -19310,7 +19310,7 @@
./usr/share/man/html9/malloc_type_attach.html comp-sys-htmlman html
./usr/share/man/html9/malloc_type_detach.html comp-sys-htmlman html
./usr/share/man/html9/malloc_type_setlimit.html comp-obsolete obsolete
-./usr/share/man/html9/mb.html comp-sys-htmlman html
+./usr/share/man/html9/mb.html comp-obsolete obsolete
./usr/share/man/html9/mb_memory.html comp-sys-htmlman html
./usr/share/man/html9/mb_read.html comp-sys-htmlman html
./usr/share/man/html9/mb_write.html comp-sys-htmlman html
@@ -27386,7 +27386,7 @@
./usr/share/man/man9/malloc_type_attach.9 comp-sys-man .man
./usr/share/man/man9/malloc_type_detach.9 comp-sys-man .man
./usr/share/man/man9/malloc_type_setlimit.9 comp-obsolete obsolete
-./usr/share/man/man9/mb.9 comp-sys-man .man
+./usr/share/man/man9/mb.9 comp-obsolete obsolete
./usr/share/man/man9/mb_memory.9 comp-sys-man .man
./usr/share/man/man9/mb_read.9 comp-sys-man .man
./usr/share/man/man9/mb_write.9 comp-sys-man .man
diff -r 3eeb430b9024 -r a3646f9330fb share/man/man9/Makefile
--- a/share/man/man9/Makefile Fri Nov 29 20:06:44 2019 +0000
+++ b/share/man/man9/Makefile Fri Nov 29 20:31:35 2019 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.441 2019/10/02 08:21:08 rin Exp $
+# $NetBSD: Makefile,v 1.442 2019/11/29 20:31:35 riastradh Exp $
# Makefile for section 9 (kernel function and variable) manual pages.
@@ -34,7 +34,7 @@
kprintf.9 kthread.9 linedisc.9 lock.9 locking.9 log.9 ltsleep.9 \
localcount.9 LWP_CACHE_CREDS.9 \
makeiplcookie.9 \
- malloc.9 mb.9 mbuf.9 mca.9 memcmp.9 memcpy.9 memoryallocators.9 \
+ malloc.9 mbuf.9 mca.9 memcmp.9 memcpy.9 memoryallocators.9 \
memmove.9 memset.9 \
microseq.9 microtime.9 microuptime.9 mi_switch.9 module.9 \
mstohz.9 mutex.9 m_tag.9 namecache.9 \
diff -r 3eeb430b9024 -r a3646f9330fb share/man/man9/mb.9
--- a/share/man/man9/mb.9 Fri Nov 29 20:06:44 2019 +0000
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,127 +0,0 @@
-.\" $NetBSD: mb.9,v 1.8 2017/11/13 09:10:47 wiz Exp $
-.\"
-.\" Copyright (c) 2007 The NetBSD Foundation, Inc.
-.\" All rights reserved.
-.\"
-.\" This code is derived from software contributed to The NetBSD Foundation
-.\" by Andrew Doran.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\" notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\" notice, this list of conditions and the following disclaimer in the
-.\" documentation and/or other materials provided with the distribution.
-.\"
-.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
-.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
-.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
-.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
-.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-.\" POSSIBILITY OF SUCH DAMAGE.
-.\"
-.Dd November 12, 2017
-.Dt MB 9
-.Os
-.Sh NAME
-.Nm mb ,
-.Nm mb_memory ,
-.Nm mb_read ,
-.Nm mb_write
-.Nd memory barriers
-.Sh SYNOPSIS
-.In sys/lock.h
-.Ft void
-.Fn mb_memory "void"
-.Ft void
-.Fn mb_read "void"
-.Ft void
-.Fn mb_write "void"
-.Sh DESCRIPTION
-.Em The
-.Nm
-.Em API is deprecated; use
-.Xr membar_ops 3
-.Em instead .
-.Pp
-Many types of processor can execute instructions in a different order
-than issued by the compiler or assembler.
-On a uniprocessor system, out of order execution is transparent
-to the programmer, operating system and applications, as the processor
-must ensure that it is self consistent.
-.Pp
-On multiprocessor systems, out of order execution can present a
-problem where locks are not used to guarantee atomicity of
-access, because loads and stores issued by any given processor
-can appear on the system bus (and thus appear to other processors)
-in an unpredictable order.
-.Pp
-.Fn mb_memory ,
-.Fn mb_read ,
-and
-.Fn mb_write
-can be used to control the order in which memory accesses occur, and
-thus the order in which those accesses become visible to other processors.
-They can be used to implement
-.Dq lockless
-access to data structures where
-the necessary barrier conditions are well understood.
-.Pp
-Memory barriers can be computationally expensive, as they are
-considered
-.Dq serializing
-operations and may stall further execution
-until the processor has drained internal buffers and re-synchronized.
-.Pp
-The memory barrier primitives control only the order of memory access.
-They provide no guarantee that stores have been flushed to the bus, or
-that loads have been made from the bus.
-.Pp
-The memory barrier primitives are guaranteed only to prevent reordering
-of accesses to main memory.
-They do not provide any guarantee of ordering when used with device
-memory (for example, loads or stores to or from a PCI device).
-To guarantee ordering of access to device memory, the
-.Xr bus_dma 9
-and
-.Xr bus_space 9
-interfaces should be used.
-.Sh FUNCTIONS
-.Bl -tag -width abcd
-.It Fn mb_memory ""
-Issue a full memory barrier, ordering all memory accesses.
-Causes all loads and stores preceding the call to
-.Fn mb_memory
-to complete before further memory accesses can be made.
-.It Fn mb_read ""
-Issue a read memory barrier, ordering all loads from memory.
-Causes all loads preceding the call to
-.Fn mb_read
-to complete before further loads can be made.
-Stores may be reordered ahead of or behind a call to
-.Fn mb_read .
-.It Fn mb_write ""
-Issue a write memory barrier, ordering all stores to memory.
-Causes all stores preceding the call to
-.Fn mb_write
-to complete before further stores can be made.
-Loads may be reordered ahead of or behind a call to
-.Fn mb_write .
-.El
-.Sh SEE ALSO
-.Xr __insn_barrier 3 ,
-.Xr membar_ops 3 ,
-.Xr bus_dma 9 ,
-.Xr bus_space 9 ,
-.Xr mutex 9 ,
-.Xr rwlock 9
-.Sh HISTORY
-The memory barrier primitives first appeared in
-.Nx 5.0 .
Home |
Main Index |
Thread Index |
Old Index