 @@ -1,14 +1,14 @@
-#	$NetBSD: mi,v 1.2400 2021/12/21 18:59:22 thorpej Exp $
+#	$NetBSD: mi,v 1.2401 2021/12/22 17:28:17 thorpej Exp $
+#
 # Note: don't delete entries from here - mark them as "obsolete" instead.
 ./etc/mtree/set.comp				comp-sys-root
 ./usr/bin/addr2line				comp-debug-bin		binutils
 ./usr/bin/ar					comp-util-bin		binutils
 ./usr/bin/as					comp-util-bin		binutils
 ./usr/bin/asa					comp-fortran-bin
 ./usr/bin/atf-compile				comp-obsolete		obsolete
 ./usr/bin/c++					comp-cxx-bin		gcccmds
 ./usr/bin/c++filt				comp-cxx-bin		binutils
 ./usr/bin/c11					comp-c-bin
 ./usr/bin/c89					comp-c-bin
 ./usr/bin/c99					comp-c-bin
 @@ -12272,27 +12272,27 @@
 ./usr/share/man/cat9/pool_cache.0		comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_cache_destroy.0	comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_cache_destruct_object.0	comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_cache_get.0		comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_cache_get_paddr.0	comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_cache_init.0		comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_cache_invalidate.0	comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_cache_invalidate_local.0	comp-obsolete	obsolete
 ./usr/share/man/cat9/pool_cache_put.0		comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_cache_put_paddr.0	comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_cache_sethardlimit.0	comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_cache_sethiwat.0	comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_cache_setlowat.0	comp-sys-catman		.cat
-./usr/share/man/cat9/pool_cache_setpredestruct.0	comp-sys-catman		.cat
+./usr/share/man/cat9/pool_cache_setpredestruct.0	comp-obsolete	obsolete
 ./usr/share/man/cat9/pool_create.0		comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_destroy.0		comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_get.0			comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_init.0		comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_prime.0		comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_put.0			comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_sethardlimit.0	comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_sethiwat.0		comp-sys-catman		.cat
 ./usr/share/man/cat9/pool_setlowat.0		comp-sys-catman		.cat
 ./usr/share/man/cat9/postsig.0			comp-sys-catman		.cat
 ./usr/share/man/cat9/powerhook_disestablish.0	comp-sys-catman		.cat
 ./usr/share/man/cat9/powerhook_establish.0	comp-sys-catman		.cat
 ./usr/share/man/cat9/powerof2.0			comp-sys-catman		.cat
 @@ -20465,27 +20465,27 @@
 ./usr/share/man/html9/pool_cache.html		comp-sys-htmlman	html
 ./usr/share/man/html9/pool_cache_destroy.html	comp-sys-htmlman	html
 ./usr/share/man/html9/pool_cache_destruct_object.html	comp-sys-htmlman	html
 ./usr/share/man/html9/pool_cache_get.html	comp-sys-htmlman	html
 ./usr/share/man/html9/pool_cache_get_paddr.html comp-sys-htmlman	html
 ./usr/share/man/html9/pool_cache_init.html	comp-sys-htmlman	html
 ./usr/share/man/html9/pool_cache_invalidate.html	comp-sys-htmlman	html
 ./usr/share/man/html9/pool_cache_invalidate_local.html	comp-obsolete	obsolete
 ./usr/share/man/html9/pool_cache_put.html	comp-sys-htmlman	html
 ./usr/share/man/html9/pool_cache_put_paddr.html comp-sys-htmlman	html
 ./usr/share/man/html9/pool_cache_sethardlimit.html	comp-sys-htmlman	html
 ./usr/share/man/html9/pool_cache_sethiwat.html	comp-sys-htmlman	html
 ./usr/share/man/html9/pool_cache_setlowat.html	comp-sys-htmlman	html
