Add libmemstat(3), a library for use by debugging and monitoring

applications in tracking kernel memory statistics.  It provides an
abstracted interface to uma(9) and malloc(9) statistics, wrapped
around the recently added binary stream sysctls for the allocators.

Using this interface, it is easy to build monitoring tools, query
specific memory types for usage information, etc.  Facilities are
provided for binding caller-provided data to memory types,
incremental updates of memory types, and queries that span multiple
allocators.

Support for additional allocators is (relatively) easy to add.

The API for libmemstat(3) will probably change some over time as
consumers are written, and requirements evolve.  It is written to
avoid encoding ABIs for data structure layout into consuming
applications for this reason.

MFC after:	1 week

1 files changed, 23 insertions, 0 deletions

diff --git a/lib/libmemstat/Makefile b/lib/libmemstat/Makefile
new file mode 100644
index 0000000..464400c
--- /dev/null
+++ b/lib/libmemstat/Makefile
@@ -0,0 +1,23 @@
+# $FreeBSD$
+
+WARNS?=		3
+LIB=		memstat
+SHLIB_MAJOR=	1
+SRCS+=		memstat.c
+SRCS+=		memstat_all.c
+SRCS+=		memstat_malloc.c
+SRCS+=		memstat_uma.c
+INCS=		memstat.h
+
+MAN=		libmemstat.3
+
+MLINKS+=	libmemstat.3 memstat_mtl_alloc.3
+MLINKS+=	libmemstat.3 memstat_mtl_first.3
+MLINKS+=	libmemstat.3 memstat_mtl_next.3
+MLINKS+=	libmemstat.3 memstat_mtl_find.3
+MLINKS+=	libmemstat.3 memstat_mtl_free.3
+MLINKS+=	libmemstat.3 memstat_sysctl_all.3
+MLINKS+=	libmemstat.3 memstat_sysctl_malloc.3
+MLINKS+=	libmemstat.3 memstat_sysctl_uma.3
+
+.include <bsd.lib.mk>