Source-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[src/trunk]: src Hook bufferio(9) man page into the build.



details:   https://anonhg.NetBSD.org/src/rev/e4497615a660
branches:  trunk
changeset: 337009:e4497615a660
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Mon Mar 30 01:15:15 2015 +0000

description:
Hook bufferio(9) man page into the build.

Remove separate getiobuf(9) man page, subsumed by bufferio(9).

diffstat:

 distrib/sets/lists/comp/mi |  11 +++++-
 share/man/man9/Makefile    |  21 +++++++----
 share/man/man9/getiobuf.9  |  79 ----------------------------------------------
 3 files changed, 23 insertions(+), 88 deletions(-)

diffs (205 lines):

diff -r 9deb8a0bfbbd -r e4497615a660 distrib/sets/lists/comp/mi
--- a/distrib/sets/lists/comp/mi        Mon Mar 30 00:44:37 2015 +0000
+++ b/distrib/sets/lists/comp/mi        Mon Mar 30 01:15:15 2015 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: mi,v 1.1949 2015/03/30 00:44:37 riastradh Exp $
+#      $NetBSD: mi,v 1.1950 2015/03/30 01:15:15 riastradh Exp $
 #
 # Note: don't delete entries from here - mark them as "obsolete" instead.
 #
@@ -9906,6 +9906,7 @@
 ./usr/share/man/cat9/btoc.0                    comp-sys-catman         .cat
 ./usr/share/man/cat9/btodb.0                   comp-sys-catman         .cat
 ./usr/share/man/cat9/buffercache.0             comp-sys-catman         .cat
+./usr/share/man/cat9/bufferio.0                        comp-sys-catman         .cat
 ./usr/share/man/cat9/bufq.0                    comp-sys-catman         .cat
 ./usr/share/man/cat9/bus_dma.0                 comp-sys-catman         .cat
 ./usr/share/man/cat9/bus_dmamap_create.0       comp-sys-catman         .cat
@@ -10558,6 +10559,8 @@
 ./usr/share/man/cat9/nanotime.0                        comp-sys-catman         .cat
 ./usr/share/man/cat9/nanouptime.0              comp-sys-catman         .cat
 ./usr/share/man/cat9/need_resched.0            comp-obsolete           obsolete
+./usr/share/man/cat9/nestiobuf_done.0          comp-sys-catman         .cat
+./usr/share/man/cat9/nestiobuf_setup.0         comp-sys-catman         .cat
 ./usr/share/man/cat9/nextrunqueue.0            comp-obsolete           obsolete
 ./usr/share/man/cat9/npf_ncode.0               comp-obsolete           obsolete
 ./usr/share/man/cat9/nullop.0                  comp-sys-catman         .cat
@@ -16705,6 +16708,7 @@
 ./usr/share/man/html9/btoc.html                        comp-sys-htmlman        html
 ./usr/share/man/html9/btodb.html               comp-sys-htmlman        html
 ./usr/share/man/html9/buffercache.html         comp-sys-htmlman        html
+./usr/share/man/html9/bufferio.html            comp-sys-htmlman        html
 ./usr/share/man/html9/bufq.html                        comp-sys-htmlman        html
 ./usr/share/man/html9/bus_dma.html             comp-sys-htmlman        html
 ./usr/share/man/html9/bus_dmamap_create.html   comp-sys-htmlman        html
@@ -17330,6 +17334,8 @@
 ./usr/share/man/html9/namei.html               comp-sys-htmlman        html
 ./usr/share/man/html9/nanotime.html            comp-sys-htmlman        html
 ./usr/share/man/html9/nanouptime.html          comp-sys-htmlman        html
+./usr/share/man/html9/nestiobuf_done.html      comp-sys-htmlman        html
+./usr/share/man/html9/nestiobuf_setup.html     comp-sys-htmlman        html
 ./usr/share/man/html9/npf_ncode.html           comp-obsolete           obsolete
 ./usr/share/man/html9/nullop.html              comp-sys-htmlman        html
 ./usr/share/man/html9/old_sysctl.html          comp-sys-htmlman        html
@@ -23612,6 +23618,7 @@
 ./usr/share/man/man9/btoc.9                    comp-sys-man            .man
 ./usr/share/man/man9/btodb.9                   comp-sys-man            .man
 ./usr/share/man/man9/buffercache.9             comp-sys-man            .man
+./usr/share/man/man9/bufferio.9                        comp-sys-man            .man
 ./usr/share/man/man9/bufq.9                    comp-sys-man            .man
 ./usr/share/man/man9/bus_dma.9                 comp-sys-man            .man
 ./usr/share/man/man9/bus_dmamap_create.9       comp-sys-man            .man
@@ -24264,6 +24271,8 @@
 ./usr/share/man/man9/nanotime.9                        comp-sys-man            .man
 ./usr/share/man/man9/nanouptime.9              comp-sys-man            .man
 ./usr/share/man/man9/need_resched.9            comp-obsolete           obsolete
+./usr/share/man/man9/nestiobuf_done.9          comp-sys-man            .man
+./usr/share/man/man9/nestiobuf_setup.9         comp-sys-man            .man
 ./usr/share/man/man9/nextrunqueue.9            comp-obsolete           obsolete
 ./usr/share/man/man9/npf_ncode.9               comp-obsolete           obsolete
 ./usr/share/man/man9/nullop.9                  comp-sys-man            .man
