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