-./usr/share/man/html9/pool_cache_setpredestruct.html	comp-sys-htmlman	html
+./usr/share/man/html9/pool_cache_setpredestruct.html	comp-obsolete	obsolete
 ./usr/share/man/html9/pool_create.html		comp-sys-htmlman	html
 ./usr/share/man/html9/pool_destroy.html		comp-sys-htmlman	html
 ./usr/share/man/html9/pool_get.html		comp-sys-htmlman	html
 ./usr/share/man/html9/pool_init.html		comp-sys-htmlman	html
 ./usr/share/man/html9/pool_prime.html		comp-sys-htmlman	html
 ./usr/share/man/html9/pool_put.html		comp-sys-htmlman	html
 ./usr/share/man/html9/pool_sethardlimit.html	comp-sys-htmlman	html
 ./usr/share/man/html9/pool_sethiwat.html	comp-sys-htmlman	html
 ./usr/share/man/html9/pool_setlowat.html	comp-sys-htmlman	html
 ./usr/share/man/html9/postsig.html		comp-sys-htmlman	html
 ./usr/share/man/html9/powerhook_disestablish.html	comp-sys-htmlman	html
 ./usr/share/man/html9/powerhook_establish.html	comp-sys-htmlman	html
 ./usr/share/man/html9/powerof2.html		comp-sys-htmlman	html
 @@ -28819,27 +28819,27 @@
 ./usr/share/man/man9/pool_cache.9		comp-sys-man		.man
 ./usr/share/man/man9/pool_cache_destroy.9	comp-sys-man		.man
 ./usr/share/man/man9/pool_cache_destruct_object.9	comp-sys-man		.man
 ./usr/share/man/man9/pool_cache_get.9		comp-sys-man		.man
 ./usr/share/man/man9/pool_cache_get_paddr.9	comp-sys-man		.man
 ./usr/share/man/man9/pool_cache_init.9		comp-sys-man		.man
 ./usr/share/man/man9/pool_cache_invalidate.9	comp-sys-man		.man
 ./usr/share/man/man9/pool_cache_invalidate_local.9	comp-obsolete	obsolete
 ./usr/share/man/man9/pool_cache_put.9		comp-sys-man		.man
 ./usr/share/man/man9/pool_cache_put_paddr.9	comp-sys-man		.man
 ./usr/share/man/man9/pool_cache_sethardlimit.9	comp-sys-man		.man
 ./usr/share/man/man9/pool_cache_sethiwat.9	comp-sys-man		.man
 ./usr/share/man/man9/pool_cache_setlowat.9	comp-sys-man		.man
-./usr/share/man/man9/pool_cache_setpredestruct.9	comp-sys-man		.man
+./usr/share/man/man9/pool_cache_setpredestruct.9	comp-obsolete	obsolete
 ./usr/share/man/man9/pool_create.9		comp-sys-man		.man
 ./usr/share/man/man9/pool_destroy.9		comp-sys-man		.man
 ./usr/share/man/man9/pool_get.9			comp-sys-man		.man
 ./usr/share/man/man9/pool_init.9		comp-sys-man		.man
 ./usr/share/man/man9/pool_prime.9		comp-sys-man		.man
 ./usr/share/man/man9/pool_put.9			comp-sys-man		.man
 ./usr/share/man/man9/pool_sethardlimit.9	comp-sys-man		.man
 ./usr/share/man/man9/pool_sethiwat.9		comp-sys-man		.man
 ./usr/share/man/man9/pool_setlowat.9		comp-sys-man		.man
 ./usr/share/man/man9/postsig.9			comp-sys-man		.man
 ./usr/share/man/man9/powerhook_disestablish.9	comp-sys-man		.man
 ./usr/share/man/man9/powerhook_establish.9	comp-sys-man		.man
 ./usr/share/man/man9/powerof2.9			comp-sys-man		.man

 @@ -1,14 +1,14 @@
-#       $NetBSD: Makefile,v 1.459 2021/12/21 18:59:22 thorpej Exp $
+#       $NetBSD: Makefile,v 1.460 2021/12/22 17:28:17 thorpej 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 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 \
 	cpu_lwp_fork.9 \
 	cpu_idle.9 cpu_initclocks.9 cpu_need_resched.9 \
 @@ -748,28 +748,27 @@ MLINKS+=pool.9 pool_create.9 pool.9 pool
 	pool.9 pool_init.9 pool.9 pool_put.9 pool.9 pool_prime.9 \
 	pool.9 pool_sethiwat.9 pool.9 pool_setlowat.9 \
 	pool.9 pool_sethardlimit.9
 MLINKS+=pool_cache.9 pool_cache_init.9 \
 	pool_cache.9 pool_cache_destroy.9 \
 	pool_cache.9 pool_cache_get_paddr.9 \
 	pool_cache.9 pool_cache_get.9 \
 	pool_cache.9 pool_cache_put_paddr.9 \
 	pool_cache.9 pool_cache_put.9 \
 	pool_cache.9 pool_cache_destruct_object.9 \
 	pool_cache.9 pool_cache_invalidate.9 \
 	pool_cache.9 pool_cache_sethiwat.9 \
 	pool_cache.9 pool_cache_setlowat.9 \