diff -r 9deb8a0bfbbd -r e4497615a660 share/man/man9/Makefile
--- a/share/man/man9/Makefile   Mon Mar 30 00:44:37 2015 +0000
+++ b/share/man/man9/Makefile   Mon Mar 30 01:15:15 2015 +0000
@@ -1,11 +1,12 @@
-#       $NetBSD: Makefile,v 1.381 2015/03/30 00:44:37 riastradh Exp $
+#       $NetBSD: Makefile,v 1.382 2015/03/30 01:15:15 riastradh Exp $
 
 #      Makefile for section 9 (kernel function and variable) manual pages.
 
 MAN=   accept_filter.9 accf_data.9 accf_http.9 \
        altq.9 arp.9 audio.9 autoconf.9 \
        bcdtobin.9 bcmp.9 bcopy.9 bintime_add.9 bluetooth.9 boothowto.9 bpf.9 \
-       buffercache.9 bufq.9 bus_dma.9 bus_space.9 byteorder.9 bzero.9 \
+       buffercache.9 bufferio.9 bufq.9 bus_dma.9 bus_space.9 byteorder.9 \
+       bzero.9 \
        callback.9 callout.9 cardbus.9 clock.9 cnmagic.9 condvar.9 config.9 \
        cons.9 copy.9 coredump_write.9 \
        cpu_configure.9 cpu_coredump.9 cpu_dumpconf.9 \
@@ -19,7 +20,8 @@
        dopowerhooks.9 do_setresuid.9 doshutdownhooks.9 driver.9 \
        edid.9 errno.9 ethersubr.9 evcnt.9 extattr.9 extent.9 \
        fetch.9 file.9 fileassoc.9 filedesc.9 firmload.9 flash.9 \
-       fork1.9 fsetown.9 fstrans.9 getiobuf.9 genfs.9 genfs_rename.9 \
+       fork1.9 fsetown.9 fstrans.9 \
+       genfs.9 genfs_rename.9 \
        hash.9 hashinit.9 hardclock.9 humanize_number.9 hz.9 \
        ieee80211.9 ieee80211_crypto.9 ieee80211_input.9 ieee80211_ioctl.9 \
        ieee80211_node.9 ieee80211_output.9 ieee80211_proto.9 \
@@ -78,7 +80,7 @@
        cprng.9 arc4random.9 \
        cprng.9 arc4randbytes.9 \
        cprng.9 rnd_extract_data.9
-       
+
 MAN+=  deviter.9
 MLINKS+=deviter.9 deviter_first.9 \
        deviter.9 deviter_init.9 \
@@ -142,9 +144,13 @@
        buffercache.9 geteblk.9 \
        buffercache.9 incore.9 \
        buffercache.9 allocbuf.9 \
-       buffercache.9 brelse.9 \
-       buffercache.9 biodone.9 \
-       buffercache.9 biowait.9
+       buffercache.9 brelse.9
+MLINKS+=bufferio.9 biodone.9 \
+       bufferio.9 biowait.9 \
+       bufferio.9 getiobuf.9 \
+       bufferio.9 putiobuf.9 \
+       bufferio.9 nestiobuf_setup.9 \
+       bufferio.9 nestiobuf_done.9
 MLINKS+=bus_space.9 bus_space_alloc.9 bus_space.9 bus_space_barrier.9 \
        bus_space.9 bus_space_copy_region_1.9 \
        bus_space.9 bus_space_copy_region_2.9 \
@@ -334,7 +340,6 @@
        fstrans.9 fscow_establish.9 \
        fstrans.9 fscow_disestablish.9 \
        fstrans.9 fscow_run.9
-MLINKS+=getiobuf.9 putiobuf.9
 MLINKS+=hash.9 hash32_buf.9 hash.9 hash32_str.9 hash.9 hash32_strn.9
 MLINKS+=hashinit.9 hashdone.9
 MLINKS+=humanize_number.9 format_bytes.9
diff -r 9deb8a0bfbbd -r e4497615a660 share/man/man9/getiobuf.9
--- a/share/man/man9/getiobuf.9 Mon Mar 30 00:44:37 2015 +0000
+++ /dev/null   Thu Jan 01 00:00:00 1970 +0000
@@ -1,79 +0,0 @@
-.\"     $NetBSD: getiobuf.9,v 1.5 2011/04/28 17:09:19 wiz Exp $
-.\"
-.\" Copyright (c)2006,2008 YAMAMOTO Takashi,
-.\" All rights reserved.
-.\"
-.\" 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 AUTHOR 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 AUTHOR 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 May 6, 2008
-.Dt GETIOBUF 9
-.Os
-.Sh NAME
-.Nm getiobuf ,
-.Nm putiobuf
-.Nd I/O descriptor allocation interface
-.\" ------------------------------------------------------------
-.Sh SYNOPSIS
-.In sys/buf.h
-.Ft struct buf *
-.Fn getiobuf "struct vnode *vp" "bool waitok"
-.Ft void
-.Fn putiobuf "struct buf *bp"
-.\" ------------------------------------------------------------
-.Sh DESCRIPTION
-.\" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-.Fn getiobuf
-allocates a
-.Em buf
-structure.
-.Pp
-.Bl -tag -width waitok
-.It Fa vp
-The vnode to which the allocated buffer will be associated.
-This can be
-.Dv NULL .
-.It Fa waitok
-If true,
-.Fa getiobuf
-can sleep until enough memory is available.
-Otherwise, it returns
-.Dv NULL
-immediately if not enough memory is available.
-.El
-.Pp
-Note that the allocated buffer doesn't belong to the buffer cache.
-To free it,
-.Fn putiobuf
-should be used.
-.Fn brelse
-should not be used on it.
-.Pp
-.\" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-.Fn putiobuf
-frees
-.Fa bp ,
-which should be a buffer allocated with
-.Fn getiobuf .
-.\" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-.Sh SEE ALSO
-.Xr buffercache 9 ,
-.Xr intro 9



Home | Main Index | Thread Index | Old Index