Index: ossp-pkg/res/AUTHORS
RCS File: /v/ossp/cvs/ossp-pkg/res/AUTHORS,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/AUTHORS,v' | diff -u /dev/null - -L'ossp-pkg/res/AUTHORS' 2>/dev/null
--- ossp-pkg/res/AUTHORS
+++ -	2024-05-09 09:56:18.057093899 +0200
@@ -0,0 +1,15 @@
+   _        ___  ____ ____  ____
+  |_|_ _   / _ \/ ___/ ___||  _ \   _ __ ___  ___ 
+  _|_||_| | | | \___ \___ \| |_) | | '__/ _ \/ __|
+ |_||_|_| | |_| |___) |__) |  __/  | | |  __/\__ \
+  |_|_|_|  \___/|____/____/|_|     |_|  \___||___/
+
+  OSSP res - Resource Pools
+
+  AUTHORS
+
+  This is a list of authors who have written
+  or edited major parts of the OSSP res sources.
+
+  Ralf S. Engelschall   <rse@engelschall.com>
+
Index: ossp-pkg/res/ChangeLog
RCS File: /v/ossp/cvs/ossp-pkg/res/ChangeLog,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/ChangeLog,v' | diff -u /dev/null - -L'ossp-pkg/res/ChangeLog' 2>/dev/null
--- ossp-pkg/res/ChangeLog
+++ -	2024-05-09 09:56:18.059750698 +0200
@@ -0,0 +1,17 @@
+   _        ___  ____ ____  ____
+  |_|_ _   / _ \/ ___/ ___||  _ \   _ __ ___  ___ 
+  _|_||_| | | | \___ \___ \| |_) | | '__/ _ \/ __|
+ |_||_|_| | |_| |___) |__) |  __/  | | |  __/\__ \
+  |_|_|_|  \___/|____/____/|_|     |_|  \___||___/
+
+  OSSP res - Resource Pools
+
+  ChangeLog
+
+  This is the list of all changes to the OSSP res source tree.
+
+  Changes between GENESIS and 0.9.0 (31-Jan-2002)
+
+   *) Created initial version
+      [Ralf S. Engelschall]
+
Index: ossp-pkg/res/INSTALL
RCS File: /v/ossp/cvs/ossp-pkg/res/INSTALL,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/INSTALL,v' | diff -u /dev/null - -L'ossp-pkg/res/INSTALL' 2>/dev/null
--- ossp-pkg/res/INSTALL
+++ -	2024-05-09 09:56:18.062342498 +0200
@@ -0,0 +1,18 @@
+   _        ___  ____ ____  ____
+  |_|_ _   / _ \/ ___/ ___||  _ \   _ __ ___  ___ 
+  _|_||_| | | | \___ \___ \| |_) | | '__/ _ \/ __|
+ |_||_|_| | |_| |___) |__) |  __/  | | |  __/\__ \
+  |_|_|_|  \___/|____/____/|_|     |_|  \___||___/
+
+  OSSP res - Resource Pools
+
+  INSTALL
+
+  To install OSSP res into /path/to/res/ perform
+  the following steps in your shell:
+
+    $ ./configure --prefix=/path/to/res
+    $ make
+    $ make check
+    $ make install
+
Index: ossp-pkg/res/Makefile.in
RCS File: /v/ossp/cvs/ossp-pkg/res/Makefile.in,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/Makefile.in,v' | diff -u /dev/null - -L'ossp-pkg/res/Makefile.in' 2>/dev/null
--- ossp-pkg/res/Makefile.in
+++ -	2024-05-09 09:56:18.064924546 +0200
@@ -0,0 +1,131 @@
+##
+##  OSSP res - Resource Pools
+##  Copyright (c) 2003 Ralf S. Engelschall <rse@engelschall.com>
+##  Copyright (c) 2003 The OSSP Project <http://www.ossp.org/>
+##
+##  This file is part of OSSP res, a resource pool library
+##  which can be found at http://www.ossp.org/pkg/lib/res/.
+##
+##  Permission to use, copy, modify, and distribute this software for
+##  any purpose with or without fee is hereby granted, provided that
+##  the above copyright notice and this permission notice appear in all
+##  copies.
+##
+##  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED 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 AUTHORS AND COPYRIGHT HOLDERS AND THEIR
+##  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.
+##
+##  Makefile.in: make(1) build procedure
+##
+
+@SET_MAKE@
+
+DESTDIR     =
+prefix      = @prefix@
+exec_prefix = @exec_prefix@
+bindir      = @bindir@
+libdir      = @libdir@
+includedir  = @includedir@
+mandir      = @mandir@
+
+CC          = @CC@
+CPPFLAGS    = @CPPFLAGS@
+CFLAGS      = @DEFS@ @CFLAGS@
+LDFLAGS     = @LDFLAGS@
+LIBS        = @LIBS@
+RM          = rm -f
+RMDIR       = rmdir
+SHTOOL      = ./shtool
+LIBTOOL     = ./libtool
+TRUE        = true
+POD2MAN     = pod2man
+
+LIB_NAME    = libres.la
+LIB_OBJS    = res.lo
+
+TST_NAME    = res_test
+TST_OBJS    = res_test.o ts.o
+
+.SUFFIXES:
+.SUFFIXES: .c .o .lo
+
+all: $(LIB_NAME) $(TST_NAME)
+
+.c.o:
+	$(CC) $(CPPFLAGS) $(CFLAGS) -c $<
+
+.c.lo:
+	@$(LIBTOOL) --mode=compile $(CC) $(CPPFLAGS) $(CFLAGS) -c $<
+
+$(LIB_OBJS): Makefile
+$(TST_OBJS): Makefile
+
+$(LIB_NAME): $(LIB_OBJS)
+	@$(LIBTOOL) --mode=link $(CC) -o $(LIB_NAME) $(LIB_OBJS) -rpath $(libdir) \
+	    -version-info `$(SHTOOL) version -l txt -d libtool VERSION`
+
+$(TST_NAME): $(TST_OBJS) $(LIB_NAME)
+	@$(LIBTOOL) --mode=link $(CC) $(LDFLAGS) -o $(TST_NAME) $(TST_OBJS) $(LIB_NAME) $(LIBS)
+
+man: res.3
+res.3: res.pod
+	V1=`$(SHTOOL) version -l txt -d short VERSION`; \
+	V2=`$(SHTOOL) version -l txt -d long VERSION`; \
+	D=`$(SHTOOL) version -l txt -d long VERSION | sed -e 's;.*(;;' -e 's;).*;;'`; \
+	$(POD2MAN) --quotes=none \
+	           --section=3 --center="Resource Pools" \
+	           --release="$$D" --date="OSSP res $$V1" res.pod | \
+	sed -e "s;RES_VERSION_STR;$$V2;" >res.3
+
+check: $(TST_NAME)
+	@$(LIBTOOL) --mode=execute ./$(TST_NAME)
+
+install:
+	$(SHTOOL) mkdir -f -p -m 755 $(DESTDIR)$(prefix)
+	$(SHTOOL) mkdir -f -p -m 755 $(DESTDIR)$(bindir)
+	$(SHTOOL) mkdir -f -p -m 755 $(DESTDIR)$(includedir)
+	$(SHTOOL) mkdir -f -p -m 755 $(DESTDIR)$(libdir)
+	$(SHTOOL) mkdir -f -p -m 755 $(DESTDIR)$(mandir)/man3
+	$(SHTOOL) install -c -m 755 res-config $(DESTDIR)$(bindir)/
+	$(SHTOOL) install -c -m 644 res.h $(DESTDIR)$(includedir)/
+	$(SHTOOL) install -c -m 644 res.3 $(DESTDIR)$(mandir)/man3/
+	@$(LIBTOOL) --mode=install $(SHTOOL) install -c -m 644 libres.la $(DESTDIR)$(libdir)/
+
+uninstall:
+	@$(LIBTOOL) --mode=uninstall $(RM) $(DESTDIR)$(libdir)/libres.la
+	-$(RM) $(DESTDIR)$(mandir)/man3/res.3
+	-$(RM) $(DESTDIR)$(includedir)/res.h
+	-$(RM) $(DESTDIR)$(bindir)/res-config
+	-$(RMDIR) $(DESTDIR)$(mandir)/man3 >/dev/null 2>&1 || $(TRUE)
+	-$(RMDIR) $(DESTDIR)$(mandir) >/dev/null 2>&1 || $(TRUE)
+	-$(RMDIR) $(DESTDIR)$(libdir) >/dev/null 2>&1 || $(TRUE)
+	-$(RMDIR) $(DESTDIR)$(includedir) >/dev/null 2>&1 || $(TRUE)
+	-$(RMDIR) $(DESTDIR)$(bindir) >/dev/null 2>&1 || $(TRUE)
+	-$(RMDIR) $(DESTDIR)$(prefix) >/dev/null 2>&1 || $(TRUE)
+
+clean:
+	-$(RM) $(LIB_NAME) $(LIB_OBJS)
+	-$(RM) $(TST_NAME) $(TST_OBJS)
+	-$(RM) -r .libs >/dev/null 2>&1 || $(TRUE)
+	-$(RM) *.o *.lo
+
+distclean: clean
+	-$(RM) config.log config.status config.cache
+	-$(RM) Makefile config.h res-config
+	-$(RM) libtool
+
+realclean: distclean
+	-$(RM) res.3
+	-$(RM) configure config.h.in
+	-$(RM) shtool
+	-$(RM) ltmain.sh libtool.m4 config.guess config.sub
+
Index: ossp-pkg/res/README
RCS File: /v/ossp/cvs/ossp-pkg/res/README,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/README,v' | diff -u /dev/null - -L'ossp-pkg/res/README' 2>/dev/null
--- ossp-pkg/res/README
+++ -	2024-05-09 09:56:18.067495811 +0200
@@ -0,0 +1,47 @@
+   _        ___  ____ ____  ____
+  |_|_ _   / _ \/ ___/ ___||  _ \   _ __ ___  ___ 
+  _|_||_| | | | \___ \___ \| |_) | | '__/ _ \/ __|
+ |_||_|_| | |_| |___) |__) |  __/  | | |  __/\__ \
+  |_|_|_|  \___/|____/____/|_|     |_|  \___||___/
+
+  OSSP res - Resource Pools
+  Version 0.1.0 (30-Jan-2003)
+
+  ABSTRACT
+
+  OSSP res is a resource management library for dealing with
+  resource pools. [...]
+
+  COPYRIGHT AND LICENSE
+
+  Copyright (c) 2003 Ralf S. Engelschall <rse@engelschall.com>
+  Copyright (c) 2003 The OSSP Project <http://www.ossp.org/>
+
+  This file is part of OSSP res, a resource pool library which
+  can be found at http://www.ossp.org/pkg/lib/res/.
+
+  Permission to use, copy, modify, and distribute this software for
+  any purpose with or without fee is hereby granted, provided that
+  the above copyright notice and this permission notice appear in all
+  copies.
+
+  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED 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 AUTHORS AND COPYRIGHT HOLDERS AND THEIR
+  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.
+
+  HOME AND DOCUMENTATION
+
+  The documentation and latest release can be found on
+
+  o http://www.ossp.org/pkg/lib/res/
+  o  ftp://ftp.ossp.org/pkg/lib/res/
+
Index: ossp-pkg/res/THANKS
RCS File: /v/ossp/cvs/ossp-pkg/res/THANKS,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/THANKS,v' | diff -u /dev/null - -L'ossp-pkg/res/THANKS' 2>/dev/null
--- ossp-pkg/res/THANKS
+++ -	2024-05-09 09:56:18.070074272 +0200
@@ -0,0 +1,13 @@
+   _        ___  ____ ____  ____
+  |_|_ _   / _ \/ ___/ ___||  _ \   _ __ ___  ___ 
+  _|_||_| | | | \___ \___ \| |_) | | '__/ _ \/ __|
+ |_||_|_| | |_| |___) |__) |  __/  | | |  __/\__ \
+  |_|_|_|  \___/|____/____/|_|     |_|  \___||___/
+
+  OSSP res - Resource Pools
+  
+  THANKS
+
+  Credit has to be given to the following people who contributed ideas,
+  bugfixes, hints, gave platform feedback, etc. (in alphabetical order):
+
Index: ossp-pkg/res/VERSION
RCS File: /v/ossp/cvs/ossp-pkg/res/VERSION,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/VERSION,v' | diff -u /dev/null - -L'ossp-pkg/res/VERSION' 2>/dev/null
--- ossp-pkg/res/VERSION
+++ -	2024-05-09 09:56:18.072592376 +0200
@@ -0,0 +1,6 @@
+
+  VERSION -- Version Information for OSSP ex (syntax: Text)
+  [automatically generated and maintained by GNU shtool]
+
+  This is OSSP ex, Version 1.0.2 (30-Jan-2003)
+
Index: ossp-pkg/res/aclocal.m4
RCS File: /v/ossp/cvs/ossp-pkg/res/aclocal.m4,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/aclocal.m4,v' | diff -u /dev/null - -L'ossp-pkg/res/aclocal.m4' 2>/dev/null
--- ossp-pkg/res/aclocal.m4
+++ -	2024-05-09 09:56:18.088973932 +0200
@@ -0,0 +1,228 @@
+dnl ##
+dnl ##  OSSP res - Resource Pools
+dnl ##  Copyright (c) 2003 Ralf S. Engelschall <rse@engelschall.com>
+dnl ##  Copyright (c) 2003 The OSSP Project <http://www.ossp.org/>
+dnl ##
+dnl ##  This file is part of OSSP res, a resource pool library
+dnl ##  which can be found at http://www.ossp.org/pkg/lib/res/.
+dnl ##
+dnl ##  Permission to use, copy, modify, and distribute this software for
+dnl ##  any purpose with or without fee is hereby granted, provided that
+dnl ##  the above copyright notice and this permission notice appear in all
+dnl ##  copies.
+dnl ##
+dnl ##  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+dnl ##  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+dnl ##  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+dnl ##  IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
+dnl ##  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+dnl ##  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+dnl ##  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+dnl ##  USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+dnl ##  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+dnl ##  OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+dnl ##  OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+dnl ##  SUCH DAMAGE.
+dnl ##
+dnl ##  aclocal.m4: GNU Autoconf local macro definitions
+dnl ##
+
+dnl ##
+dnl ##  Check whether compiler option works
+dnl ##
+dnl ##  configure.in:
+dnl ##    AC_COMPILER_OPTION(<name>, <display>, <option>,
+dnl ##                       <action-success>, <action-failure>)
+dnl ##
+
+AC_DEFUN(AC_COMPILER_OPTION,[dnl
+AC_MSG_CHECKING(whether compiler option(s) $2 work)
+AC_CACHE_VAL(ac_cv_compiler_option_$1,[
+SAVE_CFLAGS="$CFLAGS"
+CFLAGS="$CFLAGS $3"
+AC_TRY_COMPILE([],[], ac_cv_compiler_option_$1=yes, ac_cv_compiler_option_$1=no)
+CFLAGS="$SAVE_CFLAGS"
+])dnl
+if test ".$ac_cv_compiler_option_$1" = .yes; then
+    ifelse([$4], , :, [$4])
+else
+    ifelse([$5], , :, [$5])
+fi
+AC_MSG_RESULT([$ac_cv_compiler_option_$1])
+])dnl
+
+dnl ##
+dnl ##  Debugging Support
+dnl ##
+dnl ##  configure.in:
+dnl ##    AC_CHECK_DEBUGGING
+dnl ##
+
+AC_DEFUN(AC_CHECK_DEBUGGING,[dnl
+AC_ARG_ENABLE(debug,dnl
+[  --enable-debug          build for debugging (default=no)],
+[dnl
+if test ".$ac_cv_prog_gcc" = ".yes"; then
+    case "$CFLAGS" in
+        *-O* ) ;;
+           * ) CFLAGS="$CFLAGS -O2" ;;
+    esac
+    case "$CFLAGS" in
+        *-g* ) ;;
+           * ) CFLAGS="$CFLAGS -g" ;;
+    esac
+    case "$CFLAGS" in
+        *-pipe* ) ;;
+              * ) AC_COMPILER_OPTION(pipe, -pipe, -pipe, CFLAGS="$CFLAGS -pipe") ;;
+    esac
+    AC_COMPILER_OPTION(defdbg, -DDEBUG, -DDEBUG, CFLAGS="$CFLAGS -DDEBUG")
+    AC_COMPILER_OPTION(ggdb3, -ggdb3, -ggdb3, CFLAGS="$CFLAGS -ggdb3")
+    CFLAGS="$CFLAGS -pedantic"
+    CFLAGS="$CFLAGS -Wall"
+    WMORE="-Wshadow -Wpointer-arith -Wcast-align -Winline"
+    WMORE="$WMORE -Wmissing-prototypes -Wmissing-declarations -Wnested-externs"
+    AC_COMPILER_OPTION(wmore, -W<xxx>, $WMORE, CFLAGS="$CFLAGS $WMORE")
+    AC_COMPILER_OPTION(wnolonglong, -Wno-long-long, -Wno-long-long, CFLAGS="$CFLAGS -Wno-long-long")
+else
+    case "$CFLAGS" in
+        *-g* ) ;;
+           * ) CFLAGS="$CFLAGS -g" ;;
+    esac
+fi
+msg="enabled"
+],[
+if test ".$ac_cv_prog_gcc" = ".yes"; then
+case "$CFLAGS" in
+    *-pipe* ) ;;
+          * ) AC_COMPILER_OPTION(pipe, -pipe, -pipe, CFLAGS="$CFLAGS -pipe") ;;
+esac
+fi
+case "$CFLAGS" in
+    *-g* ) CFLAGS=`echo "$CFLAGS" |\
+                   sed -e 's/ -g / /g' -e 's/ -g$//' -e 's/^-g //g' -e 's/^-g$//'` ;;
+esac
+case "$CXXFLAGS" in
+    *-g* ) CXXFLAGS=`echo "$CXXFLAGS" |\
+                     sed -e 's/ -g / /g' -e 's/ -g$//' -e 's/^-g //g' -e 's/^-g$//'` ;;
+esac
+msg=disabled
+])dnl
+AC_MSG_CHECKING(for compilation debug mode)
+AC_MSG_RESULT([$msg])
+if test ".$msg" = .enabled; then
+    enable_shared=no
+fi
+])
+
+dnl ##
+dnl ##  Check for an external/extension library.
+dnl ##  - is aware of <libname>-config style scripts
+dnl ##  - searches under standard paths include, lib, etc.
+dnl ##  - searches under subareas like .libs, etc.
+dnl ##
+dnl ##  configure.in:
+dnl ##      AC_CHECK_EXTLIB(<realname>, <libname>, <func>, <header>,
+dnl ##                      [<success-action> [, <fail-action>]])
+dnl ##  Makefile.in:
+dnl ##      CFLAGS  = @CFLAGS@
+dnl ##      LDFLAGS = @LDFLAGS@
+dnl ##      LIBS    = @LIBS@
+dnl ##  shell:
+dnl ##      $ ./configure --with-<libname>[=DIR]
+dnl ##
+
+AC_DEFUN(AC_CHECK_EXTLIB,[dnl
+AC_ARG_WITH($2, [dnl
+[  --with-]m4_substr([$2[[=DIR]]                     ], 0, 19)[build with external $1 library (default=no)]], [dnl
+    if test ".$with_$2" = .yes; then
+        #   via config script in PATH
+        $2_version=`($2-config --version) 2>/dev/null`
+        if test ".$$2_version" != .; then
+            CPPFLAGS="$CPPFLAGS `$2-config --cflags`"
+            CFLAGS="$CFLAGS `$2-config --cflags`"
+            LDFLAGS="$LDFLAGS `$2-config --ldflags`"
+        fi
+    else
+        if test -d "$with_$2"; then
+            found=0
+            #   via config script
+            for dir in $with_$2/bin $with_$2; do
+                if test -f "$dir/$2-config" && test ! -f "$dir/$2-config.in"; then
+                    $2_version=`($dir/$2-config --version) 2>/dev/null`
+                    if test ".$$2_version" != .; then
+                        CPPFLAGS="$CPPFLAGS `$dir/$2-config --cflags`"
+                        CFLAGS="$CFLAGS `$dir/$2-config --cflags`"
+                        LDFLAGS="$LDFLAGS `$dir/$2-config --ldflags`"
+                        found=1
+                        break
+                    fi
+                fi
+            done
+            #   in standard sub-areas
+            if test ".$found" = .0; then
+                for dir in $with_$2/include/$2 $with_$2/include $with_$2; do
+                    if test -f "$dir/$4"; then
+                        CPPFLAGS="$CPPFLAGS -I$dir"
+                        CFLAGS="$CFLAGS -I$dir"
+                        found=1
+                        break
+                    fi
+                done
+                for dir in $with_$2/lib/$2 $with_$2/lib $with_$2; do
+                    if test -f "$dir/lib$2.la" && test -d "$dir/.libs"; then
+                        LDFLAGS="$LDFLAGS -L$dir -L$dir/.libs"
+                        found=1
+                        break
+                    elif test -f "$dir/lib$2.a" || test -f "$dir/lib$2.so"; then
+                        LDFLAGS="$LDFLAGS -L$dir"
+                        found=1
+                        break
+                    fi
+                done
+            fi
+            #   in any sub-area
+            if test ".$found" = .0; then
+changequote(, )dnl
+                for file in x `find $with_$2 -name "$4" -type f -print`; do
+                    test .$file = .x && continue
+                    dir=`echo $file | sed -e 's;[^/]*$;;' -e 's;\(.\)/$;\1;'`
+                    CPPFLAGS="$CPPFLAGS -I$dir"
+                    CFLAGS="$CFLAGS -I$dir"
+                done
+                for file in x `find $with_$2 -name "lib$2.[aso]" -type f -print`; do
+                    test .$file = .x && continue
+                    dir=`echo $file | sed -e 's;[^/]*$;;' -e 's;\(.\)/$;\1;'`
+                    LDFLAGS="$LDFLAGS -L$dir"
+                done
+changequote([, ])dnl
+            fi
+        fi
+    fi
+    AC_HAVE_HEADERS($4)
+    AC_CHECK_LIB($2, $3)
+    with_$2=yes
+    ac_var="ac_cv_header_`echo $4 | sed 'y%./+-%__p_%'`"
+    eval "ac_val=\$$ac_var"
+    if test ".$ac_val" != .yes; then
+        with_$2=no
+    fi
+    if test ".$ac_cv_lib_$2_$3" != .yes; then
+        with_$2=no
+    fi
+    if test ".$with_$2" = .no; then
+        AC_ERROR([Unable to find $1 library])
+    fi
+    ], [dnl
+if test ".$with_$2" = .; then
+    with_$2=no
+fi
+    ])dnl
+AC_MSG_CHECKING(whether to build against external $1 library)
+if test ".$with_$2" = .yes; then
+    ifelse([$5], , :, [$5])
+else
+    ifelse([$6], , :, [$6])
+fi
+AC_MSG_RESULT([$with_$2])
+])dnl
+
Index: ossp-pkg/res/configure.ac
RCS File: /v/ossp/cvs/ossp-pkg/res/configure.ac,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/configure.ac,v' | diff -u /dev/null - -L'ossp-pkg/res/configure.ac' 2>/dev/null
--- ossp-pkg/res/configure.ac
+++ -	2024-05-09 09:56:18.091629296 +0200
@@ -0,0 +1,50 @@
+dnl ##
+dnl ##  OSSP res - Resource Pools
+dnl ##  Copyright (c) 2003 Ralf S. Engelschall <rse@engelschall.com>
+dnl ##  Copyright (c) 2003 The OSSP Project <http://www.ossp.org/>
+dnl ##
+dnl ##  This file is part of OSSP res, a resource pool library
+dnl ##  which can be found at http://www.ossp.org/pkg/lib/res/.
+dnl ##
+dnl ##  Permission to use, copy, modify, and distribute this software for
+dnl ##  any purpose with or without fee is hereby granted, provided that
+dnl ##  the above copyright notice and this permission notice appear in all
+dnl ##  copies.
+dnl ##
+dnl ##  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
+dnl ##  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+dnl ##  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+dnl ##  IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
+dnl ##  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+dnl ##  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+dnl ##  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+dnl ##  USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+dnl ##  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+dnl ##  OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+dnl ##  OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+dnl ##  SUCH DAMAGE.
+dnl ##
+dnl ##  configure.ac: GNU Autoconf source script
+dnl ##
+
+AC_PREREQ(2.57)
+AC_INIT
+RES_VERSION_STR=`./shtool version -l txt -d long VERSION`
+./shtool echo -e "Configuring %BOSSP res%b (Resource Pools), version %B${EX_VERSION_STR}%b"
+AC_SUBST(RES_VERSION_STR)
+AC_CONFIG_SRCDIR(res.h)
+
+AC_PROG_MAKE_SET
+AC_PROG_CC
+AC_CHECK_DEBUGGING
+sinclude(libtool.m4)
+AC_PROG_LIBTOOL
+
+AC_CHECK_EXTLIB([OSSP ex], ex, __ex_ctx, ex.h,
+                [AC_DEFINE(WITH_EX, 1, [Define to 1 if building with OSSP ex])])
+
+AC_CONFIG_HEADERS(config.h)
+AC_CONFIG_FILES([Makefile res-config])
+AC_CONFIG_COMMANDS([adjustment], [chmod a+x res-config])
+AC_OUTPUT
+
Index: ossp-pkg/res/devtool
RCS File: /v/ossp/cvs/ossp-pkg/res/devtool,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/devtool,v' | diff -u /dev/null - -L'ossp-pkg/res/devtool' 2>/dev/null
--- ossp-pkg/res/devtool
+++ -	2024-05-09 09:56:18.094196079 +0200
@@ -0,0 +1,47 @@
+#!/bin/sh
+##
+##  devtool -- Development Tool
+##  Copyright (c) 2001 Ralf S. Engelschall <rse@engelschall.com> 
+##
+
+if [ $# -eq 0 ]; then
+    echo "devtool:USAGE: devtool <command> [<arg> ...]" 1>&2
+    exit 1
+fi
+
+cmd="$1"
+shift
+
+devtoolfunc="./devtool.func"
+
+if [ ! -f devtool.conf ]; then
+    echo "devtool:ERROR: no devtool.conf in current directory" 1>&2
+    exit 1
+fi
+
+cmdline=`grep "^%$cmd" devtool.conf`
+if [ ".$cmdline" = . ]; then
+    echo "devtool:ERROR: command $cmd not found in devtool.conf" 1>&2
+    exit 1
+fi
+
+if [ ".$TMPDIR" != . ]; then
+    tmpdir="$TMPDIR"
+elif [ ".$TEMPDIR" != . ]; then
+    tmpdir="$TEMPDIR"
+else
+    tmpdir="/tmp"
+fi
+tmpfile="$tmpdir/rc.$$.tmp"
+
+rm -f $tmpfile
+touch $tmpfile
+echo ". $devtoolfunc" >>$tmpfile
+( sed <devtool.conf -e "1,/^%common/d" -e '/^%.*/,$d'
+  sed <devtool.conf -e "1,/^%$cmd/d" -e '/^%.*/,$d' ) |\
+sed -e 's;\([ 	]\)@\([a-zA-Z_][a-zA-Z0-9_]*\);\1devtool_\2;' >>$tmpfile
+
+sh $tmpfile "$@"
+
+rm -f $tmpfile >/dev/null 2>&1 || true
+
Index: ossp-pkg/res/devtool.conf
RCS File: /v/ossp/cvs/ossp-pkg/res/devtool.conf,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/devtool.conf,v' | diff -u /dev/null - -L'ossp-pkg/res/devtool.conf' 2>/dev/null
--- ossp-pkg/res/devtool.conf
+++ -	2024-05-09 09:56:18.096968987 +0200
@@ -0,0 +1,51 @@
+##
+##  devtool.conf -- Development Tool Configuration
+##
+
+%autogen
+    @autogen shtool   1.6.2 "1.6.*" all
+    @autogen libtool  1.4.3 "1.4*"
+    @autogen autoconf 2.57  "2.5[3-9]*"
+
+%autoclean
+    @autoclean shtool
+    @autoclean libtool
+    @autoclean autoconf
+
+%configure
+    ./configure \
+        --prefix=/tmp/res \
+        --disable-shared \
+        --enable-debug \
+        "$@"
+
+%version
+    ./shtool version -l txt -n "OSSP res" -e VERSION
+    V=`./shtool version -l txt -d long VERSION`
+    sed -e "s/Version .*/Version $V/g" <README >README.n
+    mv README.n README
+
+%dist
+    echo "+++ generating"
+    ./devtool autoclean
+    ./devtool autogen
+    echo "+++ configuring"
+    ./configure
+    echo "+++ building"
+    make clean all man
+    echo "+++ cleaning"
+    make distclean
+    echo "+++ fixing"
+    ./shtool fixperm -v .
+    echo "+++ rolling"
+    V=`./shtool version -l txt -d short VERSION`
+    ./shtool tarball -o res-${V}.tar.gz -d res-${V} -u ossp -g res \
+                     -e 'CVS,\.cvsignore,\.[ao]$,^\.,devtool*,*.tar.gz,00TODO' -c 'gzip --best' .
+    ls -l res-${V}.tar.gz
+    echo "+++ testing"
+    gunzip <res-${V}.tar.gz | tar tvf -
+
+%release
+    echo "+++ copying to ftp://ftp.ossp.org/pkg/lib/res/"
+    scp res-*.tar.gz master.ossp.org:/e/ossp/ftp/pkg/lib/res/
+
Index: ossp-pkg/res/devtool.func
RCS File: /v/ossp/cvs/ossp-pkg/res/devtool.func,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/devtool.func,v' | diff -u /dev/null - -L'ossp-pkg/res/devtool.func' 2>/dev/null
--- ossp-pkg/res/devtool.func
+++ -	2024-05-09 09:56:18.099524937 +0200
@@ -0,0 +1,73 @@
+##
+##  devtool.func -- Development Tool Functions
+##  Copyright (c) 2001-2002 Ralf S. Engelschall <rse@engelschall.com> 
+##
+
+devtool_require () {
+    t="$1"; o="$2"; p="$3"; e="$4"; a="$5"
+    v=`($t $o | head -1 | awk "{ print \\\$$p; }") 2>/dev/null`
+    if [ ".$v" = . ]; then
+        echo "devtool:ERROR: unable to determine version of $t" 1>&2
+        exit 1
+    fi
+    case "$v" in
+        $e )
+            ;;
+        $a )
+            echo "devtool:WARNING: $t version $v still accepted, although expected $e." 1>&2
+            ;;
+        * )
+            echo "devtool:ERROR: $t version $e expected, but found $v." 1>&2
+            exit 1
+            ;;
+    esac
+    echo "$v"
+}
+
+devtool_autogen () {
+    tool=$1
+    shift
+    case $tool in
+        autoconf )
+            autoconf_version=`devtool_require autoconf --version 4 "$1" "$2"`
+            echo "generating (GNU Autoconf $autoconf_version): configure config.h.in"
+            autoconf
+            autoheader 2>&1 | grep -v "is unchanged"
+            rm -rf autom4te.cache >/dev/null 2>&1
+            ;;
+        libtool )
+            libtoolize_version=`devtool_require libtoolize --version 4 "$1" "$2"`
+            echo "generating (GNU Libtool $libtoolize_version): ltmain.sh, libtool.m4, config.guess, config.sub"
+            libtoolize --force --copy >/dev/null 2>&1
+            cp `libtoolize --force --copy --dry-run | grep "add the contents of" |\
+                sed -e 's;^[^\`]*\`;;' -e "s;'.*;;"` libtool.m4
+            ;;
+        shtool )
+            shtoolize_version=`devtool_require shtoolize -v 3 "$1" "$2"`
+            echo "generating (GNU Shtool $shtoolize_version): shtool"
+            shift
+            shift
+            shtoolize -q "$@"
+            ;;
+    esac
+}
+
+devtool_autoclean () {
+    tool=$1
+    shift
+    case $tool in
+        autoconf )
+            echo "removing: configure config.h.in"
+            rm -f configure config.h.in
+            ;;
+        libtool )
+            echo "removing: ltmain.sh libtool.m4 config.guess config.sub"
+            rm -f ltmain.sh libtool.m4 config.guess config.sub
+            ;;
+        shtool )
+            echo "removing: shtool"
+            rm -f shtool
+            ;;
+    esac
+}
+
Index: ossp-pkg/res/res-config.in
RCS File: /v/ossp/cvs/ossp-pkg/res/res-config.in,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/res-config.in,v' | diff -u /dev/null - -L'ossp-pkg/res/res-config.in' 2>/dev/null
--- ossp-pkg/res/res-config.in
+++ -	2024-05-09 09:56:18.102040017 +0200
@@ -0,0 +1,147 @@
+#!/bin/sh
+##
+##  OSSP res - Resource Pools
+##  Copyright (c) 2003 Ralf S. Engelschall <rse@engelschall.com>
+##  Copyright (c) 2003 The OSSP Project <http://www.ossp.org/>
+##
+##  This file is part of OSSP res, a resource pool library
+##  which can be found at http://www.ossp.org/pkg/lib/res/.
+##
+##  Permission to use, copy, modify, and distribute this software for
+##  any purpose with or without fee is hereby granted, provided that
+##  the above copyright notice and this permission notice appear in all
+##  copies.
+##
+##  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED 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 AUTHORS AND COPYRIGHT HOLDERS AND THEIR
+##  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.
+##
+##  res-config.in: library build utility
+##
+
+DIFS=' 
+'
+
+#   tool
+tool_name="res-config"
+
+#   library version
+lib_name="OSSP res"
+lib_version="@RES_VERSION_STR@"
+
+#   build paths
+prefix="@prefix@"
+exec_prefix="@exec_prefix@"
+bindir="@bindir@"
+libdir="@libdir@"
+includedir="@includedir@"
+mandir="@mandir@"
+datadir="@datadir@"
+
+#   build options
+cflags="@CFLAGS@"
+ldflags="@LDFLAGS@"
+libs="@LIBS@"
+
+#   option defaults
+help=no
+version=no
+
+usage="$tool_name"
+usage="$usage [--help] [--version] [--all]"
+usage="$usage [--prefix] [--exec-prefix] [--bindir] [--libdir] [--includedir] [--mandir] [--datadir]"
+usage="$usage [--cflags] [--ldflags] [--libs]"
+if [ $# -eq 0 ]; then
+    echo "$tool_name:Error: Invalid option" 1>&2
+    echo "$tool_name:Usage: $usage" 1>&2
+    exit 1
+fi
+output=''
+output_extra=''
+all=no
+prev=''
+OIFS="$IFS" IFS="$DIFS"
+for option
+do
+    if [ ".$prev" != . ]; then
+        eval "$prev=\$option"
+        prev=''
+        continue
+    fi
+    case "$option" in
+        -*=*) optarg=`echo "$option" | sed 's/[-_a-zA-Z0-9]*=//'` ;;
+           *) optarg='' ;;
+    esac
+    case "$option" in
+        --help|-h)
+            echo "Usage: $usage"
+            exit 0
+            ;;
+        --version|-v)
+            echo "$lib_name $lib_version"
+            exit 0
+            ;;
+        --all)
+            all=yes
+            ;;
+        --prefix)
+            output="$output $prefix"
+            ;;
+        --exec-prefix)
+            output="$output $exec_prefix"
+            ;;
+        --bindir)
+            output="$output $bindir"
+            ;;
+        --libdir)
+            output="$output $libdir"
+            ;;
+        --includedir)
+            output="$output $includedir"
+            ;;
+        --mandir)
+            output="$output $mandir"
+            ;;
+        --datadir)
+            output="$output $datadir"
+            ;;
+        --cflags)
+            output="$output -I$includedir"
+            output_extra="$output_extra $cflags"
+            ;;
+        --ldflags)
+            output="$output -L$libdir"
+            output_extra="$output_extra $ldflags"
+            ;;
+        --libs)
+            output="$output -lres"
+            output_extra="$output_extra $libs"
+            ;;
+        * )
+            echo "$tool_name:Error: Invalid option" 1>&2
+            echo "$tool_name:Usage: $usage" 1>&2
+            exit 1;
+            ;;
+    esac
+done
+IFS="$OIFS"
+if [ ".$prev" != . ]; then
+    echo "$tool_name:Error: missing argument to --`echo $prev | sed 's/_/-/g'`" 1>&2
+    exit 1
+fi
+if [ ".$output" != . ]; then
+    if [ ".$all" = .yes ]; then
+        output="$output $output_extra"
+    fi
+    echo $output
+fi
+
Index: ossp-pkg/res/res.c
RCS File: /v/ossp/cvs/ossp-pkg/res/res.c,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/res.c,v' | diff -u /dev/null - -L'ossp-pkg/res/res.c' 2>/dev/null
--- ossp-pkg/res/res.c
+++ -	2024-05-09 09:56:18.104625436 +0200
@@ -0,0 +1,34 @@
+/*
+**  OSSP res - Resource Pools
+**  Copyright (c) 2003 Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2003 The OSSP Project <http://www.ossp.org/>
+**
+**  This file is part of OSSP res, a resource pool library
+**  which can be found at http://www.ossp.org/pkg/lib/res/.
+**
+**  Permission to use, copy, modify, and distribute this software for
+**  any purpose with or without fee is hereby granted, provided that
+**  the above copyright notice and this permission notice appear in all
+**  copies.
+**
+**  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED 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 AUTHORS AND COPYRIGHT HOLDERS AND THEIR
+**  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.
+**
+**  res.c: resource pools
+*/
+
+#include <stdio.h>
+#include <stdlib.h>
+
+#include "res.h"
+
Index: ossp-pkg/res/res.h
RCS File: /v/ossp/cvs/ossp-pkg/res/res.h,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/res.h,v' | diff -u /dev/null - -L'ossp-pkg/res/res.h' 2>/dev/null
--- ossp-pkg/res/res.h
+++ -	2024-05-09 09:56:18.107166855 +0200
@@ -0,0 +1,43 @@
+/*
+**  OSSP res - Resource Pools
+**  Copyright (c) 2003 Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2003 The OSSP Project <http://www.ossp.org/>
+**
+**  This file is part of OSSP res, a resource pool library
+**  which can be found at http://www.ossp.org/pkg/lib/res/.
+**
+**  Permission to use, copy, modify, and distribute this software for
+**  any purpose with or without fee is hereby granted, provided that
+**  the above copyright notice and this permission notice appear in all
+**  copies.
+**
+**  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED 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 AUTHORS AND COPYRIGHT HOLDERS AND THEIR
+**  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.
+**
+**  res.h: resource pools
+*/
+
+#ifndef __RES_H__
+#define __RES_H__
+
+struct res_st;
+typedef struct res_st res_t;
+
+res_rc_t res_create   (res_t **res, res_t *parent);
+res_rc_t res_register (res_t  *res, res_item_t item, ...);
+res_rc_t res_insert   (res_t  *res, res_item_t item, ...);
+res_rc_t res_remove   (res_t  *res, res_item_t item, ...);
+res_rc_t res_destroy  (res_t  *res);
+
+#endif /* __RES_H__ */
+
Index: ossp-pkg/res/res.pod
RCS File: /v/ossp/cvs/ossp-pkg/res/res.pod,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/res.pod,v' | diff -u /dev/null - -L'ossp-pkg/res/res.pod' 2>/dev/null
--- ossp-pkg/res/res.pod
+++ -	2024-05-09 09:56:18.109723985 +0200
@@ -0,0 +1,70 @@
+##
+##  OSSP res - Resource Pools
+##  Copyright (c) 2003 Ralf S. Engelschall <rse@engelschall.com>
+##  Copyright (c) 2003 The OSSP Project <http://www.ossp.org/>
+##
+##  This file is part of OSSP res, a resource pool library
+##  which can be found at http://www.ossp.org/pkg/lib/res/.
+##
+##  Permission to use, copy, modify, and distribute this software for
+##  any purpose with or without fee is hereby granted, provided that
+##  the above copyright notice and this permission notice appear in all
+##  copies.
+##
+##  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED 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 AUTHORS AND COPYRIGHT HOLDERS AND THEIR
+##  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.
+##
+##  res.pod: resource pool library manual page
+##
+
+=pod
+
+=head1 NAME
+
+B<OSSP res> - Resource Pools
+
+=head1 VERSION
+
+B<OSSP res RES_VERSION_STR>
+
+=head1 SYNOPSIS
+
+B<res_t> I<variable>;
+...
+
+=head1 DESCRIPTION
+
+B<OSSP res> is ...
+
+=head2 APPLICATION PROGRAMMER INTERFACE (API)
+
+The B<OSSP res> API consists of the following elements:
+
+=head1 SEE ALSO
+
+malloc(3), open(2).
+
+=head1 HISTORY
+
+B<OSSP res> was invented in February 2003 by Ralf S. Engelschall
+E<lt>rse@engelschall.comE<gt> for use inside the B<OSSP> project. It was
+partly inspired by the memory pools in the Apache webserver.
+
+=head1 AUTHORS
+
+ Ralf S. Engelschall
+ rse@engelschall.com
+ www.engelschall.com
+
+=cut
+
Index: ossp-pkg/res/res_test.c
RCS File: /v/ossp/cvs/ossp-pkg/res/res_test.c,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/res_test.c,v' | diff -u /dev/null - -L'ossp-pkg/res/res_test.c' 2>/dev/null
--- ossp-pkg/res/res_test.c
+++ -	2024-05-09 09:56:18.112251188 +0200
@@ -0,0 +1,57 @@
+/*
+**  OSSP res - Resource Pools
+**  Copyright (c) 2003 Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2003 The OSSP Project <http://www.ossp.org/>
+**
+**  This file is part of OSSP res, a resource pool library
+**  which can be found at http://www.ossp.org/pkg/lib/res/.
+**
+**  Permission to use, copy, modify, and distribute this software for
+**  any purpose with or without fee is hereby granted, provided that
+**  the above copyright notice and this permission notice appear in all
+**  copies.
+**
+**  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED 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 AUTHORS AND COPYRIGHT HOLDERS AND THEIR
+**  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.
+**
+**  res_test.c: resource pools test suite
+*/
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <time.h>
+
+#include "ts.h"
+#include "res.h"
+
+TS_TEST(test_foo)
+{
+    ts_test_check(TS_CTX, "foo");
+
+#if 0
+    ts_test_fail(TS_CTX, "v1 = %d (!= 5678)", 1);
+#endif
+}
+
+int main(int argc, char *argv[])
+{
+    ts_suite_t *ts;
+    int n;
+
+    ts = ts_suite_new("OSSP ex (Exception Handling)");
+    ts_suite_test(ts, test_foo, "foo");
+    n = ts_suite_run(ts);
+    ts_suite_free(ts);
+    return n;
+}
+
Index: ossp-pkg/res/ts.c
RCS File: /v/ossp/cvs/ossp-pkg/res/ts.c,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/ts.c,v' | diff -u /dev/null - -L'ossp-pkg/res/ts.c' 2>/dev/null
--- ossp-pkg/res/ts.c
+++ -	2024-05-09 09:56:18.114820215 +0200
@@ -0,0 +1,468 @@
+/*
+**  TS - OSSP Test Suite Library
+**  Copyright (c) 2001-2002 Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2001-2002 The OSSP Project <http://www.ossp.org/>
+**  Copyright (c) 2001-2002 Cable & Wireless Germany <http://www.cw.com/de/>
+**
+**  This file is part of OSSP TS, a small test suite library which
+**  can be found at http://www.ossp.org/pkg/ts/.
+**
+**  Permission to use, copy, modify, and distribute this software for
+**  any purpose with or without fee is hereby granted, provided that
+**  the above copyright notice and this permission notice appear in all
+**  copies.
+**
+**  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED 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 AUTHORS AND COPYRIGHT HOLDERS AND THEIR
+**  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.
+**
+**  ts.c: test suite library
+*/
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <stdarg.h>
+
+#include "config.h"
+#if defined(HAVE_DMALLOC_H) && defined(WITH_DMALLOC)
+#include "dmalloc.h"
+#endif
+
+#include "ts.h"
+
+/* embedded ring data structure library */
+#define RING_ENTRY(elem) \
+    struct { elem *next; elem *prev; }
+#define RING_HEAD(elem) \
+    struct { elem *next; elem *prev; }
+#define RING_SENTINEL(hp, elem, link) \
+    (elem *)((char *)(hp) - ((size_t)(&((elem *)0)->link)))
+#define RING_FIRST(hp) \
+    (hp)->next
+#define RING_LAST(hp) \
+    (hp)->prev
+#define RING_NEXT(ep, link) \
+    (ep)->link.next
+#define RING_PREV(ep, link) \
+    (ep)->link.prev
+#define RING_INIT(hp, elem, link) \
+    do { RING_FIRST((hp)) = RING_SENTINEL((hp), elem, link); \
+         RING_LAST((hp))  = RING_SENTINEL((hp), elem, link); } while (0)
+#define RING_EMPTY(hp, elem, link) \
+    (RING_FIRST((hp)) == RING_SENTINEL((hp), elem, link))
+#define RING_ELEM_INIT(ep, link) \
+    do { RING_NEXT((ep), link) = (ep); \
+         RING_PREV((ep), link) = (ep); } while (0)
+#define RING_SPLICE_BEFORE(lep, ep1, epN, link) \
+    do { RING_NEXT((epN), link) = (lep); \
+         RING_PREV((ep1), link) = RING_PREV((lep), link); \
+         RING_NEXT(RING_PREV((lep), link), link) = (ep1); \
+         RING_PREV((lep), link) = (epN); } while (0)
+#define RING_SPLICE_TAIL(hp, ep1, epN, elem, link) \
+    RING_SPLICE_BEFORE(RING_SENTINEL((hp), elem, link), (ep1), (epN), link)
+#define RING_INSERT_TAIL(hp, nep, elem, link) \
+    RING_SPLICE_TAIL((hp), (nep), (nep), elem, link)
+#define RING_FOREACH(ep, hp, elem, link) \
+    for ((ep)  = RING_FIRST((hp)); \
+         (ep) != RING_SENTINEL((hp), elem, link); \
+         (ep)  = RING_NEXT((ep), link))
+
+/* test suite test log */
+struct tstl_st;
+typedef struct tstl_st tstl_t;
+struct tstl_st {
+    RING_ENTRY(tstl_t) next;
+    char              *text;
+    const char        *file;
+    int                line;
+};
+
+/* test suite test check */
+struct tstc_st;
+typedef struct tstc_st tstc_t;
+struct tstc_st {
+    RING_ENTRY(tstc_t) next;
+    char              *title;
+    int                failed;
+    const char        *file;
+    int                line;
+    RING_HEAD(tstl_t)  logs;
+};
+
+/* test suite test */
+struct ts_test_st {
+    RING_ENTRY(ts_test_t)  next;
+    char              *title;
+    ts_test_cb_t         func;
+    const char        *file;
+    int                line;
+    RING_HEAD(tstc_t)  checks;
+};
+
+/* test suite */
+struct ts_suite_st {
+    char              *title;
+    RING_HEAD(ts_test_t)   tests;
+};
+
+/* minimal output-independent vprintf(3) variant which supports %{c,s,d,%} only */
+static int ts_suite_mvxprintf(char *buffer, size_t bufsize, const char *format, va_list ap)
+{
+    /* sufficient integer buffer: <available-bits> x log_10(2) + safety */
+    char ibuf[((sizeof(int)*8)/3)+10]; 
+    char *cp;
+    char c;
+    int d;
+    int n;
+    int bytes;
+
+    if (format == NULL || ap == NULL)
+        return -1;
+    bytes = 0;
+    while (*format != '\0') {
+        if (*format == '%') {
+            c = *(format+1);
+            if (c == '%') {
+                /* expand "%%" */
+                cp = &c;
+                n = sizeof(char);
+            }
+            else if (c == 'c') {
+                /* expand "%c" */
+                c = (char)va_arg(ap, int);
+                cp = &c;
+                n = sizeof(char);
+            }
+            else if (c == 's') {
+                /* expand "%s" */
+                if ((cp = (char *)va_arg(ap, char *)) == NULL)
+                    cp = "(null)";
+                n = strlen(cp);
+            }
+            else if (c == 'd') {
+                /* expand "%d" */
+                d = (int)va_arg(ap, int);
+#ifdef HAVE_SNPRINTF
+                snprintf(ibuf, sizeof(ibuf), "%d", d); /* explicitly secure */
+#else
+                sprintf(ibuf, "%d", d);                /* implicitly secure */
+#endif
+                cp = ibuf;
+                n = strlen(cp);
+            }
+            else {
+                /* any other "%X" */
+                cp = (char *)format;
+                n  = 2;
+            }
+            format += 2;
+        }
+        else {
+            /* plain text */
+            cp = (char *)format;
+            if ((format = strchr(cp, '%')) == NULL)
+                format = strchr(cp, '\0');
+            n = format - cp;
+        }
+        /* perform output operation */
+        if (buffer != NULL) {
+            if (n > bufsize)
+                return -1;
+            memcpy(buffer, cp, n);
+            buffer  += n;
+            bufsize -= n;
+        }
+        bytes += n;
+    }
+    /* nul-terminate output */
+    if (buffer != NULL) {
+        if (bufsize == 0)
+            return -1;
+        *buffer = '\0';
+    }
+    return bytes;
+}
+
+/* minimal vasprintf(3) variant which supports %{c,s,d} only */
+static char *ts_suite_mvasprintf(const char *format, va_list ap)
+{
+    char *buffer;
+    int n;
+    va_list ap2;
+
+    if (format == NULL || ap == NULL)
+        return NULL;
+    ap2 = ap;
+    if ((n = ts_suite_mvxprintf(NULL, 0, format, ap)) == -1)
+        return NULL;
+    if ((buffer = (char *)malloc(n+1)) == NULL)
+        return NULL;
+    ts_suite_mvxprintf(buffer, n+1, format, ap2);
+    return buffer;
+}
+
+/* minimal asprintf(3) variant which supports %{c,s,d} only */
+static char *ts_suite_masprintf(const char *format, ...)
+{
+    va_list ap;
+    char *cp;
+
+    va_start(ap, format);
+    cp = ts_suite_mvasprintf(format, ap);
+    va_end(ap);
+    return cp;
+}
+
+/* create test suite */
+ts_suite_t *ts_suite_new(const char *fmt, ...)
+{
+    ts_suite_t *ts;
+    va_list ap;
+
+    if ((ts = (ts_suite_t *)malloc(sizeof(ts_suite_t))) == NULL)
+        return NULL;
+    va_start(ap, fmt);
+    ts->title = ts_suite_mvasprintf(fmt, ap);
+    RING_INIT(&ts->tests, ts_test_t, next);
+    va_end(ap);
+    return ts;
+}
+
+/* add test case to test suite */
+void ts_suite_test(ts_suite_t *ts, ts_test_cb_t func, const char *fmt, ...)
+{
+    ts_test_t *tst;
+    va_list ap;
+
+    if (ts == NULL || func == NULL || fmt == NULL)
+        return;
+    if ((tst = (ts_test_t *)malloc(sizeof(ts_test_t))) == NULL)
+        return;
+    RING_ELEM_INIT(tst, next);
+    va_start(ap, fmt);
+    tst->title = ts_suite_mvasprintf(fmt, ap);
+    va_end(ap);
+    tst->func = func;
+    tst->file = NULL;
+    tst->line = 0;
+    RING_INIT(&tst->checks, tstc_t, next);
+    RING_INSERT_TAIL(&ts->tests, tst, ts_test_t, next);
+    return;
+}
+
+/* run test suite */
+int ts_suite_run(ts_suite_t *ts)
+{
+    ts_test_t *tst;
+    tstc_t *tstc;
+    tstl_t *tstl;
+    int total_tests, total_tests_suite_failed;
+    int total_checks, total_checks_failed;
+    int test_checks, test_checks_failed;
+    const char *file;
+    int line;
+    char *cp;
+
+    if (ts == NULL)
+        return 0;
+
+    /* init total counters */
+    total_tests         = 0;
+    total_tests_suite_failed  = 0;
+    total_checks        = 0;
+    total_checks_failed = 0;
+
+    fprintf(stdout, "\n");
+    fprintf(stdout, " Test Suite: %s\n", ts->title);
+    fprintf(stdout, " __________________________________________________________________\n");
+    fprintf(stdout, "\n");
+    fflush(stdout);
+
+    /* iterate through all test cases */
+    RING_FOREACH(tst, &ts->tests, ts_test_t, next) {
+        cp = ts_suite_masprintf(" Test: %s ........................................"
+                                "........................................", tst->title);
+        cp[60] = '\0';
+        fprintf(stdout, "%s", cp);
+        free(cp);
+        fflush(stdout);
+
+        /* init test case counters */
+        test_checks        = 0;
+        test_checks_failed = 0;
+
+        /* run the test case function */
+        tst->func(tst);
+
+        /* iterate through all performed checks to determine status */
+        RING_FOREACH(tstc, &tst->checks, tstc_t, next) {
+            test_checks++;
+            if (tstc->failed)
+                test_checks_failed++;
+        }
+
+        if (test_checks_failed > 0) {
+            /* some checks failed, so do detailed reporting of test case */
+            fprintf(stdout, " FAILED\n");
+            fprintf(stdout, "       Ops, %d/%d checks failed! Detailed report follows:\n",
+                    test_checks_failed, test_checks);
+            RING_FOREACH(tstc, &tst->checks, tstc_t, next) {
+                file = (tstc->file != NULL ? tstc->file : tst->file);
+                line = (tstc->line != 0    ? tstc->line : tst->line);
+                if (file != NULL)
+                    fprintf(stdout, "       Check: %s [%s:%d]\n", tstc->title, file, line);
+                else
+                    fprintf(stdout, "       Check: %s\n", tstc->title);
+                RING_FOREACH(tstl, &tstc->logs, tstl_t, next) {
+                    file = (tstl->file != NULL ? tstl->file : file);
+                    line = (tstl->line != 0    ? tstl->line : line);
+                    if (file != NULL)
+                        fprintf(stdout, "              Log: %s [%s:%d]\n", tstl->text, file, line);
+                    else
+                        fprintf(stdout, "              Log: %s\n", tstl->text);
+                }
+            }
+        }
+        else {
+            /* test case ran successfully */
+            fprintf(stdout, ".... OK\n");
+        }
+        fflush(stdout);
+
+        /* accumulate counters */
+        total_checks += test_checks;
+        total_tests++;
+        if (test_checks_failed > 0) {
+            total_checks_failed += test_checks_failed;
+            total_tests_suite_failed++;
+        }
+    }
+
+    /* print test suite summary */
+    fprintf(stdout, " __________________________________________________________________\n");
+    fprintf(stdout, "\n");
+    fprintf(stdout, " Test Summary: %d tests (%d ok, %d failed), %d checks (%d ok, %d failed)\n", 
+            total_tests, (total_tests - total_tests_suite_failed), total_tests_suite_failed, 
+            total_checks, (total_checks - total_checks_failed), total_checks_failed); 
+    if (total_tests_suite_failed > 0)
+        fprintf(stdout, " Test Suite: FAILED\n");
+    else
+        fprintf(stdout, " Test Suite: OK\n");
+    fprintf(stdout, "\n");
+    fflush(stdout);
+
+    return total_checks_failed;
+}
+
+/* destroy test suite */
+void ts_suite_free(ts_suite_t *ts)
+{
+    ts_test_t *tst;
+    tstc_t *tstc;
+    tstl_t *tstl;
+
+    if (ts == NULL)
+        return;
+    RING_FOREACH(tst, &ts->tests, ts_test_t, next) {
+        RING_FOREACH(tstc, &tst->checks, tstc_t, next) {
+            RING_FOREACH(tstl, &tstc->logs, tstl_t, next) {
+                free(tstl->text);
+            }
+            free(tstc->title);
+            free(tstc);
+        }
+        free(tst->title);
+        free(tst);
+    }
+    free(ts->title);
+    free(ts);
+    return;
+}
+
+/* annotate test case with file name and line number */
+ts_test_t *ts_test_ctx(ts_test_t *tst, const char *file, int line)
+{
+    if (tst != NULL && file != NULL) {
+        tst->file = file;
+        tst->line = line;
+    }
+    return tst;
+}
+
+/* annotate test case with check */
+void ts_test_check(ts_test_t *tst, const char *fmt, ...)
+{
+    tstc_t *tstc;
+    va_list ap;
+
+    if (tst == NULL || fmt == NULL)
+        return;
+    if ((tstc = (tstc_t *)malloc(sizeof(tstc_t))) == NULL)
+        return;
+    va_start(ap, fmt);
+    RING_ELEM_INIT(tstc, next);
+    tstc->title = ts_suite_mvasprintf(fmt, ap);
+    tstc->failed = 0;
+    tstc->file = tst->file;
+    tstc->line = tst->line;
+    RING_INIT(&tstc->logs, tstl_t, next);
+    RING_INSERT_TAIL(&tst->checks, tstc, tstc_t, next);
+    va_end(ap);
+    return;
+}
+
+/* annotate test case with log message and failure */
+void ts_test_fail(ts_test_t *tst, const char *fmt, ...)
+{
+    tstc_t *tstc;
+    tstl_t *tstl;
+    va_list ap;
+
+    if (tst == NULL || fmt == NULL)
+        return;
+    if ((tstl = (tstl_t *)malloc(sizeof(tstl_t))) == NULL)
+        return;
+    va_start(ap, fmt);
+    tstl->text = ts_suite_mvasprintf(fmt, ap);
+    tstl->file = tst->file;
+    tstl->line = tst->line;
+    RING_ELEM_INIT(tstl, next);
+    tstc = RING_LAST(&tst->checks);
+    RING_INSERT_TAIL(&tstc->logs, tstl, tstl_t, next);
+    tstc->failed = 1;
+    va_end(ap);
+    return;
+}
+
+/* annotate test case with log message only */
+void ts_test_log(ts_test_t *tst, const char *fmt, ...)
+{
+    tstc_t *tstc;
+    tstl_t *tstl;
+    va_list ap;
+
+    if (tst == NULL || fmt == NULL)
+        return;
+    if ((tstl = (tstl_t *)malloc(sizeof(tstl_t))) == NULL)
+        return;
+    va_start(ap, fmt);
+    tstl->text = ts_suite_mvasprintf(fmt, ap);
+    tstl->file = tst->file;
+    tstl->line = tst->line;
+    RING_ELEM_INIT(tstl, next);
+    tstc = RING_LAST(&tst->checks);
+    RING_INSERT_TAIL(&tstc->logs, tstl, tstl_t, next);
+    va_end(ap);
+    return;
+}
+
Index: ossp-pkg/res/ts.h
RCS File: /v/ossp/cvs/ossp-pkg/res/ts.h,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/res/ts.h,v' | diff -u /dev/null - -L'ossp-pkg/res/ts.h' 2>/dev/null
--- ossp-pkg/res/ts.h
+++ -	2024-05-09 09:56:18.117542236 +0200
@@ -0,0 +1,64 @@
+/*
+**  TS - OSSP Test Suite Library
+**  Copyright (c) 2001-2002 Ralf S. Engelschall <rse@engelschall.com>
+**  Copyright (c) 2001-2002 The OSSP Project <http://www.ossp.org/>
+**  Copyright (c) 2001-2002 Cable & Wireless Germany <http://www.cw.com/de/>
+**
+**  This file is part of OSSP TS, a small test suite library which
+**  can be found at http://www.ossp.org/pkg/ts/.
+**
+**  Permission to use, copy, modify, and distribute this software for
+**  any purpose with or without fee is hereby granted, provided that
+**  the above copyright notice and this permission notice appear in all
+**  copies.
+**
+**  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED 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 AUTHORS AND COPYRIGHT HOLDERS AND THEIR
+**  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.
+**
+**  ts.h: test suite library API
+*/
+
+#ifndef _TS_H_
+#define _TS_H_
+
+/* test suite object type */
+struct ts_suite_st;
+typedef struct ts_suite_st ts_suite_t;
+
+/* test object type */
+struct ts_test_st;
+typedef struct ts_test_st ts_test_t;
+
+/* test callback function type */
+typedef void (*ts_test_cb_t)(ts_test_t *);
+
+/* test suite operations */
+ts_suite_t *ts_suite_new  (const char *fmt, ...);
+void        ts_suite_test (ts_suite_t *s, ts_test_cb_t func, const char *fmt, ...);
+int         ts_suite_run  (ts_suite_t *s);
+void        ts_suite_free (ts_suite_t *s);
+
+/* test operations */
+ts_test_t  *ts_test_ctx   (ts_test_t *t, const char *file, int line);
+void        ts_test_check (ts_test_t *t, const char *fmt, ...);
+void        ts_test_fail  (ts_test_t *t, const char *fmt, ...);
+void        ts_test_log   (ts_test_t *t, const char *fmt, ...);
+
+/* test suite short-cut macros */
+#define TS_TEST(name) \
+    static void name(ts_test_t *_t)
+#define TS_CTX \
+    ts_test_ctx(_t, __FILE__, __LINE__)
+
+#endif /* _TS_H_ */
+