-	pool_cache.9 pool_cache_sethardlimit.9 \
+	pool_cache.9 pool_cache_sethardlimit.9
 	pool_cache.9 pool_cache_setpredestruct.9
 MLINKS+=powerhook_establish.9 powerhook_disestablish.9
 MLINKS+=preempt.9 yield.9
 MLINKS+=pserialize.9 pserialize_create.9 \
 	pserialize.9 pserialize_destroy.9 \
 	pserialize.9 pserialize_read_enter.9 \
 	pserialize.9 pserialize_read_exit.9 \
 	pserialize.9 pserialize_perform.9
 MLINKS+=pslist.9 PSLIST_DESTROY.9 \
 	pslist.9 PSLIST_ENTRY_DESTROY.9 \
 	pslist.9 PSLIST_ENTRY_INIT.9 \
 	pslist.9 PSLIST_ENTRY_INITIALIZER.9 \
 	pslist.9 PSLIST_INIT.9 \
 	pslist.9 PSLIST_INITIALIZER.9 \

 @@ -1,14 +1,14 @@
-.\"	$NetBSD: pool.9,v 1.49 2020/04/13 08:59:14 wiz Exp $
+.\"	$NetBSD: pool.9,v 1.50 2021/12/22 17:28:17 thorpej Exp $
 .\"
 .\" Copyright (c) 1997, 1998, 2007 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" This code is derived from software contributed to The NetBSD Foundation
 .\" by Paul Kranenburg.
 .\"
 .\" 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
 @@ -88,32 +88,48 @@ The handle identifying the pool resource
 .It Fa size
 Specifies the size of the memory items managed by the pool.
 .It Fa align
 Specifies the memory address alignment of the items returned by
 .Fn pool_get .
 This argument must be a power of two.
 If zero,
 the alignment defaults to an architecture-specific natural alignment.
 .It Fa align_offset
 The offset within an item to which the
 .Fa align
 parameter applies.
 .It Fa flags
-Should be set to zero or
+Should be set to zero,
-.Dv PR_NOTOUCH .
+.Dv PR_NOTOUCH ,
 or
 .Dv PR_PSERIALIZE .
 If
 .Dv PR_NOTOUCH
 is given, free items are never used to keep internal state so that
 the pool can be used for non memory backed objects.
 If
 .Dv PR_PSERIALIZE
 is given, then the allocator guarantees that a passive serialization
 barrier equivalent to
 .Dq xc_barrier(0)
 will be performed before the object's backing store is returned to
 the system.
 .Dv PR_PSERIALIZE
 implies
 .Dv PR_NOTOUCH .
 Because of the guarantees provided by
 .Dv PR_PSERIALIZE ,
 objects muste never be freed to a pool using this option from either
 hard or soft interrupt context, as doing so may block.
 .It Fa wchan
 The
 .Sq wait channel
 passed on to
 .Xr cv_wait 9
 if
 .Fn pool_get
 must wait for items to be returned to the pool.
 .It Fa palloc
 Can be set to
 .Dv NULL
 or
 .Dv pool_allocator_kmem ,

 @@ -1,14 +1,14 @@
-.\"	$NetBSD: pool_cache.9,v 1.23 2021/12/21 18:59:22 thorpej Exp $
+.\"	$NetBSD: pool_cache.9,v 1.24 2021/12/22 17:28:17 thorpej Exp $
 .\"
 .\" Copyright (c)2003 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.
 .\"
 @@ -59,28 +59,27 @@
 .\" ------------------------------------------------------------
 .Sh NAME
 .Nm pool_cache ,
 .Nm pool_cache_init ,
 .Nm pool_cache_destroy ,
 .Nm pool_cache_get_paddr ,
 .Nm pool_cache_get ,
 .Nm pool_cache_put_paddr ,
 .Nm pool_cache_put ,
 .Nm pool_cache_destruct_object ,
 .Nm pool_cache_invalidate ,
 .Nm pool_cache_sethiwat ,
 .Nm pool_cache_setlowat ,
-.Nm pool_cache_sethardlimit ,
+.Nm pool_cache_sethardlimit
 .Nm pool_cache_setpredestruct
 .Nd resource-pool cache manager
 .\" ------------------------------------------------------------
 .Sh SYNOPSIS
 .In sys/pool.h
 .\" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 .Ft pool_cache_t
 .Fn pool_cache_init \
 "size_t size" "u_int align" "u_int align_offset" "int flags" \
 "const char *name" "struct pool_allocator *palloc" "int ipl" \
 "int (*ctor)(void *, void *, int)" "void (*dtor)(void *, void *)" "void *arg"
 .\" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 .Ft void
 .Fn pool_cache_destroy \
 @@ -110,30 +109,26 @@
 .Fn pool_cache_invalidate \
 "pool_cache_t pc"
 .\" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 .Ft void
 .Fn pool_cache_sethiwat \
 "pool_cache_t pc" "int n"
 .Ft void
 .Fn pool_cache_setlowat \
 "pool_cache_t pc" "int n"
 .Ft void
 .Fn pool_cache_sethardlimit \
 "pool_cache_t pc" "int n" "const char *warnmess" "int ratecap"
 .\" ------------------------------------------------------------
 .Ft void
 .Fn pool_cache_setpredestruct \
 "pool_cache_t pc" "void (*fn)(void *)"
 .\" ------------------------------------------------------------
 .Sh DESCRIPTION
 These utility routines provide management of pools of fixed-sized
 areas of memory.
 Resource pools set aside an amount of memory for exclusive use by the resource
 pool owner.
 This can be used by applications to guarantee the availability of a minimum
 amount of memory needed to continue operation independent of the memory
 resources currently available from the system-wide memory allocator.
 .Pp
 .Nm
 follows the
 .Xr pool 9
 API closely and offers routines that are functionally equivalent to
 @@ -165,32 +160,48 @@ Specifies the size of the memory items m
 .Pp
 Specifies the memory address alignment of the items returned by
 .Fn pool_cache_get .
 This argument must be a power of two.
 If zero,
 the alignment defaults to an architecture-specific natural alignment.
 .It Fa align_offset
 .Pp
 The offset within an item to which the
 .Fa align
 parameter applies.
 .It Fa flags
 .Pp
-Should be set to zero or
+Should be set to zero,
-.Dv PR_NOTOUCH .
+.Dv PR_NOTOUCH ,
 or
 .Dv PR_PSERIALIZE .
 If
 .Dv PR_NOTOUCH
 is given, free items are never used to keep internal state so that
 the pool can be used for non memory backed objects.
 If
 .Dv PR_PSERIALIZE
 is given, then the allocator guarantees that a passive serialization barrier
 equivalent to
 .Dq xc_barrier(0)
 will be performed before either the object's destructor is called or
 before object's backing store is returned to the system.
 .Dv PR_PSERIALIZE
 implies
 .Dv PR_NOTOUCH .
 Because of the guarantees provided by
 .Dv PR_PSERIALIZE ,
 objects must never be freed to a pool cache using this option
 from either hard or soft interrupt context, as doing so may block.
 .It Fa name
 .Pp
 The name used to identify the object in diagnostic output.
 .It Fa palloc
 .Pp
 Should be typically be set to NULL, instructing
 .Fn pool_cache_init
 to select an appropriate back-end allocator.
 Alternate allocators can be used to partition space from arbitrary sources.
 Use of alternate allocators is not documented here as it is not a stable,
 endorsed part of the API.
 .It Fa ipl
 .Pp
 @@ -342,35 +353,26 @@ The number of free items is not guarante
 .\" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 .It Fn pool_cache_sethardlimit "pc" "n" "warnmess" "ratecap"
 Set the maximum number of total items (both free and allocated) for the backing
 .Xr pool 9
 to
 .Fa n .
 When the hard limit is reached, the warning message
 .Fa warnmess
 will be logged.
 .Fa ratecap
 represents the minimal interval (in seconds) after which another warning
 message is issued when the pool hits its hard limit again.
 .\" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 .It Fn pool_cache_setpredestruct "fn"
 Sets a pre-destructor hook for the pool cache.
 This hook will be invoked
 .Pq with the same argument passed to the destructor
 before a batch of one or more objects is destructed.
 Pool cache users who rely on type-stability or use other
 forms of passive serialization may use this hook as a
 synchronization point.
 .\" - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 .It Fn pool_cache_prime "pc" "n"
 Set the minimum number of total items (both free and allocated) for the backing
 .Xr pool 9
 to
 .Fa n .
 .El
 .\" ------------------------------------------------------------
 .Sh CODE REFERENCES
 The
 .Nm
 subsystem is implemented within the file
 .Pa sys/kern/subr_pool.c .
 .Sh SEE ALSO