Index: ossp-pkg/pth/.cvsignore
RCS File: /v/ossp/cvs/ossp-pkg/pth/.cvsignore,v
co -q -kk -p'1.19' '/v/ossp/cvs/ossp-pkg/pth/.cvsignore,v' | diff -u /dev/null - -L'ossp-pkg/pth/.cvsignore' 2>/dev/null
--- ossp-pkg/pth/.cvsignore
+++ -	2024-05-14 08:38:00.809549637 +0200
@@ -0,0 +1,30 @@
+Makefile
+config.log
+config.cache
+config.status
+libtool
+.libs
+.done-*
+pth-config
+pth_acdef.h
+pth_acmac.h
+pth.h
+pth_p.h
+pthread-config
+pthread.h
+test_std
+test_httpd
+test_misc
+test_mp
+test_philo
+test_sig
+test_select
+test_sfio
+test_pthread
+*.o
+*.lo
+*.a
+*.la
+core
+*.core
+libtool.m4
Index: ossp-pkg/pth/ChangeLog
RCS File: /v/ossp/cvs/ossp-pkg/pth/ChangeLog,v
rcsdiff -q -kk '-r1.558' '-r1.559' -u '/v/ossp/cvs/ossp-pkg/pth/ChangeLog,v' 2>/dev/null
--- ChangeLog	2002/01/27 16:11:42	1.558
+++ ChangeLog	2002/01/30 12:54:21	1.559
@@ -19,6 +19,10 @@
     | |_ ___) |
   __|_(_)____/____________________________________________________________
 
+   *) Removed all generated files from CVS.
+      Use OSSP devtool stuff to re-generate files on demand.
+      Switched to Autoconf 2.52 and Libtool 1.4.2 environment.
+      [Ralf S. Engelschall]
 
      _  _  _   
     / || || |  
Index: ossp-pkg/pth/HACKING
RCS File: /v/ossp/cvs/ossp-pkg/pth/HACKING,v
rcsdiff -q -kk '-r1.12' '-r1.13' -u '/v/ossp/cvs/ossp-pkg/pth/HACKING,v' 2>/dev/null
--- HACKING	2001/03/24 14:56:46	1.12
+++ HACKING	2002/01/30 12:54:21	1.13
@@ -94,8 +94,8 @@
   config.guess .......... Autoconf platform guessing tool (part I)
   config.param .......... Autoconf command line parameter collections
   config.sub ............ Autoconf platform guessing tool (part II)
-  configure ............. Autoconf script (pre-generated from configure.in)
-  configure.in .......... Autoconf script source
+  configure ............. Autoconf script (pre-generated from configure.ac)
+  configure.ac .......... Autoconf script source
 
   ltconfig .............. Libtool configuration script
   ltmain.sh ............. Libtool main template
Index: ossp-pkg/pth/Makefile.in
RCS File: /v/ossp/cvs/ossp-pkg/pth/Makefile.in,v
rcsdiff -q -kk '-r1.144' '-r1.145' -u '/v/ossp/cvs/ossp-pkg/pth/Makefile.in,v' 2>/dev/null
--- Makefile.in	2002/01/27 11:03:39	1.144
+++ Makefile.in	2002/01/30 12:54:21	1.145
@@ -293,6 +293,7 @@
 #   clean the source tree by removing really all generate stuff
 realclean: distclean
 	$(RM) $(TARGET_MANS)
+	./devtool autoclean
 
 #   give hints what to do as the next step
 what-next:
@@ -372,54 +373,6 @@
 	./test_sfio
 test-pthread: test_pthread
 	./test_pthread
-
-#   GNU compat targets
-check: test
-installcheck:
-installdirs: install-dirs
-install-strip: install
-mostlyclean: clean
-maintainer-clean: realclean
-info:
-dvi:
-TAGS:
-
-##
-##  ____ DEVELOPER TARGETS ___________________________________________
-##  (THIS IS NOT INTENDED TO BE RUN BY END USERS)
-##
-
-#   fixup the permissions in the source tree
-fixperm:
-	@echo "Fixing permissions in source tree"
-	@$(SHTOOL) fixperm *
-
-#   update Autoconf files
-update-autoconf: configure pth_acdef.h.in
-configure: configure.in
-	$(RM) configure
-	autoconf
-pth_acdef.h.in: configure.in acconfig.h acheader.m4
-	$(RM) pth_acdef.h.in
-	cat acheader.m4 configure.in | autoheader - >pth_acdef.h.in
-
-#   update build tools
-update-tools:
-	@$(RM) shtool ltmain.sh ltconfig
-	@$(MAKE) $(MKFLAGS) shtool ltmain.sh ltconfig
-shtool:
-	shtoolize -o shtool echo version scpp mkdir install fixperm tarball
-ltmain.sh:
-	@F=`libtoolize -n -c -f | grep 'cp.*ltmain.sh' |\
-	    $(SED) -e 's;[^/]*;;' -e 's; .*;;'`; \
-	$(ECHO) "ltmain.sh <-- $$F"; cat $$F |\
-	$(SED) -e 's:/bin/sh; then:/bin/sh || test ".`$(ECHO) $$nonopt | grep shtool`" != .;then:' \
-	    -e 's:exec \$$SHELL \$$0 --finish:exit 0 #:' >ltmain.sh
-ltconfig:
-	@F=`libtoolize -n -c -f | grep 'cp.*ltconfig' | $(SED) -e 's;[^/]*;;' -e 's; .*;;'`; \
-	$(ECHO) "ltconfig <-- $$F"; $(CAT) $$F >ltconfig
-
-#   debug the test programs
 debug: debug-std
 debug-std: test_std
 	TEST=test_std && $(_DEBUG)
@@ -440,38 +393,16 @@
 debug-pthread: test_pthread
 	TEST=test_pthread && $(_DEBUG)
 
-#   roll the release or snapshot tarball
-dist: distclean fixperm
-	@V=`$(SHTOOL) version -l c -d short $(_VERSION_FILE)`; NAME="pth-$$V"; \
-	$(ECHO) "Rolling RELEASE tarball $$NAME.tar.gz"; $(_TARBALL)
-snap: distclean fixperm
-	@V=`$(SHTOOL) version -l c -d short $(_VERSION_FILE)`; NAME="pth-$$V-SNAP"; \
-	$(ECHO) "Rolling SNAPSHOT tarball $$NAME.tar.gz"; $(_TARBALL)
-
-#   increase or update version information
-new-version:
-	@V="$(VERSION)"; \
-	if [ ".$$V" != . ]; then \
-		OPT="-s$$V"; \
-	else \
-		OPT="-e"; \
-	fi; \
-	$(_VERSION)
-update-version:
-	@OPT="-s`$(SHTOOL) version -lc -dshort $(_VERSION_FILE)`" && $(_VERSION)
-
-#   make a striptease
-striptease:
-	@$(PERL) striptease.pl
-
-#   create dependencies
-depend:
-	$(CP) Makefile.in Makefile.in.bak \
-	&& $(SED) -ne '1,/^# DO NOT REMOVE/p' Makefile.in > Makefile.new \
-	&& $(CC) -MM $(CPPFLAGS) $(CFLAGS) *.c |\
-	   $(SED) -e 's/^\(pth_.*\)\.o:/\1.lo:/' >> Makefile.new \
-	&& $(CP) Makefile.new Makefile.in \
-	&& $(RM) Makefile.new
+#   GNU compat targets
+check: test
+installcheck:
+installdirs: install-dirs
+install-strip: install
+mostlyclean: clean
+maintainer-clean: realclean
+info:
+dvi:
+TAGS:
 
 ##
 ##  ____ DEPENDENCY AREA ____________________________________________
@@ -481,58 +412,37 @@
 $(LOBJS): Makefile
 
 # DO NOT REMOVE
-pth_attr.lo: pth_attr.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_cancel.lo: pth_cancel.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_clean.lo: pth_clean.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_compat.lo: pth_compat.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_data.lo: pth_data.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_debug.lo: pth_debug.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_errno.lo: pth_errno.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_event.lo: pth_event.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_ext.lo: pth_ext.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
-pth_fork.lo: pth_fork.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_high.lo: pth_high.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_lib.lo: pth_lib.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
-pth_mctx.lo: pth_mctx.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_msg.lo: pth_msg.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
-pth_pqueue.lo: pth_pqueue.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_ring.lo: pth_ring.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_sched.lo: pth_sched.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_string.lo: pth_string.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_sync.lo: pth_sync.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_syscall.lo: pth_syscall.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_tcb.lo: pth_tcb.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
-pth_time.lo: pth_time.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_util.lo: pth_util.c pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
-pth_vers.lo: pth_vers.c
-pthread.o: pthread.c pthread.h pth_p.h pth_vers.c pth.h pth_acdef.h \
- pth_acmac.h
+pth_attr.lo: pth_attr.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_cancel.o: pth_cancel.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_clean.o: pth_clean.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_compat.o: pth_compat.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_data.o: pth_data.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_debug.o: pth_debug.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_errno.o: pth_errno.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_event.o: pth_event.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_ext.o: pth_ext.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_fork.o: pth_fork.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_high.o: pth_high.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_lib.o: pth_lib.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_mctx.o: pth_mctx.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_msg.o: pth_msg.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_pqueue.o: pth_pqueue.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_ring.o: pth_ring.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_sched.o: pth_sched.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_string.o: pth_string.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_sync.o: pth_sync.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_syscall.o: pth_syscall.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_tcb.o: pth_tcb.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_time.o: pth_time.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_util.o: pth_util.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
+pth_vers.o: pth_vers.c pth_vers.c
+pthread.o: pthread.c pth_p.h pth_vers.c pth.h pth_acdef.h pth_acmac.h
 test_common.o: test_common.c pth.h test_common.h
 test_httpd.o: test_httpd.c pth.h test_common.h
 test_misc.o: test_misc.c pth.h
 test_mp.o: test_mp.c pth.h test_common.h
 test_philo.o: test_philo.c pth.h test_common.h
-test_pthread.o: test_pthread.c pthread.h
-test_select.o: test_select.c pth.h
+test_pthread.o: test_pthread.c test_select.o: test_select.c pth.h
 test_sfio.o: test_sfio.c pth.h
 test_sig.o: test_sig.c pth.h
 test_std.o: test_std.c pth.h
Index: ossp-pkg/pth/aclocal.m4
RCS File: /v/ossp/cvs/ossp-pkg/pth/aclocal.m4,v
rcsdiff -q -kk '-r1.92' '-r1.93' -u '/v/ossp/cvs/ossp-pkg/pth/aclocal.m4,v' 2>/dev/null
--- aclocal.m4	2002/01/27 11:03:40	1.92
+++ aclocal.m4	2002/01/30 12:54:21	1.93
@@ -22,7 +22,6 @@
 dnl ##
 dnl ##  aclocal.m4: Pth Autoconf macros
 dnl ##
-divert(-1)
                         dnl # ``"Reuse an expert's code" is the right
                         dnl #   advice for most people. But it's a useless 
                         dnl #   advice for the experts writing the code 
@@ -32,11 +31,11 @@
 dnl ##
 dnl ##  Display Configuration Headers
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_MSG_PART(<text>)
 dnl ##
 
-define(AC_MSG_PART,[dnl
+m4_define(AC_MSG_PART,[dnl
 if test ".$enable_subdir" != .yes; then
     AC_MSG_RESULT()
     AC_MSG_RESULT(${TB}$1:${TN})
@@ -46,11 +45,11 @@
 dnl ##
 dnl ##  Display a message under --verbose
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_MSG_VERBOSE(<text>)
 dnl ##
 
-define(AC_MSG_VERBOSE,[dnl
+m4_define(AC_MSG_VERBOSE,[dnl
 if test ".$verbose" = .yes; then
     AC_MSG_RESULT([  $1])
 fi
@@ -59,12 +58,12 @@
 dnl ##
 dnl ##  Do not display message for a command
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_MSG_SILENT(...)
 dnl ##
 
-define(AC_FD_TMP, 9)
-define(AC_MSG_SILENT,[dnl
+m4_define(AC_FD_TMP, 9)
+m4_define(AC_MSG_SILENT,[dnl
 exec AC_FD_TMP>&AC_FD_MSG AC_FD_MSG>/dev/null
 $1
 exec AC_FD_MSG>&AC_FD_TMP AC_FD_TMP>&-
@@ -73,13 +72,13 @@
 dnl ##
 dnl ##  Perform something only once
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_ONCE(<action>)
 dnl ##
 
-define(AC_ONCE,[
+m4_define(AC_ONCE,[
 ifelse(ac_once_$1, already_done, ,[
-    define(ac_once_$1, already_done)
+    m4_define(ac_once_$1, already_done)
     $2
 ])dnl
 ])
@@ -87,7 +86,7 @@
 dnl ##
 dnl ##  Support for $(S)
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_SRCDIR_PREFIX(<varname>)
 dnl ##
 
@@ -115,7 +114,7 @@
 dnl ##
 dnl ##  Support for --enable-subdir (for use with pth.m4)
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_ENABLESUBDIR
 dnl ##
 
@@ -134,14 +133,14 @@
 dnl ##
 dnl ##  Support for Configuration Headers
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_HEADLINE(<short-name>, <long-name>,
 dnl ##                <vers-var>, <vers-file>,
 dnl ##                <copyright>)
 dnl ##
 
 AC_DEFUN(AC_HEADLINE,[dnl
-AC_DIVERT_PUSH(AC_DIVERSION_NOTICE)dnl
+AC_DIVERT_PUSH(NOTICE)dnl
 #   configuration header
 if test ".`echo dummy [$]@ | grep enable-subdir`" != .; then
     enable_subdir=yes
@@ -184,15 +183,13 @@
 dnl ##
 dnl ##  Support for Platform IDs
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_PLATFORM(<variable>)
 dnl ##
 
 AC_DEFUN(AC_PLATFORM,[
-if test ".$host" != .NONE; then
+if test ".$host" != .; then
     $1="$host"
-elif test ".$nonopt" != .NONE; then
-    $1="$nonopt"
 else
     $1=`${CONFIG_SHELL-/bin/sh} $srcdir/config.guess`
 fi
@@ -206,15 +203,15 @@
 dnl ##
 dnl ##  Support for config.param files
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CONFIG_PARAM(<file>)
 dnl ##
 
 AC_DEFUN(AC_CONFIG_PARAM,[
 AC_DIVERT_PUSH(-1)
-AC_ARG_WITH(param,[  --with-param=ID[,ID,..] load parameters from $1])
+AC_ARG_WITH(param,[  --with-param=ID[[,ID,..]] load parameters from $1])
 AC_DIVERT_POP()
-AC_DIVERT_PUSH(AC_DIVERSION_NOTICE)
+AC_DIVERT_PUSH(NOTICE)
 ac_prev=""
 ac_param=""
 if test -f $1; then
@@ -294,7 +291,7 @@
 dnl ##
 dnl ##  Check whether compiler option works
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_COMPILER_OPTION(<name>, <display>, <option>,
 dnl ##                       <action-success>, <action-failure>)
 dnl ##
@@ -324,90 +321,53 @@
 dnl ##
 dnl ##  Check whether `long long' and `long double' type exists
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_LONGLONG
 dnl ##    AC_CHECK_LONGDOUBLE
 dnl ##
 
 AC_DEFUN(AC_CHECK_LONGLONG,[dnl
 AC_MSG_CHECKING(for built-in type long long)
- AC_CACHE_VAL(ac_cv_type_longlong,[
+ AC_CACHE_VAL(ac_cv_type_longlong,[dnl
   AC_TRY_LINK([
 #include <sys/types.h>
   ],[
     long long X = 2, Y = 1, Z;
     Z = X / Y; 
   ],
-    AC_DEFINE(HAVE_LONGLONG)
     ac_cv_type_longlong=yes, 
     ac_cv_type_longlong=no
   )dnl
  ])dnl
 AC_MSG_RESULT([$ac_cv_type_longlong])
+if test ".$ac_cv_type_longlong" = .yes; then
+    AC_DEFINE(HAVE_LONGLONG)
+fi
 ])dnl
 
 AC_DEFUN(AC_CHECK_LONGDOUBLE,[dnl
 AC_MSG_CHECKING(for built-in type long double)
- AC_CACHE_VAL(ac_cv_type_longdouble,[
+ AC_CACHE_VAL(ac_cv_type_longdouble,[dnl
   AC_TRY_LINK([
 #include <sys/types.h>
   ],[
     long double X = 2, Y = 1, Z;
     Z = X / Y; 
   ],
-    AC_DEFINE(HAVE_LONGDOUBLE)
     ac_cv_type_longdouble=yes, 
     ac_cv_type_longdouble=no
   )dnl
  ])dnl
 AC_MSG_RESULT([$ac_cv_type_longdouble])
-])dnl
-
-dnl ##
-dnl ##  Minimalistic Libtool Glue Code
-dnl ##
-dnl ##  configure.in:
-dnl ##    AC_PROG_LIBTOOL(<platform-variable>)
-dnl ##
-
-AC_DEFUN(AC_PROG_LIBTOOL,[dnl
-AC_ARG_ENABLE(static,dnl
-[  --enable-static         build static libraries (default=yes)],
-enable_static="$enableval",
-if test ".$enable_static" = .; then
-    enable_static=yes
-fi
-)dnl
-AC_ARG_ENABLE(shared,dnl
-[  --enable-shared         build shared libraries (default=yes)],
-enable_shared="$enableval",
-if test ".$enable_shared" = .; then
-    enable_shared=yes
+if test ".$ac_cv_type_longdouble" = .yes; then
+    AC_DEFINE(HAVE_LONGDOUBLE)
 fi
-)dnl
-case "$PLATFORM" in
-    #   Solaris 2.7/x86 is slightly broken
-    *-pc-solaris2.[[78]] [)] enable_shared=no ;;
-esac
-libtool_flags=''
-dnl libtool_flags="$libtool_flags --cache-file=$cache_file"
-libtool_flags="$libtool_flags --disable-lock"
-test ".$silent"            = .yes && libtool_flags="$libtool_flags --silent"
-test ".$enable_static"     = .no  && libtool_flags="$libtool_flags --disable-static"
-test ".$enable_shared"     = .no  && libtool_flags="$libtool_flags --disable-shared"
-test ".$ac_cv_prog_gcc"    = .yes && libtool_flags="$libtool_flags --with-gcc"
-test ".$ac_cv_prog_gnu_ld" = .yes && libtool_flags="$libtool_flags --with-gnu-ld"
-CC="$CC" CFLAGS="$CFLAGS" CPPFLAGS="$CPPFLAGS" LD="$LD" \
-${CONFIG_SHELL-/bin/sh} $srcdir/ltconfig --no-reexec \
-$libtool_flags --srcdir=$srcdir --no-verify $srcdir/ltmain.sh $1 ||\
-AC_MSG_ERROR([libtool configuration failed])
-dnl (AC_CACHE_LOAD) >/dev/null 2>&1
 ])dnl
 
 dnl ##
 dnl ##  Debugging Support
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_DEBUGGING
 dnl ##
 
@@ -472,7 +432,7 @@
 dnl ##
 dnl ##  Profiling Support
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_PROFILING
 dnl ##
 
@@ -500,7 +460,7 @@
 dnl ##
 dnl ##  Build Parameters
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_BUILDPARAM
 dnl ##
 
@@ -546,7 +506,7 @@
 dnl ##
 dnl ##  Optimization Support
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_OPTIMIZE
 dnl ##
 
@@ -595,7 +555,7 @@
 dnl ##
 dnl ##  Check for a pre-processor define in a header
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_DEFINE(<define>, <header>)
 dnl ##  acconfig.h:
 dnl ##    #undef HAVE_<define>
@@ -619,7 +579,7 @@
 dnl ##
 dnl ##  Check for an ANSI C typedef in a header
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_TYPEDEF(<typedef>, <header>)
 dnl ##  acconfig.h:
 dnl ##    #undef HAVE_<typedef>
@@ -644,7 +604,7 @@
 dnl ##
 dnl ##  Check for an ANSI C struct attribute in a structure defined in a header
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_STRUCTATTR(<attr>, <struct>, <header>)
 dnl ##  acconfig.h:
 dnl ##    #undef HAVE_<attr>
@@ -672,7 +632,7 @@
 dnl ##
 dnl ##  Check for argument type of a function
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_ARGTYPE(<header> [...], <func>, <arg-number>,
 dnl ##                     <max-arg-number>, <action-with-${ac_type}>)
 dnl ##
@@ -705,7 +665,9 @@
     fi
     i=`expr $i + 1`
 done
+changequote([, ])dnl
 (eval "$ac_cpp conftest.$ac_ext") 2>&AC_FD_CC |\
+changequote(, )dnl
 sed -e ':join' \
     -e '/,[ 	]*$/N' \
     -e 's/,[ 	]*\n[ 	]*/, /' \
@@ -741,62 +703,10 @@
 ])
 
 dnl ##
-dnl ##  Check for existance of a function
-dnl ##
-dnl ##  configure.in:
-dnl ##     AC_CHECK_FUNCTION(<function> [, <action-if-found> [, <action-if-not-found>]])
-dnl ##     AC_CHECK_FUNCTIONS(<function> [...] [, <action-if-found> [, <action-if-not-found>]])
-dnl ##
-
-AC_DEFUN(AC_CHECK_FUNCTIONS,[dnl
-for ac_func in $1; do
-    AC_CHECK_FUNCTION($ac_func,
-        [changequote(, )dnl
-        ac_tr_func=HAVE_`echo $ac_func | tr 'abcdefghijklmnopqrstuvwxyz' 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'`
-        changequote([, ])dnl
-        AC_DEFINE_UNQUOTED($ac_tr_func) $2], $3)dnl
-done
-])
-
-AC_DEFUN(AC_CHECK_FUNCTION, [dnl
-AC_MSG_CHECKING([for function $1])
-AC_CACHE_VAL(ac_cv_func_$1, [dnl
-AC_TRY_LINK([
-/* System header to define __stub macros and hopefully few prototypes,
-   which can conflict with char $1(); below. */
-#include <assert.h>
-#ifdef __cplusplus
-extern "C"
-#endif
-/* We use char because int might match the return type of a gcc2
-   builtin and then its argument prototype would still apply. */
-char $1();
-char (*f)();
-], [
-/* The GNU C library defines this for functions which it implements
-   to always fail with ENOSYS.  Some functions are actually named
-   something starting with __ and the normal name is an alias. */
-#if defined (__stub_$1) || defined (__stub___$1)
-choke me
-#else
-f = $1;
-#endif
-], eval "ac_cv_func_$1=yes", eval "ac_cv_func_$1=no")])
-if eval "test \"`echo '$ac_cv_func_'$1`\" = yes"; then
-  AC_MSG_RESULT(yes)
-  ifelse([$2], , :, [$2])
-else
-  AC_MSG_RESULT(no)
-ifelse([$3], , , [$3
-])dnl
-fi
-])
-
-dnl ##
 dnl ##  Decision Hierachy
 dnl ##
 
-define(AC_IFALLYES,[dnl
+m4_define(AC_IFALLYES,[dnl
 ac_rc=yes
 for ac_spec in $1; do
     ac_type=`echo "$ac_spec" | sed -e 's/:.*$//'`
@@ -831,20 +741,20 @@
 fi
 ])
 
-define(AC_BEGIN_DECISION,[dnl
+m4_define(AC_BEGIN_DECISION,[dnl
 ac_decision_item='$1'
 ac_decision_msg='FAILED'
 ac_decision=''
 ])
 
-define(AC_DECIDE,[dnl
+m4_define(AC_DECIDE,[dnl
 ac_decision='$1'
 ac_decision_msg='$2'
 ac_decision_$1=yes
 ac_decision_$1_msg='$2'
 ])
 
-define(AC_DECISION_OVERRIDE,[dnl
+m4_define(AC_DECISION_OVERRIDE,[dnl
     ac_decision=''
     for ac_item in $1; do
          eval "ac_decision_this=\$ac_decision_${ac_item}"
@@ -855,12 +765,12 @@
     done
 ])
 
-define(AC_DECISION_FORCE,[dnl
+m4_define(AC_DECISION_FORCE,[dnl
 ac_decision="$1"
 eval "ac_decision_msg=\"\$ac_decision_${ac_decision}_msg\""
 ])
 
-define(AC_END_DECISION,[dnl
+m4_define(AC_END_DECISION,[dnl
 if test ".$ac_decision" = .; then
     echo "[$]0:Error: decision on $ac_decision_item failed." 1>&2
     echo "[$]0:Hint: see config.log for more details!" 1>&2
@@ -876,7 +786,7 @@
 dnl ##
 dnl ##  Check for existance of a file
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_TEST_FILE(<file>, <success-action>, <failure-action>)
 dnl ##
 
@@ -902,7 +812,7 @@
 dnl ##
 dnl ##  Check for socket/network size type
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_SOCKLENTYPE(<action-with-${ac_type}>)
 dnl ##
 
@@ -950,7 +860,7 @@
 dnl ##
 dnl ##  Check for filedescriptor number type
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_NFDSTYPE(<action-with-${ac_type}>)
 dnl ##
 
@@ -975,7 +885,7 @@
 dnl ##
 dnl ##  Check for direction of stack growth
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_STACKGROWTH(<define>)
 dnl ##  acconfig.h:
 dnl ##    #undef <define>
@@ -1038,7 +948,7 @@
 dnl ##
 dnl ##  Check whether and how a POSIX compliant sigsetjmp(3) can be achieved
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_SJLJ(<success-action>, <failure-action>, <type-var>)
 dnl ##
 
@@ -1152,7 +1062,7 @@
 rc=`cat conftestval`,
 rc=failed,
 rc=failed
-)dnl
+)
 CFLAGS="$OCFLAGS"
 if test ".$rc" = .ok; then
     ac_cv_check_sjlj=$testtype
@@ -1204,7 +1114,7 @@
 dnl ##
 dnl ##  Check for number of signals (NSIG)
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_NSIG(<define>)
 dnl ##  acconfig.h:
 dnl ##    #undef <define>
@@ -1248,7 +1158,7 @@
 nsig=`cat conftestval`,
 nsig=32,
 nsig=32
-)dnl
+)
 AC_MSG_RESULT([$nsig])
 AC_DEFINE_UNQUOTED($1, $nsig)
 ])
@@ -1259,7 +1169,7 @@
 dnl ##  - searches under standard paths include, lib, etc.
 dnl ##  - searches under subareas like .libs, etc.
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##      AC_CHECK_EXTLIB(<realname>, <libname>, <func>, <header>,
 dnl ##                      [<success-action> [, <fail-action>]])
 dnl ##  Makefile.in:
@@ -1271,8 +1181,8 @@
 dnl ##
 
 AC_DEFUN(AC_CHECK_EXTLIB,[dnl
-AC_ARG_WITH($2,dnl
-[  --with-]substr([$2[[=DIR]]                 ], 0, 19)[build against $1 library (default=no)],
+AC_ARG_WITH($2,[dnl
+[  --with-]m4_substr([$2[[=DIR]]                 ], 0, 19)[build against $1 library (default=no)]],
     if test ".$with_$2" = .yes; then
         #   via config script
         $2_version=`($2-config --version) 2>/dev/null`
@@ -1357,7 +1267,7 @@
 dnl ##  Check whether SVR4/SUSv2 makecontext(2), swapcontext(2) and
 dnl ##  friends can be used for user-space context switching
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##     AC_CHECK_MCSC(<success-action>, <failure-action>)
 dnl ##
 
@@ -1434,7 +1344,7 @@
 dnl ##  Check how stacks have to be setup for the functions
 dnl ##  sigstack(2), sigaltstack(2) and makecontext(2).
 dnl ##
-dnl ##  configure.in:
+dnl ##  configure.ac:
 dnl ##    AC_CHECK_STACKSETUP(sigstack|sigaltstack|makecontext, <macro-addr>, <macro-size>)
 dnl ##  acconfig.h:
 dnl ##    #undef HAVE_{SIGSTACK|SIGALTSTACK|MAKECONTEXT}
@@ -1458,7 +1368,7 @@
 dnl #   we require the C compiler and the standard headers
 AC_REQUIRE([AC_HEADER_STDC])dnl
 dnl #   we at least require the function to check
-AC_CHECK_FUNCTIONS($1)
+AC_CHECK_FUNCS($1)
 dnl #   sigaltstack on some platforms uses stack_t instead of struct sigaltstack
 ifelse($1, sigaltstack, [
     AC_ONCE(stacksetup_stack_t, [
@@ -1619,7 +1529,7 @@
 ],[
 dnl #   cross-platform => failed
 ac_cv_stacksetup_$1='guessed:(skaddr),(sksize)'
-])dnl
+])
 dnl #   restore original compile environment
 CFLAGS="$OCFLAGS"
 ])dnl
@@ -1640,5 +1550,3 @@
 AC_MSG_VERBOSE([$]$3)
 ])
 
-divert
-
Index: ossp-pkg/pth/config.guess
RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/config.guess,v
co -q -kk -p'1.7' '/v/ossp/cvs/ossp-pkg/pth/Attic/config.guess,v' | diff -u /dev/null - -L'ossp-pkg/pth/config.guess' 2>/dev/null
--- ossp-pkg/pth/config.guess
+++ -	2024-05-14 08:38:00.838565373 +0200
@@ -0,0 +1,983 @@
+#! /bin/sh
+# Attempt to guess a canonical system name.
+#   Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999
+#   Free Software Foundation, Inc.
+#
+# This file is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+#
+# As a special exception to the GNU General Public License, if you
+# distribute this file as part of a program that contains a
+# configuration script generated by Autoconf, you may include it under
+# the same distribution terms that you use for the rest of that program.
+
+# Written by Per Bothner <bothner@cygnus.com>.
+# The master version of this file is at the FSF in /home/gd/gnu/lib.
+# Please send patches to the Autoconf mailing list <autoconf@gnu.org>.
+#
+# This script attempts to guess a canonical system name similar to
+# config.sub.  If it succeeds, it prints the system name on stdout, and
+# exits with 0.  Otherwise, it exits with 1.
+#
+# The plan is that this can be called by configure scripts if you
+# don't specify an explicit system type (host/target name).
+#
+# Only a few systems have been added to this list; please add others
+# (but try to keep the structure clean).
+#
+
+# Use $HOST_CC if defined. $CC may point to a cross-compiler
+if test x"$CC_FOR_BUILD" = x; then
+  if test x"$HOST_CC" != x; then
+    CC_FOR_BUILD="$HOST_CC"
+  else
+    if test x"$CC" != x; then
+      CC_FOR_BUILD="$CC"
+    else
+      CC_FOR_BUILD=cc
+    fi
+  fi
+fi
+
+
+# This is needed to find uname on a Pyramid OSx when run in the BSD universe.
+# (ghazi@noc.rutgers.edu 8/24/94.)
+if (test -f /.attbin/uname) >/dev/null 2>&1 ; then
+	PATH=$PATH:/.attbin ; export PATH
+fi
+
+UNAME_MACHINE=`(uname -m) 2>/dev/null` || UNAME_MACHINE=unknown
+UNAME_RELEASE=`(uname -r) 2>/dev/null` || UNAME_RELEASE=unknown
+UNAME_SYSTEM=`(uname -s) 2>/dev/null` || UNAME_SYSTEM=unknown
+UNAME_VERSION=`(uname -v) 2>/dev/null` || UNAME_VERSION=unknown
+
+dummy=dummy-$$
+trap 'rm -f $dummy.c $dummy.o $dummy; exit 1' 1 2 15
+
+# Note: order is significant - the case branches are not exclusive.
+
+case "${UNAME_MACHINE}:${UNAME_SYSTEM}:${UNAME_RELEASE}:${UNAME_VERSION}" in
+    alpha:OSF1:*:*)
+	if test $UNAME_RELEASE = "V4.0"; then
+		UNAME_RELEASE=`/usr/sbin/sizer -v | awk '{print $3}'`
+	fi
+	# A Vn.n version is a released version.
+	# A Tn.n version is a released field test version.
+	# A Xn.n version is an unreleased experimental baselevel.
+	# 1.2 uses "1.2" for uname -r.
+	cat <<EOF >$dummy.s
+	.globl main
+	.ent main
+main:
+	.frame \$30,0,\$26,0
+	.prologue 0
+	.long 0x47e03d80 # implver $0
+	lda \$2,259
+	.long 0x47e20c21 # amask $2,$1
+	srl \$1,8,\$2
+	sll \$2,2,\$2
+	sll \$0,3,\$0
+	addl \$1,\$0,\$0
+	addl \$2,\$0,\$0
+	ret \$31,(\$26),1
+	.end main
+EOF
+	$CC_FOR_BUILD $dummy.s -o $dummy 2>/dev/null
+	if test "$?" = 0 ; then
+		./$dummy
+		case "$?" in
+			7)
+				UNAME_MACHINE="alpha"
+				;;
+			15)
+				UNAME_MACHINE="alphaev5"
+				;;
+			14)
+				UNAME_MACHINE="alphaev56"
+				;;
+			10)
+				UNAME_MACHINE="alphapca56"
+				;;
+			16)
+				UNAME_MACHINE="alphaev6"
+				;;
+		esac
+	fi
+	rm -f $dummy.s $dummy
+	echo ${UNAME_MACHINE}-dec-osf`echo ${UNAME_RELEASE} | sed -e 's/^[VTX]//' | tr 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 'abcdefghijklmnopqrstuvwxyz'`
+	exit 0 ;;
+    Alpha\ *:Windows_NT*:*)
+	# How do we know it's Interix rather than the generic POSIX subsystem?
+	# Should we change UNAME_MACHINE based on the output of uname instead
+	# of the specific Alpha model?
+	echo alpha-pc-interix
+	exit 0 ;;
+    21064:Windows_NT:50:3)
+	echo alpha-dec-winnt3.5
+	exit 0 ;;
+    Amiga*:UNIX_System_V:4.0:*)
+	echo m68k-cbm-sysv4
+	exit 0;;
+    amiga:NetBSD:*:*)
+      echo m68k-cbm-netbsd${UNAME_RELEASE}
+      exit 0 ;;
+    amiga:OpenBSD:*:*)
+	echo m68k-unknown-openbsd${UNAME_RELEASE}
+	exit 0 ;;
+    *:[Aa]miga[Oo][Ss]:*:*)
+	echo ${UNAME_MACHINE}-unknown-amigaos
+	exit 0 ;;
+    arc64:OpenBSD:*:*)
+	echo mips64el-unknown-openbsd${UNAME_RELEASE}
+	exit 0 ;;
+    arc:OpenBSD:*:*)
+	echo mipsel-unknown-openbsd${UNAME_RELEASE}
+	exit 0 ;;
+    hkmips:OpenBSD:*:*)
+	echo mips-unknown-openbsd${UNAME_RELEASE}
+	exit 0 ;;
+    pmax:OpenBSD:*:*)
+	echo mipsel-unknown-openbsd${UNAME_RELEASE}
+	exit 0 ;;
+    sgi:OpenBSD:*:*)
+	echo mips-unknown-openbsd${UNAME_RELEASE}
+	exit 0 ;;
+    wgrisc:OpenBSD:*:*)
+	echo mipsel-unknown-openbsd${UNAME_RELEASE}
+	exit 0 ;;
+    arm:RISC*:1.[012]*:*|arm:riscix:1.[012]*:*)
+	echo arm-acorn-riscix${UNAME_RELEASE}
+	exit 0;;
+    arm32:NetBSD:*:*)
+	echo arm-unknown-netbsd`echo ${UNAME_RELEASE}|sed -e 's/[-_].*/\./'`
+	exit 0 ;;
+    SR2?01:HI-UX/MPP:*:*)
+	echo hppa1.1-hitachi-hiuxmpp
+	exit 0;;
+    Pyramid*:OSx*:*:* | MIS*:OSx*:*:* | MIS*:SMP_DC-OSx*:*:*)
+	# akee@wpdis03.wpafb.af.mil (Earle F. Ake) contributed MIS and NILE.
+	if test "`(/bin/universe) 2>/dev/null`" = att ; then
+		echo pyramid-pyramid-sysv3
+	else
+		echo pyramid-pyramid-bsd
+	fi
+	exit 0 ;;
+    NILE*:*:*:dcosx)
+	echo pyramid-pyramid-svr4
+	exit 0 ;;
+    sun4H:SunOS:5.*:*)
+	echo sparc-hal-solaris2`echo ${UNAME_RELEASE}|sed -e 's/[^.]*//'`
+	exit 0 ;;
+    sun4*:SunOS:5.*:* | tadpole*:SunOS:5.*:*)
+	echo sparc-sun-solaris2`echo ${UNAME_RELEASE}|sed -e 's/[^.]*//'`
+	exit 0 ;;
+    i86pc:SunOS:5.*:*)
+	echo i386-pc-solaris2`echo ${UNAME_RELEASE}|sed -e 's/[^.]*//'`
+	exit 0 ;;
+    sun4*:SunOS:6*:*)
+	# According to config.sub, this is the proper way to canonicalize
+	# SunOS6.  Hard to guess exactly what SunOS6 will be like, but
+	# it's likely to be more like Solaris than SunOS4.
+	echo sparc-sun-solaris3`echo ${UNAME_RELEASE}|sed -e 's/[^.]*//'`
+	exit 0 ;;
+    sun4*:SunOS:*:*)
+	case "`/usr/bin/arch -k`" in
+	    Series*|S4*)
+		UNAME_RELEASE=`uname -v`
+		;;
+	esac
+	# Japanese Language versions have a version number like `4.1.3-JL'.
+	echo sparc-sun-sunos`echo ${UNAME_RELEASE}|sed -e 's/-/_/'`
+	exit 0 ;;
+    sun3*:SunOS:*:*)
+	echo m68k-sun-sunos${UNAME_RELEASE}
+	exit 0 ;;
+    sun*:*:4.2BSD:*)
+	UNAME_RELEASE=`(head -1 /etc/motd | awk '{print substr($5,1,3)}') 2>/dev/null`
+	test "x${UNAME_RELEASE}" = "x" && UNAME_RELEASE=3
+	case "`/bin/arch`" in
+	    sun3)
+		echo m68k-sun-sunos${UNAME_RELEASE}
+		;;
+	    sun4)
+		echo sparc-sun-sunos${UNAME_RELEASE}
+		;;
+	esac
+	exit 0 ;;
+    aushp:SunOS:*:*)
+	echo sparc-auspex-sunos${UNAME_RELEASE}
+	exit 0 ;;
+    atari*:NetBSD:*:*)
+	echo m68k-atari-netbsd${UNAME_RELEASE}
+	exit 0 ;;
+    atari*:OpenBSD:*:*)
+	echo m68k-unknown-openbsd${UNAME_RELEASE}
+	exit 0 ;;
+    # The situation for MiNT is a little confusing.  The machine name
+    # can be virtually everything (everything which is not
+    # "atarist" or "atariste" at least should have a processor
+    # > m68000).  The system name ranges from "MiNT" over "FreeMiNT"
+    # to the lowercase version "mint" (or "freemint").  Finally
+    # the system name "TOS" denotes a system which is actually not
+    # MiNT.  But MiNT is downward compatible to TOS, so this should
+    # be no problem.
+    atarist[e]:*MiNT:*:* | atarist[e]:*mint:*:* | atarist[e]:*TOS:*:*)
+        echo m68k-atari-mint${UNAME_RELEASE}
+	exit 0 ;;
+    atari*:*MiNT:*:* | atari*:*mint:*:* | atarist[e]:*TOS:*:*)
+	echo m68k-atari-mint${UNAME_RELEASE}
+        exit 0 ;;
+    *falcon*:*MiNT:*:* | *falcon*:*mint:*:* | *falcon*:*TOS:*:*)
+        echo m68k-atari-mint${UNAME_RELEASE}
+	exit 0 ;;
+    milan*:*MiNT:*:* | milan*:*mint:*:* | *milan*:*TOS:*:*)
+        echo m68k-milan-mint${UNAME_RELEASE}
+        exit 0 ;;
+    hades*:*MiNT:*:* | hades*:*mint:*:* | *hades*:*TOS:*:*)
+        echo m68k-hades-mint${UNAME_RELEASE}
+        exit 0 ;;
+    *:*MiNT:*:* | *:*mint:*:* | *:*TOS:*:*)
+        echo m68k-unknown-mint${UNAME_RELEASE}
+        exit 0 ;;
+    sun3*:NetBSD:*:*)
+	echo m68k-sun-netbsd${UNAME_RELEASE}
+	exit 0 ;;
+    sun3*:OpenBSD:*:*)
+	echo m68k-unknown-openbsd${UNAME_RELEASE}
+	exit 0 ;;
+    mac68k:NetBSD:*:*)
+	echo m68k-apple-netbsd${UNAME_RELEASE}
+	exit 0 ;;
+    mac68k:OpenBSD:*:*)
+	echo m68k-unknown-openbsd${UNAME_RELEASE}
+	exit 0 ;;
+    mvme68k:OpenBSD:*:*)
+	echo m68k-unknown-openbsd${UNAME_RELEASE}
+	exit 0 ;;
+    mvme88k:OpenBSD:*:*)
+	echo m88k-unknown-openbsd${UNAME_RELEASE}
+	exit 0 ;;
+    powerpc:machten:*:*)
+	echo powerpc-apple-machten${UNAME_RELEASE}
+	exit 0 ;;
+    macppc:NetBSD:*:*)
+        echo powerpc-apple-netbsd${UNAME_RELEASE}
+        exit 0 ;;
+    RISC*:Mach:*:*)
+	echo mips-dec-mach_bsd4.3
+	exit 0 ;;
+    RISC*:ULTRIX:*:*)
+	echo mips-dec-ultrix${UNAME_RELEASE}
+	exit 0 ;;
+    VAX*:ULTRIX*:*:*)
+	echo vax-dec-ultrix${UNAME_RELEASE}
+	exit 0 ;;
+    2020:CLIX:*:* | 2430:CLIX:*:*)
+	echo clipper-intergraph-clix${UNAME_RELEASE}
+	exit 0 ;;
+    mips:*:*:UMIPS | mips:*:*:RISCos)
+	sed 's/^	//' << EOF >$dummy.c
+#ifdef __cplusplus
+	int main (int argc, char *argv[]) {
+#else
+	int main (argc, argv) int argc; char *argv[]; {
+#endif
+	#if defined (host_mips) && defined (MIPSEB)
+	#if defined (SYSTYPE_SYSV)
+	  printf ("mips-mips-riscos%ssysv\n", argv[1]); exit (0);
+	#endif
+	#if defined (SYSTYPE_SVR4)
+	  printf ("mips-mips-riscos%ssvr4\n", argv[1]); exit (0);
+	#endif
+	#if defined (SYSTYPE_BSD43) || defined(SYSTYPE_BSD)
+	  printf ("mips-mips-riscos%sbsd\n", argv[1]); exit (0);
+	#endif
+	#endif
+	  exit (-1);
+	}
+EOF
+	$CC_FOR_BUILD $dummy.c -o $dummy \
+	  && ./$dummy `echo "${UNAME_RELEASE}" | sed -n 's/\([0-9]*\).*/\1/p'` \
+	  && rm $dummy.c $dummy && exit 0
+	rm -f $dummy.c $dummy
+	echo mips-mips-riscos${UNAME_RELEASE}
+	exit 0 ;;
+    Night_Hawk:Power_UNIX:*:*)
+	echo powerpc-harris-powerunix
+	exit 0 ;;
+    m88k:CX/UX:7*:*)
+	echo m88k-harris-cxux7
+	exit 0 ;;
+    m88k:*:4*:R4*)
+	echo m88k-motorola-sysv4
+	exit 0 ;;
+    m88k:*:3*:R3*)
+	echo m88k-motorola-sysv3
+	exit 0 ;;
+    AViiON:dgux:*:*)
+        # DG/UX returns AViiON for all architectures
+        UNAME_PROCESSOR=`/usr/bin/uname -p`
+        if [ $UNAME_PROCESSOR = mc88100 -o $UNAME_PROCESSOR = mc88110 ] ; then
+	if [ ${TARGET_BINARY_INTERFACE}x = m88kdguxelfx \
+	     -o ${TARGET_BINARY_INTERFACE}x = x ] ; then
+		echo m88k-dg-dgux${UNAME_RELEASE}
+	else
+		echo m88k-dg-dguxbcs${UNAME_RELEASE}
+	fi
+        else echo i586-dg-dgux${UNAME_RELEASE}
+        fi
+ 	exit 0 ;;
+    M88*:DolphinOS:*:*)	# DolphinOS (SVR3)
+	echo m88k-dolphin-sysv3
+	exit 0 ;;
+    M88*:*:R3*:*)
+	# Delta 88k system running SVR3
+	echo m88k-motorola-sysv3
+	exit 0 ;;
+    XD88*:*:*:*) # Tektronix XD88 system running UTekV (SVR3)
+	echo m88k-tektronix-sysv3
+	exit 0 ;;
+    Tek43[0-9][0-9]:UTek:*:*) # Tektronix 4300 system running UTek (BSD)
+	echo m68k-tektronix-bsd
+	exit 0 ;;
+    *:IRIX*:*:*)
+	echo mips-sgi-irix`echo ${UNAME_RELEASE}|sed -e 's/-/_/g'`
+	exit 0 ;;
+    ????????:AIX?:[12].1:2)   # AIX 2.2.1 or AIX 2.1.1 is RT/PC AIX.
+	echo romp-ibm-aix      # uname -m gives an 8 hex-code CPU id
+	exit 0 ;;              # Note that: echo "'`uname -s`'" gives 'AIX '
+    i?86:AIX:*:*)
+	echo i386-ibm-aix
+	exit 0 ;;
+    *:AIX:2:3)
+	if grep bos325 /usr/include/stdio.h >/dev/null 2>&1; then
+		sed 's/^		//' << EOF >$dummy.c
+		#include <sys/systemcfg.h>
+
+		main()
+			{
+			if (!__power_pc())
+				exit(1);
+			puts("powerpc-ibm-aix3.2.5");
+			exit(0);
+			}
+EOF
+		$CC_FOR_BUILD $dummy.c -o $dummy && ./$dummy && rm $dummy.c $dummy && exit 0
+		rm -f $dummy.c $dummy
+		echo rs6000-ibm-aix3.2.5
+	elif grep bos324 /usr/include/stdio.h >/dev/null 2>&1; then
+		echo rs6000-ibm-aix3.2.4
+	else
+		echo rs6000-ibm-aix3.2
+	fi
+	exit 0 ;;
+    *:AIX:*:4)
+	IBM_CPU_ID=`/usr/sbin/lsdev -C -c processor -S available | head -1 | awk '{ print $1 }'`
+	if /usr/sbin/lsattr -EHl ${IBM_CPU_ID} | grep POWER >/dev/null 2>&1; then
+		IBM_ARCH=rs6000
+	else
+		IBM_ARCH=powerpc
+	fi
+	if [ -x /usr/bin/oslevel ] ; then
+		IBM_REV=`/usr/bin/oslevel`
+	else
+		IBM_REV=4.${UNAME_RELEASE}
+	fi
+	echo ${IBM_ARCH}-ibm-aix${IBM_REV}
+	exit 0 ;;
+    *:AIX:*:*)
+	echo rs6000-ibm-aix
+	exit 0 ;;
+    ibmrt:4.4BSD:*|romp-ibm:BSD:*)
+	echo romp-ibm-bsd4.4
+	exit 0 ;;
+    ibmrt:*BSD:*|romp-ibm:BSD:*)            # covers RT/PC NetBSD and
+	echo romp-ibm-bsd${UNAME_RELEASE}   # 4.3 with uname added to
+	exit 0 ;;                           # report: romp-ibm BSD 4.3
+    *:BOSX:*:*)
+	echo rs6000-bull-bosx
+	exit 0 ;;
+    DPX/2?00:B.O.S.:*:*)
+	echo m68k-bull-sysv3
+	exit 0 ;;
+    9000/[34]??:4.3bsd:1.*:*)
+	echo m68k-hp-bsd
+	exit 0 ;;
+    hp300:4.4BSD:*:* | 9000/[34]??:4.3bsd:2.*:*)
+	echo m68k-hp-bsd4.4
+	exit 0 ;;
+    9000/[34678]??:HP-UX:*:*)
+	case "${UNAME_MACHINE}" in
+	    9000/31? )            HP_ARCH=m68000 ;;
+	    9000/[34]?? )         HP_ARCH=m68k ;;
+	    9000/[678][0-9][0-9])
+              sed 's/^              //' << EOF >$dummy.c
+              #include <stdlib.h>
+              #include <unistd.h>
+
+              int main ()
+              {
+              #if defined(_SC_KERNEL_BITS)
+                  long bits = sysconf(_SC_KERNEL_BITS);
+              #endif
+                  long cpu  = sysconf (_SC_CPU_VERSION);
+
+                  switch (cpu)
+              	{
+              	case CPU_PA_RISC1_0: puts ("hppa1.0"); break;
+              	case CPU_PA_RISC1_1: puts ("hppa1.1"); break;
+              	case CPU_PA_RISC2_0:
+              #if defined(_SC_KERNEL_BITS)
+              	    switch (bits)
+              		{
+              		case 64: puts ("hppa2.0w"); break;
+              		case 32: puts ("hppa2.0n"); break;
+              		default: puts ("hppa2.0"); break;
+              		} break;
+              #else  /* !defined(_SC_KERNEL_BITS) */
+              	    puts ("hppa2.0"); break;
+              #endif
+              	default: puts ("hppa1.0"); break;
+              	}
+                  exit (0);
+              }
+EOF
+	($CC_FOR_BUILD $dummy.c -o $dummy 2>/dev/null ) && HP_ARCH=`./$dummy`
+	rm -f $dummy.c $dummy
+	esac
+	HPUX_REV=`echo ${UNAME_RELEASE}|sed -e 's/[^.]*.[0B]*//'`
+	echo ${HP_ARCH}-hp-hpux${HPUX_REV}
+	exit 0 ;;
+    3050*:HI-UX:*:*)
+	sed 's/^	//' << EOF >$dummy.c
+	#include <unistd.h>
+	int
+	main ()
+	{
+	  long cpu = sysconf (_SC_CPU_VERSION);
+	  /* The order matters, because CPU_IS_HP_MC68K erroneously returns
+	     true for CPU_PA_RISC1_0.  CPU_IS_PA_RISC returns correct
+	     results, however.  */
+	  if (CPU_IS_PA_RISC (cpu))
+	    {
+	      switch (cpu)
+		{
+		  case CPU_PA_RISC1_0: puts ("hppa1.0-hitachi-hiuxwe2"); break;
+		  case CPU_PA_RISC1_1: puts ("hppa1.1-hitachi-hiuxwe2"); break;
+		  case CPU_PA_RISC2_0: puts ("hppa2.0-hitachi-hiuxwe2"); break;
+		  default: puts ("hppa-hitachi-hiuxwe2"); break;
+		}
+	    }
+	  else if (CPU_IS_HP_MC68K (cpu))
+	    puts ("m68k-hitachi-hiuxwe2");
+	  else puts ("unknown-hitachi-hiuxwe2");
+	  exit (0);
+	}
+EOF
+	$CC_FOR_BUILD $dummy.c -o $dummy && ./$dummy && rm $dummy.c $dummy && exit 0
+	rm -f $dummy.c $dummy
+	echo unknown-hitachi-hiuxwe2
+	exit 0 ;;
+    9000/7??:4.3bsd:*:* | 9000/8?[79]:4.3bsd:*:* )
+	echo hppa1.1-hp-bsd
+	exit 0 ;;
+    9000/8??:4.3bsd:*:*)
+	echo hppa1.0-hp-bsd
+	exit 0 ;;
+    *9??*:MPE/iX:*:*)
+	echo hppa1.0-hp-mpeix
+	exit 0 ;;
+    hp7??:OSF1:*:* | hp8?[79]:OSF1:*:* )
+	echo hppa1.1-hp-osf
+	exit 0 ;;
+    hp8??:OSF1:*:*)
+	echo hppa1.0-hp-osf
+	exit 0 ;;
+    i?86:OSF1:*:*)
+	if [ -x /usr/sbin/sysversion ] ; then
+	    echo ${UNAME_MACHINE}-unknown-osf1mk
+	else
+	    echo ${UNAME_MACHINE}-unknown-osf1
+	fi
+	exit 0 ;;
+    parisc*:Lites*:*:*)
+	echo hppa1.1-hp-lites
+	exit 0 ;;
+    hppa*:OpenBSD:*:*)
+	echo hppa-unknown-openbsd
+	exit 0 ;;
+    C1*:ConvexOS:*:* | convex:ConvexOS:C1*:*)
+	echo c1-convex-bsd
+        exit 0 ;;
+    C2*:ConvexOS:*:* | convex:ConvexOS:C2*:*)
+	if getsysinfo -f scalar_acc
+	then echo c32-convex-bsd
+	else echo c2-convex-bsd
+	fi
+        exit 0 ;;
+    C34*:ConvexOS:*:* | convex:ConvexOS:C34*:*)
+	echo c34-convex-bsd
+        exit 0 ;;
+    C38*:ConvexOS:*:* | convex:ConvexOS:C38*:*)
+	echo c38-convex-bsd
+        exit 0 ;;
+    C4*:ConvexOS:*:* | convex:ConvexOS:C4*:*)
+	echo c4-convex-bsd
+        exit 0 ;;
+    CRAY*X-MP:*:*:*)
+	echo xmp-cray-unicos
+        exit 0 ;;
+    CRAY*Y-MP:*:*:*)
+	echo ymp-cray-unicos${UNAME_RELEASE}
+	exit 0 ;;
+    CRAY*[A-Z]90:*:*:*)
+	echo ${UNAME_MACHINE}-cray-unicos${UNAME_RELEASE} \
+	| sed -e 's/CRAY.*\([A-Z]90\)/\1/' \
+	      -e y/ABCDEFGHIJKLMNOPQRSTUVWXYZ/abcdefghijklmnopqrstuvwxyz/
+	exit 0 ;;
+    CRAY*TS:*:*:*)
+	echo t90-cray-unicos${UNAME_RELEASE}
+	exit 0 ;;
+    CRAY*T3E:*:*:*)
+	echo t3e-cray-unicosmk${UNAME_RELEASE}
+	exit 0 ;;
+    CRAY-2:*:*:*)
+	echo cray2-cray-unicos
+        exit 0 ;;
+    F300:UNIX_System_V:*:*)
+        FUJITSU_SYS=`uname -p | tr 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 'abcdefghijklmnopqrstuvwxyz' | sed -e 's/\///'`
+        FUJITSU_REL=`echo ${UNAME_RELEASE} | sed -e 's/ /_/'`
+        echo "f300-fujitsu-${FUJITSU_SYS}${FUJITSU_REL}"
+        exit 0 ;;
+    F301:UNIX_System_V:*:*)
+       echo f301-fujitsu-uxpv`echo $UNAME_RELEASE | sed 's/ .*//'`
+       exit 0 ;;
+    hp3[0-9][05]:NetBSD:*:*)
+	echo m68k-hp-netbsd${UNAME_RELEASE}
+	exit 0 ;;
+    hp300:OpenBSD:*:*)
+	echo m68k-unknown-openbsd${UNAME_RELEASE}
+	exit 0 ;;
+    i?86:BSD/386:*:* | i?86:BSD/OS:*:*)
+	echo ${UNAME_MACHINE}-pc-bsdi${UNAME_RELEASE}
+	exit 0 ;;
+    sparc*:BSD/OS:*:*)
+	echo sparc-unknown-bsdi${UNAME_RELEASE}
+	exit 0 ;;
+    *:BSD/OS:*:*)
+	echo ${UNAME_MACHINE}-unknown-bsdi${UNAME_RELEASE}
+	exit 0 ;;
+    *:FreeBSD:*:*)
+	# echo ${UNAME_MACHINE}-unknown-freebsd`echo ${UNAME_RELEASE}|sed -e 's/[-(].*//'`
+        VERS=`echo ${UNAME_RELEASE} | sed -e 's/[-(].*//'`
+        MACH=`/sbin/sysctl -n hw.model`
+        ARCH='unknown'
+        case ${MACH} in
+           *386*       ) MACH="i386" ;;
+           *486*       ) MACH="i486" ;;
+           Pentium\ II*) MACH="i686" ;;
+           Pentium*    ) MACH="i586" ;;
+           Alpha*      ) MACH="alpha" ;;
+           *           ) MACH="$UNAME_MACHINE" ;;
+        esac
+        case ${MACH} in
+           i[0-9]86 ) ARCH="pc" ;;
+        esac
+        echo "${MACH}-${ARCH}-freebsd${VERS}"
+	exit 0 ;;
+    *:NetBSD:*:*)
+	echo ${UNAME_MACHINE}-unknown-netbsd`echo ${UNAME_RELEASE}|sed -e 's/[-_].*/\./'`
+	exit 0 ;;
+    *:OpenBSD:*:*)
+	echo ${UNAME_MACHINE}-unknown-openbsd`echo ${UNAME_RELEASE}|sed -e 's/[-_].*/\./'`
+	exit 0 ;;
+    i*:CYGWIN*:*)
+	echo ${UNAME_MACHINE}-pc-cygwin
+	exit 0 ;;
+    i*:MINGW*:*)
+	echo ${UNAME_MACHINE}-pc-mingw32
+	exit 0 ;;
+    i*:Windows_NT*:* | Pentium*:Windows_NT*:*)
+	# How do we know it's Interix rather than the generic POSIX subsystem?
+	# It also conflicts with pre-2.0 versions of AT&T UWIN. Should we
+	# UNAME_MACHINE based on the output of uname instead of i386?
+	echo i386-pc-interix
+	exit 0 ;;
+    i*:UWIN*:*)
+	echo ${UNAME_MACHINE}-pc-uwin
+	exit 0 ;;
+    p*:CYGWIN*:*)
+	echo powerpcle-unknown-cygwin
+	exit 0 ;;
+    prep*:SunOS:5.*:*)
+	echo powerpcle-unknown-solaris2`echo ${UNAME_RELEASE}|sed -e 's/[^.]*//'`
+	exit 0 ;;
+    *:GNU:*:*)
+	echo `echo ${UNAME_MACHINE}|sed -e 's,[-/].*$,,'`-unknown-gnu`echo ${UNAME_RELEASE}|sed -e 's,/.*$,,'`
+	exit 0 ;;
+    *:Linux:*:*)
+	# determine canonical machine name
+	MACHINE="$UNAME_MACHINE"
+	case "$MACHINE" in
+	    arm*|sa110*) MACHINE="arm" ;;
+	esac
+
+        # determine (distribution) vendor
+	VENDOR="gnu"
+	for tagfile in dummy `cd /etc && echo *-release *_version 2>/dev/null`; do
+	    test ! -f /etc/$tagfile && continue
+	    VENDOR=`echo $tagfile | sed -e 's/-release$//' -e 's/_version$//' |\
+	            tr 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' 'abcdefghijklmnopqrstuvwxyz'`
+	done
+
+	# determine kernel version
+	KERNEL=`echo ${UNAME_RELEASE} | sed -e 's/^\([0-9]*\.[0-9]*\)\..*$/\1/'`
+
+	# determine [g]libc version
+	cat >$dummy.c <<EOF
+#include <stdio.h>
+#include <features.h>
+main(argc, argv)
+int argc;
+char *argv[];
+{
+#if defined(__GLIBC__) && !defined(__GLIBC_MINOR__)
+    printf("%d", __GLIBC__);
+#elif defined(__GLIBC__) && defined(__GLIBC_MINOR__)
+    printf("%d.%d", __GLIBC__, __GLIBC_MINOR__);
+#elif defined(__GNU_LIBRARY__)
+    printf("%d", __GNU_LIBRARY__);
+#else
+    printf("1");
+#endif
+    return 0;
+}
+EOF
+	LIBC="1"
+	$CC_FOR_BUILD $dummy.c -o $dummy # 2>/dev/null
+	if [ $? = 0 ]; then
+	    LIBC=`./$dummy | sed -e 's/^\([0-9]*\.[0-9]*\)\..*$/\1/'`
+	fi
+	rm -f $dummy.c $dummy
+
+	echo "${MACHINE}-${VENDOR}-linux${KERNEL}glibc${LIBC}"
+	;;
+# ptx 4.0 does uname -s correctly, with DYNIX/ptx in there.  earlier versions
+# are messed up and put the nodename in both sysname and nodename.
+    i?86:DYNIX/ptx:4*:*)
+	echo i386-sequent-sysv4
+	exit 0 ;;
+    i?86:UnixWare:*:* )
+        echo ${UNAME_MACHINE}-pc-sysv${UNAME_RELEASE}uw${UNAME_VERSION}
+        exit 0 ;;
+    i?86:UNIX_SV:4.2MP:2.*)
+        # Unixware is an offshoot of SVR4, but it has its own version
+        # number series starting with 2...
+        # I am not positive that other SVR4 systems won't match this,
+	# I just have to hope.  -- rms.
+        # Use sysv4.2uw... so that sysv4* matches it.
+	echo ${UNAME_MACHINE}-pc-sysv4.2uw${UNAME_VERSION}
+	exit 0 ;;
+    i?86:*:4.*:* | i?86:SYSTEM_V:4.*:*)
+	if grep Novell /usr/include/link.h >/dev/null 2>/dev/null; then
+		echo ${UNAME_MACHINE}-univel-sysv${UNAME_RELEASE}
+	else
+		echo ${UNAME_MACHINE}-pc-sysv${UNAME_RELEASE}
+	fi
+	exit 0 ;;
+    i?86:*:5:7*)
+	UNAME_REL=`(/bin/uname -X|egrep Release|sed -e 's/.*= //')`
+	(/bin/uname -X|egrep i80486 >/dev/null) && UNAME_MACHINE=i486
+	(/bin/uname -X|egrep '^Machine.*Pentium' >/dev/null) && UNAME_MACHINE=i586
+	(/bin/uname -X|egrep '^Machine.*Pent.*II' >/dev/null) && UNAME_MACHINE=i686
+	(/bin/uname -X|egrep '^Machine.*Pentium Pro' >/dev/null) && UNAME_MACHINE=i585
+	echo ${UNAME_MACHINE}-${UNAME_SYSTEM}${UNAME_VERSION}-sysv${UNAME_RELEASE}
+	exit 0 ;;
+    i?86:*:3.2:*)
+	if test -f /usr/options/cb.name; then
+		UNAME_REL=`sed -n 's/.*Version //p' </usr/options/cb.name`
+		echo ${UNAME_MACHINE}-pc-isc$UNAME_REL
+	elif /bin/uname -X 2>/dev/null >/dev/null ; then
+		UNAME_REL=`(/bin/uname -X|egrep Release|sed -e 's/.*= //')`
+		(/bin/uname -X|egrep i80486 >/dev/null) && UNAME_MACHINE=i486
+		(/bin/uname -X|egrep '^Machine.*Pentium' >/dev/null) \
+			&& UNAME_MACHINE=i586
+		(/bin/uname -X|egrep '^Machine.*Pent ?II' >/dev/null) \
+			&& UNAME_MACHINE=i686
+		(/bin/uname -X|egrep '^Machine.*Pentium Pro' >/dev/null) \
+			&& UNAME_MACHINE=i686
+		echo ${UNAME_MACHINE}-pc-sco$UNAME_REL
+	else
+		echo ${UNAME_MACHINE}-pc-sysv32
+	fi
+	exit 0 ;;
+    pc:*:*:*)
+        # uname -m prints for DJGPP always 'pc', but it prints nothing about
+        # the processor, so we play safe by assuming i386.
+	echo i386-pc-msdosdjgpp
+        exit 0 ;;
+    Intel:Mach:3*:*)
+	echo i386-pc-mach3
+	exit 0 ;;
+    paragon:*:*:*)
+	echo i860-intel-osf1
+	exit 0 ;;
+    i860:*:4.*:*) # i860-SVR4
+	if grep Stardent /usr/include/sys/uadmin.h >/dev/null 2>&1 ; then
+	  echo i860-stardent-sysv${UNAME_RELEASE} # Stardent Vistra i860-SVR4
+	else # Add other i860-SVR4 vendors below as they are discovered.
+	  echo i860-unknown-sysv${UNAME_RELEASE}  # Unknown i860-SVR4
+	fi
+	exit 0 ;;
+    mini*:CTIX:SYS*5:*)
+	# "miniframe"
+	echo m68010-convergent-sysv
+	exit 0 ;;
+    M68*:*:R3V[567]*:*)
+	test -r /sysV68 && echo 'm68k-motorola-sysv' && exit 0 ;;
+    3[34]??:*:4.0:3.0 | 3[34]??,*:*:4.0:3.0 | 4850:*:4.0:3.0)
+	OS_REL=''
+	test -r /etc/.relid \
+	&& OS_REL=.`sed -n 's/[^ ]* [^ ]* \([0-9][0-9]\).*/\1/p' < /etc/.relid`
+	/bin/uname -p 2>/dev/null | grep 86 >/dev/null \
+	  && echo i486-ncr-sysv4.3${OS_REL} && exit 0
+	/bin/uname -p 2>/dev/null | /bin/grep entium >/dev/null \
+	  && echo i586-ncr-sysv4.3${OS_REL} && exit 0 ;;
+    3[34]??:*:4.0:* | 3[34]??,*:*:4.0:*)
+        /bin/uname -p 2>/dev/null | grep 86 >/dev/null \
+          && echo i486-ncr-sysv4 && exit 0 ;;
+    m68*:LynxOS:2.*:*)
+	echo m68k-unknown-lynxos${UNAME_RELEASE}
+	exit 0 ;;
+    mc68030:UNIX_System_V:4.*:*)
+	echo m68k-atari-sysv4
+	exit 0 ;;
+    i?86:LynxOS:2.*:* | i?86:LynxOS:3.[01]*:*)
+	echo i386-unknown-lynxos${UNAME_RELEASE}
+	exit 0 ;;
+    TSUNAMI:LynxOS:2.*:*)
+	echo sparc-unknown-lynxos${UNAME_RELEASE}
+	exit 0 ;;
+    rs6000:LynxOS:2.*:* | PowerPC:LynxOS:2.*:*)
+	echo rs6000-unknown-lynxos${UNAME_RELEASE}
+	exit 0 ;;
+    SM[BE]S:UNIX_SV:*:*)
+	echo mips-dde-sysv${UNAME_RELEASE}
+	exit 0 ;;
+    BS2000:POSIX-BC:*:*)
+	echo BS2000-siemens-sysv4
+	exit 0 ;;
+    RM*:ReliantUNIX-*:*:*)
+	echo mips-sni-sysv4
+	exit 0 ;;
+    RM*:SINIX-*:*:*)
+	echo mips-sni-sysv4
+	exit 0 ;;
+    *:SINIX-*:*:*)
+	if uname -p 2>/dev/null >/dev/null ; then
+		UNAME_MACHINE=`(uname -p) 2>/dev/null`
+		echo ${UNAME_MACHINE}-sni-sysv4
+	else
+		echo ns32k-sni-sysv
+	fi
+	exit 0 ;;
+    PENTIUM:CPunix:4.0*:*) # Unisys `ClearPath HMP IX 4000' SVR4/MP effort
+                           # says <Richard.M.Bartel@ccMail.Census.GOV>
+        echo i586-unisys-sysv4
+        exit 0 ;;
+    *:UNIX_System_V:4*:FTX*)
+	# From Gerald Hewes <hewes@openmarket.com>.
+	# How about differentiating between stratus architectures? -djm
+	echo hppa1.1-stratus-sysv4
+	exit 0 ;;
+    *:*:*:FTX*)
+	# From seanf@swdc.stratus.com.
+	echo i860-stratus-sysv4
+	exit 0 ;;
+    mc68*:A/UX:*:*)
+	echo m68k-apple-aux${UNAME_RELEASE}
+	exit 0 ;;
+    news*:NEWS-OS:*:6*)
+	echo mips-sony-newsos6
+	exit 0 ;;
+    R[34]000:*System_V*:*:* | R4000:UNIX_SYSV:*:* | R*000:UNIX_SV:*:*)
+	if [ -d /usr/nec ]; then
+	        echo mips-nec-sysv${UNAME_RELEASE}
+	else
+	        echo mips-unknown-sysv${UNAME_RELEASE}
+	fi
+        exit 0 ;;
+    BeBox:BeOS:*:*)	# BeOS running on hardware made by Be, PPC only.
+	echo powerpc-be-beos
+	exit 0 ;;
+    BeMac:BeOS:*:*)	# BeOS running on Mac or Mac clone, PPC only.
+	echo powerpc-apple-beos
+	exit 0 ;;
+    BePC:BeOS:*:*)	# BeOS running on Intel PC compatible.
+	echo i586-pc-beos
+	exit 0 ;;
+    SX-4:SUPER-UX:*:*)
+	echo sx4-nec-superux${UNAME_RELEASE}
+	exit 0 ;;
+    SX-5:SUPER-UX:*:*)
+	echo sx5-nec-superux${UNAME_RELEASE}
+	exit 0 ;;
+    Power*:Rhapsody:*:*)
+	echo powerpc-apple-rhapsody${UNAME_RELEASE}
+	exit 0 ;;
+    *:Rhapsody:*:*)
+	echo ${UNAME_MACHINE}-apple-rhapsody${UNAME_RELEASE}
+	exit 0 ;;
+esac
+
+#echo '(No uname command or uname output not recognized.)' 1>&2
+#echo "${UNAME_MACHINE}:${UNAME_SYSTEM}:${UNAME_RELEASE}:${UNAME_VERSION}" 1>&2
+
+cat >$dummy.c <<EOF
+#ifdef _SEQUENT_
+# include <sys/types.h>
+# include <sys/utsname.h>
+#endif
+main ()
+{
+#if defined (sony)
+#if defined (MIPSEB)
+  /* BFD wants "bsd" instead of "newsos".  Perhaps BFD should be changed,
+     I don't know....  */
+  printf ("mips-sony-bsd\n"); exit (0);
+#else
+#include <sys/param.h>
+  printf ("m68k-sony-newsos%s\n",
+#ifdef NEWSOS4
+          "4"
+#else
+	  ""
+#endif
+         ); exit (0);
+#endif
+#endif
+
+#if defined (__arm) && defined (__acorn) && defined (__unix)
+  printf ("arm-acorn-riscix"); exit (0);
+#endif
+
+#if defined (hp300) && !defined (hpux)
+  printf ("m68k-hp-bsd\n"); exit (0);
+#endif
+
+#if defined (NeXT)
+#if !defined (__ARCHITECTURE__)
+#define __ARCHITECTURE__ "m68k"
+#endif
+  int version;
+  version=`(hostinfo | sed -n 's/.*NeXT Mach \([0-9]*\).*/\1/p') 2>/dev/null`;
+  if (version < 4)
+    printf ("%s-next-nextstep%d\n", __ARCHITECTURE__, version);
+  else
+    printf ("%s-next-openstep%d\n", __ARCHITECTURE__, version);
+  exit (0);
+#endif
+
+#if defined (MULTIMAX) || defined (n16)
+#if defined (UMAXV)
+  printf ("ns32k-encore-sysv\n"); exit (0);
+#else
+#if defined (CMU)
+  printf ("ns32k-encore-mach\n"); exit (0);
+#else
+  printf ("ns32k-encore-bsd\n"); exit (0);
+#endif
+#endif
+#endif
+
+#if defined (__386BSD__)
+  printf ("i386-pc-bsd\n"); exit (0);
+#endif
+
+#if defined (sequent)
+#if defined (i386)
+  printf ("i386-sequent-dynix\n"); exit (0);
+#endif
+#if defined (ns32000)
+  printf ("ns32k-sequent-dynix\n"); exit (0);
+#endif
+#endif
+
+#if defined (_SEQUENT_)
+    struct utsname un;
+
+    uname(&un);
+
+    if (strncmp(un.version, "V2", 2) == 0) {
+	printf ("i386-sequent-ptx2\n"); exit (0);
+    }
+    if (strncmp(un.version, "V1", 2) == 0) { /* XXX is V1 correct? */
+	printf ("i386-sequent-ptx1\n"); exit (0);
+    }
+    printf ("i386-sequent-ptx\n"); exit (0);
+
+#endif
+
+#if defined (vax)
+#if !defined (ultrix)
+  printf ("vax-dec-bsd\n"); exit (0);
+#else
+  printf ("vax-dec-ultrix\n"); exit (0);
+#endif
+#endif
+
+#if defined (alliant) && defined (i860)
+  printf ("i860-alliant-bsd\n"); exit (0);
+#endif
+
+  exit (1);
+}
+EOF
+
+$CC_FOR_BUILD $dummy.c -o $dummy 2>/dev/null && ./$dummy && rm $dummy.c $dummy && exit 0
+rm -f $dummy.c $dummy
+
+# Apollos put the system type in the environment.
+
+test -d /usr/apollo && { echo ${ISP}-apollo-${SYSTYPE}; exit 0; }
+
+# Convex versions that predate uname can use getsysinfo(1)
+
+if [ -x /usr/convex/getsysinfo ]
+then
+    case `getsysinfo -f cpu_type` in
+    c1*)
+	echo c1-convex-bsd
+	exit 0 ;;
+    c2*)
+	if getsysinfo -f scalar_acc
+	then echo c32-convex-bsd
+	else echo c2-convex-bsd
+	fi
+	exit 0 ;;
+    c34*)
+	echo c34-convex-bsd
+	exit 0 ;;
+    c38*)
+	echo c38-convex-bsd
+	exit 0 ;;
+    c4*)
+	echo c4-convex-bsd
+	exit 0 ;;
+    esac
+fi
+
+#echo '(Unable to guess system type)' 1>&2
+
+exit 1
Index: ossp-pkg/pth/config.sub
RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/config.sub,v
co -q -kk -p'1.4' '/v/ossp/cvs/ossp-pkg/pth/Attic/config.sub,v' | diff -u /dev/null - -L'ossp-pkg/pth/config.sub' 2>/dev/null
--- ossp-pkg/pth/config.sub
+++ -	2024-05-14 08:38:00.841526696 +0200
@@ -0,0 +1,1222 @@
+#! /bin/sh
+# Configuration validation subroutine script, version 1.1.
+#   Copyright (C) 1991, 92-97, 1998, 1999 Free Software Foundation, Inc.
+# This file is (in principle) common to ALL GNU software.
+# The presence of a machine in this file suggests that SOME GNU software
+# can handle that machine.  It does not imply ALL GNU software can.
+#
+# This file is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place - Suite 330,
+# Boston, MA 02111-1307, USA.
+
+# As a special exception to the GNU General Public License, if you
+# distribute this file as part of a program that contains a
+# configuration script generated by Autoconf, you may include it under
+# the same distribution terms that you use for the rest of that program.
+
+# Configuration subroutine to validate and canonicalize a configuration type.
+# Supply the specified configuration type as an argument.
+# If it is invalid, we print an error message on stderr and exit with code 1.
+# Otherwise, we print the canonical config type on stdout and succeed.
+
+# This file is supposed to be the same for all GNU packages
+# and recognize all the CPU types, system types and aliases
+# that are meaningful with *any* GNU software.
+# Each package is responsible for reporting which valid configurations
+# it does not support.  The user should be able to distinguish
+# a failure to support a valid configuration from a meaningless
+# configuration.
+
+# The goal of this file is to map all the various variations of a given
+# machine specification into a single specification in the form:
+#	CPU_TYPE-MANUFACTURER-OPERATING_SYSTEM
+# or in some cases, the newer four-part form:
+#	CPU_TYPE-MANUFACTURER-KERNEL-OPERATING_SYSTEM
+# It is wrong to echo any other type of specification.
+
+if [ x$1 = x ]
+then
+	echo Configuration name missing. 1>&2
+	echo "Usage: $0 CPU-MFR-OPSYS" 1>&2
+	echo "or     $0 ALIAS" 1>&2
+	echo where ALIAS is a recognized configuration type. 1>&2
+	exit 1
+fi
+
+# First pass through any local machine types.
+case $1 in
+	*local*)
+		echo $1
+		exit 0
+		;;
+	*)
+	;;
+esac
+
+# Separate what the user gave into CPU-COMPANY and OS or KERNEL-OS (if any).
+# Here we must recognize all the valid KERNEL-OS combinations.
+maybe_os=`echo $1 | sed 's/^\(.*\)-\([^-]*-[^-]*\)$/\2/'`
+case $maybe_os in
+  linux-gnu*)
+    os=-$maybe_os
+    basic_machine=`echo $1 | sed 's/^\(.*\)-\([^-]*-[^-]*\)$/\1/'`
+    ;;
+  *)
+    basic_machine=`echo $1 | sed 's/-[^-]*$//'`
+    if [ $basic_machine != $1 ]
+    then os=`echo $1 | sed 's/.*-/-/'`
+    else os=; fi
+    ;;
+esac
+
+### Let's recognize common machines as not being operating systems so
+### that things like config.sub decstation-3100 work.  We also
+### recognize some manufacturers as not being operating systems, so we
+### can provide default operating systems below.
+case $os in
+	-sun*os*)
+		# Prevent following clause from handling this invalid input.
+		;;
+	-dec* | -mips* | -sequent* | -encore* | -pc532* | -sgi* | -sony* | \
+	-att* | -7300* | -3300* | -delta* | -motorola* | -sun[234]* | \
+	-unicom* | -ibm* | -next | -hp | -isi* | -apollo | -altos* | \
+	-convergent* | -ncr* | -news | -32* | -3600* | -3100* | -hitachi* |\
+	-c[123]* | -convex* | -sun | -crds | -omron* | -dg | -ultra | -tti* | \
+	-harris | -dolphin | -highlevel | -gould | -cbm | -ns | -masscomp | \
+	-apple)
+		os=
+		basic_machine=$1
+		;;
+	-sim | -cisco | -oki | -wec | -winbond)
+		os=
+		basic_machine=$1
+		;;
+	-scout)
+		;;
+	-wrs)
+		os=vxworks
+		basic_machine=$1
+		;;
+	-hiux*)
+		os=-hiuxwe2
+		;;
+	-sco5)
+		os=-sco3.2v5
+		basic_machine=`echo $1 | sed -e 's/86-.*/86-pc/'`
+		;;
+	-sco4)
+		os=-sco3.2v4
+		basic_machine=`echo $1 | sed -e 's/86-.*/86-pc/'`
+		;;
+	-sco3.2.[4-9]*)
+		os=`echo $os | sed -e 's/sco3.2./sco3.2v/'`
+		basic_machine=`echo $1 | sed -e 's/86-.*/86-pc/'`
+		;;
+	-sco3.2v[4-9]*)
+		# Don't forget version if it is 3.2v4 or newer.
+		basic_machine=`echo $1 | sed -e 's/86-.*/86-pc/'`
+		;;
+	-sco*)
+		os=-sco3.2v2
+		basic_machine=`echo $1 | sed -e 's/86-.*/86-pc/'`
+		;;
+	-udk*)
+		basic_machine=`echo $1 | sed -e 's/86-.*/86-pc/'`
+		;;
+	-isc)
+		os=-isc2.2
+		basic_machine=`echo $1 | sed -e 's/86-.*/86-pc/'`
+		;;
+	-clix*)
+		basic_machine=clipper-intergraph
+		;;
+	-isc*)
+		basic_machine=`echo $1 | sed -e 's/86-.*/86-pc/'`
+		;;
+	-lynx*)
+		os=-lynxos
+		;;
+	-ptx*)
+		basic_machine=`echo $1 | sed -e 's/86-.*/86-sequent/'`
+		;;
+	-windowsnt*)
+		os=`echo $os | sed -e 's/windowsnt/winnt/'`
+		;;
+	-psos*)
+		os=-psos
+		;;
+esac
+
+# Decode aliases for certain CPU-COMPANY combinations.
+case $basic_machine in
+	# Recognize the basic CPU types without company name.
+	# Some are omitted here because they have special meanings below.
+	tahoe | i860 | ia64 | m32r | m68k | m68000 | m88k | ns32k | arc | arm \
+		| arme[lb] | pyramid | mn10200 | mn10300 | tron | a29k \
+		| 580 | i960 | h8300 \
+		| hppa | hppa1.0 | hppa1.1 | hppa2.0 | hppa2.0w | hppa2.0n \
+		| alpha | alphaev[4-7] | alphaev56 | alphapca5[67] \
+		| we32k | ns16k | clipper | i370 | sh | powerpc | powerpcle \
+		| 1750a | dsp16xx | pdp11 | mips16 | mips64 | mipsel | mips64el \
+		| mips64orion | mips64orionel | mipstx39 | mipstx39el \
+		| mips64vr4300 | mips64vr4300el | mips64vr4100 | mips64vr4100el \
+		| mips64vr5000 | miprs64vr5000el | mcore \
+		| sparc | sparclet | sparclite | sparc64 | sparcv9 | v850 | c4x \
+		| thumb | d10v)
+		basic_machine=$basic_machine-unknown
+		;;
+	m88110 | m680[12346]0 | m683?2 | m68360 | m5200 | z8k | v70 | h8500 | w65)
+		;;
+
+	# We use `pc' rather than `unknown'
+	# because (1) that's what they normally are, and
+	# (2) the word "unknown" tends to confuse beginning users.
+	i[34567]86)
+	  basic_machine=$basic_machine-pc
+	  ;;
+	# Object if more than one company name word.
+	*-*-*)
+		echo Invalid configuration \`$1\': machine \`$basic_machine\' not recognized 1>&2
+		exit 1
+		;;
+	# Recognize the basic CPU types with company name.
+	# FIXME: clean up the formatting here.
+	vax-* | tahoe-* | i[34567]86-* | i860-* | ia64-* | m32r-* | m68k-* | m68000-* \
+	      | m88k-* | sparc-* | ns32k-* | fx80-* | arc-* | arm-* | c[123]* \
+	      | mips-* | pyramid-* | tron-* | a29k-* | romp-* | rs6000-* \
+	      | power-* | none-* | 580-* | cray2-* | h8300-* | h8500-* | i960-* \
+	      | xmp-* | ymp-* \
+	      | hppa-* | hppa1.0-* | hppa1.1-* | hppa2.0-* | hppa2.0w-* | hppa2.0n-* \
+	      | alpha-* | alphaev[4-7]-* | alphaev56-* | alphapca5[67]-* \
+	      | we32k-* | cydra-* | ns16k-* | pn-* | np1-* | xps100-* \
+	      | clipper-* | orion-* \
+	      | sparclite-* | pdp11-* | sh-* | powerpc-* | powerpcle-* \
+	      | sparc64-* | sparcv9-* | sparc86x-* | mips16-* | mips64-* | mipsel-* \
+	      | mips64el-* | mips64orion-* | mips64orionel-* \
+	      | mips64vr4100-* | mips64vr4100el-* | mips64vr4300-* | mips64vr4300el-* \
+	      | mipstx39-* | mipstx39el-* | mcore-* \
+	      | f301-* | armv*-* | t3e-* \
+	      | m88110-* | m680[01234]0-* | m683?2-* | m68360-* | z8k-* | d10v-* \
+	      | thumb-* | v850-* | d30v-* | tic30-* | c30-* )
+		;;
+	# Recognize the various machine names and aliases which stand
+	# for a CPU type and a company and sometimes even an OS.
+	386bsd)
+		basic_machine=i386-unknown
+		os=-bsd
+		;;
+	3b1 | 7300 | 7300-att | att-7300 | pc7300 | safari | unixpc)
+		basic_machine=m68000-att
+		;;
+	3b*)
+		basic_machine=we32k-att
+		;;
+	a29khif)
+		basic_machine=a29k-amd
+		os=-udi
+		;;
+	adobe68k)
+		basic_machine=m68010-adobe
+		os=-scout
+		;;
+	alliant | fx80)
+		basic_machine=fx80-alliant
+		;;
+	altos | altos3068)
+		basic_machine=m68k-altos
+		;;
+	am29k)
+		basic_machine=a29k-none
+		os=-bsd
+		;;
+	amdahl)
+		basic_machine=580-amdahl
+		os=-sysv
+		;;
+	amiga | amiga-*)
+		basic_machine=m68k-cbm
+		;;
+	amigaos | amigados)
+		basic_machine=m68k-cbm
+		os=-amigaos
+		;;
+	amigaunix | amix)
+		basic_machine=m68k-cbm
+		os=-sysv4
+		;;
+	apollo68)
+		basic_machine=m68k-apollo
+		os=-sysv
+		;;
+	apollo68bsd)
+		basic_machine=m68k-apollo
+		os=-bsd
+		;;
+	aux)
+		basic_machine=m68k-apple
+		os=-aux
+		;;
+	balance)
+		basic_machine=ns32k-sequent
+		os=-dynix
+		;;
+	convex-c1)
+		basic_machine=c1-convex
+		os=-bsd
+		;;
+	convex-c2)
+		basic_machine=c2-convex
+		os=-bsd
+		;;
+	convex-c32)
+		basic_machine=c32-convex
+		os=-bsd
+		;;
+	convex-c34)
+		basic_machine=c34-convex
+		os=-bsd
+		;;
+	convex-c38)
+		basic_machine=c38-convex
+		os=-bsd
+		;;
+	cray | ymp)
+		basic_machine=ymp-cray
+		os=-unicos
+		;;
+	cray2)
+		basic_machine=cray2-cray
+		os=-unicos
+		;;
+	[ctj]90-cray)
+		basic_machine=c90-cray
+		os=-unicos
+		;;
+	crds | unos)
+		basic_machine=m68k-crds
+		;;
+	da30 | da30-*)
+		basic_machine=m68k-da30
+		;;
+	decstation | decstation-3100 | pmax | pmax-* | pmin | dec3100 | decstatn)
+		basic_machine=mips-dec
+		;;
+	delta | 3300 | motorola-3300 | motorola-delta \
+	      | 3300-motorola | delta-motorola)
+		basic_machine=m68k-motorola
+		;;
+	delta88)
+		basic_machine=m88k-motorola
+		os=-sysv3
+		;;
+	dpx20 | dpx20-*)
+		basic_machine=rs6000-bull
+		os=-bosx
+		;;
+	dpx2* | dpx2*-bull)
+		basic_machine=m68k-bull
+		os=-sysv3
+		;;
+	ebmon29k)
+		basic_machine=a29k-amd
+		os=-ebmon
+		;;
+	elxsi)
+		basic_machine=elxsi-elxsi
+		os=-bsd
+		;;
+	encore | umax | mmax)
+		basic_machine=ns32k-encore
+		;;
+	es1800 | OSE68k | ose68k | ose | OSE)
+		basic_machine=m68k-ericsson
+		os=-ose
+		;;
+	fx2800)
+		basic_machine=i860-alliant
+		;;
+	genix)
+		basic_machine=ns32k-ns
+		;;
+	gmicro)
+		basic_machine=tron-gmicro
+		os=-sysv
+		;;
+	h3050r* | hiux*)
+		basic_machine=hppa1.1-hitachi
+		os=-hiuxwe2
+		;;
+	h8300hms)
+		basic_machine=h8300-hitachi
+		os=-hms
+		;;
+	h8300xray)
+		basic_machine=h8300-hitachi
+		os=-xray
+		;;
+	h8500hms)
+		basic_machine=h8500-hitachi
+		os=-hms
+		;;
+	harris)
+		basic_machine=m88k-harris
+		os=-sysv3
+		;;
+	hp300-*)
+		basic_machine=m68k-hp
+		;;
+	hp300bsd)
+		basic_machine=m68k-hp
+		os=-bsd
+		;;
+	hp300hpux)
+		basic_machine=m68k-hp
+		os=-hpux
+		;;
+	hp3k9[0-9][0-9] | hp9[0-9][0-9])
+		basic_machine=hppa1.0-hp
+		;;
+	hp9k2[0-9][0-9] | hp9k31[0-9])
+		basic_machine=m68000-hp
+		;;
+	hp9k3[2-9][0-9])
+		basic_machine=m68k-hp
+		;;
+	hp9k6[0-9][0-9] | hp6[0-9][0-9])
+		basic_machine=hppa1.0-hp
+		;;
+	hp9k7[0-79][0-9] | hp7[0-79][0-9])
+		basic_machine=hppa1.1-hp
+		;;
+	hp9k78[0-9] | hp78[0-9])
+		# FIXME: really hppa2.0-hp
+		basic_machine=hppa1.1-hp
+		;;
+	hp9k8[67]1 | hp8[67]1 | hp9k80[24] | hp80[24] | hp9k8[78]9 | hp8[78]9 | hp9k893 | hp893)
+		# FIXME: really hppa2.0-hp
+		basic_machine=hppa1.1-hp
+		;;
+	hp9k8[0-9][13679] | hp8[0-9][13679])
+		basic_machine=hppa1.1-hp
+		;;
+	hp9k8[0-9][0-9] | hp8[0-9][0-9])
+		basic_machine=hppa1.0-hp
+		;;
+	hppa-next)
+		os=-nextstep3
+		;;
+	hppaosf)
+		basic_machine=hppa1.1-hp
+		os=-osf
+		;;
+	hppro)
+		basic_machine=hppa1.1-hp
+		os=-proelf
+		;;
+	i370-ibm* | ibm*)
+		basic_machine=i370-ibm
+		os=-mvs
+		;;
+# I'm not sure what "Sysv32" means.  Should this be sysv3.2?
+	i[34567]86v32)
+		basic_machine=`echo $1 | sed -e 's/86.*/86-pc/'`
+		os=-sysv32
+		;;
+	i[34567]86v4*)
+		basic_machine=`echo $1 | sed -e 's/86.*/86-pc/'`
+		os=-sysv4
+		;;
+	i[34567]86v)
+		basic_machine=`echo $1 | sed -e 's/86.*/86-pc/'`
+		os=-sysv
+		;;
+	i[34567]86sol2)
+		basic_machine=`echo $1 | sed -e 's/86.*/86-pc/'`
+		os=-solaris2
+		;;
+	i386mach)
+		basic_machine=i386-mach
+		os=-mach
+		;;
+	i386-vsta | vsta)
+		basic_machine=i386-unknown
+		os=-vsta
+		;;
+	i386-go32 | go32)
+		basic_machine=i386-unknown
+		os=-go32
+		;;
+	i386-mingw32 | mingw32)
+		basic_machine=i386-unknown
+		os=-mingw32
+		;;
+	iris | iris4d)
+		basic_machine=mips-sgi
+		case $os in
+		    -irix*)
+			;;
+		    *)
+			os=-irix4
+			;;
+		esac
+		;;
+	isi68 | isi)
+		basic_machine=m68k-isi
+		os=-sysv
+		;;
+	m88k-omron*)
+		basic_machine=m88k-omron
+		;;
+	magnum | m3230)
+		basic_machine=mips-mips
+		os=-sysv
+		;;
+	merlin)
+		basic_machine=ns32k-utek
+		os=-sysv
+		;;
+	miniframe)
+		basic_machine=m68000-convergent
+		;;
+	*mint | *MiNT)
+		basic_machine=m68k-atari
+		os=-mint
+		;;
+	mipsel*-linux*)
+		basic_machine=mipsel-unknown
+		os=-linux-gnu
+		;;
+	mips*-linux*)
+		basic_machine=mips-unknown
+		os=-linux-gnu
+		;;
+	mips3*-*)
+		basic_machine=`echo $basic_machine | sed -e 's/mips3/mips64/'`
+		;;
+	mips3*)
+		basic_machine=`echo $basic_machine | sed -e 's/mips3/mips64/'`-unknown
+		;;
+	monitor)
+		basic_machine=m68k-rom68k
+		os=-coff
+		;;
+	msdos)
+		basic_machine=i386-unknown
+		os=-msdos
+		;;
+	ncr3000)
+		basic_machine=i486-ncr
+		os=-sysv4
+		;;
+	netbsd386)
+		basic_machine=i386-unknown
+		os=-netbsd
+		;;
+	netwinder)
+		basic_machine=armv4l-corel
+		os=-linux
+		;;
+	news | news700 | news800 | news900)
+		basic_machine=m68k-sony
+		os=-newsos
+		;;
+	news1000)
+		basic_machine=m68030-sony
+		os=-newsos
+		;;
+	news-3600 | risc-news)
+		basic_machine=mips-sony
+		os=-newsos
+		;;
+	necv70)
+		basic_machine=v70-nec
+		os=-sysv
+		;;
+	next | m*-next )
+		basic_machine=m68k-next
+		case $os in
+		    -nextstep* )
+			;;
+		    -ns2*)
+		      os=-nextstep2
+			;;
+		    *)
+		      os=-nextstep3
+			;;
+		esac
+		;;
+	nh3000)
+		basic_machine=m68k-harris
+		os=-cxux
+		;;
+	nh[45]000)
+		basic_machine=m88k-harris
+		os=-cxux
+		;;
+	nindy960)
+		basic_machine=i960-intel
+		os=-nindy
+		;;
+	mon960)
+		basic_machine=i960-intel
+		os=-mon960
+		;;
+	np1)
+		basic_machine=np1-gould
+		;;
+	op50n-* | op60c-*)
+		basic_machine=hppa1.1-oki
+		os=-proelf
+		;;
+	OSE68000 | ose68000)
+		basic_machine=m68000-ericsson
+		os=-ose
+		;;
+	os68k)
+		basic_machine=m68k-none
+		os=-os68k
+		;;
+	pa-hitachi)
+		basic_machine=hppa1.1-hitachi
+		os=-hiuxwe2
+		;;
+	paragon)
+		basic_machine=i860-intel
+		os=-osf
+		;;
+	pbd)
+		basic_machine=sparc-tti
+		;;
+	pbb)
+		basic_machine=m68k-tti
+		;;
+        pc532 | pc532-*)
+		basic_machine=ns32k-pc532
+		;;
+	pentium | p5 | k5 | k6 | nexen)
+		basic_machine=i586-pc
+		;;
+	pentiumpro | p6 | 6x86)
+		basic_machine=i686-pc
+		;;
+	pentiumii | pentium2)
+		basic_machine=i786-pc
+		;;
+	pentium-* | p5-* | k5-* | k6-* | nexen-*)
+		basic_machine=i586-`echo $basic_machine | sed 's/^[^-]*-//'`
+		;;
+	pentiumpro-* | p6-* | 6x86-*)
+		basic_machine=i686-`echo $basic_machine | sed 's/^[^-]*-//'`
+		;;
+	pentiumii-* | pentium2-*)
+		basic_machine=i786-`echo $basic_machine | sed 's/^[^-]*-//'`
+		;;
+	pn)
+		basic_machine=pn-gould
+		;;
+	power)	basic_machine=rs6000-ibm
+		;;
+	ppc)	basic_machine=powerpc-unknown
+	        ;;
+	ppc-*)	basic_machine=powerpc-`echo $basic_machine | sed 's/^[^-]*-//'`
+		;;
+	ppcle | powerpclittle | ppc-le | powerpc-little)
+		basic_machine=powerpcle-unknown
+	        ;;
+	ppcle-* | powerpclittle-*)
+		basic_machine=powerpcle-`echo $basic_machine | sed 's/^[^-]*-//'`
+		;;
+	ps2)
+		basic_machine=i386-ibm
+		;;
+	rom68k)
+		basic_machine=m68k-rom68k
+		os=-coff
+		;;
+	rm[46]00)
+		basic_machine=mips-siemens
+		;;
+	rtpc | rtpc-*)
+		basic_machine=romp-ibm
+		;;
+	sa29200)
+		basic_machine=a29k-amd
+		os=-udi
+		;;
+	sequent)
+		basic_machine=i386-sequent
+		;;
+	sh)
+		basic_machine=sh-hitachi
+		os=-hms
+		;;
+	sparclite-wrs)
+		basic_machine=sparclite-wrs
+		os=-vxworks
+		;;
+	sps7)
+		basic_machine=m68k-bull
+		os=-sysv2
+		;;
+	spur)
+		basic_machine=spur-unknown
+		;;
+	st2000)
+		basic_machine=m68k-tandem
+		;;
+	stratus)
+		basic_machine=i860-stratus
+		os=-sysv4
+		;;
+	sun2)
+		basic_machine=m68000-sun
+		;;
+	sun2os3)
+		basic_machine=m68000-sun
+		os=-sunos3
+		;;
+	sun2os4)
+		basic_machine=m68000-sun
+		os=-sunos4
+		;;
+	sun3os3)
+		basic_machine=m68k-sun
+		os=-sunos3
+		;;
+	sun3os4)
+		basic_machine=m68k-sun
+		os=-sunos4
+		;;
+	sun4os3)
+		basic_machine=sparc-sun
+		os=-sunos3
+		;;
+	sun4os4)
+		basic_machine=sparc-sun
+		os=-sunos4
+		;;
+	sun4sol2)
+		basic_machine=sparc-sun
+		os=-solaris2
+		;;
+	sun3 | sun3-*)
+		basic_machine=m68k-sun
+		;;
+	sun4)
+		basic_machine=sparc-sun
+		;;
+	sun386 | sun386i | roadrunner)
+		basic_machine=i386-sun
+		;;
+	symmetry)
+		basic_machine=i386-sequent
+		os=-dynix
+		;;
+	s390*)
+		basic_machine=s390-ibm
+		;;
+	t3e)
+		basic_machine=t3e-cray
+		os=-unicos
+		;;
+	tx39)
+		basic_machine=mipstx39-unknown
+		;;
+	tx39el)
+		basic_machine=mipstx39el-unknown
+		;;
+	tower | tower-32)
+		basic_machine=m68k-ncr
+		;;
+	udi29k)
+		basic_machine=a29k-amd
+		os=-udi
+		;;
+	ultra3)
+		basic_machine=a29k-nyu
+		os=-sym1
+		;;
+	v810 | necv810)
+		basic_machine=v810-nec
+		os=-none
+		;;
+	vaxv)
+		basic_machine=vax-dec
+		os=-sysv
+		;;
+	vms)
+		basic_machine=vax-dec
+		os=-vms
+		;;
+	vpp*|vx|vx-*)
+               basic_machine=f301-fujitsu
+               ;;
+	vxworks960)
+		basic_machine=i960-wrs
+		os=-vxworks
+		;;
+	vxworks68)
+		basic_machine=m68k-wrs
+		os=-vxworks
+		;;
+	vxworks29k)
+		basic_machine=a29k-wrs
+		os=-vxworks
+		;;
+	w65*)
+		basic_machine=w65-wdc
+		os=-none
+		;;
+	w89k-*)
+		basic_machine=hppa1.1-winbond
+		os=-proelf
+		;;
+	xmp)
+		basic_machine=xmp-cray
+		os=-unicos
+		;;
+        xps | xps100)
+		basic_machine=xps100-honeywell
+		;;
+	z8k-*-coff)
+		basic_machine=z8k-unknown
+		os=-sim
+		;;
+	none)
+		basic_machine=none-none
+		os=-none
+		;;
+
+# Here we handle the default manufacturer of certain CPU types.  It is in
+# some cases the only manufacturer, in others, it is the most popular.
+	w89k)
+		basic_machine=hppa1.1-winbond
+		;;
+	op50n)
+		basic_machine=hppa1.1-oki
+		;;
+	op60c)
+		basic_machine=hppa1.1-oki
+		;;
+	mips)
+		if [ x$os = x-linux-gnu ]; then
+			basic_machine=mips-unknown
+		else
+			basic_machine=mips-mips
+		fi
+		;;
+	romp)
+		basic_machine=romp-ibm
+		;;
+	rs6000)
+		basic_machine=rs6000-ibm
+		;;
+	vax)
+		basic_machine=vax-dec
+		;;
+	pdp11)
+		basic_machine=pdp11-dec
+		;;
+	we32k)
+		basic_machine=we32k-att
+		;;
+	sparc | sparcv9)
+		basic_machine=sparc-sun
+		;;
+        cydra)
+		basic_machine=cydra-cydrome
+		;;
+	orion)
+		basic_machine=orion-highlevel
+		;;
+	orion105)
+		basic_machine=clipper-highlevel
+		;;
+	mac | mpw | mac-mpw)
+		basic_machine=m68k-apple
+		;;
+	pmac | pmac-mpw)
+		basic_machine=powerpc-apple
+		;;
+	c4x*)
+		basic_machine=c4x-none
+		os=-coff
+		;;
+	BS2000-siemens)
+		;;
+	*)
+		echo Invalid configuration \`$1\': machine \`$basic_machine\' not recognized 1>&2
+		exit 1
+		;;
+esac
+
+# Here we canonicalize certain aliases for manufacturers.
+case $basic_machine in
+	*-digital*)
+		basic_machine=`echo $basic_machine | sed 's/digital.*/dec/'`
+		;;
+	*-commodore*)
+		basic_machine=`echo $basic_machine | sed 's/commodore.*/cbm/'`
+		;;
+	*)
+		;;
+esac
+
+# Decode manufacturer-specific aliases for certain operating systems.
+
+if [ x"$os" != x"" ]
+then
+case $os in
+        # First match some system type aliases
+        # that might get confused with valid system types.
+	# -solaris* is a basic system type, with this one exception.
+	-solaris1 | -solaris1.*)
+		os=`echo $os | sed -e 's|solaris1|sunos4|'`
+		;;
+	-solaris)
+		os=-solaris2
+		;;
+	-svr4*)
+		os=-sysv4
+		;;
+	-unixware*)
+		os=-sysv4.2uw
+		;;
+	-gnu/linux*)
+		os=`echo $os | sed -e 's|gnu/linux|linux-gnu|'`
+		;;
+	# First accept the basic system types.
+	# The portable systems comes first.
+	# Each alternative MUST END IN A *, to match a version number.
+	# -sysv* is not here because it comes later, after sysvr4.
+	-gnu* | -bsd* | -mach* | -minix* | -genix* | -ultrix* | -irix* \
+	      | -*vms* | -sco* | -esix* | -isc* | -aix* | -sunos | -sunos[34]*\
+	      | -hpux* | -unos* | -osf* | -luna* | -dgux* | -solaris* | -sym* \
+	      | -amigaos* | -amigados* | -msdos* | -newsos* | -unicos* | -aof* \
+	      | -aos* \
+	      | -nindy* | -vxsim* | -vxworks* | -ebmon* | -hms* | -mvs* \
+	      | -clix* | -riscos* | -uniplus* | -iris* | -rtu* | -xenix* \
+	      | -hiux* | -386bsd* | -netbsd* | -openbsd* | -freebsd* | -riscix* \
+	      | -lynxos* | -bosx* | -nextstep* | -cxux* | -aout* | -elf* | -oabi* \
+	      | -ptx* | -coff* | -ecoff* | -winnt* | -domain* | -vsta* \
+	      | -udi* | -eabi* | -lites* | -ieee* | -go32* | -aux* \
+	      | -cygwin* | -pe* | -psos* | -moss* | -proelf* | -rtems* \
+	      | -mingw32* | -linux-gnu* | -uxpv* | -beos* | -mpeix* | -udk* \
+	      | -interix* | -uwin* | -rhapsody* | -openstep* | -oskit*)
+	# Remember, each alternative MUST END IN *, to match a version number.
+		;;
+	-sim | -es1800* | -hms* | -xray | -os68k* | -none* | -v88r* \
+	      | -windows* | -osx | -abug | -netware* | -os9* | -beos* \
+	      | -macos* | -mpw* | -magic* | -mon960* | -lnews*)
+		;;
+	-mac*)
+		os=`echo $os | sed -e 's|mac|macos|'`
+		;;
+	-linux*)
+		os=`echo $os | sed -e 's|linux|linux-gnu|'`
+		;;
+	-sunos5*)
+		os=`echo $os | sed -e 's|sunos5|solaris2|'`
+		;;
+	-sunos6*)
+		os=`echo $os | sed -e 's|sunos6|solaris3|'`
+		;;
+	-osfrose*)
+		os=-osfrose
+		;;
+	-osf*)
+		os=-osf
+		;;
+	-utek*)
+		os=-bsd
+		;;
+	-dynix*)
+		os=-bsd
+		;;
+	-acis*)
+		os=-aos
+		;;
+	-386bsd)
+		os=-bsd
+		;;
+	-ctix* | -uts*)
+		os=-sysv
+		;;
+	-ns2 )
+	        os=-nextstep2
+		;;
+	# Preserve the version number of sinix5.
+	-sinix5.*)
+		os=`echo $os | sed -e 's|sinix|sysv|'`
+		;;
+	-sinix*)
+		os=-sysv4
+		;;
+	-triton*)
+		os=-sysv3
+		;;
+	-oss*)
+		os=-sysv3
+		;;
+	-svr4)
+		os=-sysv4
+		;;
+	-svr3)
+		os=-sysv3
+		;;
+	-sysvr4)
+		os=-sysv4
+		;;
+	# This must come after -sysvr4.
+	-sysv*)
+		;;
+	-ose*)
+		os=-ose
+		;;
+	-es1800*)
+		os=-ose
+		;;
+	-xenix)
+		os=-xenix
+		;;
+        -*mint | -*MiNT)
+	        os=-mint
+		;;
+	-none)
+		;;
+	*)
+		# Get rid of the `-' at the beginning of $os.
+		os=`echo $os | sed 's/[^-]*-//'`
+		echo Invalid configuration \`$1\': system \`$os\' not recognized 1>&2
+		exit 1
+		;;
+esac
+else
+
+# Here we handle the default operating systems that come with various machines.
+# The value should be what the vendor currently ships out the door with their
+# machine or put another way, the most popular os provided with the machine.
+
+# Note that if you're going to try to match "-MANUFACTURER" here (say,
+# "-sun"), then you have to tell the case statement up towards the top
+# that MANUFACTURER isn't an operating system.  Otherwise, code above
+# will signal an error saying that MANUFACTURER isn't an operating
+# system, and we'll never get to this point.
+
+case $basic_machine in
+	*-acorn)
+		os=-riscix1.2
+		;;
+	arm*-corel)
+		os=-linux
+		;;
+	arm*-semi)
+		os=-aout
+		;;
+        pdp11-*)
+		os=-none
+		;;
+	*-dec | vax-*)
+		os=-ultrix4.2
+		;;
+	m68*-apollo)
+		os=-domain
+		;;
+	i386-sun)
+		os=-sunos4.0.2
+		;;
+	m68000-sun)
+		os=-sunos3
+		# This also exists in the configure program, but was not the
+		# default.
+		# os=-sunos4
+		;;
+	m68*-cisco)
+		os=-aout
+		;;
+	mips*-cisco)
+		os=-elf
+		;;
+	mips*-*)
+		os=-elf
+		;;
+	*-tti)	# must be before sparc entry or we get the wrong os.
+		os=-sysv3
+		;;
+	sparc-* | *-sun)
+		os=-sunos4.1.1
+		;;
+	*-be)
+		os=-beos
+		;;
+	*-ibm)
+		os=-aix
+		;;
+	*-wec)
+		os=-proelf
+		;;
+	*-winbond)
+		os=-proelf
+		;;
+	*-oki)
+		os=-proelf
+		;;
+	*-hp)
+		os=-hpux
+		;;
+	*-hitachi)
+		os=-hiux
+		;;
+	i860-* | *-att | *-ncr | *-altos | *-motorola | *-convergent)
+		os=-sysv
+		;;
+	*-cbm)
+		os=-amigaos
+		;;
+	*-dg)
+		os=-dgux
+		;;
+	*-dolphin)
+		os=-sysv3
+		;;
+	m68k-ccur)
+		os=-rtu
+		;;
+	m88k-omron*)
+		os=-luna
+		;;
+	*-next )
+		os=-nextstep
+		;;
+	*-sequent)
+		os=-ptx
+		;;
+	*-crds)
+		os=-unos
+		;;
+	*-ns)
+		os=-genix
+		;;
+	i370-*)
+		os=-mvs
+		;;
+	*-next)
+		os=-nextstep3
+		;;
+        *-gould)
+		os=-sysv
+		;;
+        *-highlevel)
+		os=-bsd
+		;;
+	*-encore)
+		os=-bsd
+		;;
+        *-sgi)
+		os=-irix
+		;;
+        *-siemens)
+		os=-sysv4
+		;;
+	*-masscomp)
+		os=-rtu
+		;;
+	f301-fujitsu)
+		os=-uxpv
+		;;
+	*-rom68k)
+		os=-coff
+		;;
+	*-*bug)
+		os=-coff
+		;;
+	*-apple)
+		os=-macos
+		;;
+	*-atari*)
+		os=-mint
+		;;
+	*)
+		os=-none
+		;;
+esac
+fi
+
+# Here we handle the case where we know the os, and the CPU type, but not the
+# manufacturer.  We pick the logical manufacturer.
+vendor=unknown
+case $basic_machine in
+	*-unknown)
+		case $os in
+			-riscix*)
+				vendor=acorn
+				;;
+			-sunos*)
+				vendor=sun
+				;;
+			-aix*)
+				vendor=ibm
+				;;
+			-beos*)
+				vendor=be
+				;;
+			-hpux*)
+				vendor=hp
+				;;
+			-mpeix*)
+				vendor=hp
+				;;
+			-hiux*)
+				vendor=hitachi
+				;;
+			-unos*)
+				vendor=crds
+				;;
+			-dgux*)
+				vendor=dg
+				;;
+			-luna*)
+				vendor=omron
+				;;
+			-genix*)
+				vendor=ns
+				;;
+			-mvs*)
+				vendor=ibm
+				;;
+			-ptx*)
+				vendor=sequent
+				;;
+			-vxsim* | -vxworks*)
+				vendor=wrs
+				;;
+			-aux*)
+				vendor=apple
+				;;
+			-hms*)
+				vendor=hitachi
+				;;
+			-mpw* | -macos*)
+				vendor=apple
+				;;
+			-*mint | -*MiNT)
+				vendor=atari
+				;;
+		esac
+		basic_machine=`echo $basic_machine | sed "s/unknown/$vendor/"`
+		;;
+esac
+
+echo $basic_machine$os
+exit 0
Index: ossp-pkg/pth/configure.ac
RCS File: /v/ossp/cvs/ossp-pkg/pth/configure.ac,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/pth/configure.ac,v' | diff -u /dev/null - -L'ossp-pkg/pth/configure.ac' 2>/dev/null
--- ossp-pkg/pth/configure.ac
+++ -	2024-05-14 08:38:00.845505343 +0200
@@ -0,0 +1,612 @@
+dnl ##
+dnl ##  GNU Pth - The GNU Portable Threads
+dnl ##  Copyright (c) 1999-2002 Ralf S. Engelschall <rse@engelschall.com>
+dnl ##
+dnl ##  This file is part of GNU Pth, a non-preemptive thread scheduling
+dnl ##  library which can be found at http://www.gnu.org/software/pth/.
+dnl ##
+dnl ##  This library is free software; you can redistribute it and/or
+dnl ##  modify it under the terms of the GNU Lesser General Public
+dnl ##  License as published by the Free Software Foundation; either
+dnl ##  version 2.1 of the License, or (at your option) any later version.
+dnl ##
+dnl ##  This library is distributed in the hope that it will be useful,
+dnl ##  but WITHOUT ANY WARRANTY; without even the implied warranty of
+dnl ##  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+dnl ##  Lesser General Public License for more details.
+dnl ##
+dnl ##  You should have received a copy of the GNU Lesser General Public
+dnl ##  License along with this library; if not, write to the Free Software
+dnl ##  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+dnl ##  USA, or contact Ralf S. Engelschall <rse@engelschall.com>.
+dnl ##
+dnl ##  configure.ac: Pth Autoconf specification
+dnl ##
+
+dnl #                              ``Programming in Bourne-Shell
+dnl #                                is a higher form of masochism.''
+dnl #                                           -- Unknown
+
+dnl ##
+dnl ##  PROLOG
+dnl ##
+
+dnl #   standard Autoconf prolog
+AC_PREREQ(2.52)dnl
+AC_REVISION([1.0])
+
+dnl #   autoconf initialization
+AC_INIT(README)
+AC_ENABLESUBDIR
+AC_SRCDIR_PREFIX(srcdir_prefix)
+AC_HEADLINE(dnl
+GNU Pth, Portable Threads, dnl
+PTH_VERSION, pth_vers.c, dnl
+[Copyright (c) 1999-2002 Ralf S. Engelschall <rse@engelschall.com>])
+AC_CONFIG_PARAM(config.param)
+AC_CONFIG_HEADER(pth_acdef.h)dnl
+AC_PREFIX_DEFAULT(/usr/local)
+AC_PLATFORM(PLATFORM)
+
+dnl ##
+dnl ##  BUILD TOOLS
+dnl ##
+
+AC_MSG_PART(Build Tools)
+
+AC_PROG_CC
+AC_PROG_CPP
+AC_SET_MAKE
+AC_CHECK_DEBUGGING
+AC_CHECK_PROFILING
+AC_CHECK_OPTIMIZE
+if test -f "$srcdir/ltmain.sh"; then
+    case "$PLATFORM" in
+        #   Solaris 2.7/x86 is slightly broken
+        *-pc-solaris2.[[78]] [)] enable_shared=no ;;
+    esac
+    sinclude(libtool.m4)
+    AC_PROG_LIBTOOL
+else
+    dnl # only for stripped down Pth source tree
+    AC_CHECK_PROG(AR, ar, ar)
+    AC_PROG_RANLIB
+fi
+
+dnl ##  Support for some special platform/compiler options
+case "$PLATFORM:$CC" in
+    *-sun-solaris2*:cc )
+        #   shut-up harmless warnings caused by do-while macros on Solaris
+        test ".$ac_cv_prog_gcc" = ".no" && CFLAGS="$CFLAGS -w"
+        ;;
+    *-*-sysv*uw[[27]]*:cc )
+        #   shut-up harmless warnings caused by do-while macros on UnixWare
+        CFLAGS="$CFLAGS -w"
+        ;;
+    *-hp-hpux*:cc )
+        #   HPUX needs a few special options to find its ANSI C brain
+        CFLAGS="$CFLAGS -Ae -O"
+        ;;
+    *-hp-hpux*:CC )
+        #   HPUX outputs useless warnings
+        CFLAGS="$CFLAGS -w"
+        ;;
+    *-sgi-irix6.2:cc )
+        #   shut-up warnings caused by IRIX brain-dead 32/64 bit stuff
+        LDFLAGS="$LDFLAGS -woff 85 -Wl,-woff,84 -Wl,-woff,85"
+        ;;
+    *-sgi-irix6.5.[[2-9]]:cc )
+        #   since IRIX 6.5.2 the C compiler is smart enough,
+        #   but the linker is still complaining, of course
+        LDFLAGS="$LDFLAGS -woff 84,85,134"
+        ;;
+    *-sgi-irix6.5:cc )
+        #   shut-up warnings caused by IRIX brain-dead 32/64 bit stuff
+        CFLAGS="$CFLAGS -woff 1110,1048"
+        LDFLAGS="$LDFLAGS -woff 84,85,134"
+        ;;
+    *-dec-osf4*:cc )
+        #   make sure the standard compliant functions are used on Tru64/OSF1 4.x
+        CFLAGS="$CFLAGS -std"
+        ;;
+    *-dec-osf5*:cc )
+        #   make sure the standard compliant functions are used on Tru64/OSF1 5.x
+        CFLAGS="$CFLAGS -std -D_XOPEN_SOURCE_EXTENDED"
+        ;;
+    *-*-isc*:* )
+        #   ISC is brain-dead and needs a bunch of options to find its brain
+        CPPFLAGS="$CPPFLAGS -D_POSIX_SOURCE";
+        LIBS="$LIBS -lcposix -linet";
+        ;;
+esac
+
+dnl ##
+dnl ##   MANDATORY PLATFORM ENVIRONMENT
+dnl ##
+
+AC_MSG_PART(Mandatory Platform Environment)
+
+dnl # check for standard headers
+AC_HEADER_STDC
+AC_HAVE_HEADERS(dnl
+   stdio.h stdlib.h stdarg.h string.h signal.h unistd.h setjmp.h fcntl.h dnl
+   errno.h sys/types.h sys/time.h sys/wait.h sys/stat.h sys/socket.h)
+AC_CHECK_FUNCS(dnl
+   gettimeofday select sigaction sigprocmask sigpending sigsuspend)
+AC_BEGIN_DECISION([mandatory system headers and functions])
+AC_IFALLYES(dnl
+   header:stdio.h header:stdlib.h header:stdarg.h header:string.h dnl
+   header:signal.h header:unistd.h header:setjmp.h header:fcntl.h header:errno.h dnl
+   header:sys/types.h header:sys/time.h header:sys/wait.h header:sys/stat.h header:sys/socket.h dnl
+   func:gettimeofday func:select func:sigaction func:sigprocmask dnl
+   func:sigpending func:sigsuspend,
+   AC_DECIDE(fine, [all fine]))
+AC_END_DECISION
+
+
+dnl ##
+dnl ##  OPTIONAL PLATFORM ENVIRONMENT
+dnl ##
+
+AC_MSG_PART(Optional Platform Environment)
+
+dnl #  check for the number of signals
+AC_CHECK_NSIG(PTH_NSIG)
+
+dnl # check whether poll(2)'s input stuff has to be faked
+AC_CHECK_FUNCS(poll)
+AC_CHECK_DEFINE(POLLIN, poll.h)
+AC_MSG_CHECKING(whether poll(2) facility has to be faked)
+AC_IFALLYES(func:poll define:POLLIN, PTH_FAKE_POLL=0, PTH_FAKE_POLL=1)
+if test .$PTH_FAKE_POLL = .1; then
+    msg="yes"
+else
+    msg="no"
+fi
+AC_SUBST(PTH_FAKE_POLL)
+AC_MSG_RESULT([$msg])
+
+dnl # check for readv/writev environment
+AC_HAVE_HEADERS(sys/uio.h)
+AC_CHECK_FUNCS(readv writev)
+AC_MSG_CHECKING(whether readv(2)/writev(2) facility has to be faked)
+AC_IFALLYES(func:readv func:writev header:sys/uio.h, PTH_FAKE_RWV=0, PTH_FAKE_RWV=1)
+if test .$PTH_FAKE_RWV = .1; then
+    msg="yes"
+else
+    msg="no"
+fi
+AC_SUBST(PTH_FAKE_RWV)
+AC_MSG_RESULT([$msg])
+
+dnl # check for various other functions which would be nice to have
+AC_CHECK_FUNCS(usleep strerror)
+
+dnl # check for various other headers which we might need
+AC_HAVE_HEADERS(sys/resource.h net/errno.h paths.h)
+
+dnl # at least the test programs need some socket stuff
+AC_CHECK_LIB(nsl, gethostname)
+if test ".`echo $LIBS | grep nsl`" = . ;then
+    AC_CHECK_LIB(nsl, gethostbyname)
+fi
+AC_CHECK_LIB(socket, accept)
+
+dnl # check whether we've to use a non-standard #include <sys/select.h>  to get
+dnl # the definition for fd_set under AIX and other brain-dead platforms.
+AC_HAVE_HEADERS(sys/select.h)
+EXTRA_INCLUDE_SYS_SELECT_H="#include <sys/select.h>"
+if test ".$ac_cv_header_sys_select_h" != .yes; then
+    EXTRA_INCLUDE_SYS_SELECT_H="/* $EXTRA_INCLUDE_SYS_SELECT_H */"
+fi
+AC_SUBST(EXTRA_INCLUDE_SYS_SELECT_H)
+
+dnl # check whether we've to define sig_atomic_t
+AC_CHECK_TYPEDEF(sig_atomic_t, signal.h)
+FALLBACK_SIG_ATOMIC_T="typedef int sig_atomic_t;"
+if test ".$ac_cv_typedef_sig_atomic_t" = .yes; then
+    FALLBACK_SIG_ATOMIC_T="/* $FALLBACK_SIG_ATOMIC_T */"
+fi
+AC_SUBST(FALLBACK_SIG_ATOMIC_T)
+
+dnl # check whether we've to define pid_t
+AC_CHECK_TYPEDEF(pid_t, sys/types.h)
+FALLBACK_PID_T="typedef int pid_t;"
+if test ".$ac_cv_typedef_pid_t" = .yes; then
+    FALLBACK_PID_T="/* $FALLBACK_PID_T */"
+fi
+AC_SUBST(FALLBACK_PID_T)
+
+dnl # check whether we've to define size_t
+AC_CHECK_TYPEDEF(size_t, stdlib.h)
+FALLBACK_SIZE_T="typedef unsigned int size_t;"
+if test ".$ac_cv_typedef_size_t" = .yes; then
+    FALLBACK_SIZE_T="/* $FALLBACK_SIZE_T */"
+fi
+AC_SUBST(FALLBACK_SIZE_T)
+
+dnl # check whether we've to define ssize_t
+AC_CHECK_TYPEDEF(ssize_t, sys/types.h)
+FALLBACK_SSIZE_T="typedef unsigned int ssize_t;"
+if test ".$ac_cv_typedef_ssize_t" = .yes; then
+    FALLBACK_SSIZE_T="/* $FALLBACK_SSIZE_T */"
+fi
+AC_SUBST(FALLBACK_SSIZE_T)
+
+dnl # check whether we've to define off_t
+AC_CHECK_TYPEDEF(off_t, sys/types.h)
+FALLBACK_OFF_T="typedef int off_t;"
+if test ".$ac_cv_typedef_off_t" = .yes; then
+    FALLBACK_OFF_T="/* $FALLBACK_OFF_T */"
+fi
+AC_SUBST(FALLBACK_OFF_T)
+
+dnl # check whether stack_t exists instead of sigaltstack
+AC_CHECK_TYPEDEF(stack_t, signal.h)
+
+dnl # check whether ss_base instead of ss_sp attribute exists
+AC_CHECK_STRUCTATTR(ss_base, sigaltstack, sys/signal.h)
+AC_CHECK_STRUCTATTR(ss_sp,   sigaltstack, sys/signal.h)
+
+dnl # check for gettimeofday() variant
+AC_MSG_CHECKING(for a single-argument based gettimeofday)
+cross_compile=no
+AC_TRY_COMPILE([
+#include <sys/types.h>
+#include <sys/time.h>
+#include <unistd.h>
+],[
+struct timeval tv;
+(void)gettimeofday(&tv);
+],
+msg="yes"
+,
+msg="no"
+)
+case $PLATFORM in
+    *-*-aix4* ) msg="no" ;; # on AIX the compiler test doesn't work
+    *-*-isc* )  msg="no" ;; # on ISC the compiler test doesn't work
+esac
+if test ".$msg" = .yes; then
+    AC_DEFINE(HAVE_GETTIMEOFDAY_ARGS1)
+fi
+AC_MSG_RESULT([$msg])
+
+dnl # check for struct timespec
+AC_MSG_CHECKING(for struct timespec)
+cross_compile=no
+AC_TRY_COMPILE([
+#include <time.h>
+#include <sys/time.h>
+],[
+struct timespec ts;
+],
+msg="yes"
+,
+msg="no"
+)
+if test ".$msg" = .yes; then
+    AC_DEFINE(HAVE_STRUCT_TIMESPEC)
+fi
+AC_MSG_RESULT([$msg])
+
+dnl # check for network/socket size type
+AC_CHECK_SOCKLENTYPE([
+FALLBACK_SOCKLEN_T="typedef ${ac_type} socklen_t;"
+if test ".$ac_type" = ".socklen_t"; then
+    FALLBACK_SOCKLEN_T="/* $FALLBACK_SOCKLEN_T */"
+fi
+AC_SUBST(FALLBACK_SOCKLEN_T)
+])
+
+dnl # check for filedescriptor number type
+AC_CHECK_NFDSTYPE([
+FALLBACK_NFDS_T="typedef ${ac_type} nfds_t;"
+if test ".$ac_type" = ".nfds_t"; then
+    FALLBACK_NFDS_T="/* $FALLBACK_NFDS_T */"
+fi
+AC_SUBST(FALLBACK_NFDS_T)
+])
+
+dnl # check for 64-bit types (for pth_snprintf.c)
+AC_CHECK_LONGLONG
+AC_CHECK_LONGDOUBLE
+
+dnl ##
+dnl ##  MACHINE CONTEXT IMPLEMENTATION
+dnl ##
+
+AC_MSG_PART(Machine Context Implementation)
+
+dnl #
+dnl #  1. determine possibilities
+dnl #
+
+dnl #  check for MCSC method
+AC_CHECK_HEADERS(ucontext.h)
+AC_CHECK_FUNCS(makecontext swapcontext getcontext setcontext)
+AC_CHECK_MCSC(mcsc=yes, mcsc=no)
+
+dnl #  check for SJLJ method
+AC_CHECK_HEADERS(signal.h)
+AC_CHECK_FUNCS(sigsetjmp siglongjmp setjmp longjmp _setjmp _longjmp)
+AC_CHECK_FUNCS(sigaltstack sigstack)
+AC_CHECK_SJLJ(sjlj=yes, sjlj=no, sjlj_type)
+
+dnl #
+dnl #  2. make a general decision
+dnl #
+
+if test ".$mcsc" = .yes; then
+    mctx_mth=mcsc
+    mctx_dsp=sc
+    mctx_stk=mc
+elif test ".$sjlj" = .yes; then
+    mctx_mth=sjlj
+    mctx_dsp=$sjlj_type
+    mctx_stk=none
+    AC_IFALLYES(func:sigstack,    mctx_stk=ss)
+    AC_IFALLYES(func:sigaltstack, mctx_stk=sas)
+    case $mctx_dsp in
+         sjljlx|sjljisc|sjljw32 ) mctx_stk=none
+    esac
+else
+    AC_ERROR([no appropriate mctx method found])
+fi
+
+dnl #
+dnl #  3. allow decision to be overridden by user
+dnl #
+
+AC_ARG_WITH(mctx-mth,dnl
+[  --with-mctx-mth=ID      force mctx method      (mcsc,sjlj)],[
+case $withval in
+    mcsc|sjlj ) mctx_mth=$withval ;;
+    * ) AC_ERROR([invalid mctx method -- allowed: mcsc,sjlj]) ;;
+esac
+])dnl
+AC_ARG_WITH(mctx-dsp,dnl
+[  --with-mctx-dsp=ID      force mctx dispatching (sc,ssjlj,sjlj,usjlj,sjlje,...)],[
+case $withval in
+    sc|ssjlj|sjlj|usjlj|sjlje|sjljlx|sjljisc|sjljw32 ) mctx_dsp=$withval ;;
+    * ) AC_ERROR([invalid mctx dispatching -- allowed: sc,ssjlj,sjlj,usjlj,sjlje,sjljlx,sjljisc,sjljw32]) ;;
+esac
+])dnl
+AC_ARG_WITH(mctx-stk,dnl
+[  --with-mctx-stk=ID      force mctx stack setup (mc,ss,sas,...)],[
+case $withval in
+    mc|ss|sas|none ) mctx_stk=$withval ;;
+    * ) AC_ERROR([invalid mctx stack setup -- allowed: mc,ss,sas,none]) ;;
+esac
+])dnl
+
+dnl #
+dnl #  4. determine a few additional details
+dnl #
+
+dnl #  whether sigaltstack has to use stack_t instead of struct sigaltstack
+AC_CHECK_TYPEDEF(stack_t, signal.h)
+
+dnl #  direction of stack grow
+AC_CHECK_STACKGROWTH(PTH_STACKGROWTH)
+if test ".$ac_cv_check_stackgrowth" = ".down"; then
+    PTH_STACK_GROWTH="down"
+else
+    PTH_STACK_GROWTH="up"
+fi
+AC_SUBST(PTH_STACK_GROWTH)
+
+dnl #  how to specify stacks for the various functions
+AC_CHECK_STACKSETUP(makecontext, pth_skaddr_makecontext, pth_sksize_makecontext)
+AC_CHECK_STACKSETUP(sigaltstack, pth_skaddr_sigaltstack, pth_sksize_sigaltstack)
+AC_CHECK_STACKSETUP(sigstack,    pth_skaddr_sigstack,    pth_sksize_sigstack)
+
+dnl #  how to implement POSIX compliant sig{set,long}jmp()
+case $mctx_dsp in [
+    ssjlj )
+        pth_sigjmpbuf='sigjmp_buf'
+        pth_sigsetjmp='sigsetjmp(buf,1)'
+        pth_siglongjmp='siglongjmp(buf,val)'
+        ;;
+    sjlj )
+        pth_sigjmpbuf='jmp_buf'
+        pth_sigsetjmp='setjmp(buf)'
+        pth_siglongjmp='longjmp(buf,val)'
+        ;;
+    usjlj )
+        pth_sigjmpbuf='jmp_buf'
+        pth_sigsetjmp='_setjmp(buf)'
+        pth_siglongjmp='_longjmp(buf,val)'
+        ;;
+    sjlje )
+        pth_sigjmpbuf='jmp_buf'
+        pth_sigsetjmp='setjmp(buf)'
+        pth_siglongjmp='longjmp(buf,val)'
+        ;;
+    sjljlx|sjljisc|sjljw32 )
+        pth_sigjmpbuf='sigjmp_buf'
+        pth_sigsetjmp='sigsetjmp(buf,1)'
+        pth_siglongjmp='siglongjmp(buf,val)'
+        ;;
+] esac
+pth_sigjmpbuf="#define pth_sigjmpbuf $pth_sigjmpbuf"
+pth_sigsetjmp="#define pth_sigsetjmp(buf) $pth_sigsetjmp"
+pth_siglongjmp="#define pth_siglongjmp(buf,val) $pth_siglongjmp"
+AC_SUBST(pth_sigjmpbuf)
+AC_SUBST(pth_sigsetjmp)
+AC_SUBST(pth_siglongjmp)
+
+dnl #
+dnl #  5. export the results
+dnl #
+
+AC_DEFINE_UNQUOTED(PTH_MCTX_MTH_use, [PTH_MCTX_MTH_$mctx_mth])
+AC_DEFINE_UNQUOTED(PTH_MCTX_DSP_use, [PTH_MCTX_DSP_$mctx_dsp])
+AC_DEFINE_UNQUOTED(PTH_MCTX_STK_use, [PTH_MCTX_STK_$mctx_stk])
+
+PTH_MCTX_ID="$mctx_mth/$mctx_dsp/$mctx_stk"
+AC_MSG_RESULT([decision on mctx implementation... ${TB}${PTH_MCTX_ID}${TN}])
+AC_SUBST(PTH_MCTX_ID)
+
+AC_MSG_VERBOSE([decided mctx method: $mctx_mth])
+AC_MSG_VERBOSE([decided mctx dispatching: $mctx_dsp])
+AC_MSG_VERBOSE([decided mctx stack setup: $mctx_stk])
+
+
+dnl ##
+dnl ##  SYSTEM CALL MAPPING
+dnl ##
+
+AC_MSG_PART(System Call Mapping)
+
+AC_CHECK_FUNCS(syscall)
+AC_CHECK_HEADERS(sys/syscall.h sys/socketcall.h)
+AC_CHECK_DEFINE(SYS_read, sys/syscall.h)
+
+AC_MSG_CHECKING([whether soft system call mapping is used])
+AC_ARG_ENABLE(syscall-soft,dnl
+[  --enable-syscall-soft   enable soft system call mapping (default=no)],
+enable_syscall_soft="$enableval",
+if test ".$enable_syscall_soft" = .; then
+    enable_syscall_soft=no
+fi
+)dnl
+if test .$enable_syscall_soft = .yes; then
+    PTH_SYSCALL_SOFT=1
+    msg="yes"
+else
+    PTH_SYSCALL_SOFT=0
+    msg="no"
+fi
+AC_MSG_RESULT([$msg])
+AC_SUBST(PTH_SYSCALL_SOFT)
+
+AC_MSG_CHECKING([whether hard system call mapping is used])
+AC_ARG_ENABLE(syscall-hard,dnl
+[  --enable-syscall-hard   enable hard system call mapping (default=no)],
+enable_syscall_hard="$enableval",[
+if test ".$enable_syscall_hard" = .; then
+    enable_syscall_hard=no
+fi
+])dnl
+if test ".$enable_syscall_hard" = .yes; then
+    AC_IFALLYES(func:syscall header:sys/syscall.h define:SYS_read,
+                enable_syscall_hard=yes, enable_syscall_hard=no)
+fi
+if test ".$enable_syscall_hard" = .yes; then
+    PTH_SYSCALL_HARD=1
+    msg="yes"
+else
+    PTH_SYSCALL_HARD=0
+    msg="no"
+fi
+AC_MSG_RESULT([$msg])
+AC_SUBST(PTH_SYSCALL_HARD)
+if test ".$enable_syscall_hard" = .yes; then
+    echo "${TB}Warning: The hard system call mapping variant is still work in progress.${TN}"
+    echo "${TB}         Do neither expect it to compile on all platforms (because of${TN}"
+    echo "${TB}         conflicts with vendor prototypes) nor to actually work!${TN}"
+fi
+
+
+dnl ##
+dnl ##  BUILD PARAMETERS
+dnl ##
+
+AC_MSG_PART(Build Parameters)
+
+dnl #  check for various build parameters
+AC_CHECK_BUILDPARAM
+
+dnl #  whether to build Pthread library
+AC_MSG_CHECKING(whether to build Pthread library)
+AC_ARG_ENABLE(pthread,dnl
+[  --enable-pthread        build Pthread library (default=no)],
+enable_pthread="$enableval",
+if test ".$enable_pthread" = .; then
+    enable_pthread=no
+fi
+)dnl
+AC_MSG_RESULT([$enable_pthread])
+if test ".$enable_pthread" = .yes; then
+    PTHREAD_O=pthread.o       dnl # only for stripped down Pth source tree
+    LIBPTHREAD_A=libpthread.a dnl # only for stripped down Pth source tree
+    LIBPTHREAD_LA=libpthread.la
+    PTHREAD_CONFIG_1='$(S)pthread-config.1'
+    PTHREAD_3='$(S)pthread.3'
+    INSTALL_PTHREAD=install-pthread
+    UNINSTALL_PTHREAD=uninstall-pthread
+    TEST_PTHREAD=test_pthread
+    enable_syscall_soft=yes
+    AC_HAVE_HEADERS(pthread.h)
+    ac_warn=no
+    if test ".$ac_cv_header_pthread_h" = .yes; then
+        warn=yes
+        changequote(<<,>>)
+        case $PLATFORM in
+            *-*-freebsd* ) ac_warn=no ;;
+            *-*-linux*   ) ac_warn=no ;;
+            *-*-solaris* ) ac_warn=no ;;
+            *-*-irix*    ) ac_warn=no ;;
+        esac
+        changequote([,])
+    fi
+    if test ".$ac_warn" = .yes; then
+        echo "${TB}Warning: You seem to have a vendor Pthread library installed.${TN}"
+        echo "${TB}         There might be conflicts with its pthread.h under compile-time!${TN}"
+    fi
+else
+    PTHREAD_O=""     dnl # only for stripped down Pth source tree
+    LIBPTHREAD_A=""  dnl # only for stripped down Pth source tree
+    LIBPTHREAD_LA=""
+    PTHREAD_CONFIG_1=""
+    PTHREAD_3=""
+    INSTALL_PTHREAD=""
+    UNINSTALL_PTHREAD=""
+    TEST_PTHREAD=""
+fi
+AC_SUBST(PTHREAD_O)
+AC_SUBST(LIBPTHREAD_A)
+AC_SUBST(LIBPTHREAD_LA)
+AC_SUBST(PTHREAD_CONFIG_1)
+AC_SUBST(PTHREAD_3)
+AC_SUBST(INSTALL_PTHREAD)
+AC_SUBST(UNINSTALL_PTHREAD)
+AC_SUBST(TEST_PTHREAD)
+
+dnl #   whether to build against Sfio library
+PTH_EXT_SFIO=0
+AC_CHECK_EXTLIB(Sfio, sfio, sfdisc, sfio.h, PTH_EXT_SFIO=1)
+AC_SUBST(PTH_EXT_SFIO)
+
+dnl #   whether to build against Dmalloc library
+AC_CHECK_EXTLIB(Dmalloc, dmalloc, dmalloc_debug, dmalloc.h, AC_DEFINE(PTH_DMALLOC))
+
+dnl ##
+dnl ##  OUTPUT SUBSTITUTION
+dnl ##
+
+AC_MSG_PART(Output Substitution)
+
+AC_OUTPUT(dnl
+Makefile dnl
+pthread-config dnl
+pthread.h dnl
+pth-config dnl
+pth.h dnl
+pth_acmac.h dnl
+,dnl
+chmod +rx pthread-config
+chmod +rx pth-config
+)dnl
+if test ".$enable_pthread" = .no; then
+    rm -f pthread-config
+    rm -f pthread.h
+fi
+
+if test ".$enable_batch" != .yes; then
+    echo ""
+    echo "Now please type \`${TB}make${TN}' to compile. Good luck."
+    echo ""
+fi
+
Index: ossp-pkg/pth/configure.in
RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/configure.in,v
co -q -kk -p'1.123' '/v/ossp/cvs/ossp-pkg/pth/Attic/configure.in,v' | diff -u - /dev/null -L'ossp-pkg/pth/configure.in' 2>/dev/null
--- ossp-pkg/pth/configure.in
+++ /dev/null	2024-05-14 08:37:11.000000000 +0200
@@ -1,607 +0,0 @@
-dnl ##
-dnl ##  GNU Pth - The GNU Portable Threads
-dnl ##  Copyright (c) 1999-2002 Ralf S. Engelschall <rse@engelschall.com>
-dnl ##
-dnl ##  This file is part of GNU Pth, a non-preemptive thread scheduling
-dnl ##  library which can be found at http://www.gnu.org/software/pth/.
-dnl ##
-dnl ##  This library is free software; you can redistribute it and/or
-dnl ##  modify it under the terms of the GNU Lesser General Public
-dnl ##  License as published by the Free Software Foundation; either
-dnl ##  version 2.1 of the License, or (at your option) any later version.
-dnl ##
-dnl ##  This library is distributed in the hope that it will be useful,
-dnl ##  but WITHOUT ANY WARRANTY; without even the implied warranty of
-dnl ##  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-dnl ##  Lesser General Public License for more details.
-dnl ##
-dnl ##  You should have received a copy of the GNU Lesser General Public
-dnl ##  License along with this library; if not, write to the Free Software
-dnl ##  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
-dnl ##  USA, or contact Ralf S. Engelschall <rse@engelschall.com>.
-dnl ##
-dnl ##  configure.in: Pth Autoconf specification
-dnl ##
-
-dnl #                              ``Programming in Bourne-Shell
-dnl #                                is a higher form of masochism.''
-dnl #                                           -- Unknown
-
-dnl ##
-dnl ##  PROLOG
-dnl ##
-
-dnl #   standard Autoconf prolog
-AC_PREREQ(2.12)dnl
-AC_REVISION([1.0])
-
-dnl #   autoconf initialization
-AC_INIT(README)
-AC_ENABLESUBDIR
-AC_SRCDIR_PREFIX(srcdir_prefix)
-AC_HEADLINE(dnl
-GNU Pth, Portable Threads, dnl
-PTH_VERSION, pth_vers.c, dnl
-[Copyright (c) 1999-2002 Ralf S. Engelschall <rse@engelschall.com>])
-AC_CONFIG_PARAM(config.param)
-AC_CONFIG_HEADER(pth_acdef.h)dnl
-AC_PREFIX_DEFAULT(/usr/local)
-AC_PLATFORM(PLATFORM)
-
-dnl ##
-dnl ##  BUILD TOOLS
-dnl ##
-
-AC_MSG_PART(Build Tools)
-
-AC_PROG_CC
-AC_PROG_CPP
-AC_SET_MAKE
-AC_CHECK_DEBUGGING
-AC_CHECK_PROFILING
-AC_CHECK_OPTIMIZE
-if test -f "$srcdir/ltconfig"; then
-    AC_PROG_LIBTOOL($PLATFORM)
-else
-    dnl # only for stripped down Pth source tree
-    AC_CHECK_PROG(AR, ar, ar)
-    AC_PROG_RANLIB
-fi
-
-dnl ##  Support for some special platform/compiler options
-case "$PLATFORM:$CC" in
-    *-sun-solaris2*:cc )
-        #   shut-up harmless warnings caused by do-while macros on Solaris
-        test ".$ac_cv_prog_gcc" = ".no" && CFLAGS="$CFLAGS -w"
-        ;;
-    *-*-sysv*uw[[27]]*:cc )
-        #   shut-up harmless warnings caused by do-while macros on UnixWare
-        CFLAGS="$CFLAGS -w"
-        ;;
-    *-hp-hpux*:cc )
-        #   HPUX needs a few special options to find its ANSI C brain
-        CFLAGS="$CFLAGS -Ae -O"
-        ;;
-    *-hp-hpux*:CC )
-        #   HPUX outputs useless warnings
-        CFLAGS="$CFLAGS -w"
-        ;;
-    *-sgi-irix6.2:cc )
-        #   shut-up warnings caused by IRIX brain-dead 32/64 bit stuff
-        LDFLAGS="$LDFLAGS -woff 85 -Wl,-woff,84 -Wl,-woff,85"
-        ;;
-    *-sgi-irix6.5.[[2-9]]:cc )
-        #   since IRIX 6.5.2 the C compiler is smart enough,
-        #   but the linker is still complaining, of course
-        LDFLAGS="$LDFLAGS -woff 84,85,134"
-        ;;
-    *-sgi-irix6.5:cc )
-        #   shut-up warnings caused by IRIX brain-dead 32/64 bit stuff
-        CFLAGS="$CFLAGS -woff 1110,1048"
-        LDFLAGS="$LDFLAGS -woff 84,85,134"
-        ;;
-    *-dec-osf4*:cc )
-        #   make sure the standard compliant functions are used on Tru64/OSF1 4.x
-        CFLAGS="$CFLAGS -std"
-        ;;
-    *-dec-osf5*:cc )
-        #   make sure the standard compliant functions are used on Tru64/OSF1 5.x
-        CFLAGS="$CFLAGS -std -D_XOPEN_SOURCE_EXTENDED"
-        ;;
-    *-*-isc*:* )
-        #   ISC is brain-dead and needs a bunch of options to find its brain
-        CPPFLAGS="$CPPFLAGS -D_POSIX_SOURCE";
-        LIBS="$LIBS -lcposix -linet";
-        ;;
-esac
-
-dnl ##
-dnl ##   MANDATORY PLATFORM ENVIRONMENT
-dnl ##
-
-AC_MSG_PART(Mandatory Platform Environment)
-
-dnl # check for standard headers
-AC_HEADER_STDC
-AC_HAVE_HEADERS(dnl
-   stdio.h stdlib.h stdarg.h string.h signal.h unistd.h setjmp.h fcntl.h dnl
-   errno.h sys/types.h sys/time.h sys/wait.h sys/stat.h sys/socket.h)
-AC_CHECK_FUNCTIONS(dnl
-   gettimeofday select sigaction sigprocmask sigpending sigsuspend)
-AC_BEGIN_DECISION([mandatory system headers and functions])
-AC_IFALLYES(dnl
-   header:stdio.h header:stdlib.h header:stdarg.h header:string.h dnl
-   header:signal.h header:unistd.h header:setjmp.h header:fcntl.h header:errno.h dnl
-   header:sys/types.h header:sys/time.h header:sys/wait.h header:sys/stat.h header:sys/socket.h dnl
-   func:gettimeofday func:select func:sigaction func:sigprocmask dnl
-   func:sigpending func:sigsuspend,
-   AC_DECIDE(fine, [all fine]))
-AC_END_DECISION
-
-
-dnl ##
-dnl ##  OPTIONAL PLATFORM ENVIRONMENT
-dnl ##
-
-AC_MSG_PART(Optional Platform Environment)
-
-dnl #  check for the number of signals
-AC_CHECK_NSIG(PTH_NSIG)
-
-dnl # check whether poll(2)'s input stuff has to be faked
-AC_CHECK_FUNCTIONS(poll)
-AC_CHECK_DEFINE(POLLIN, poll.h)
-AC_MSG_CHECKING(whether poll(2) facility has to be faked)
-AC_IFALLYES(func:poll define:POLLIN, PTH_FAKE_POLL=0, PTH_FAKE_POLL=1)
-if test .$PTH_FAKE_POLL = .1; then
-    msg="yes"
-else
-    msg="no"
-fi
-AC_SUBST(PTH_FAKE_POLL)
-AC_MSG_RESULT([$msg])
-
-dnl # check for readv/writev environment
-AC_HAVE_HEADERS(sys/uio.h)
-AC_CHECK_FUNCTIONS(readv writev)
-AC_MSG_CHECKING(whether readv(2)/writev(2) facility has to be faked)
-AC_IFALLYES(func:readv func:writev header:sys/uio.h, PTH_FAKE_RWV=0, PTH_FAKE_RWV=1)
-if test .$PTH_FAKE_RWV = .1; then
-    msg="yes"
-else
-    msg="no"
-fi
-AC_SUBST(PTH_FAKE_RWV)
-AC_MSG_RESULT([$msg])
-
-dnl # check for various other functions which would be nice to have
-AC_CHECK_FUNCTIONS(usleep strerror)
-
-dnl # check for various other headers which we might need
-AC_HAVE_HEADERS(sys/resource.h net/errno.h paths.h)
-
-dnl # at least the test programs need some socket stuff
-AC_CHECK_LIB(nsl, gethostname)
-if test ".`echo $LIBS | grep nsl`" = . ;then
-    AC_CHECK_LIB(nsl, gethostbyname)
-fi
-AC_CHECK_LIB(socket, accept)
-
-dnl # check whether we've to use a non-standard #include <sys/select.h>  to get
-dnl # the definition for fd_set under AIX and other brain-dead platforms.
-AC_HAVE_HEADERS(sys/select.h)
-EXTRA_INCLUDE_SYS_SELECT_H="#include <sys/select.h>"
-if test ".$ac_cv_header_sys_select_h" != .yes; then
-    EXTRA_INCLUDE_SYS_SELECT_H="/* $EXTRA_INCLUDE_SYS_SELECT_H */"
-fi
-AC_SUBST(EXTRA_INCLUDE_SYS_SELECT_H)
-
-dnl # check whether we've to define sig_atomic_t
-AC_CHECK_TYPEDEF(sig_atomic_t, signal.h)
-FALLBACK_SIG_ATOMIC_T="typedef int sig_atomic_t;"
-if test ".$ac_cv_typedef_sig_atomic_t" = .yes; then
-    FALLBACK_SIG_ATOMIC_T="/* $FALLBACK_SIG_ATOMIC_T */"
-fi
-AC_SUBST(FALLBACK_SIG_ATOMIC_T)
-
-dnl # check whether we've to define pid_t
-AC_CHECK_TYPEDEF(pid_t, sys/types.h)
-FALLBACK_PID_T="typedef int pid_t;"
-if test ".$ac_cv_typedef_pid_t" = .yes; then
-    FALLBACK_PID_T="/* $FALLBACK_PID_T */"
-fi
-AC_SUBST(FALLBACK_PID_T)
-
-dnl # check whether we've to define size_t
-AC_CHECK_TYPEDEF(size_t, stdlib.h)
-FALLBACK_SIZE_T="typedef unsigned int size_t;"
-if test ".$ac_cv_typedef_size_t" = .yes; then
-    FALLBACK_SIZE_T="/* $FALLBACK_SIZE_T */"
-fi
-AC_SUBST(FALLBACK_SIZE_T)
-
-dnl # check whether we've to define ssize_t
-AC_CHECK_TYPEDEF(ssize_t, sys/types.h)
-FALLBACK_SSIZE_T="typedef unsigned int ssize_t;"
-if test ".$ac_cv_typedef_ssize_t" = .yes; then
-    FALLBACK_SSIZE_T="/* $FALLBACK_SSIZE_T */"
-fi
-AC_SUBST(FALLBACK_SSIZE_T)
-
-dnl # check whether we've to define off_t
-AC_CHECK_TYPEDEF(off_t, sys/types.h)
-FALLBACK_OFF_T="typedef int off_t;"
-if test ".$ac_cv_typedef_off_t" = .yes; then
-    FALLBACK_OFF_T="/* $FALLBACK_OFF_T */"
-fi
-AC_SUBST(FALLBACK_OFF_T)
-
-dnl # check whether stack_t exists instead of sigaltstack
-AC_CHECK_TYPEDEF(stack_t, signal.h)
-
-dnl # check whether ss_base instead of ss_sp attribute exists
-AC_CHECK_STRUCTATTR(ss_base, sigaltstack, sys/signal.h)
-AC_CHECK_STRUCTATTR(ss_sp,   sigaltstack, sys/signal.h)
-
-dnl # check for gettimeofday() variant
-AC_MSG_CHECKING(for a single-argument based gettimeofday)
-cross_compile=no
-AC_TRY_COMPILE([
-#include <sys/types.h>
-#include <sys/time.h>
-#include <unistd.h>
-],[
-struct timeval tv;
-(void)gettimeofday(&tv);
-],
-msg="yes"
-,
-msg="no"
-)
-case $PLATFORM in
-    *-*-aix4* ) msg="no" ;; # on AIX the compiler test doesn't work
-    *-*-isc* )  msg="no" ;; # on ISC the compiler test doesn't work
-esac
-if test ".$msg" = .yes; then
-    AC_DEFINE(HAVE_GETTIMEOFDAY_ARGS1)
-fi
-AC_MSG_RESULT([$msg])
-
-dnl # check for struct timespec
-AC_MSG_CHECKING(for struct timespec)
-cross_compile=no
-AC_TRY_COMPILE([
-#include <time.h>
-#include <sys/time.h>
-],[
-struct timespec ts;
-],
-msg="yes"
-,
-msg="no"
-)
-if test ".$msg" = .yes; then
-    AC_DEFINE(HAVE_STRUCT_TIMESPEC)
-fi
-AC_MSG_RESULT([$msg])
-
-dnl # check for network/socket size type
-AC_CHECK_SOCKLENTYPE([
-FALLBACK_SOCKLEN_T="typedef ${ac_type} socklen_t;"
-if test ".$ac_type" = ".socklen_t"; then
-    FALLBACK_SOCKLEN_T="/* $FALLBACK_SOCKLEN_T */"
-fi
-AC_SUBST(FALLBACK_SOCKLEN_T)
-])
-
-dnl # check for filedescriptor number type
-AC_CHECK_NFDSTYPE([
-FALLBACK_NFDS_T="typedef ${ac_type} nfds_t;"
-if test ".$ac_type" = ".nfds_t"; then
-    FALLBACK_NFDS_T="/* $FALLBACK_NFDS_T */"
-fi
-AC_SUBST(FALLBACK_NFDS_T)
-])
-
-dnl # check for 64-bit types (for pth_snprintf.c)
-AC_CHECK_LONGLONG
-AC_CHECK_LONGDOUBLE
-
-dnl ##
-dnl ##  MACHINE CONTEXT IMPLEMENTATION
-dnl ##
-
-AC_MSG_PART(Machine Context Implementation)
-
-dnl #
-dnl #  1. determine possibilities
-dnl #
-
-dnl #  check for MCSC method
-AC_CHECK_HEADERS(ucontext.h)
-AC_CHECK_FUNCTIONS(makecontext swapcontext getcontext setcontext)
-AC_CHECK_MCSC(mcsc=yes, mcsc=no)
-
-dnl #  check for SJLJ method
-AC_CHECK_HEADERS(signal.h)
-AC_CHECK_FUNCTIONS(sigsetjmp siglongjmp setjmp longjmp _setjmp _longjmp)
-AC_CHECK_FUNCTIONS(sigaltstack sigstack)
-AC_CHECK_SJLJ(sjlj=yes, sjlj=no, sjlj_type)
-
-dnl #
-dnl #  2. make a general decision
-dnl #
-
-if test ".$mcsc" = .yes; then
-    mctx_mth=mcsc
-    mctx_dsp=sc
-    mctx_stk=mc
-elif test ".$sjlj" = .yes; then
-    mctx_mth=sjlj
-    mctx_dsp=$sjlj_type
-    mctx_stk=none
-    AC_IFALLYES(func:sigstack,    mctx_stk=ss)
-    AC_IFALLYES(func:sigaltstack, mctx_stk=sas)
-    case $mctx_dsp in
-         sjljlx|sjljisc|sjljw32 ) mctx_stk=none
-    esac
-else
-    AC_ERROR([no appropriate mctx method found])
-fi
-
-dnl #
-dnl #  3. allow decision to be overridden by user
-dnl #
-
-AC_ARG_WITH(mctx-mth,dnl
-[  --with-mctx-mth=ID      force mctx method      (mcsc,sjlj)],[
-case $withval in
-    mcsc|sjlj ) mctx_mth=$withval ;;
-    * ) AC_ERROR([invalid mctx method -- allowed: mcsc,sjlj]) ;;
-esac
-])dnl
-AC_ARG_WITH(mctx-dsp,dnl
-[  --with-mctx-dsp=ID      force mctx dispatching (sc,ssjlj,sjlj,usjlj,sjlje,...)],[
-case $withval in
-    sc|ssjlj|sjlj|usjlj|sjlje|sjljlx|sjljisc|sjljw32 ) mctx_dsp=$withval ;;
-    * ) AC_ERROR([invalid mctx dispatching -- allowed: sc,ssjlj,sjlj,usjlj,sjlje,sjljlx,sjljisc,sjljw32]) ;;
-esac
-])dnl
-AC_ARG_WITH(mctx-stk,dnl
-[  --with-mctx-stk=ID      force mctx stack setup (mc,ss,sas,...)],[
-case $withval in
-    mc|ss|sas|none ) mctx_stk=$withval ;;
-    * ) AC_ERROR([invalid mctx stack setup -- allowed: mc,ss,sas,none]) ;;
-esac
-])dnl
-
-dnl #
-dnl #  4. determine a few additional details
-dnl #
-
-dnl #  whether sigaltstack has to use stack_t instead of struct sigaltstack
-AC_CHECK_TYPEDEF(stack_t, signal.h)
-
-dnl #  direction of stack grow
-AC_CHECK_STACKGROWTH(PTH_STACKGROWTH)
-if test ".$ac_cv_check_stackgrowth" = ".down"; then
-    PTH_STACK_GROWTH="down"
-else
-    PTH_STACK_GROWTH="up"
-fi
-AC_SUBST(PTH_STACK_GROWTH)
-
-dnl #  how to specify stacks for the various functions
-AC_CHECK_STACKSETUP(makecontext, pth_skaddr_makecontext, pth_sksize_makecontext)
-AC_CHECK_STACKSETUP(sigaltstack, pth_skaddr_sigaltstack, pth_sksize_sigaltstack)
-AC_CHECK_STACKSETUP(sigstack,    pth_skaddr_sigstack,    pth_sksize_sigstack)
-
-dnl #  how to implement POSIX compliant sig{set,long}jmp()
-case $mctx_dsp in [
-    ssjlj )
-        pth_sigjmpbuf='sigjmp_buf'
-        pth_sigsetjmp='sigsetjmp(buf,1)'
-        pth_siglongjmp='siglongjmp(buf,val)'
-        ;;
-    sjlj )
-        pth_sigjmpbuf='jmp_buf'
-        pth_sigsetjmp='setjmp(buf)'
-        pth_siglongjmp='longjmp(buf,val)'
-        ;;
-    usjlj )
-        pth_sigjmpbuf='jmp_buf'
-        pth_sigsetjmp='_setjmp(buf)'
-        pth_siglongjmp='_longjmp(buf,val)'
-        ;;
-    sjlje )
-        pth_sigjmpbuf='jmp_buf'
-        pth_sigsetjmp='setjmp(buf)'
-        pth_siglongjmp='longjmp(buf,val)'
-        ;;
-    sjljlx|sjljisc|sjljw32 )
-        pth_sigjmpbuf='sigjmp_buf'
-        pth_sigsetjmp='sigsetjmp(buf,1)'
-        pth_siglongjmp='siglongjmp(buf,val)'
-        ;;
-] esac
-pth_sigjmpbuf="#define pth_sigjmpbuf $pth_sigjmpbuf"
-pth_sigsetjmp="#define pth_sigsetjmp(buf) $pth_sigsetjmp"
-pth_siglongjmp="#define pth_siglongjmp(buf,val) $pth_siglongjmp"
-AC_SUBST(pth_sigjmpbuf)
-AC_SUBST(pth_sigsetjmp)
-AC_SUBST(pth_siglongjmp)
-
-dnl #
-dnl #  5. export the results
-dnl #
-
-AC_DEFINE_UNQUOTED(PTH_MCTX_MTH_use, [PTH_MCTX_MTH_$mctx_mth])
-AC_DEFINE_UNQUOTED(PTH_MCTX_DSP_use, [PTH_MCTX_DSP_$mctx_dsp])
-AC_DEFINE_UNQUOTED(PTH_MCTX_STK_use, [PTH_MCTX_STK_$mctx_stk])
-
-PTH_MCTX_ID="$mctx_mth/$mctx_dsp/$mctx_stk"
-AC_MSG_RESULT([decision on mctx implementation... ${TB}${PTH_MCTX_ID}${TN}])
-AC_SUBST(PTH_MCTX_ID)
-
-AC_MSG_VERBOSE([decided mctx method: $mctx_mth])
-AC_MSG_VERBOSE([decided mctx dispatching: $mctx_dsp])
-AC_MSG_VERBOSE([decided mctx stack setup: $mctx_stk])
-
-
-dnl ##
-dnl ##  SYSTEM CALL MAPPING
-dnl ##
-
-AC_MSG_PART(System Call Mapping)
-
-AC_CHECK_FUNCTIONS(syscall)
-AC_CHECK_HEADERS(sys/syscall.h sys/socketcall.h)
-AC_CHECK_DEFINE(SYS_read, sys/syscall.h)
-
-AC_MSG_CHECKING([whether soft system call mapping is used])
-AC_ARG_ENABLE(syscall-soft,dnl
-[  --enable-syscall-soft   enable soft system call mapping (default=no)],
-enable_syscall_soft="$enableval",
-if test ".$enable_syscall_soft" = .; then
-    enable_syscall_soft=no
-fi
-)dnl
-if test .$enable_syscall_soft = .yes; then
-    PTH_SYSCALL_SOFT=1
-    msg="yes"
-else
-    PTH_SYSCALL_SOFT=0
-    msg="no"
-fi
-AC_MSG_RESULT([$msg])
-AC_SUBST(PTH_SYSCALL_SOFT)
-
-AC_MSG_CHECKING([whether hard system call mapping is used])
-AC_ARG_ENABLE(syscall-hard,dnl
-[  --enable-syscall-hard   enable hard system call mapping (default=no)],
-enable_syscall_hard="$enableval",[
-if test ".$enable_syscall_hard" = .; then
-    enable_syscall_hard=no
-fi
-])dnl
-if test ".$enable_syscall_hard" = .yes; then
-    AC_IFALLYES(func:syscall header:sys/syscall.h define:SYS_read,
-                enable_syscall_hard=yes, enable_syscall_hard=no)
-fi
-if test ".$enable_syscall_hard" = .yes; then
-    PTH_SYSCALL_HARD=1
-    msg="yes"
-else
-    PTH_SYSCALL_HARD=0
-    msg="no"
-fi
-AC_MSG_RESULT([$msg])
-AC_SUBST(PTH_SYSCALL_HARD)
-if test ".$enable_syscall_hard" = .yes; then
-    echo "${TB}Warning: The hard system call mapping variant is still work in progress.${TN}"
-    echo "${TB}         Do neither expect it to compile on all platforms (because of${TN}"
-    echo "${TB}         conflicts with vendor prototypes) nor to actually work!${TN}"
-fi
-
-
-dnl ##
-dnl ##  BUILD PARAMETERS
-dnl ##
-
-AC_MSG_PART(Build Parameters)
-
-dnl #  check for various build parameters
-AC_CHECK_BUILDPARAM
-
-dnl #  whether to build Pthread library
-AC_MSG_CHECKING(whether to build Pthread library)
-AC_ARG_ENABLE(pthread,dnl
-[  --enable-pthread        build Pthread library (default=no)],
-enable_pthread="$enableval",
-if test ".$enable_pthread" = .; then
-    enable_pthread=no
-fi
-)dnl
-AC_MSG_RESULT([$enable_pthread])
-if test ".$enable_pthread" = .yes; then
-    PTHREAD_O=pthread.o       dnl # only for stripped down Pth source tree
-    LIBPTHREAD_A=libpthread.a dnl # only for stripped down Pth source tree
-    LIBPTHREAD_LA=libpthread.la
-    PTHREAD_CONFIG_1='$(S)pthread-config.1'
-    PTHREAD_3='$(S)pthread.3'
-    INSTALL_PTHREAD=install-pthread
-    UNINSTALL_PTHREAD=uninstall-pthread
-    TEST_PTHREAD=test_pthread
-    enable_syscall_soft=yes
-    AC_HAVE_HEADERS(pthread.h)
-    ac_warn=no
-    if test ".$ac_cv_header_pthread_h" = .yes; then
-        warn=yes
-        changequote(<<,>>)
-        case $PLATFORM in
-            *-*-freebsd* ) ac_warn=no ;;
-            *-*-linux*   ) ac_warn=no ;;
-            *-*-solaris* ) ac_warn=no ;;
-            *-*-irix*    ) ac_warn=no ;;
-        esac
-        changequote([,])
-    fi
-    if test ".$ac_warn" = .yes; then
-        echo "${TB}Warning: You seem to have a vendor Pthread library installed.${TN}"
-        echo "${TB}         There might be conflicts with its pthread.h under compile-time!${TN}"
-    fi
-else
-    PTHREAD_O=""     dnl # only for stripped down Pth source tree
-    LIBPTHREAD_A=""  dnl # only for stripped down Pth source tree
-    LIBPTHREAD_LA=""
-    PTHREAD_CONFIG_1=""
-    PTHREAD_3=""
-    INSTALL_PTHREAD=""
-    UNINSTALL_PTHREAD=""
-    TEST_PTHREAD=""
-fi
-AC_SUBST(PTHREAD_O)
-AC_SUBST(LIBPTHREAD_A)
-AC_SUBST(LIBPTHREAD_LA)
-AC_SUBST(PTHREAD_CONFIG_1)
-AC_SUBST(PTHREAD_3)
-AC_SUBST(INSTALL_PTHREAD)
-AC_SUBST(UNINSTALL_PTHREAD)
-AC_SUBST(TEST_PTHREAD)
-
-dnl #   whether to build against Sfio library
-PTH_EXT_SFIO=0
-AC_CHECK_EXTLIB(Sfio, sfio, sfdisc, sfio.h, PTH_EXT_SFIO=1)
-AC_SUBST(PTH_EXT_SFIO)
-
-dnl #   whether to build against Dmalloc library
-AC_CHECK_EXTLIB(Dmalloc, dmalloc, dmalloc_debug, dmalloc.h, AC_DEFINE(PTH_DMALLOC))
-
-dnl ##
-dnl ##  OUTPUT SUBSTITUTION
-dnl ##
-
-AC_MSG_PART(Output Substitution)
-
-AC_OUTPUT(dnl
-Makefile dnl
-pthread-config dnl
-pthread.h dnl
-pth-config dnl
-pth.h dnl
-pth_acmac.h dnl
-,dnl
-chmod +rx pthread-config
-chmod +rx pth-config
-)dnl
-if test ".$enable_pthread" = .no; then
-    rm -f pthread-config
-    rm -f pthread.h
-fi
-
-if test ".$enable_batch" != .yes; then
-    echo ""
-    echo "Now please type \`${TB}make${TN}' to compile. Good luck."
-    echo ""
-fi
-
Index: ossp-pkg/pth/devtool
RCS File: /v/ossp/cvs/ossp-pkg/pth/devtool,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/pth/devtool,v' | diff -u /dev/null - -L'ossp-pkg/pth/devtool' 2>/dev/null
--- ossp-pkg/pth/devtool
+++ -	2024-05-14 08:38:00.851592618 +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/pth/devtool.conf
RCS File: /v/ossp/cvs/ossp-pkg/pth/devtool.conf,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/pth/devtool.conf,v' | diff -u /dev/null - -L'ossp-pkg/pth/devtool.conf' 2>/dev/null
--- ossp-pkg/pth/devtool.conf
+++ -	2024-05-14 08:38:00.854149221 +0200
@@ -0,0 +1,55 @@
+##
+##  devtool.conf -- Development Tool Configuration
+##
+
+%autogen
+    @autogen shtool   1.5.4 "1.5.*" echo version scpp mkdir install fixperm tarball
+    @autogen libtool  1.4.2 "1.4*"
+    @autogen autoconf 2.52  "2.5.*"
+	cat acheader.m4 configure.ac | autoheader - >pth_acdef.h.in
+
+%autoclean
+    @autoclean shtool
+    @autoclean libtool
+    @autoclean autoconf
+
+%configure
+    if [ $# -gt 0 ]; then
+        param="$1"
+        shift
+    else
+        param=devel
+    fi
+    ./configure --with-param=$param "$@"
+
+%version
+    ./shtool version -lc -n 'GNU Pth' -p pth_internal_ -e pth_vers.c
+
+%dist
+    make distclean >/dev/null 2>&1
+    ./shtool fixperm -v .
+    V=`./shtool version -lc -d short pth_vers.c`
+    ./shtool tarball -o pth-${V}.tar.gz -d pth-${V} -u gnu -g pth \
+                     -e 'CVS,\.cvsignore,\.[ao],^\.,devtool*' -c 'gzip --best' .
+
+%snap
+    make distclean >/dev/null 2>&1
+    ./shtool fixperm -v .
+    V=`./shtool version -lc -d short pth_vers.c`
+    ./shtool tarball -o pth-${V}-SNAP.tar.gz -d pth-${V} -u gnu -g pth \
+                     -e 'CVS,\.cvsignore,\.[ao],^\.,devtool*' -c 'gzip --best' .
+
+%striptease
+	perl striptease.pl
+
+%depend
+	cp Makefile.in Makefile.in.bak
+	sed -ne '1,/^# DO NOT REMOVE/p' Makefile.in >Makefile.new
+	gcc -MM -I. *.c |\
+	perl -e 'my $d = ""; $d .= $_ while (<STDIN>); $_ = $d; \
+	         s/^(pth_.*)\.o:/$1.lo:/; \
+	         s|\\\n\s*| |sg; s|\b?\S*/\S*\b?||g; s|\s{2,}| |g; \
+	         print $_;' >> Makefile.new
+	cp Makefile.new Makefile.in
+	rm -f Makefile.new
+
Index: ossp-pkg/pth/devtool.func
RCS File: /v/ossp/cvs/ossp-pkg/pth/devtool.func,v
co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/pth/devtool.func,v' | diff -u /dev/null - -L'ossp-pkg/pth/devtool.func' 2>/dev/null
--- ossp-pkg/pth/devtool.func
+++ -	2024-05-14 08:38:00.856748479 +0200
@@ -0,0 +1,72 @@
+##
+##  devtool.func -- Development Tool Functions
+##  Copyright (c) 2001 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"
+            ;;
+        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/pth/ltconfig
RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/ltconfig,v
co -q -kk -p'1.8' '/v/ossp/cvs/ossp-pkg/pth/Attic/ltconfig,v' | diff -u /dev/null - -L'ossp-pkg/pth/ltconfig' 2>/dev/null
--- ossp-pkg/pth/ltconfig
+++ -	2024-05-14 08:38:00.859340325 +0200
@@ -0,0 +1,3114 @@
+#! /bin/sh
+
+# ltconfig - Create a system-specific libtool.
+# Copyright (C) 1996-1999 Free Software Foundation, Inc.
+# Originally by Gordon Matzigkeit <gord@gnu.ai.mit.edu>, 1996
+#
+# This file is free software; you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+#
+# As a special exception to the GNU General Public License, if you
+# distribute this file as part of a program that contains a
+# configuration script generated by Autoconf, you may include it under
+# the same distribution terms that you use for the rest of that program.
+
+# A lot of this script is taken from autoconf-2.10.
+
+# Check that we are running under the correct shell.
+SHELL=${CONFIG_SHELL-/bin/sh}
+echo=echo
+if test "X$1" = X--no-reexec; then
+  # Discard the --no-reexec flag, and continue.
+  shift
+elif test "X$1" = X--fallback-echo; then
+  # Avoid inline document here, it may be left over
+  :
+elif test "X`($echo '\t') 2>/dev/null`" = 'X\t'; then
+  # Yippee, $echo works!
+  :
+else
+  # Restart under the correct shell.
+  exec "$SHELL" "$0" --no-reexec ${1+"$@"}
+fi
+
+if test "X$1" = X--fallback-echo; then
+  # used as fallback echo
+  shift
+  cat <<EOF
+$*
+EOF
+  exit 0
+fi
+
+# Find the correct PATH separator.  Usually this is `:', but
+# DJGPP uses `;' like DOS.
+if test "X${PATH_SEPARATOR+set}" != Xset; then
+  UNAME=${UNAME-`uname 2>/dev/null`}
+  case X$UNAME in
+    *-DOS) PATH_SEPARATOR=';' ;;
+    *)     PATH_SEPARATOR=':' ;;
+  esac
+fi
+
+# The HP-UX ksh and POSIX shell print the target directory to stdout
+# if CDPATH is set.
+if test "X${CDPATH+set}" = Xset; then CDPATH=:; export CDPATH; fi
+
+if test "X${echo_test_string+set}" != Xset; then
+  # find a string as large as possible, as long as the shell can cope with it
+  for cmd in 'sed 50q "$0"' 'sed 20q "$0"' 'sed 10q "$0"' 'sed 2q "$0"' 'echo test'; do
+    # expected sizes: less than 2Kb, 1Kb, 512 bytes, 16 bytes, ...
+    if (echo_test_string="`eval $cmd`") 2>/dev/null &&
+       echo_test_string="`eval $cmd`" &&
+       (test "X$echo_test_string" = "X$echo_test_string") 2>/dev/null; then
+      break
+    fi
+  done
+fi
+
+if test "X`($echo '\t') 2>/dev/null`" != 'X\t' ||
+   test "X`($echo "$echo_test_string") 2>/dev/null`" != X"$echo_test_string"; then
+  # The Solaris, AIX, and Digital Unix default echo programs unquote
+  # backslashes.  This makes it impossible to quote backslashes using
+  #   echo "$something" | sed 's/\\/\\\\/g'
+  #
+  # So, first we look for a working echo in the user's PATH.
+
+  IFS="${IFS= 	}"; save_ifs="$IFS"; IFS="${IFS}${PATH_SEPARATOR}"
+  for dir in $PATH /usr/ucb; do
+    if (test -f $dir/echo || test -f $dir/echo$ac_exeext) &&
+       test "X`($dir/echo '\t') 2>/dev/null`" = 'X\t' &&
+       test "X`($dir/echo "$echo_test_string") 2>/dev/null`" = X"$echo_test_string"; then
+      echo="$dir/echo"
+      break
+    fi
+  done
+  IFS="$save_ifs"
+
+  if test "X$echo" = Xecho; then
+    # We didn't find a better echo, so look for alternatives.
+    if test "X`(print -r '\t') 2>/dev/null`" = 'X\t' &&
+       test "X`(print -r "$echo_test_string") 2>/dev/null`" = X"$echo_test_string"; then
+      # This shell has a builtin print -r that does the trick.
+      echo='print -r'
+    elif (test -f /bin/ksh || test -f /bin/ksh$ac_exeext) &&
+	 test "X$CONFIG_SHELL" != X/bin/ksh; then
+      # If we have ksh, try running ltconfig again with it.
+      ORIGINAL_CONFIG_SHELL="${CONFIG_SHELL-/bin/sh}"
+      export ORIGINAL_CONFIG_SHELL
+      CONFIG_SHELL=/bin/ksh
+      export CONFIG_SHELL
+      exec "$CONFIG_SHELL" "$0" --no-reexec ${1+"$@"}
+    else
+      # Try using printf.
+      echo='printf "%s\n"'
+      if test "X`($echo '\t') 2>/dev/null`" = 'X\t' &&
+	 test "X`($echo "$echo_test_string") 2>/dev/null`" = X"$echo_test_string"; then
+	# Cool, printf works
+	:
+      elif test "X`("$ORIGINAL_CONFIG_SHELL" "$0" --fallback-echo '\t') 2>/dev/null`" = 'X\t' &&
+	   test "X`("$ORIGINAL_CONFIG_SHELL" "$0" --fallback-echo "$echo_test_string") 2>/dev/null`" = X"$echo_test_string"; then
+	CONFIG_SHELL="$ORIGINAL_CONFIG_SHELL"
+	export CONFIG_SHELL
+	SHELL="$CONFIG_SHELL"
+	export SHELL
+	echo="$CONFIG_SHELL $0 --fallback-echo"
+      elif test "X`("$CONFIG_SHELL" "$0" --fallback-echo '\t') 2>/dev/null`" = 'X\t' &&
+	   test "X`("$CONFIG_SHELL" "$0" --fallback-echo "$echo_test_string") 2>/dev/null`" = X"$echo_test_string"; then
+	echo="$CONFIG_SHELL $0 --fallback-echo"
+      else
+	# maybe with a smaller string...
+	prev=:
+
+	for cmd in 'echo test' 'sed 2q "$0"' 'sed 10q "$0"' 'sed 20q "$0"' 'sed 50q "$0"'; do
+	  if (test "X$echo_test_string" = "X`eval $cmd`") 2>/dev/null; then
+	    break
+	  fi
+	  prev="$cmd"
+	done
+
+	if test "$prev" != 'sed 50q "$0"'; then
+	  echo_test_string=`eval $prev`
+	  export echo_test_string
+	  exec "${ORIGINAL_CONFIG_SHELL}" "$0" ${1+"$@"}
+	else
+	  # Oops.  We lost completely, so just stick with echo.
+	  echo=echo
+	fi
+      fi
+    fi
+  fi
+fi
+
+# Sed substitution that helps us do robust quoting.  It backslashifies
+# metacharacters that are still active within double-quoted strings.
+Xsed='sed -e s/^X//'
+sed_quote_subst='s/\([\\"\\`$\\\\]\)/\\\1/g'
+
+# Same as above, but do not quote variable references.
+double_quote_subst='s/\([\\"\\`\\\\]\)/\\\1/g'
+
+# Sed substitution to delay expansion of an escaped shell variable in a
+# double_quote_subst'ed string.
+delay_variable_subst='s/\\\\\\\\\\\$/\\\\\\$/g'
+
+# The name of this program.
+progname=`$echo "X$0" | $Xsed -e 's%^.*/%%'`
+
+# Constants:
+PROGRAM=ltconfig
+PACKAGE=libtool
+VERSION=1.3.5
+TIMESTAMP=" (1.385.2.206 2000/05/27 11:12:27)"
+ac_compile='${CC-cc} -c $CFLAGS $CPPFLAGS conftest.$ac_ext 1>&5'
+ac_link='${CC-cc} -o conftest $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS 1>&5'
+rm="rm -f"
+
+help="Try \`$progname --help' for more information."
+
+# Global variables:
+default_ofile=libtool
+can_build_shared=yes
+enable_shared=yes
+# All known linkers require a `.a' archive for static linking (except M$VC,
+# which needs '.lib').
+enable_static=yes
+enable_fast_install=yes
+enable_dlopen=unknown
+enable_win32_dll=no
+ltmain=
+silent=
+srcdir=
+ac_config_guess=
+ac_config_sub=
+host=
+nonopt=
+ofile="$default_ofile"
+verify_host=yes
+with_gcc=no
+with_gnu_ld=no
+need_locks=yes
+ac_ext=c
+objext=o
+libext=a
+exeext=
+cache_file=
+
+old_AR="$AR"
+old_CC="$CC"
+old_CFLAGS="$CFLAGS"
+old_CPPFLAGS="$CPPFLAGS"
+old_LDFLAGS="$LDFLAGS"
+old_LD="$LD"
+old_LN_S="$LN_S"
+old_LIBS="$LIBS"
+old_NM="$NM"
+old_RANLIB="$RANLIB"
+old_DLLTOOL="$DLLTOOL"
+old_OBJDUMP="$OBJDUMP"
+old_AS="$AS"
+
+# Parse the command line options.
+args=
+prev=
+for option
+do
+  case "$option" in
+  -*=*) optarg=`echo "$option" | sed 's/[-_a-zA-Z0-9]*=//'` ;;
+  *) optarg= ;;
+  esac
+
+  # If the previous option needs an argument, assign it.
+  if test -n "$prev"; then
+    eval "$prev=\$option"
+    prev=
+    continue
+  fi
+
+  case "$option" in
+  --help) cat <<EOM
+Usage: $progname [OPTION]... [HOST [LTMAIN]]
+
+Generate a system-specific libtool script.
+
+    --debug                enable verbose shell tracing
+    --disable-shared       do not build shared libraries
+    --disable-static       do not build static libraries
+    --disable-fast-install do not optimize for fast installation
+    --enable-dlopen        enable dlopen support
+    --enable-win32-dll     enable building dlls on win32 hosts
+    --help                 display this help and exit
+    --no-verify            do not verify that HOST is a valid host type
+-o, --output=FILE          specify the output file [default=$default_ofile]
+    --quiet                same as \`--silent'
+    --silent               do not print informational messages
+    --srcdir=DIR           find \`config.guess' in DIR
+    --version              output version information and exit
+    --with-gcc             assume that the GNU C compiler will be used
+    --with-gnu-ld          assume that the C compiler uses the GNU linker
+    --disable-lock         disable file locking
+    --cache-file=FILE      configure cache file
+
+LTMAIN is the \`ltmain.sh' shell script fragment or \`ltmain.c' program
+that provides basic libtool functionality.
+
+HOST is the canonical host system name [default=guessed].
+EOM
+  exit 0
+  ;;
+
+  --debug)
+    echo "$progname: enabling shell trace mode"
+    set -x
+    ;;
+
+  --disable-shared) enable_shared=no ;;
+
+  --disable-static) enable_static=no ;;
+
+  --disable-fast-install) enable_fast_install=no ;;
+
+  --enable-dlopen) enable_dlopen=yes ;;
+
+  --enable-win32-dll) enable_win32_dll=yes ;;
+
+  --quiet | --silent) silent=yes ;;
+
+  --srcdir) prev=srcdir ;;
+  --srcdir=*) srcdir="$optarg" ;;
+
+  --no-verify) verify_host=no ;;
+
+  --output | -o) prev=ofile ;;
+  --output=*) ofile="$optarg" ;;
+
+  --version) echo "$PROGRAM (GNU $PACKAGE) $VERSION$TIMESTAMP"; exit 0 ;;
+
+  --with-gcc) with_gcc=yes ;;
+  --with-gnu-ld) with_gnu_ld=yes ;;
+
+  --disable-lock) need_locks=no ;;
+
+  --cache-file=*) cache_file="$optarg" ;;
+
+  -*)
+    echo "$progname: unrecognized option \`$option'" 1>&2
+    echo "$help" 1>&2
+    exit 1
+    ;;
+
+  *)
+    if test -z "$ltmain"; then
+      ltmain="$option"
+    elif test -z "$host"; then
+# This generates an unnecessary warning for sparc-sun-solaris4.1.3_U1
+#      if test -n "`echo $option| sed 's/[-a-z0-9.]//g'`"; then
+#        echo "$progname: warning \`$option' is not a valid host type" 1>&2
+#      fi
+      host="$option"
+    else
+      echo "$progname: too many arguments" 1>&2
+      echo "$help" 1>&2
+      exit 1
+    fi ;;
+  esac
+done
+
+if test -z "$ltmain"; then
+  echo "$progname: you must specify a LTMAIN file" 1>&2
+  echo "$help" 1>&2
+  exit 1
+fi
+
+if test ! -f "$ltmain"; then
+  echo "$progname: \`$ltmain' does not exist" 1>&2
+  echo "$help" 1>&2
+  exit 1
+fi
+
+# Quote any args containing shell metacharacters.
+ltconfig_args=
+for arg
+do
+  case "$arg" in
+  *" "*|*"	"*|*[\[\]\~\#\$\^\&\*\(\)\{\}\\\|\;\<\>\?]*)
+  ltconfig_args="$ltconfig_args '$arg'" ;;
+  *) ltconfig_args="$ltconfig_args $arg" ;;
+  esac
+done
+
+# A relevant subset of AC_INIT.
+
+# File descriptor usage:
+# 0 standard input
+# 1 file creation
+# 2 errors and warnings
+# 3 some systems may open it to /dev/tty
+# 4 used on the Kubota Titan
+# 5 compiler messages saved in config.log
+# 6 checking for... messages and results
+if test "$silent" = yes; then
+  exec 6>/dev/null
+else
+  exec 6>&1
+fi
+exec 5>>./config.log
+
+# NLS nuisances.
+# Only set LANG and LC_ALL to C if already set.
+# These must not be set unconditionally because not all systems understand
+# e.g. LANG=C (notably SCO).
+if test "X${LC_ALL+set}" = Xset; then LC_ALL=C; export LC_ALL; fi
+if test "X${LANG+set}"   = Xset; then LANG=C;   export LANG;   fi
+
+if test -n "$cache_file" && test -r "$cache_file"; then
+  echo "loading cache $cache_file within ltconfig"
+  . $cache_file
+fi
+
+if (echo "testing\c"; echo 1,2,3) | grep c >/dev/null; then
+  # Stardent Vistra SVR4 grep lacks -e, says ghazi@caip.rutgers.edu.
+  if (echo -n testing; echo 1,2,3) | sed s/-n/xn/ | grep xn >/dev/null; then
+    ac_n= ac_c='
+' ac_t='	'
+  else
+    ac_n=-n ac_c= ac_t=
+  fi
+else
+  ac_n= ac_c='\c' ac_t=
+fi
+
+if test -z "$srcdir"; then
+  # Assume the source directory is the same one as the path to LTMAIN.
+  srcdir=`$echo "X$ltmain" | $Xsed -e 's%/[^/]*$%%'`
+  test "$srcdir" = "$ltmain" && srcdir=.
+fi
+
+trap "$rm conftest*; exit 1" 1 2 15
+if test "$verify_host" = yes; then
+  # Check for config.guess and config.sub.
+  ac_aux_dir=
+  for ac_dir in $srcdir $srcdir/.. $srcdir/../..; do
+    if test -f $ac_dir/config.guess; then
+      ac_aux_dir=$ac_dir
+      break
+    fi
+  done
+  if test -z "$ac_aux_dir"; then
+    echo "$progname: cannot find config.guess in $srcdir $srcdir/.. $srcdir/../.." 1>&2
+    echo "$help" 1>&2
+    exit 1
+  fi
+  ac_config_guess=$ac_aux_dir/config.guess
+  ac_config_sub=$ac_aux_dir/config.sub
+
+  # Make sure we can run config.sub.
+  if $SHELL $ac_config_sub sun4 >/dev/null 2>&1; then :
+  else
+    echo "$progname: cannot run $ac_config_sub" 1>&2
+    echo "$help" 1>&2
+    exit 1
+  fi
+
+  echo $ac_n "checking host system type""... $ac_c" 1>&6
+
+  host_alias=$host
+  case "$host_alias" in
+  "")
+    if host_alias=`$SHELL $ac_config_guess`; then :
+    else
+      echo "$progname: cannot guess host type; you must specify one" 1>&2
+      echo "$help" 1>&2
+      exit 1
+    fi ;;
+  esac
+  host=`$SHELL $ac_config_sub $host_alias`
+  echo "$ac_t$host" 1>&6
+
+  # Make sure the host verified.
+  test -z "$host" && exit 1
+
+elif test -z "$host"; then
+  echo "$progname: you must specify a host type if you use \`--no-verify'" 1>&2
+  echo "$help" 1>&2
+  exit 1
+else
+  host_alias=$host
+fi
+
+# Transform linux* to *-*-linux-gnu*, to support old configure scripts.
+case "$host_os" in
+linux-gnu*) ;;
+linux*) host=`echo $host | sed 's/^\(.*-.*-linux\)\(.*\)$/\1-gnu\2/'`
+esac
+
+host_cpu=`echo $host | sed 's/^\([^-]*\)-\([^-]*\)-\(.*\)$/\1/'`
+host_vendor=`echo $host | sed 's/^\([^-]*\)-\([^-]*\)-\(.*\)$/\2/'`
+host_os=`echo $host | sed 's/^\([^-]*\)-\([^-]*\)-\(.*\)$/\3/'`
+
+case "$host_os" in
+aix3*)
+  # AIX sometimes has problems with the GCC collect2 program.  For some
+  # reason, if we set the COLLECT_NAMES environment variable, the problems
+  # vanish in a puff of smoke.
+  if test "X${COLLECT_NAMES+set}" != Xset; then
+    COLLECT_NAMES=
+    export COLLECT_NAMES
+  fi
+  ;;
+esac
+
+# Determine commands to create old-style static archives.
+old_archive_cmds='$AR cru $oldlib$oldobjs'
+old_postinstall_cmds='chmod 644 $oldlib'
+old_postuninstall_cmds=
+
+# Set a sane default for `AR'.
+test -z "$AR" && AR=ar
+
+# Set a sane default for `OBJDUMP'.
+test -z "$OBJDUMP" && OBJDUMP=objdump
+
+# If RANLIB is not set, then run the test.
+if test "${RANLIB+set}" != "set"; then
+  result=no
+
+  echo $ac_n "checking for ranlib... $ac_c" 1>&6
+  IFS="${IFS= 	}"; save_ifs="$IFS"; IFS="${IFS}${PATH_SEPARATOR}"
+  for dir in $PATH; do
+    test -z "$dir" && dir=.
+    if test -f $dir/ranlib || test -f $dir/ranlib$ac_exeext; then
+      RANLIB="ranlib"
+      result="ranlib"
+      break
+    fi
+  done
+  IFS="$save_ifs"
+
+  echo "$ac_t$result" 1>&6
+fi
+
+if test -n "$RANLIB"; then
+  old_archive_cmds="$old_archive_cmds~\$RANLIB \$oldlib"
+  old_postinstall_cmds="\$RANLIB \$oldlib~$old_postinstall_cmds"
+fi
+
+# Set sane defaults for `DLLTOOL', `OBJDUMP', and `AS', used on cygwin.
+test -z "$DLLTOOL" && DLLTOOL=dlltool
+test -z "$OBJDUMP" && OBJDUMP=objdump
+test -z "$AS" && AS=as
+
+# Check to see if we are using GCC.
+if test "$with_gcc" != yes || test -z "$CC"; then
+  # If CC is not set, then try to find GCC or a usable CC.
+  if test -z "$CC"; then
+    echo $ac_n "checking for gcc... $ac_c" 1>&6
+    IFS="${IFS= 	}"; save_ifs="$IFS"; IFS="${IFS}${PATH_SEPARATOR}"
+    for dir in $PATH; do
+      test -z "$dir" && dir=.
+      if test -f $dir/gcc || test -f $dir/gcc$ac_exeext; then
+	CC="gcc"
+	break
+      fi
+    done
+    IFS="$save_ifs"
+
+    if test -n "$CC"; then
+      echo "$ac_t$CC" 1>&6
+    else
+      echo "$ac_t"no 1>&6
+    fi
+  fi
+
+  # Not "gcc", so try "cc", rejecting "/usr/ucb/cc".
+  if test -z "$CC"; then
+    echo $ac_n "checking for cc... $ac_c" 1>&6
+    IFS="${IFS= 	}"; save_ifs="$IFS"; IFS="${IFS}${PATH_SEPARATOR}"
+    cc_rejected=no
+    for dir in $PATH; do
+      test -z "$dir" && dir=.
+      if test -f $dir/cc || test -f $dir/cc$ac_exeext; then
+	if test "$dir/cc" = "/usr/ucb/cc"; then
+	  cc_rejected=yes
+	  continue
+	fi
+	CC="cc"
+	break
+      fi
+    done
+    IFS="$save_ifs"
+    if test $cc_rejected = yes; then
+      # We found a bogon in the path, so make sure we never use it.
+      set dummy $CC
+      shift
+      if test $# -gt 0; then
+	# We chose a different compiler from the bogus one.
+	# However, it has the same name, so the bogon will be chosen
+	# first if we set CC to just the name; use the full file name.
+	shift
+	set dummy "$dir/cc" "$@"
+	shift
+	CC="$@"
+      fi
+    fi
+
+    if test -n "$CC"; then
+      echo "$ac_t$CC" 1>&6
+    else
+      echo "$ac_t"no 1>&6
+    fi
+
+    if test -z "$CC"; then
+      echo "$progname: error: no acceptable cc found in \$PATH" 1>&2
+      exit 1
+    fi
+  fi
+
+  # Now see if the compiler is really GCC.
+  with_gcc=no
+  echo $ac_n "checking whether we are using GNU C... $ac_c" 1>&6
+  echo "$progname:581: checking whether we are using GNU C" >&5
+
+  $rm conftest.c
+  cat > conftest.c <<EOF
+#ifdef __GNUC__
+  yes;
+#endif
+EOF
+  if { ac_try='${CC-cc} -E conftest.c'; { (eval echo $progname:589: \"$ac_try\") 1>&5; (eval $ac_try) 2>&5; }; } | egrep yes >/dev/null 2>&1; then
+    with_gcc=yes
+  fi
+  $rm conftest.c
+  echo "$ac_t$with_gcc" 1>&6
+fi
+
+# Allow CC to be a program name with arguments.
+set dummy $CC
+compiler="$2"
+
+echo $ac_n "checking for object suffix... $ac_c" 1>&6
+$rm conftest*
+echo 'int i = 1;' > conftest.c
+echo "$progname:603: checking for object suffix" >& 5
+if { (eval echo $progname:604: \"$ac_compile\") 1>&5; (eval $ac_compile) 2>conftest.err; }; then
+  # Append any warnings to the config.log.
+  cat conftest.err 1>&5
+
+  for ac_file in conftest.*; do
+    case $ac_file in
+    *.c) ;;
+    *) objext=`echo $ac_file | sed -e s/conftest.//` ;;
+    esac
+  done
+else
+  cat conftest.err 1>&5
+  echo "$progname: failed program was:" >&5
+  cat conftest.c >&5
+fi
+$rm conftest*
+echo "$ac_t$objext" 1>&6
+
+echo $ac_n "checking for executable suffix... $ac_c" 1>&6
+if eval "test \"`echo '$''{'ac_cv_exeext'+set}'`\" = set"; then
+  echo $ac_n "(cached) $ac_c" 1>&6
+else
+  ac_cv_exeext="no"
+  $rm conftest*
+  echo 'main () { return 0; }' > conftest.c
+  echo "$progname:629: checking for executable suffix" >& 5
+  if { (eval echo $progname:630: \"$ac_link\") 1>&5; (eval $ac_link) 2>conftest.err; }; then
+    # Append any warnings to the config.log.
+    cat conftest.err 1>&5
+
+    for ac_file in conftest.*; do
+      case $ac_file in
+      *.c | *.err | *.$objext ) ;;
+      *) ac_cv_exeext=.`echo $ac_file | sed -e s/conftest.//` ;;
+      esac
+    done
+  else
+    cat conftest.err 1>&5
+    echo "$progname: failed program was:" >&5
+    cat conftest.c >&5
+  fi
+  $rm conftest*
+fi
+if test "X$ac_cv_exeext" = Xno; then
+  exeext=""
+else
+  exeext="$ac_cv_exeext"
+fi
+echo "$ac_t$ac_cv_exeext" 1>&6
+
+echo $ac_n "checking for $compiler option to produce PIC... $ac_c" 1>&6
+pic_flag=
+special_shlib_compile_flags=
+wl=
+link_static_flag=
+no_builtin_flag=
+
+if test "$with_gcc" = yes; then
+  wl='-Wl,'
+  link_static_flag='-static'
+
+  case "$host_os" in
+  beos* | irix5* | irix6* | osf3* | osf4* | osf5*)
+    # PIC is the default for these OSes.
+    ;;
+  aix*)
+    # Below there is a dirty hack to force normal static linking with -ldl
+    # The problem is because libdl dynamically linked with both libc and
+    # libC (AIX C++ library), which obviously doesn't included in libraries
+    # list by gcc. This cause undefined symbols with -static flags.
+    # This hack allows C programs to be linked with "-static -ldl", but
+    # we not sure about C++ programs.
+    link_static_flag="$link_static_flag ${wl}-lC"
+    ;;
+  cygwin* | mingw* | os2*)
+    # We can build DLLs from non-PIC.
+    ;;
+  amigaos*)
+    # FIXME: we need at least 68020 code to build shared libraries, but
+    # adding the `-m68020' flag to GCC prevents building anything better,
+    # like `-m68040'.
+    pic_flag='-m68020 -resident32 -malways-restore-a4'
+    ;;
+  sysv4*MP*)
+    if test -d /usr/nec; then
+       pic_flag=-Kconform_pic
+    fi
+    ;;
+  *)
+    pic_flag='-fPIC'
+    ;;
+  esac
+else
+  # PORTME Check for PIC flags for the system compiler.
+  case "$host_os" in
+  aix3* | aix4*)
+    # All AIX code is PIC.
+    link_static_flag='-bnso -bI:/lib/syscalls.exp'
+    ;;
+
+  hpux9* | hpux10* | hpux11*)
+    # Is there a better link_static_flag that works with the bundled CC?
+    wl='-Wl,'
+    link_static_flag="${wl}-a ${wl}archive"
+    pic_flag='+Z'
+    ;;
+
+  irix5* | irix6*)
+    wl='-Wl,'
+    link_static_flag='-non_shared'
+    # PIC (with -KPIC) is the default.
+    ;;
+
+  cygwin* | mingw* | os2*)
+    # We can build DLLs from non-PIC.
+    ;;
+
+  osf3* | osf4* | osf5*)
+    # All OSF/1 code is PIC.
+    wl='-Wl,'
+    link_static_flag='-non_shared'
+    ;;
+
+  sco3.2v5*)
+    pic_flag='-Kpic'
+    link_static_flag='-dn'
+    special_shlib_compile_flags='-belf'
+    ;;
+
+  solaris*)
+    pic_flag='-KPIC'
+    link_static_flag='-Bstatic'
+    wl='-Wl,'
+    ;;
+
+  sunos4*)
+    pic_flag='-PIC'
+    link_static_flag='-Bstatic'
+    wl='-Qoption ld '
+    ;;
+
+  sysv4 | sysv4.2uw2* | sysv4.3* | sysv5*)
+    pic_flag='-KPIC'
+    link_static_flag='-Bstatic'
+    wl='-Wl,'
+    ;;
+
+  uts4*)
+    pic_flag='-pic'
+    link_static_flag='-Bstatic'
+    ;;
+  sysv4*MP*)
+    if test -d /usr/nec ;then
+      pic_flag='-Kconform_pic'
+      link_static_flag='-Bstatic'
+    fi
+    ;;
+  *)
+    can_build_shared=no
+    ;;
+  esac
+fi
+
+if test -n "$pic_flag"; then
+  echo "$ac_t$pic_flag" 1>&6
+
+  # Check to make sure the pic_flag actually works.
+  echo $ac_n "checking if $compiler PIC flag $pic_flag works... $ac_c" 1>&6
+  $rm conftest*
+  echo "int some_variable = 0;" > conftest.c
+  save_CFLAGS="$CFLAGS"
+  CFLAGS="$CFLAGS $pic_flag -DPIC"
+  echo "$progname:776: checking if $compiler PIC flag $pic_flag works" >&5
+  if { (eval echo $progname:777: \"$ac_compile\") 1>&5; (eval $ac_compile) 2>conftest.err; } && test -s conftest.$objext; then
+    # Append any warnings to the config.log.
+    cat conftest.err 1>&5
+    
+    case "$host_os" in
+    hpux9* | hpux10* | hpux11*)
+      # On HP-UX, both CC and GCC only warn that PIC is supported... then they
+      # create non-PIC objects.  So, if there were any warnings, we assume that
+      # PIC is not supported.
+      if test -s conftest.err; then
+	echo "$ac_t"no 1>&6
+	can_build_shared=no
+	pic_flag=
+      else
+	echo "$ac_t"yes 1>&6
+	pic_flag=" $pic_flag"
+      fi
+      ;;
+    *)
+      echo "$ac_t"yes 1>&6
+      pic_flag=" $pic_flag"
+      ;;
+    esac
+  else
+    # Append any errors to the config.log.
+    cat conftest.err 1>&5
+    can_build_shared=no
+    pic_flag=
+    echo "$ac_t"no 1>&6
+  fi
+  CFLAGS="$save_CFLAGS"
+  $rm conftest*
+else
+  echo "$ac_t"none 1>&6
+fi
+
+# Check to see if options -o and -c are simultaneously supported by compiler
+echo $ac_n "checking if $compiler supports -c -o file.o... $ac_c" 1>&6
+$rm -r conftest 2>/dev/null
+mkdir conftest
+cd conftest
+$rm conftest*
+echo "int some_variable = 0;" > conftest.c
+mkdir out
+# According to Tom Tromey, Ian Lance Taylor reported there are C compilers
+# that will create temporary files in the current directory regardless of
+# the output directory.  Thus, making CWD read-only will cause this test
+# to fail, enabling locking or at least warning the user not to do parallel
+# builds.
+chmod -w .
+save_CFLAGS="$CFLAGS"
+CFLAGS="$CFLAGS -o out/conftest2.o"
+echo "$progname:829: checking if $compiler supports -c -o file.o" >&5
+if { (eval echo $progname:830: \"$ac_compile\") 1>&5; (eval $ac_compile) 2>out/conftest.err; } && test -s out/conftest2.o; then
+
+  # The compiler can only warn and ignore the option if not recognized
+  # So say no if there are warnings
+    if test -s out/conftest.err; then
+      echo "$ac_t"no 1>&6
+      compiler_c_o=no
+    else
+      echo "$ac_t"yes 1>&6
+      compiler_c_o=yes
+    fi
+else
+  # Append any errors to the config.log.
+  cat out/conftest.err 1>&5
+  compiler_c_o=no
+  echo "$ac_t"no 1>&6
+fi
+CFLAGS="$save_CFLAGS"
+chmod u+w .
+$rm conftest* out/*
+rmdir out
+cd ..
+rmdir conftest
+$rm -r conftest 2>/dev/null
+
+if test x"$compiler_c_o" = x"yes"; then
+  # Check to see if we can write to a .lo
+  echo $ac_n "checking if $compiler supports -c -o file.lo... $ac_c" 1>&6
+  $rm conftest*
+  echo "int some_variable = 0;" > conftest.c
+  save_CFLAGS="$CFLAGS"
+  CFLAGS="$CFLAGS -c -o conftest.lo"
+  echo "$progname:862: checking if $compiler supports -c -o file.lo" >&5
+if { (eval echo $progname:863: \"$ac_compile\") 1>&5; (eval $ac_compile) 2>conftest.err; } && test -s conftest.lo; then
+
+    # The compiler can only warn and ignore the option if not recognized
+    # So say no if there are warnings
+      if test -s conftest.err; then
+	echo "$ac_t"no 1>&6
+	compiler_o_lo=no
+      else
+	echo "$ac_t"yes 1>&6
+	compiler_o_lo=yes
+      fi
+  else
+    # Append any errors to the config.log.
+    cat conftest.err 1>&5
+    compiler_o_lo=no
+    echo "$ac_t"no 1>&6
+  fi
+  CFLAGS="$save_CFLAGS"
+  $rm conftest*
+else
+  compiler_o_lo=no
+fi
+
+# Check to see if we can do hard links to lock some files if needed
+hard_links="nottested"
+if test "$compiler_c_o" = no && test "$need_locks" != no; then
+  # do not overwrite the value of need_locks provided by the user
+  echo $ac_n "checking if we can lock with hard links... $ac_c" 1>&6
+  hard_links=yes
+  $rm conftest*
+  ln conftest.a conftest.b 2>/dev/null && hard_links=no
+  touch conftest.a
+  ln conftest.a conftest.b 2>&5 || hard_links=no
+  ln conftest.a conftest.b 2>/dev/null && hard_links=no
+  echo "$ac_t$hard_links" 1>&6
+  $rm conftest*
+  if test "$hard_links" = no; then
+    echo "*** WARNING: \`$CC' does not support \`-c -o', so \`make -j' may be unsafe" >&2
+    need_locks=warn
+  fi
+else
+  need_locks=no
+fi
+
+if test "$with_gcc" = yes; then
+  # Check to see if options -fno-rtti -fno-exceptions are supported by compiler
+  echo $ac_n "checking if $compiler supports -fno-rtti -fno-exceptions ... $ac_c" 1>&6
+  $rm conftest*
+  echo "int some_variable = 0;" > conftest.c
+  save_CFLAGS="$CFLAGS"
+  CFLAGS="$CFLAGS -fno-rtti -fno-exceptions -c conftest.c"
+  echo "$progname:914: checking if $compiler supports -fno-rtti -fno-exceptions" >&5
+  if { (eval echo $progname:915: \"$ac_compile\") 1>&5; (eval $ac_compile) 2>conftest.err; } && test -s conftest.o; then
+
+    # The compiler can only warn and ignore the option if not recognized
+    # So say no if there are warnings
+      if test -s conftest.err; then
+	echo "$ac_t"no 1>&6
+	compiler_rtti_exceptions=no
+      else
+	echo "$ac_t"yes 1>&6
+	compiler_rtti_exceptions=yes
+      fi
+  else
+    # Append any errors to the config.log.
+    cat conftest.err 1>&5
+    compiler_rtti_exceptions=no
+    echo "$ac_t"no 1>&6
+  fi
+  CFLAGS="$save_CFLAGS"
+  $rm conftest*
+
+  if test "$compiler_rtti_exceptions" = "yes"; then
+    no_builtin_flag=' -fno-builtin -fno-rtti -fno-exceptions'
+  else
+    no_builtin_flag=' -fno-builtin'
+  fi
+  
+fi
+
+# Check for any special shared library compilation flags.
+if test -n "$special_shlib_compile_flags"; then
+  echo "$progname: warning: \`$CC' requires \`$special_shlib_compile_flags' to build shared libraries" 1>&2
+  if echo "$old_CC $old_CFLAGS " | egrep -e "[ 	]$special_shlib_compile_flags[ 	]" >/dev/null; then :
+  else
+    echo "$progname: add \`$special_shlib_compile_flags' to the CC or CFLAGS env variable and reconfigure" 1>&2
+    can_build_shared=no
+  fi
+fi
+
+echo $ac_n "checking if $compiler static flag $link_static_flag works... $ac_c" 1>&6
+$rm conftest*
+echo 'main(){return(0);}' > conftest.c
+save_LDFLAGS="$LDFLAGS"
+LDFLAGS="$LDFLAGS $link_static_flag"
+echo "$progname:958: checking if $compiler static flag $link_static_flag works" >&5
+if { (eval echo $progname:959: \"$ac_link\") 1>&5; (eval $ac_link) 2>&5; } && test -s conftest; then
+  echo "$ac_t$link_static_flag" 1>&6
+else
+  echo "$ac_t"none 1>&6
+  link_static_flag=
+fi
+LDFLAGS="$save_LDFLAGS"
+$rm conftest*
+
+if test -z "$LN_S"; then
+  # Check to see if we can use ln -s, or we need hard links.
+  echo $ac_n "checking whether ln -s works... $ac_c" 1>&6
+  $rm conftest.dat
+  if ln -s X conftest.dat 2>/dev/null; then
+    $rm conftest.dat
+    LN_S="ln -s"
+  else
+    LN_S=ln
+  fi
+  if test "$LN_S" = "ln -s"; then
+    echo "$ac_t"yes 1>&6
+  else
+    echo "$ac_t"no 1>&6
+  fi
+fi
+
+# Make sure LD is an absolute path.
+if test -z "$LD"; then
+  ac_prog=ld
+  if test "$with_gcc" = yes; then
+    # Check if gcc -print-prog-name=ld gives a path.
+    echo $ac_n "checking for ld used by GCC... $ac_c" 1>&6
+    echo "$progname:991: checking for ld used by GCC" >&5
+    ac_prog=`($CC -print-prog-name=ld) 2>&5`
+    case "$ac_prog" in
+    # Accept absolute paths.
+    [\\/]* | [A-Za-z]:[\\/]*)
+      re_direlt='/[^/][^/]*/\.\./'
+      # Canonicalize the path of ld
+      ac_prog=`echo $ac_prog| sed 's%\\\\%/%g'`
+      while echo $ac_prog | grep "$re_direlt" > /dev/null 2>&1; do
+	ac_prog=`echo $ac_prog| sed "s%$re_direlt%/%"`
+      done
+      test -z "$LD" && LD="$ac_prog"
+      ;;
+    "")
+      # If it fails, then pretend we are not using GCC.
+      ac_prog=ld
+      ;;
+    *)
+      # If it is relative, then search for the first ld in PATH.
+      with_gnu_ld=unknown
+      ;;
+    esac
+  elif test "$with_gnu_ld" = yes; then
+    echo $ac_n "checking for GNU ld... $ac_c" 1>&6
+    echo "$progname:1015: checking for GNU ld" >&5
+  else
+    echo $ac_n "checking for non-GNU ld""... $ac_c" 1>&6
+    echo "$progname:1018: checking for non-GNU ld" >&5
+  fi
+
+  if test -z "$LD"; then
+    IFS="${IFS= 	}"; ac_save_ifs="$IFS"; IFS="${IFS}${PATH_SEPARATOR}"
+    for ac_dir in $PATH; do
+      test -z "$ac_dir" && ac_dir=.
+      if test -f "$ac_dir/$ac_prog" || test -f "$ac_dir/$ac_prog$ac_exeext"; then
+	LD="$ac_dir/$ac_prog"
+	# Check to see if the program is GNU ld.  I'd rather use --version,
+	# but apparently some GNU ld's only accept -v.
+	# Break only if it was the GNU/non-GNU ld that we prefer.
+	if "$LD" -v 2>&1 < /dev/null | egrep '(GNU|with BFD)' > /dev/null; then
+	  test "$with_gnu_ld" != no && break
+	else
+	  test "$with_gnu_ld" != yes && break
+	fi
+      fi
+    done
+    IFS="$ac_save_ifs"
+  fi
+
+  if test -n "$LD"; then
+    echo "$ac_t$LD" 1>&6
+  else
+    echo "$ac_t"no 1>&6
+  fi
+
+  if test -z "$LD"; then
+    echo "$progname: error: no acceptable ld found in \$PATH" 1>&2
+    exit 1
+  fi
+fi
+
+# Check to see if it really is or is not GNU ld.
+echo $ac_n "checking if the linker ($LD) is GNU ld... $ac_c" 1>&6
+# I'd rather use --version here, but apparently some GNU ld's only accept -v.
+if $LD -v 2>&1 </dev/null | egrep '(GNU|with BFD)' 1>&5; then
+  with_gnu_ld=yes
+else
+  with_gnu_ld=no
+fi
+echo "$ac_t$with_gnu_ld" 1>&6
+
+# See if the linker supports building shared libraries.
+echo $ac_n "checking whether the linker ($LD) supports shared libraries... $ac_c" 1>&6
+
+allow_undefined_flag=
+no_undefined_flag=
+need_lib_prefix=unknown
+need_version=unknown
+# when you set need_version to no, make sure it does not cause -set_version
+# flags to be left without arguments
+archive_cmds=
+archive_expsym_cmds=
+old_archive_from_new_cmds=
+export_dynamic_flag_spec=
+whole_archive_flag_spec=
+thread_safe_flag_spec=
+hardcode_libdir_flag_spec=
+hardcode_libdir_separator=
+hardcode_direct=no
+hardcode_minus_L=no
+hardcode_shlibpath_var=unsupported
+runpath_var=
+always_export_symbols=no
+export_symbols_cmds='$NM $libobjs $convenience | $global_symbol_pipe | sed '\''s/.* //'\'' | sort | uniq > $export_symbols'
+# include_expsyms should be a list of space-separated symbols to be *always*
+# included in the symbol list
+include_expsyms=
+# exclude_expsyms can be an egrep regular expression of symbols to exclude
+# it will be wrapped by ` (' and `)$', so one must not match beginning or
+# end of line.  Example: `a|bc|.*d.*' will exclude the symbols `a' and `bc',
+# as well as any symbol that contains `d'.
+exclude_expsyms="_GLOBAL_OFFSET_TABLE_"
+# Although _GLOBAL_OFFSET_TABLE_ is a valid symbol C name, most a.out
+# platforms (ab)use it in PIC code, but their linkers get confused if
+# the symbol is explicitly referenced.  Since portable code cannot
+# rely on this symbol name, it's probably fine to never include it in
+# preloaded symbol tables.
+
+case "$host_os" in
+cygwin* | mingw*)
+  # FIXME: the MSVC++ port hasn't been tested in a loooong time
+  # When not using gcc, we currently assume that we are using
+  # Microsoft Visual C++.
+  if test "$with_gcc" != yes; then
+    with_gnu_ld=no
+  fi
+  ;;
+
+esac
+
+ld_shlibs=yes
+if test "$with_gnu_ld" = yes; then
+  # If archive_cmds runs LD, not CC, wlarc should be empty
+  wlarc='${wl}'
+
+  # See if GNU ld supports shared libraries.
+  case "$host_os" in
+  aix3* | aix4*)
+    # On AIX, the GNU linker is very broken
+    ld_shlibs=no
+    cat <<EOF 1>&2
+
+*** Warning: the GNU linker, at least up to release 2.9.1, is reported
+*** to be unable to reliably create shared libraries on AIX.
+*** Therefore, libtool is disabling shared libraries support.  If you
+*** really care for shared libraries, you may want to modify your PATH
+*** so that a non-GNU linker is found, and then restart.
+
+EOF
+    ;;
+
+  amigaos*)
+    archive_cmds='$rm $objdir/a2ixlibrary.data~$echo "#define NAME $libname" > $objdir/a2ixlibrary.data~$echo "#define LIBRARY_ID 1" >> $objdir/a2ixlibrary.data~$echo "#define VERSION $major" >> $objdir/a2ixlibrary.data~$echo "#define REVISION $revision" >> $objdir/a2ixlibrary.data~$AR cru $lib $libobjs~$RANLIB $lib~(cd $objdir && a2ixlibrary -32)'
+    hardcode_libdir_flag_spec='-L$libdir'
+    hardcode_minus_L=yes
+
+    # Samuel A. Falvo II <kc5tja@dolphin.openprojects.net> reports
+    # that the semantics of dynamic libraries on AmigaOS, at least up
+    # to version 4, is to share data among multiple programs linked
+    # with the same dynamic library.  Since this doesn't match the
+    # behavior of shared libraries on other platforms, we can use
+    # them.
+    ld_shlibs=no
+    ;;
+
+  beos*)
+    if $LD --help 2>&1 | egrep ': supported targets:.* elf' > /dev/null; then
+      allow_undefined_flag=unsupported
+      # Joseph Beckenbach <jrb3@best.com> says some releases of gcc
+      # support --undefined.  This deserves some investigation.  FIXME
+      archive_cmds='$CC -nostart $libobjs $deplibs $linkopts ${wl}-soname $wl$soname -o $lib'
+    else
+      ld_shlibs=no
+    fi
+    ;;
+
+  cygwin* | mingw*)
+    # hardcode_libdir_flag_spec is actually meaningless, as there is
+    # no search path for DLLs.
+    hardcode_libdir_flag_spec='-L$libdir'
+    allow_undefined_flag=unsupported
+    always_export_symbols=yes
+
+    # Extract the symbol export list from an `--export-all' def file,
+    # then regenerate the def file from the symbol export list, so that
+    # the compiled dll only exports the symbol export list.
+    # Be careful not to strip the DATA tag left by newer dlltools.
+    export_symbols_cmds='test -f $objdir/$soname-ltdll.c || sed -e "/^# \/\* ltdll\.c starts here \*\//,/^# \/\* ltdll.c ends here \*\// { s/^# //; p; }" -e d < $0 > $objdir/$soname-ltdll.c~
+      test -f $objdir/$soname-ltdll.$objext || (cd $objdir && $CC -c $soname-ltdll.c)~
+      $DLLTOOL --export-all --exclude-symbols DllMain@12,_cygwin_dll_entry@12,_cygwin_noncygwin_dll_entry@12 --output-def $objdir/$soname-def  $objdir/$soname-ltdll.$objext $libobjs $convenience~
+      sed -e "1,/EXPORTS/d" -e "s/ @ [0-9]*//" -e "s/ *;.*$//" < $objdir/$soname-def > $export_symbols'
+
+    # If DATA tags from a recent dlltool are present, honour them!
+    archive_expsym_cmds='echo EXPORTS > $objdir/$soname-def~
+      _lt_hint=1;
+      cat $export_symbols | while read symbol; do
+        set dummy \$symbol;
+        case \$# in
+          2) echo "	\$2 @ \$_lt_hint ; " >> $objdir/$soname-def;;
+          *) echo "     \$2 @ \$_lt_hint \$3 ; " >> $objdir/$soname-def;;
+        esac;
+	_lt_hint=`expr 1 + \$_lt_hint`;
+      done~
+      test -f $objdir/$soname-ltdll.c || sed -e "/^# \/\* ltdll\.c starts here \*\//,/^# \/\* ltdll.c ends here \*\// { s/^# //; p; }" -e d < $0 > $objdir/$soname-ltdll.c~
+      test -f $objdir/$soname-ltdll.$objext || (cd $objdir && $CC -c $soname-ltdll.c)~
+      $CC -Wl,--base-file,$objdir/$soname-base -Wl,--dll -nostartfiles -Wl,-e,__cygwin_dll_entry@12 -o $lib $objdir/$soname-ltdll.$objext $libobjs $deplibs $linkopts~
+      $DLLTOOL --as=$AS --dllname $soname --exclude-symbols DllMain@12,_cygwin_dll_entry@12,_cygwin_noncygwin_dll_entry@12 --def $objdir/$soname-def --base-file $objdir/$soname-base --output-exp $objdir/$soname-exp~
+      $CC -Wl,--base-file,$objdir/$soname-base $objdir/$soname-exp -Wl,--dll -nostartfiles -Wl,-e,__cygwin_dll_entry@12 -o $lib $objdir/$soname-ltdll.$objext $libobjs $deplibs $linkopts~
+      $DLLTOOL --as=$AS --dllname $soname --exclude-symbols DllMain@12,_cygwin_dll_entry@12,_cygwin_noncygwin_dll_entry@12 --def $objdir/$soname-def --base-file $objdir/$soname-base --output-exp $objdir/$soname-exp~
+      $CC $objdir/$soname-exp -Wl,--dll -nostartfiles -Wl,-e,__cygwin_dll_entry@12 -o $lib $objdir/$soname-ltdll.$objext $libobjs $deplibs $linkopts'
+
+      old_archive_from_new_cmds='$DLLTOOL --as=$AS --dllname $soname --def $objdir/$soname-def --output-lib $objdir/$libname.a' 
+    ;;
+
+  netbsd*)
+    if echo __ELF__ | $CC -E - | grep __ELF__ >/dev/null; then
+      archive_cmds='$CC -shared $libobjs $deplibs $linkopts ${wl}-soname $wl$soname -o $lib'
+      archive_expsym_cmds='$CC -shared $libobjs $deplibs $linkopts ${wl}-soname $wl$soname ${wl}-retain-symbols-file $wl$export_symbols -o $lib'
+    else
+      archive_cmds='$LD -Bshareable $libobjs $deplibs $linkopts -o $lib'
+      # can we support soname and/or expsyms with a.out? -oliva
+    fi
+    ;;
+
+  solaris* | sysv5*)
+    if $LD -v 2>&1 | egrep 'BFD 2\.8' > /dev/null; then
+      ld_shlibs=no
+      cat <<EOF 1>&2
+
+*** Warning: The releases 2.8.* of the GNU linker cannot reliably
+*** create shared libraries on Solaris systems.  Therefore, libtool
+*** is disabling shared libraries support.  We urge you to upgrade GNU
+*** binutils to release 2.9.1 or newer.  Another option is to modify
+*** your PATH or compiler configuration so that the native linker is
+*** used, and then restart.
+
+EOF
+    elif $LD --help 2>&1 | egrep ': supported targets:.* elf' > /dev/null; then
+      archive_cmds='$CC -shared $libobjs $deplibs $linkopts ${wl}-soname $wl$soname -o $lib'
+      archive_expsym_cmds='$CC -shared $libobjs $deplibs $linkopts ${wl}-soname $wl$soname ${wl}-retain-symbols-file $wl$export_symbols -o $lib'
+    else
+      ld_shlibs=no
+    fi
+    ;;      
+
+  sunos4*)
+    archive_cmds='$LD -assert pure-text -Bshareable -o $lib $libobjs $deplibs $linkopts'
+    wlarc=
+    hardcode_direct=yes
+    hardcode_shlibpath_var=no
+    ;;
+
+  *)
+    if $LD --help 2>&1 | egrep ': supported targets:.* elf' > /dev/null; then
+      archive_cmds='$CC -shared $libobjs $deplibs $linkopts ${wl}-soname $wl$soname -o $lib'
+      archive_expsym_cmds='$CC -shared $libobjs $deplibs $linkopts ${wl}-soname $wl$soname ${wl}-retain-symbols-file $wl$export_symbols -o $lib'
+    else
+      ld_shlibs=no
+    fi
+    ;;
+  esac
+
+  if test "$ld_shlibs" = yes; then
+    runpath_var=LD_RUN_PATH
+    hardcode_libdir_flag_spec='${wl}--rpath ${wl}$libdir'
+    export_dynamic_flag_spec='${wl}--export-dynamic'
+    case $host_os in
+    cygwin* | mingw*)
+      # dlltool doesn't understand --whole-archive et. al.
+      whole_archive_flag_spec=
+      ;;
+    *)
+      # ancient GNU ld didn't support --whole-archive et. al.
+      if $LD --help 2>&1 | egrep 'no-whole-archive' > /dev/null; then
+        whole_archive_flag_spec="$wlarc"'--whole-archive$convenience '"$wlarc"'--no-whole-archive'
+      else
+        whole_archive_flag_spec=
+      fi
+      ;;
+    esac
+  fi
+else
+  # PORTME fill in a description of your system's linker (not GNU ld)
+  case "$host_os" in
+  aix3*)
+    allow_undefined_flag=unsupported
+    always_export_symbols=yes
+    archive_expsym_cmds='$LD -o $objdir/$soname $libobjs $deplibs $linkopts -bE:$export_symbols -T512 -H512 -bM:SRE~$AR cru $lib $objdir/$soname'
+    # Note: this linker hardcodes the directories in LIBPATH if there
+    # are no directories specified by -L.
+    hardcode_minus_L=yes
+    if test "$with_gcc" = yes && test -z "$link_static_flag"; then
+      # Neither direct hardcoding nor static linking is supported with a
+      # broken collect2.
+      hardcode_direct=unsupported
+    fi
+    ;;
+
+  aix4*)
+    hardcode_libdir_flag_spec='${wl}-b ${wl}nolibpath ${wl}-b ${wl}libpath:$libdir:/usr/lib:/lib'
+    hardcode_libdir_separator=':'
+    if test "$with_gcc" = yes; then
+      collect2name=`${CC} -print-prog-name=collect2`
+      if test -f "$collect2name" && \
+	 strings "$collect2name" | grep resolve_lib_name >/dev/null
+      then
+	# We have reworked collect2
+	hardcode_direct=yes
+      else
+	# We have old collect2
+	hardcode_direct=unsupported
+	# It fails to find uninstalled libraries when the uninstalled
+	# path is not listed in the libpath.  Setting hardcode_minus_L
+	# to unsupported forces relinking
+	hardcode_minus_L=yes
+	hardcode_libdir_flag_spec='-L$libdir'
+	hardcode_libdir_separator=
+      fi
+      shared_flag='-shared'
+    else
+      shared_flag='${wl}-bM:SRE'
+      hardcode_direct=yes
+    fi
+    allow_undefined_flag=' ${wl}-berok'
+    archive_cmds="\$CC $shared_flag"' -o $objdir/$soname $libobjs $deplibs $linkopts ${wl}-bexpall ${wl}-bnoentry${allow_undefined_flag}'
+    archive_expsym_cmds="\$CC $shared_flag"' -o $objdir/$soname $libobjs $deplibs $linkopts ${wl}-bE:$export_symbols ${wl}-bnoentry${allow_undefined_flag}'
+    case "$host_os" in aix4.[01]|aix4.[01].*)
+      # According to Greg Wooledge, -bexpall is only supported from AIX 4.2 on
+      always_export_symbols=yes ;;
+    esac
+   ;;
+
+  amigaos*)
+    archive_cmds='$rm $objdir/a2ixlibrary.data~$echo "#define NAME $libname" > $objdir/a2ixlibrary.data~$echo "#define LIBRARY_ID 1" >> $objdir/a2ixlibrary.data~$echo "#define VERSION $major" >> $objdir/a2ixlibrary.data~$echo "#define REVISION $revision" >> $objdir/a2ixlibrary.data~$AR cru $lib $libobjs~$RANLIB $lib~(cd $objdir && a2ixlibrary -32)'
+    hardcode_libdir_flag_spec='-L$libdir'
+    hardcode_minus_L=yes
+    # see comment about different semantics on the GNU ld section
+    ld_shlibs=no
+    ;;
+
+  cygwin* | mingw*)
+    # When not using gcc, we currently assume that we are using
+    # Microsoft Visual C++.
+    # hardcode_libdir_flag_spec is actually meaningless, as there is
+    # no search path for DLLs.
+    hardcode_libdir_flag_spec=' '
+    allow_undefined_flag=unsupported
+    # Tell ltmain to make .lib files, not .a files.
+    libext=lib
+    # FIXME: Setting linknames here is a bad hack.
+    archive_cmds='$CC -o $lib $libobjs $linkopts `echo "$deplibs" | sed -e '\''s/ -lc$//'\''` -link -dll~linknames='
+    # The linker will automatically build a .lib file if we build a DLL.
+    old_archive_from_new_cmds='true'
+    # FIXME: Should let the user specify the lib program.
+    old_archive_cmds='lib /OUT:$oldlib$oldobjs'
+    fix_srcfile_path='`cygpath -w $srcfile`'
+    ;;
+
+  freebsd1*)
+    ld_shlibs=no
+    ;;
+
+  # FreeBSD 2.2.[012] allows us to include c++rt0.o to get C++ constructor
+  # support.  Future versions do this automatically, but an explicit c++rt0.o
+  # does not break anything, and helps significantly (at the cost of a little
+  # extra space).
+  freebsd2.2*)
+    archive_cmds='$LD -Bshareable -o $lib $libobjs $deplibs $linkopts /usr/lib/c++rt0.o'
+    hardcode_libdir_flag_spec='-R$libdir'
+    hardcode_direct=yes
+    hardcode_shlibpath_var=no
+    ;;
+
+  # Unfortunately, older versions of FreeBSD 2 do not have this feature.
+  freebsd2*)
+    archive_cmds='$LD -Bshareable -o $lib $libobjs $deplibs $linkopts'
+    hardcode_direct=yes
+    hardcode_minus_L=yes
+    hardcode_shlibpath_var=no
+    ;;
+
+  # FreeBSD 3 and greater uses gcc -shared to do shared libraries.
+  freebsd*)
+    archive_cmds='$CC -shared -o $lib $libobjs $deplibs $linkopts'
+    hardcode_libdir_flag_spec='-R$libdir'
+    hardcode_direct=yes
+    hardcode_shlibpath_var=no
+    ;;
+
+  hpux9* | hpux10* | hpux11*)
+    case "$host_os" in
+    hpux9*) archive_cmds='$rm $objdir/$soname~$LD -b +b $install_libdir -o $objdir/$soname $libobjs $deplibs $linkopts~test $objdir/$soname = $lib || mv $objdir/$soname $lib' ;;
+    *) archive_cmds='$LD -b +h $soname +b $install_libdir -o $lib $libobjs $deplibs $linkopts' ;;
+    esac
+    hardcode_libdir_flag_spec='${wl}+b ${wl}$libdir'
+    hardcode_libdir_separator=:
+    hardcode_direct=yes
+    hardcode_minus_L=yes # Not in the search PATH, but as the default
+			 # location of the library.
+    export_dynamic_flag_spec='${wl}-E'
+    ;;
+
+  irix5* | irix6*)
+    if test "$with_gcc" = yes; then
+      archive_cmds='$CC -shared $libobjs $deplibs $linkopts ${wl}-soname ${wl}$soname `test -n "$verstring" && echo ${wl}-set_version ${wl}$verstring` ${wl}-update_registry ${wl}${objdir}/so_locations -o $lib'
+    else
+      archive_cmds='$LD -shared $libobjs $deplibs $linkopts -soname $soname `test -n "$verstring" && echo -set_version $verstring` -update_registry ${objdir}/so_locations -o $lib'
+    fi
+    hardcode_libdir_flag_spec='${wl}-rpath ${wl}$libdir'
+    hardcode_libdir_separator=:
+    ;;
+
+  netbsd*)
+    if echo __ELF__ | $CC -E - | grep __ELF__ >/dev/null; then
+      archive_cmds='$LD -Bshareable -o $lib $libobjs $deplibs $linkopts'  # a.out
+    else
+      archive_cmds='$LD -shared -o $lib $libobjs $deplibs $linkopts'      # ELF
+    fi
+    hardcode_libdir_flag_spec='${wl}-R$libdir'
+    hardcode_direct=yes
+    hardcode_shlibpath_var=no
+    ;;
+
+  openbsd*)
+    archive_cmds='$LD -Bshareable -o $lib $libobjs $deplibs $linkopts'
+    hardcode_libdir_flag_spec='-R$libdir'
+    hardcode_direct=yes
+    hardcode_shlibpath_var=no
+    ;;
+
+  os2*)
+    hardcode_libdir_flag_spec='-L$libdir'
+    hardcode_minus_L=yes
+    allow_undefined_flag=unsupported
+    archive_cmds='$echo "LIBRARY $libname INITINSTANCE" > $objdir/$libname.def~$echo "DESCRIPTION \"$libname\"" >> $objdir/$libname.def~$echo DATA >> $objdir/$libname.def~$echo " SINGLE NONSHARED" >> $objdir/$libname.def~$echo EXPORTS >> $objdir/$libname.def~emxexp $libobjs >> $objdir/$libname.def~$CC -Zdll -Zcrtdll -o $lib $libobjs $deplibs $linkopts $objdir/$libname.def'
+    old_archive_from_new_cmds='emximp -o $objdir/$libname.a $objdir/$libname.def'
+    ;;
+
+  osf3*)
+    if test "$with_gcc" = yes; then
+      allow_undefined_flag=' ${wl}-expect_unresolved ${wl}\*'
+      archive_cmds='$CC -shared${allow_undefined_flag} $libobjs $deplibs $linkopts ${wl}-soname ${wl}$soname `test -n "$verstring" && echo ${wl}-set_version ${wl}$verstring` ${wl}-update_registry ${wl}${objdir}/so_locations -o $lib'
+    else
+      allow_undefined_flag=' -expect_unresolved \*'
+      archive_cmds='$LD -shared${allow_undefined_flag} $libobjs $deplibs $linkopts -soname $soname `test -n "$verstring" && echo -set_version $verstring` -update_registry ${objdir}/so_locations -o $lib'
+    fi
+    hardcode_libdir_flag_spec='${wl}-rpath ${wl}$libdir'
+    hardcode_libdir_separator=:
+    ;;
+
+  osf4* | osf5*)  # As osf3* with the addition of the -msym flag
+    if test "$with_gcc" = yes; then
+      allow_undefined_flag=' ${wl}-expect_unresolved ${wl}\*'
+      archive_cmds='$CC -shared${allow_undefined_flag} $libobjs $deplibs $linkopts ${wl}-msym ${wl}-soname ${wl}$soname `test -n "$verstring" && echo ${wl}-set_version ${wl}$verstring` ${wl}-update_registry ${wl}${objdir}/so_locations -o $lib'
+    else
+      allow_undefined_flag=' -expect_unresolved \*'
+      archive_cmds='$LD -shared${allow_undefined_flag} $libobjs $deplibs $linkopts -msym -soname $soname `test -n "$verstring" && echo -set_version $verstring` -update_registry ${objdir}/so_locations -o $lib'
+    fi
+    hardcode_libdir_flag_spec='${wl}-rpath ${wl}$libdir'
+    hardcode_libdir_separator=:
+    ;;
+  rhapsody*)
+    archive_cmds='$CC -bundle -undefined suppress -o $lib $libobjs $deplibs $linkopts'
+    hardcode_libdir_flags_spec='-L$libdir'
+    hardcode_direct=yes
+    hardcode_shlibpath_var=no
+    ;;
+                                       
+  sco3.2v5*)
+    archive_cmds='$LD -G -h $soname -o $lib $libobjs $deplibs $linkopts'
+    hardcode_shlibpath_var=no
+    runpath_var=LD_RUN_PATH
+    hardcode_runpath_var=yes
+    ;;
+
+  solaris*)
+    no_undefined_flag=' -z text'
+    # $CC -shared without GNU ld will not create a library from C++
+    # object files and a static libstdc++, better avoid it by now
+    archive_cmds='$LD -G${allow_undefined_flag} -h $soname -o $lib $libobjs $deplibs $linkopts'
+    archive_expsym_cmds='$echo "{ global:" > $lib.exp~cat $export_symbols | sed -e "s/\(.*\)/\1;/" >> $lib.exp~$echo "local: *; };" >> $lib.exp~
+		$LD -G${allow_undefined_flag} -M $lib.exp -h $soname -o $lib $libobjs $deplibs $linkopts~$rm $lib.exp'
+    hardcode_libdir_flag_spec='-R$libdir'
+    hardcode_shlibpath_var=no
+    case "$host_os" in
+    solaris2.[0-5] | solaris2.[0-5].*) ;;
+    *) # Supported since Solaris 2.6 (maybe 2.5.1?)
+      whole_archive_flag_spec='-z allextract$convenience -z defaultextract' ;;
+    esac
+    ;;
+
+  sunos4*)
+    archive_cmds='$LD -assert pure-text -Bstatic -o $lib $libobjs $deplibs $linkopts'
+    hardcode_libdir_flag_spec='-L$libdir'
+    hardcode_direct=yes
+    hardcode_minus_L=yes
+    hardcode_shlibpath_var=no
+    ;;
+
+  sysv4)
+    if test "x$host_vendor" = xsequent; then
+      # Use $CC to link under sequent, because it throws in some extra .o 
+      # files that make .init and .fini sections work.
+      archive_cmds='$CC -G ${wl}-h $soname -o $lib $libobjs $deplibs $linkopts'
+    else
+      archive_cmds='$LD -G -h $soname -o $lib $libobjs $deplibs $linkopts'
+    fi
+    runpath_var='LD_RUN_PATH'
+    hardcode_shlibpath_var=no
+    hardcode_direct=no #Motorola manual says yes, but my tests say they lie 
+    ;;  
+
+  sysv4.3*)
+    archive_cmds='$LD -G -h $soname -o $lib $libobjs $deplibs $linkopts'
+    hardcode_shlibpath_var=no
+    export_dynamic_flag_spec='-Bexport'
+    ;;
+
+  sysv5*)
+    no_undefined_flag=' -z text'
+    # $CC -shared without GNU ld will not create a library from C++
+    # object files and a static libstdc++, better avoid it by now
+    archive_cmds='$LD -G${allow_undefined_flag} -h $soname -o $lib $libobjs $deplibs $linkopts'
+    archive_expsym_cmds='$echo "{ global:" > $lib.exp~cat $export_symbols | sed -e "s/\(.*\)/\1;/" >> $lib.exp~$echo "local: *; };" >> $lib.exp~
+		$LD -G${allow_undefined_flag} -M $lib.exp -h $soname -o $lib $libobjs $deplibs $linkopts~$rm $lib.exp'
+    hardcode_libdir_flag_spec=
+    hardcode_shlibpath_var=no
+    runpath_var='LD_RUN_PATH'
+    ;;
+
+  uts4*)
+    archive_cmds='$LD -G -h $soname -o $lib $libobjs $deplibs $linkopts'
+    hardcode_libdir_flag_spec='-L$libdir'
+    hardcode_shlibpath_var=no
+    ;;
+
+  dgux*)
+    archive_cmds='$LD -G -h $soname -o $lib $libobjs $deplibs $linkopts'
+    hardcode_libdir_flag_spec='-L$libdir'
+    hardcode_shlibpath_var=no
+    ;;
+
+  sysv4*MP*)
+    if test -d /usr/nec; then
+      archive_cmds='$LD -G -h $soname -o $lib $libobjs $deplibs $linkopts'
+      hardcode_shlibpath_var=no
+      runpath_var=LD_RUN_PATH
+      hardcode_runpath_var=yes
+      ld_shlibs=yes
+    fi
+    ;;
+
+  sysv4.2uw2*)
+    archive_cmds='$LD -G -o $lib $libobjs $deplibs $linkopts'
+    hardcode_direct=yes
+    hardcode_minus_L=no
+    hardcode_shlibpath_var=no
+    hardcode_runpath_var=yes
+    runpath_var=LD_RUN_PATH
+    ;;
+
+  unixware7*)
+    archive_cmds='$LD -G -h $soname -o $lib $libobjs $deplibs $linkopts'
+    runpath_var='LD_RUN_PATH'
+    hardcode_shlibpath_var=no
+    ;;
+
+  *)
+    ld_shlibs=no
+    ;;
+  esac
+fi
+echo "$ac_t$ld_shlibs" 1>&6
+test "$ld_shlibs" = no && can_build_shared=no
+
+if test -z "$NM"; then
+  echo $ac_n "checking for BSD-compatible nm... $ac_c" 1>&6
+  case "$NM" in
+  [\\/]* | [A-Za-z]:[\\/]*) ;; # Let the user override the test with a path.
+  *)
+    IFS="${IFS= 	}"; ac_save_ifs="$IFS"; IFS="${IFS}${PATH_SEPARATOR}"
+    for ac_dir in $PATH /usr/ucb /usr/ccs/bin /bin; do
+      test -z "$ac_dir" && ac_dir=.
+      if test -f $ac_dir/nm || test -f $ac_dir/nm$ac_exeext; then
+	# Check to see if the nm accepts a BSD-compat flag.
+	# Adding the `sed 1q' prevents false positives on HP-UX, which says:
+	#   nm: unknown option "B" ignored
+	if ($ac_dir/nm -B /dev/null 2>&1 | sed '1q'; exit 0) | egrep /dev/null >/dev/null; then
+	  NM="$ac_dir/nm -B"
+	  break
+	elif ($ac_dir/nm -p /dev/null 2>&1 | sed '1q'; exit 0) | egrep /dev/null >/dev/null; then
+	  NM="$ac_dir/nm -p"
+	  break
+	else
+	  NM=${NM="$ac_dir/nm"} # keep the first match, but
+	  continue # so that we can try to find one that supports BSD flags
+	fi
+      fi
+    done
+    IFS="$ac_save_ifs"
+    test -z "$NM" && NM=nm
+    ;;
+  esac
+  echo "$ac_t$NM" 1>&6
+fi
+
+# Check for command to grab the raw symbol name followed by C symbol from nm.
+echo $ac_n "checking command to parse $NM output... $ac_c" 1>&6
+
+# These are sane defaults that work on at least a few old systems.
+# [They come from Ultrix.  What could be older than Ultrix?!! ;)]
+
+# Character class describing NM global symbol codes.
+symcode='[BCDEGRST]'
+
+# Regexp to match symbols that can be accessed directly from C.
+sympat='\([_A-Za-z][_A-Za-z0-9]*\)'
+
+# Transform the above into a raw symbol and a C symbol.
+symxfrm='\1 \2\3 \3'
+
+# Transform an extracted symbol line into a proper C declaration
+global_symbol_to_cdecl="sed -n -e 's/^. .* \(.*\)$/extern char \1;/p'"
+
+# Define system-specific variables.
+case "$host_os" in
+aix*)
+  symcode='[BCDT]'
+  ;;
+cygwin* | mingw*)
+  symcode='[ABCDGISTW]'
+  ;;
+hpux*) # Its linker distinguishes data from code symbols
+  global_symbol_to_cdecl="sed -n -e 's/^T .* \(.*\)$/extern char \1();/p' -e 's/^. .* \(.*\)$/extern char \1;/p'"
+  ;;
+irix*)
+  symcode='[BCDEGRST]'
+  ;;
+solaris*)
+  symcode='[BDT]'
+  ;;
+sysv4)
+  symcode='[DFNSTU]'
+  ;;
+esac
+
+# If we're using GNU nm, then use its standard symbol codes.
+if $NM -V 2>&1 | egrep '(GNU|with BFD)' > /dev/null; then
+  symcode='[ABCDGISTW]'
+fi
+
+# Try without a prefix undercore, then with it.
+for ac_symprfx in "" "_"; do
+
+  # Write the raw and C identifiers.
+  global_symbol_pipe="sed -n -e 's/^.*[ 	]\($symcode\)[ 	][ 	]*\($ac_symprfx\)$sympat$/$symxfrm/p'"
+
+  # Check to see that the pipe works correctly.
+  pipe_works=no
+  $rm conftest*
+  cat > conftest.c <<EOF
+#ifdef __cplusplus
+extern "C" {
+#endif
+char nm_test_var;
+void nm_test_func(){}
+#ifdef __cplusplus
+}
+#endif
+main(){nm_test_var='a';nm_test_func();return(0);}
+EOF
+
+  echo "$progname:1653: checking if global_symbol_pipe works" >&5
+  if { (eval echo $progname:1654: \"$ac_compile\") 1>&5; (eval $ac_compile) 2>&5; } && test -s conftest.$objext; then
+    # Now try to grab the symbols.
+    nlist=conftest.nm
+    if { echo "$progname:1657: eval \"$NM conftest.$objext | $global_symbol_pipe > $nlist\"" >&5; eval "$NM conftest.$objext | $global_symbol_pipe > $nlist 2>&5"; } && test -s "$nlist"; then
+
+      # Try sorting and uniquifying the output.
+      if sort "$nlist" | uniq > "$nlist"T; then
+	mv -f "$nlist"T "$nlist"
+      else
+	rm -f "$nlist"T
+      fi
+
+      # Make sure that we snagged all the symbols we need.
+      if egrep ' nm_test_var$' "$nlist" >/dev/null; then
+	if egrep ' nm_test_func$' "$nlist" >/dev/null; then
+	  cat <<EOF > conftest.c
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+EOF
+	  # Now generate the symbol file.
+	  eval "$global_symbol_to_cdecl"' < "$nlist" >> conftest.c'
+
+	  cat <<EOF >> conftest.c
+#if defined (__STDC__) && __STDC__
+# define lt_ptr_t void *
+#else
+# define lt_ptr_t char *
+# define const
+#endif
+
+/* The mapping between symbol names and symbols. */
+const struct {
+  const char *name;
+  lt_ptr_t address;
+}
+lt_preloaded_symbols[] =
+{
+EOF
+	  sed 's/^. \(.*\) \(.*\)$/  {"\2", (lt_ptr_t) \&\2},/' < "$nlist" >> conftest.c
+	  cat <<\EOF >> conftest.c
+  {0, (lt_ptr_t) 0}
+};
+
+#ifdef __cplusplus
+}
+#endif
+EOF
+	  # Now try linking the two files.
+	  mv conftest.$objext conftstm.$objext
+	  save_LIBS="$LIBS"
+	  save_CFLAGS="$CFLAGS"
+	  LIBS="conftstm.$objext"
+	  CFLAGS="$CFLAGS$no_builtin_flag"
+	  if { (eval echo $progname:1709: \"$ac_link\") 1>&5; (eval $ac_link) 2>&5; } && test -s conftest; then
+	    pipe_works=yes
+	  else
+	    echo "$progname: failed program was:" >&5
+	    cat conftest.c >&5
+	  fi
+	  LIBS="$save_LIBS"
+	else
+	  echo "cannot find nm_test_func in $nlist" >&5
+	fi
+      else
+	echo "cannot find nm_test_var in $nlist" >&5
+      fi
+    else
+      echo "cannot run $global_symbol_pipe" >&5
+    fi
+  else
+    echo "$progname: failed program was:" >&5
+    cat conftest.c >&5
+  fi
+  $rm conftest* conftst*
+
+  # Do not use the global_symbol_pipe unless it works.
+  if test "$pipe_works" = yes; then
+    break
+  else
+    global_symbol_pipe=
+  fi
+done
+if test "$pipe_works" = yes; then
+  echo "${ac_t}ok" 1>&6
+else
+  echo "${ac_t}failed" 1>&6
+fi
+
+if test -z "$global_symbol_pipe"; then
+  global_symbol_to_cdecl=
+fi
+
+# Check hardcoding attributes.
+echo $ac_n "checking how to hardcode library paths into programs... $ac_c" 1>&6
+hardcode_action=
+if test -n "$hardcode_libdir_flag_spec" || \
+   test -n "$runpath_var"; then
+
+  # We can hardcode non-existant directories.
+  if test "$hardcode_direct" != no &&
+     # If the only mechanism to avoid hardcoding is shlibpath_var, we
+     # have to relink, otherwise we might link with an installed library
+     # when we should be linking with a yet-to-be-installed one
+     ## test "$hardcode_shlibpath_var" != no &&
+     test "$hardcode_minus_L" != no; then
+    # Linking always hardcodes the temporary library directory.
+    hardcode_action=relink
+  else
+    # We can link without hardcoding, and we can hardcode nonexisting dirs.
+    hardcode_action=immediate
+  fi
+else
+  # We cannot hardcode anything, or else we can only hardcode existing
+  # directories.
+  hardcode_action=unsupported
+fi
+echo "$ac_t$hardcode_action" 1>&6
+
+
+reload_flag=
+reload_cmds='$LD$reload_flag -o $output$reload_objs'
+echo $ac_n "checking for $LD option to reload object files... $ac_c" 1>&6
+# PORTME Some linkers may need a different reload flag.
+reload_flag='-r'
+echo "$ac_t$reload_flag" 1>&6
+test -n "$reload_flag" && reload_flag=" $reload_flag"
+
+# PORTME Fill in your ld.so characteristics
+library_names_spec=
+libname_spec='lib$name'
+soname_spec=
+postinstall_cmds=
+postuninstall_cmds=
+finish_cmds=
+finish_eval=
+shlibpath_var=
+shlibpath_overrides_runpath=unknown
+version_type=none
+dynamic_linker="$host_os ld.so"
+sys_lib_dlsearch_path_spec="/lib /usr/lib"
+sys_lib_search_path_spec="/lib /usr/lib /usr/local/lib"
+file_magic_cmd=
+file_magic_test_file=
+deplibs_check_method='unknown'
+# Need to set the preceding variable on all platforms that support
+# interlibrary dependencies.
+# 'none' -- dependencies not supported.
+# `unknown' -- same as none, but documents that we really don't know.
+# 'pass_all' -- all dependencies passed with no checks.
+# 'test_compile' -- check by making test program.
+# 'file_magic [regex]' -- check by looking for files in library path
+# which responds to the $file_magic_cmd with a given egrep regex.
+# If you have `file' or equivalent on your system and you're not sure
+# whether `pass_all' will *always* work, you probably want this one.
+echo $ac_n "checking dynamic linker characteristics... $ac_c" 1>&6
+case "$host_os" in
+aix3*)
+  version_type=linux
+  library_names_spec='${libname}${release}.so$versuffix $libname.a'
+  shlibpath_var=LIBPATH
+
+  # AIX has no versioning support, so we append a major version to the name.
+  soname_spec='${libname}${release}.so$major'
+  ;;
+
+aix4*)
+  version_type=linux
+  # AIX has no versioning support, so currently we can not hardcode correct
+  # soname into executable. Probably we can add versioning support to
+  # collect2, so additional links can be useful in future.
+  # We preserve .a as extension for shared libraries though AIX4.2
+  # and later linker supports .so
+  library_names_spec='${libname}${release}.so$versuffix ${libname}${release}.so$major $libname.a'
+  shlibpath_var=LIBPATH
+  deplibs_check_method=pass_all
+  ;;
+
+amigaos*)
+  library_names_spec='$libname.ixlibrary $libname.a'
+  # Create ${libname}_ixlibrary.a entries in /sys/libs.
+  finish_eval='for lib in `ls $libdir/*.ixlibrary 2>/dev/null`; do libname=`$echo "X$lib" | $Xsed -e '\''s%^.*/\([^/]*\)\.ixlibrary$%\1%'\''`; test $rm /sys/libs/${libname}_ixlibrary.a; $show "(cd /sys/libs && $LN_S $lib ${libname}_ixlibrary.a)"; (cd /sys/libs && $LN_S $lib ${libname}_ixlibrary.a) || exit 1; done'
+  ;;
+
+beos*)
+  library_names_spec='${libname}.so'
+  dynamic_linker="$host_os ld.so"
+  shlibpath_var=LIBRARY_PATH
+  deplibs_check_method=pass_all
+  lt_cv_dlopen="load_add_on"
+  lt_cv_dlopen_libs=
+  lt_cv_dlopen_self=yes
+  ;;
+
+bsdi4*)
+  version_type=linux
+  need_version=no
+  library_names_spec='${libname}${release}.so$versuffix ${libname}${release}.so$major $libname.so'
+  soname_spec='${libname}${release}.so$major'
+  finish_cmds='PATH="\$PATH:/sbin" ldconfig $libdir'
+  shlibpath_var=LD_LIBRARY_PATH
+  deplibs_check_method='file_magic ELF [0-9][0-9]*-bit [ML]SB (shared object|dynamic lib)'
+  file_magic_cmd=/usr/bin/file
+  file_magic_test_file=/shlib/libc.so
+  sys_lib_search_path_spec="/shlib /usr/lib /usr/X11/lib /usr/contrib/lib /lib /usr/local/lib"
+  sys_lib_dlsearch_path_spec="/shlib /usr/lib /usr/local/lib"
+  export_dynamic_flag_spec=-rdynamic
+  # the default ld.so.conf also contains /usr/contrib/lib and
+  # /usr/X11R6/lib (/usr/X11 is a link to /usr/X11R6), but let us allow
+  # libtool to hard-code these into programs
+  ;;
+
+cygwin* | mingw*)
+  version_type=windows
+  need_version=no
+  need_lib_prefix=no
+  if test "$with_gcc" = yes; then
+    library_names_spec='${libname}`echo ${release} | sed -e 's/[.]/-/g'`${versuffix}.dll $libname.a'
+  else
+    library_names_spec='${libname}`echo ${release} | sed -e 's/[.]/-/g'`${versuffix}.dll $libname.lib'
+  fi
+  dynamic_linker='Win32 ld.exe'
+  deplibs_check_method='file_magic file format pei*-i386(.*architecture: i386)?'
+  file_magic_cmd='${OBJDUMP} -f'
+  # FIXME: first we should search . and the directory the executable is in
+  shlibpath_var=PATH
+  lt_cv_dlopen="LoadLibrary"
+  lt_cv_dlopen_libs=
+  ;;
+
+freebsd1*)
+  dynamic_linker=no
+  ;;
+  
+freebsd*)
+  objformat=`test -x /usr/bin/objformat && /usr/bin/objformat || echo aout`
+  version_type=freebsd-$objformat
+  case "$version_type" in
+    freebsd-elf*)
+      deplibs_check_method='file_magic ELF [0-9][0-9]*-bit [LM]SB shared object'
+      file_magic_cmd=/usr/bin/file
+      file_magic_test_file=`echo /usr/lib/libc.so*`
+      library_names_spec='${libname}${release}.so$versuffix ${libname}${release}.so $libname.so'
+      need_version=no
+      need_lib_prefix=no
+      ;;
+    freebsd-*)
+      deplibs_check_method=unknown
+      library_names_spec='${libname}${release}.so$versuffix $libname.so$versuffix'
+      need_version=yes
+      ;;
+  esac
+  shlibpath_var=LD_LIBRARY_PATH
+  case "$host_os" in
+  freebsd2* | freebsd3.[01]* | freebsdelf3.[01]*)
+    shlibpath_overrides_runpath=yes
+    ;;
+  *) # from 3.2 on
+    shlibpath_overrides_runpath=no
+    ;;
+  esac
+  ;;
+
+gnu*)
+  version_type=linux
+  need_lib_prefix=no
+  need_version=no
+  library_names_spec='${libname}${release}.so$versuffix ${libname}${release}.so${major} ${libname}.so'
+  soname_spec='${libname}${release}.so$major'
+  shlibpath_var=LD_LIBRARY_PATH
+  ;;
+
+hpux9* | hpux10* | hpux11*)
+  # Give a soname corresponding to the major version so that dld.sl refuses to
+  # link against other versions.
+  dynamic_linker="$host_os dld.sl"
+  version_type=sunos
+  need_lib_prefix=no
+  need_version=no
+  shlibpath_var=SHLIB_PATH
+  shlibpath_overrides_runpath=no # +s is required to enable SHLIB_PATH
+  library_names_spec='${libname}${release}.sl$versuffix ${libname}${release}.sl$major $libname.sl'
+  soname_spec='${libname}${release}.sl$major'
+  # HP-UX runs *really* slowly unless shared libraries are mode 555.
+  postinstall_cmds='chmod 555 $lib'
+  case "$host_os" in
+  hpux10.20*)
+    # TODO:  Does this work for hpux-11 too?
+    deplibs_check_method='file_magic (s[0-9][0-9][0-9]|PA-RISC[0-9].[0-9]) shared library'
+    file_magic_cmd=/usr/bin/file
+    file_magic_test_file=/usr/lib/libc.sl
+    ;;
+  esac
+  ;;
+
+irix5* | irix6*)
+  version_type=irix
+  need_lib_prefix=no
+  need_version=no
+  soname_spec='${libname}${release}.so.$major'
+  library_names_spec='${libname}${release}.so.$versuffix ${libname}${release}.so.$major ${libname}${release}.so $libname.so'
+  case "$host_os" in
+  irix5*)
+    libsuff= shlibsuff=
+    # this will be overridden with pass_all, but let us keep it just in case
+    deplibs_check_method="file_magic ELF 32-bit MSB dynamic lib MIPS - version 1"
+    ;;
+  *)
+    case "$LD" in # libtool.m4 will add one of these switches to LD
+    *-32|*"-32 ") libsuff= shlibsuff= libmagic=32-bit;;
+    *-n32|*"-n32 ") libsuff=32 shlibsuff=N32 libmagic=N32;;
+    *-64|*"-64 ") libsuff=64 shlibsuff=64 libmagic=64-bit;;
+    *) libsuff= shlibsuff= libmagic=never-match;;
+    esac
+    ;;
+  esac
+  shlibpath_var=LD_LIBRARY${shlibsuff}_PATH
+  shlibpath_overrides_runpath=no
+  sys_lib_search_path_spec="/usr/lib${libsuff} /lib${libsuff} /usr/local/lib${libsuff}"
+  sys_lib_dlsearch_path_spec="/usr/lib${libsuff} /lib${libsuff}"
+  file_magic_cmd=/usr/bin/file
+  file_magic_test_file=`echo /lib${libsuff}/libc.so*`
+  deplibs_check_method='pass_all'
+  ;;
+
+# No shared lib support for Linux oldld, aout, or coff.
+linux-gnuoldld* | linux-gnuaout* | linux-gnucoff*)
+  dynamic_linker=no
+  ;;
+
+# This must be Linux ELF.
+linux-gnu*)
+  version_type=linux
+  need_lib_prefix=no
+  need_version=no
+  library_names_spec='${libname}${release}.so$versuffix ${libname}${release}.so$major $libname.so'
+  soname_spec='${libname}${release}.so$major'
+  finish_cmds='PATH="\$PATH:/sbin" ldconfig -n $libdir'
+  shlibpath_var=LD_LIBRARY_PATH
+  shlibpath_overrides_runpath=no
+  deplibs_check_method=pass_all
+
+  if test -f /lib/ld.so.1; then
+    dynamic_linker='GNU ld.so'
+  else
+    # Only the GNU ld.so supports shared libraries on MkLinux.
+    case "$host_cpu" in
+    powerpc*) dynamic_linker=no ;;
+    *) dynamic_linker='Linux ld.so' ;;
+    esac
+  fi
+  ;;
+
+netbsd*)
+  version_type=sunos
+  if echo __ELF__ | $CC -E - | grep __ELF__ >/dev/null; then
+    library_names_spec='${libname}${release}.so$versuffix ${libname}.so$versuffix'
+    finish_cmds='PATH="\$PATH:/sbin" ldconfig -m $libdir'
+    dynamic_linker='NetBSD (a.out) ld.so'
+  else
+    library_names_spec='${libname}${release}.so$versuffix ${libname}${release}.so$major ${libname}${release}.so ${libname}.so'
+    soname_spec='${libname}${release}.so$major'
+    dynamic_linker='NetBSD ld.elf_so'
+  fi
+  shlibpath_var=LD_LIBRARY_PATH
+  ;;
+
+openbsd*)
+  version_type=sunos
+  if test "$with_gnu_ld" = yes; then
+    need_lib_prefix=no
+    need_version=no
+  fi
+  library_names_spec='${libname}${release}.so$versuffix ${libname}.so$versuffix'
+  finish_cmds='PATH="\$PATH:/sbin" ldconfig -m $libdir'
+  shlibpath_var=LD_LIBRARY_PATH
+  ;;
+
+os2*)
+  libname_spec='$name'
+  need_lib_prefix=no
+  library_names_spec='$libname.dll $libname.a'
+  dynamic_linker='OS/2 ld.exe'
+  shlibpath_var=LIBPATH
+  ;;
+
+osf3* | osf4* | osf5*)
+  version_type=osf
+  need_version=no
+  soname_spec='${libname}${release}.so'
+  library_names_spec='${libname}${release}.so$versuffix ${libname}${release}.so $libname.so'
+  shlibpath_var=LD_LIBRARY_PATH
+  # this will be overridden with pass_all, but let us keep it just in case
+  deplibs_check_method='file_magic COFF format alpha shared library'
+  file_magic_cmd=/usr/bin/file
+  file_magic_test_file=/shlib/libc.so
+  deplibs_check_method='pass_all'
+  sys_lib_search_path_spec="/usr/shlib /usr/ccs/lib /usr/lib/cmplrs/cc /usr/lib /usr/local/lib /var/shlib"
+  sys_lib_dlsearch_path_spec="$sys_lib_search_path_spec"
+  ;;
+
+rhapsody*)
+  version_type=sunos
+  library_names_spec='${libname}.so'
+  soname_spec='${libname}.so'
+  shlibpath_var=DYLD_LIBRARY_PATH
+  deplibs_check_method=pass_all
+  ;;
+
+sco3.2v5*)
+  version_type=osf
+  soname_spec='${libname}${release}.so$major'
+  library_names_spec='${libname}${release}.so$versuffix ${libname}${release}.so$major $libname.so'
+  shlibpath_var=LD_LIBRARY_PATH
+  ;;
+
+solaris*)
+  version_type=linux
+  need_lib_prefix=no
+  need_version=no
+  library_names_spec='${libname}${release}.so$versuffix ${libname}${release}.so$major $libname.so'
+  soname_spec='${libname}${release}.so$major'
+  shlibpath_var=LD_LIBRARY_PATH
+  shlibpath_overrides_runpath=yes
+  # ldd complains unless libraries are executable
+  postinstall_cmds='chmod +x $lib'
+  deplibs_check_method="file_magic ELF [0-9][0-9]-bit [LM]SB dynamic lib"
+  file_magic_cmd=/usr/bin/file
+  file_magic_test_file=/lib/libc.so
+  ;;
+
+sunos4*)
+  version_type=sunos
+  library_names_spec='${libname}${release}.so$versuffix ${libname}.so$versuffix'
+  finish_cmds='PATH="\$PATH:/usr/etc" ldconfig $libdir'
+  shlibpath_var=LD_LIBRARY_PATH
+  shlibpath_overrides_runpath=yes
+  if test "$with_gnu_ld" = yes; then
+    need_lib_prefix=no
+  fi
+  need_version=yes
+  ;;
+
+sysv4 | sysv4.2uw2* | sysv4.3* | sysv5*)
+  version_type=linux
+  library_names_spec='${libname}${release}.so$versuffix ${libname}${release}.so$major $libname.so'
+  soname_spec='${libname}${release}.so$major'
+  shlibpath_var=LD_LIBRARY_PATH
+  case "$host_vendor" in
+    sequent)
+      file_magic_cmd='/bin/file'
+      deplibs_check_method='file_magic ELF [0-9][0-9]*-bit [LM]SB (shared object|dynamic lib )'
+      ;;
+    ncr)
+      deplibs_check_method='pass_all'
+      ;;
+    motorola)
+      need_lib_prefix=no
+      need_version=no
+      shlibpath_overrides_runpath=no
+      sys_lib_search_path_spec='/lib /usr/lib /usr/ccs/lib'
+      deplibs_check_method='file_magic ELF [0-9][0-9]*-bit [ML]SB (shared object|dynamic lib) M[0-9][0-9]* Version [0-9]'
+      file_magic_cmd=/usr/bin/file
+      file_magic_test_file=`echo /usr/lib/libc.so*`
+      ;;
+  esac
+  ;;
+
+uts4*)
+  version_type=linux
+  library_names_spec='${libname}${release}.so$versuffix ${libname}${release}.so$major $libname.so'
+  soname_spec='${libname}${release}.so$major'
+  shlibpath_var=LD_LIBRARY_PATH
+  ;;
+
+dgux*)
+  version_type=linux
+  need_lib_prefix=no
+  need_version=no
+  library_names_spec='${libname}${release}.so$versuffix ${libname}${release}.so$major $libname.so'
+  soname_spec='${libname}${release}.so$major'
+  shlibpath_var=LD_LIBRARY_PATH
+  ;;
+
+sysv4*MP*)
+  if test -d /usr/nec ;then
+    version_type=linux
+    library_names_spec='$libname.so.$versuffix $libname.so.$major $libname.so'
+    soname_spec='$libname.so.$major'
+    shlibpath_var=LD_LIBRARY_PATH
+  fi
+  ;;
+
+*)
+  dynamic_linker=no
+  ;;
+esac
+echo "$ac_t$dynamic_linker" 1>&6
+test "$dynamic_linker" = no && can_build_shared=no
+
+# Report the final consequences.
+echo "checking if libtool supports shared libraries... $can_build_shared" 1>&6
+
+# Only try to build win32 dlls if AC_LIBTOOL_WIN32_DLL was used in
+# configure.in, otherwise build static only libraries.
+case "$host_os" in
+cygwin* | mingw* | os2*)
+  if test x$can_build_shared = xyes; then
+    test x$enable_win32_dll = xno && can_build_shared=no
+    echo "checking if package supports dlls... $can_build_shared" 1>&6
+  fi
+;;
+esac
+
+if test -n "$file_magic_test_file" && test -n "$file_magic_cmd"; then
+  case "$deplibs_check_method" in
+  "file_magic "*)
+    file_magic_regex="`expr \"$deplibs_check_method\" : \"file_magic \(.*\)\"`"
+    if eval $file_magic_cmd \$file_magic_test_file 2> /dev/null |
+       egrep "$file_magic_regex" > /dev/null; then
+      :
+    else
+      cat <<EOF 1>&2
+
+*** Warning: the command libtool uses to detect shared libraries,
+*** $file_magic_cmd, produces output that libtool cannot recognize.
+*** The result is that libtool may fail to recognize shared libraries
+*** as such.  This will affect the creation of libtool libraries that
+*** depend on shared libraries, but programs linked with such libtool
+*** libraries will work regardless of this problem.  Nevertheless, you
+*** may want to report the problem to your system manager and/or to
+*** bug-libtool@gnu.org
+
+EOF
+    fi ;;
+  esac
+fi
+
+echo $ac_n "checking whether to build shared libraries... $ac_c" 1>&6
+test "$can_build_shared" = "no" && enable_shared=no
+
+# On AIX, shared libraries and static libraries use the same namespace, and
+# are all built from PIC.
+case "$host_os" in
+aix3*)
+  test "$enable_shared" = yes && enable_static=no
+  if test -n "$RANLIB"; then
+    archive_cmds="$archive_cmds~\$RANLIB \$lib"
+    postinstall_cmds='$RANLIB $lib'
+  fi
+  ;;
+
+aix4*)
+  test "$enable_shared" = yes && enable_static=no
+  ;;
+esac
+
+echo "$ac_t$enable_shared" 1>&6
+
+# Make sure either enable_shared or enable_static is yes.
+test "$enable_shared" = yes || enable_static=yes
+
+echo "checking whether to build static libraries... $enable_static" 1>&6
+
+if test "$hardcode_action" = relink; then
+  # Fast installation is not supported
+  enable_fast_install=no
+elif test "$shlibpath_overrides_runpath" = yes ||
+     test "$enable_shared" = no; then
+  # Fast installation is not necessary
+  enable_fast_install=needless
+fi
+
+echo $ac_n "checking for objdir... $ac_c" 1>&6
+rm -f .libs 2>/dev/null
+mkdir .libs 2>/dev/null
+if test -d .libs; then
+  objdir=.libs
+else
+  # MS-DOS does not allow filenames that begin with a dot.
+  objdir=_libs
+fi
+rmdir .libs 2>/dev/null
+echo "$ac_t$objdir" 1>&6
+
+if test "x$enable_dlopen" != xyes; then
+  enable_dlopen=unknown
+  enable_dlopen_self=unknown
+  enable_dlopen_self_static=unknown
+else
+if eval "test \"`echo '$''{'lt_cv_dlopen'+set}'`\" != set"; then
+  lt_cv_dlopen=no lt_cv_dlopen_libs=
+echo $ac_n "checking for dlopen in -ldl""... $ac_c" 1>&6
+echo "$progname:2248: checking for dlopen in -ldl" >&5
+ac_lib_var=`echo dl'_'dlopen | sed 'y%./+-%__p_%'`
+if eval "test \"`echo '$''{'ac_cv_lib_$ac_lib_var'+set}'`\" = set"; then
+  echo $ac_n "(cached) $ac_c" 1>&6
+else
+  ac_save_LIBS="$LIBS"
+LIBS="-ldl  $LIBS"
+cat > conftest.$ac_ext <<EOF
+#line 2256 "ltconfig"
+/* Override any gcc2 internal prototype to avoid an error.  */
+/* We use char because int might match the return type of a gcc2
+    builtin and then its argument prototype would still apply.  */
+#ifdef __cplusplus
+extern "C"
+#endif
+char dlopen();
+
+int main() {
+dlopen()
+; return 0; }
+EOF
+if { (eval echo $progname:2269: \"$ac_link\") 1>&5; (eval $ac_link) 2>&5; } && test -s conftest${ac_exeext}; then
+  rm -rf conftest*
+  eval "ac_cv_lib_$ac_lib_var=yes"
+else
+  echo "$progname: failed program was:" >&5
+  cat conftest.$ac_ext >&5
+  rm -rf conftest*
+  eval "ac_cv_lib_$ac_lib_var=no"
+fi
+rm -f conftest*
+LIBS="$ac_save_LIBS"
+
+fi
+if eval "test \"`echo '$ac_cv_lib_'$ac_lib_var`\" = yes"; then
+  echo "$ac_t""yes" 1>&6
+  lt_cv_dlopen="dlopen" lt_cv_dlopen_libs="-ldl"
+else
+  echo "$ac_t""no" 1>&6
+echo $ac_n "checking for dlopen""... $ac_c" 1>&6
+echo "$progname:2288: checking for dlopen" >&5
+if eval "test \"`echo '$''{'ac_cv_func_dlopen'+set}'`\" = set"; then
+  echo $ac_n "(cached) $ac_c" 1>&6
+else
+  cat > conftest.$ac_ext <<EOF
+#line 2293 "ltconfig"
+/* System header to define __stub macros and hopefully few prototypes,
+    which can conflict with char dlopen(); below.  */
+#include <assert.h>
+/* Override any gcc2 internal prototype to avoid an error.  */
+/* We use char because int might match the return type of a gcc2
+    builtin and then its argument prototype would still apply.  */
+#ifdef __cplusplus
+extern "C"
+#endif
+char dlopen();
+
+int main() {
+
+/* The GNU C library defines this for functions which it implements
+    to always fail with ENOSYS.  Some functions are actually named
+    something starting with __ and the normal name is an alias.  */
+#if defined (__stub_dlopen) || defined (__stub___dlopen)
+choke me
+#else
+dlopen();
+#endif
+
+; return 0; }
+EOF
+if { (eval echo $progname:2318: \"$ac_link\") 1>&5; (eval $ac_link) 2>&5; } && test -s conftest${ac_exeext}; then
+  rm -rf conftest*
+  eval "ac_cv_func_dlopen=yes"
+else
+  echo "$progname: failed program was:" >&5
+  cat conftest.$ac_ext >&5
+  rm -rf conftest*
+  eval "ac_cv_func_dlopen=no"
+fi
+rm -f conftest*
+fi
+if eval "test \"`echo '$ac_cv_func_'dlopen`\" = yes"; then
+  echo "$ac_t""yes" 1>&6
+  lt_cv_dlopen="dlopen"
+else
+  echo "$ac_t""no" 1>&6
+echo $ac_n "checking for dld_link in -ldld""... $ac_c" 1>&6
+echo "$progname:2335: checking for dld_link in -ldld" >&5
+ac_lib_var=`echo dld'_'dld_link | sed 'y%./+-%__p_%'`
+if eval "test \"`echo '$''{'ac_cv_lib_$ac_lib_var'+set}'`\" = set"; then
+  echo $ac_n "(cached) $ac_c" 1>&6
+else
+  ac_save_LIBS="$LIBS"
+LIBS="-ldld  $LIBS"
+cat > conftest.$ac_ext <<EOF
+#line 2343 "ltconfig"
+/* Override any gcc2 internal prototype to avoid an error.  */
+/* We use char because int might match the return type of a gcc2
+    builtin and then its argument prototype would still apply.  */
+#ifdef __cplusplus
+extern "C"
+#endif
+char dld_link();
+
+int main() {
+dld_link()
+; return 0; }
+EOF
+if { (eval echo $progname:2356: \"$ac_link\") 1>&5; (eval $ac_link) 2>&5; } && test -s conftest${ac_exeext}; then
+  rm -rf conftest*
+  eval "ac_cv_lib_$ac_lib_var=yes"
+else
+  echo "$progname: failed program was:" >&5
+  cat conftest.$ac_ext >&5
+  rm -rf conftest*
+  eval "ac_cv_lib_$ac_lib_var=no"
+fi
+rm -f conftest*
+LIBS="$ac_save_LIBS"
+
+fi
+if eval "test \"`echo '$ac_cv_lib_'$ac_lib_var`\" = yes"; then
+  echo "$ac_t""yes" 1>&6
+  lt_cv_dlopen="dld_link" lt_cv_dlopen_libs="-ldld"
+else
+  echo "$ac_t""no" 1>&6
+echo $ac_n "checking for shl_load""... $ac_c" 1>&6
+echo "$progname:2375: checking for shl_load" >&5
+if eval "test \"`echo '$''{'ac_cv_func_shl_load'+set}'`\" = set"; then
+  echo $ac_n "(cached) $ac_c" 1>&6
+else
+  cat > conftest.$ac_ext <<EOF
+#line 2380 "ltconfig"
+/* System header to define __stub macros and hopefully few prototypes,
+    which can conflict with char shl_load(); below.  */
+#include <assert.h>
+/* Override any gcc2 internal prototype to avoid an error.  */
+/* We use char because int might match the return type of a gcc2
+    builtin and then its argument prototype would still apply.  */
+#ifdef __cplusplus
+extern "C"
+#endif
+char shl_load();
+
+int main() {
+
+/* The GNU C library defines this for functions which it implements
+    to always fail with ENOSYS.  Some functions are actually named
+    something starting with __ and the normal name is an alias.  */
+#if defined (__stub_shl_load) || defined (__stub___shl_load)
+choke me
+#else
+shl_load();
+#endif
+
+; return 0; }
+EOF
+if { (eval echo $progname:2405: \"$ac_link\") 1>&5; (eval $ac_link) 2>&5; } && test -s conftest${ac_exeext}; then
+  rm -rf conftest*
+  eval "ac_cv_func_shl_load=yes"
+else
+  echo "$progname: failed program was:" >&5
+  cat conftest.$ac_ext >&5
+  rm -rf conftest*
+  eval "ac_cv_func_shl_load=no"
+fi
+rm -f conftest*
+fi
+
+if eval "test \"`echo '$ac_cv_func_'shl_load`\" = yes"; then
+  echo "$ac_t""yes" 1>&6
+  lt_cv_dlopen="shl_load"
+else
+  echo "$ac_t""no" 1>&6
+echo $ac_n "checking for shl_load in -ldld""... $ac_c" 1>&6
+echo "$progname:2423: checking for shl_load in -ldld" >&5
+ac_lib_var=`echo dld'_'shl_load | sed 'y%./+-%__p_%'`
+if eval "test \"`echo '$''{'ac_cv_lib_$ac_lib_var'+set}'`\" = set"; then
+  echo $ac_n "(cached) $ac_c" 1>&6
+else
+  ac_save_LIBS="$LIBS"
+LIBS="-ldld  $LIBS"
+cat > conftest.$ac_ext <<EOF
+#line 2431 "ltconfig"
+#include "confdefs.h"
+/* Override any gcc2 internal prototype to avoid an error.  */
+/* We use char because int might match the return type of a gcc2
+    builtin and then its argument prototype would still apply.  */
+#ifdef __cplusplus
+extern "C"
+#endif
+char shl_load();
+
+int main() {
+shl_load()
+; return 0; }
+EOF
+if { (eval echo $progname:2445: \"$ac_link\") 1>&5; (eval $ac_link) 2>&5; } && test -s conftest${ac_exeext}; then
+  rm -rf conftest*
+  eval "ac_cv_lib_$ac_lib_var=yes"
+else
+  echo "$progname: failed program was:" >&5
+  cat conftest.$ac_ext >&5
+  rm -rf conftest*
+  eval "ac_cv_lib_$ac_lib_var=no"
+fi
+rm -f conftest*
+LIBS="$ac_save_LIBS"
+
+fi
+if eval "test \"`echo '$ac_cv_lib_'$ac_lib_var`\" = yes"; then
+  echo "$ac_t""yes" 1>&6
+  lt_cv_dlopen="shl_load" lt_cv_dlopen_libs="-ldld"
+else
+  echo "$ac_t""no" 1>&6
+fi
+
+
+fi
+
+    
+fi
+
+  
+fi
+
+
+fi
+
+fi
+
+  if test "x$lt_cv_dlopen" != xno; then
+    enable_dlopen=yes
+  fi
+
+  case "$lt_cv_dlopen" in
+  dlopen)
+for ac_hdr in dlfcn.h; do
+ac_safe=`echo "$ac_hdr" | sed 'y%./+-%__p_%'`
+echo $ac_n "checking for $ac_hdr""... $ac_c" 1>&6
+echo "$progname:2488: checking for $ac_hdr" >&5
+if eval "test \"`echo '$''{'ac_cv_header_$ac_safe'+set}'`\" = set"; then
+  echo $ac_n "(cached) $ac_c" 1>&6
+else
+  cat > conftest.$ac_ext <<EOF
+#line 2493 "ltconfig"
+#include <$ac_hdr>
+int fnord = 0;
+EOF
+ac_try="$ac_compile >/dev/null 2>conftest.out"
+{ (eval echo $progname:2498: \"$ac_try\") 1>&5; (eval $ac_try) 2>&5; }
+ac_err=`grep -v '^ *+' conftest.out | grep -v "^conftest.${ac_ext}\$"`
+if test -z "$ac_err"; then
+  rm -rf conftest*
+  eval "ac_cv_header_$ac_safe=yes"
+else
+  echo "$ac_err" >&5
+  echo "$progname: failed program was:" >&5
+  cat conftest.$ac_ext >&5
+  rm -rf conftest*
+  eval "ac_cv_header_$ac_safe=no"
+fi
+rm -f conftest*
+fi
+if eval "test \"`echo '$ac_cv_header_'$ac_safe`\" = yes"; then
+  echo "$ac_t""yes" 1>&6
+else
+  echo "$ac_t""no" 1>&6
+fi
+done
+
+    if test "x$ac_cv_header_dlfcn_h" = xyes; then
+      CPPFLAGS="$CPPFLAGS -DHAVE_DLFCN_H"
+    fi
+    eval LDFLAGS=\"\$LDFLAGS $export_dynamic_flag_spec\"
+    LIBS="$lt_cv_dlopen_libs $LIBS"
+
+  echo $ac_n "checking whether a program can dlopen itself""... $ac_c" 1>&6
+echo "$progname:2526: checking whether a program can dlopen itself" >&5
+if test "${lt_cv_dlopen_self+set}" = set; then
+  echo $ac_n "(cached) $ac_c" 1>&6
+else
+  if test "$cross_compiling" = yes; then
+    lt_cv_dlopen_self=cross
+  else
+    cat > conftest.c <<EOF
+#line 2534 "ltconfig"
+
+#if HAVE_DLFCN_H
+#include <dlfcn.h>
+#endif
+
+#include <stdio.h>
+
+#ifdef RTLD_GLOBAL
+# define LTDL_GLOBAL	RTLD_GLOBAL
+#else
+# ifdef DL_GLOBAL
+#  define LTDL_GLOBAL	DL_GLOBAL
+# else
+#  define LTDL_GLOBAL	0
+# endif
+#endif
+
+/* We may have to define LTDL_LAZY_OR_NOW in the command line if we
+   find out it does not work in some platform. */
+#ifndef LTDL_LAZY_OR_NOW
+# ifdef RTLD_LAZY
+#  define LTDL_LAZY_OR_NOW	RTLD_LAZY
+# else
+#  ifdef DL_LAZY
+#   define LTDL_LAZY_OR_NOW	DL_LAZY
+#  else
+#   ifdef RTLD_NOW
+#    define LTDL_LAZY_OR_NOW	RTLD_NOW
+#   else
+#    ifdef DL_NOW
+#     define LTDL_LAZY_OR_NOW	DL_NOW
+#    else
+#     define LTDL_LAZY_OR_NOW	0
+#    endif
+#   endif
+#  endif
+# endif
+#endif
+
+fnord() { int i=42;}
+main() { void *self, *ptr1, *ptr2; self=dlopen(0,LTDL_GLOBAL|LTDL_LAZY_OR_NOW);
+    if(self) { ptr1=dlsym(self,"fnord"); ptr2=dlsym(self,"_fnord");
+	       if(ptr1 || ptr2) { dlclose(self); exit(0); } } exit(1); } 
+
+EOF
+if { (eval echo $progname:2580: \"$ac_link\") 1>&5; (eval $ac_link) 2>&5; } && test -s conftest && (./conftest; exit) 2>/dev/null
+then
+  lt_cv_dlopen_self=yes
+else
+  echo "$progname: failed program was:" >&5
+  cat conftest.$ac_ext >&5
+  rm -fr conftest*
+  lt_cv_dlopen_self=no
+fi
+rm -fr conftest*
+fi
+
+fi
+
+echo "$ac_t""$lt_cv_dlopen_self" 1>&6
+
+  if test "$lt_cv_dlopen_self" = yes; then
+    LDFLAGS="$LDFLAGS $link_static_flag"
+  echo $ac_n "checking whether a statically linked program can dlopen itself""... $ac_c" 1>&6
+echo "$progname:2599: checking whether a statically linked program can dlopen itself" >&5
+if test "${lt_cv_dlopen_self_static+set}" = set; then
+  echo $ac_n "(cached) $ac_c" 1>&6
+else
+  if test "$cross_compiling" = yes; then
+    lt_cv_dlopen_self_static=cross
+  else
+    cat > conftest.c <<EOF
+#line 2607 "ltconfig"
+
+#if HAVE_DLFCN_H
+#include <dlfcn.h>
+#endif
+
+#include <stdio.h>
+
+#ifdef RTLD_GLOBAL
+# define LTDL_GLOBAL	RTLD_GLOBAL
+#else
+# ifdef DL_GLOBAL
+#  define LTDL_GLOBAL	DL_GLOBAL
+# else
+#  define LTDL_GLOBAL	0
+# endif
+#endif
+
+/* We may have to define LTDL_LAZY_OR_NOW in the command line if we
+   find out it does not work in some platform. */
+#ifndef LTDL_LAZY_OR_NOW
+# ifdef RTLD_LAZY
+#  define LTDL_LAZY_OR_NOW	RTLD_LAZY
+# else
+#  ifdef DL_LAZY
+#   define LTDL_LAZY_OR_NOW	DL_LAZY
+#  else
+#   ifdef RTLD_NOW
+#    define LTDL_LAZY_OR_NOW	RTLD_NOW
+#   else
+#    ifdef DL_NOW
+#     define LTDL_LAZY_OR_NOW	DL_NOW
+#    else
+#     define LTDL_LAZY_OR_NOW	0
+#    endif
+#   endif
+#  endif
+# endif
+#endif
+
+fnord() { int i=42;}
+main() { void *self, *ptr1, *ptr2; self=dlopen(0,LTDL_GLOBAL|LTDL_LAZY_OR_NOW);
+    if(self) { ptr1=dlsym(self,"fnord"); ptr2=dlsym(self,"_fnord");
+    if(ptr1 || ptr2) { dlclose(self); exit(0); } } exit(1); } 
+
+EOF
+if { (eval echo $progname:2653: \"$ac_link\") 1>&5; (eval $ac_link) 2>&5; } && test -s conftest && (./conftest; exit) 2>/dev/null
+then
+  lt_cv_dlopen_self_static=yes
+else
+  echo "$progname: failed program was:" >&5
+  cat conftest.$ac_ext >&5
+  rm -fr conftest*
+  lt_cv_dlopen_self_static=no
+fi
+rm -fr conftest*
+fi
+
+fi
+
+echo "$ac_t""$lt_cv_dlopen_self_static" 1>&6
+fi
+    ;;
+  esac
+
+  case "$lt_cv_dlopen_self" in
+  yes|no) enable_dlopen_self=$lt_cv_dlopen_self ;;
+  *) enable_dlopen_self=unknown ;;
+  esac
+
+  case "$lt_cv_dlopen_self_static" in
+  yes|no) enable_dlopen_self_static=$lt_cv_dlopen_self_static ;;
+  *) enable_dlopen_self_static=unknown ;;
+  esac
+fi
+
+# Copy echo and quote the copy, instead of the original, because it is
+# used later.
+ltecho="$echo"
+if test "X$ltecho" = "X$CONFIG_SHELL $0 --fallback-echo"; then
+   ltecho="$CONFIG_SHELL \$0 --fallback-echo"
+fi
+LTSHELL="$SHELL"
+
+LTCONFIG_VERSION="$VERSION"
+
+# Only quote variables if we're using ltmain.sh.
+case "$ltmain" in
+*.sh)
+  # Now quote all the things that may contain metacharacters.
+  for var in ltecho old_CC old_CFLAGS old_CPPFLAGS \
+    old_LD old_LDFLAGS old_LIBS \
+    old_NM old_RANLIB old_LN_S old_DLLTOOL old_OBJDUMP old_AS \
+    AR CC LD LN_S NM LTSHELL LTCONFIG_VERSION \
+    reload_flag reload_cmds wl \
+    pic_flag link_static_flag no_builtin_flag export_dynamic_flag_spec \
+    thread_safe_flag_spec whole_archive_flag_spec libname_spec \
+    library_names_spec soname_spec \
+    RANLIB old_archive_cmds old_archive_from_new_cmds old_postinstall_cmds \
+    old_postuninstall_cmds archive_cmds archive_expsym_cmds postinstall_cmds postuninstall_cmds \
+    file_magic_cmd export_symbols_cmds deplibs_check_method allow_undefined_flag no_undefined_flag \
+    finish_cmds finish_eval global_symbol_pipe global_symbol_to_cdecl \
+    hardcode_libdir_flag_spec hardcode_libdir_separator  \
+    sys_lib_search_path_spec sys_lib_dlsearch_path_spec \
+    compiler_c_o compiler_o_lo need_locks exclude_expsyms include_expsyms; do
+
+    case "$var" in
+    reload_cmds | old_archive_cmds | old_archive_from_new_cmds | \
+    old_postinstall_cmds | old_postuninstall_cmds | \
+    export_symbols_cmds | archive_cmds | archive_expsym_cmds | \
+    postinstall_cmds | postuninstall_cmds | \
+    finish_cmds | sys_lib_search_path_spec | sys_lib_dlsearch_path_spec)
+      # Double-quote double-evaled strings.
+      eval "$var=\\\"\`\$echo \"X\$$var\" | \$Xsed -e \"\$double_quote_subst\" -e \"\$sed_quote_subst\" -e \"\$delay_variable_subst\"\`\\\""
+      ;;
+    *)
+      eval "$var=\\\"\`\$echo \"X\$$var\" | \$Xsed -e \"\$sed_quote_subst\"\`\\\""
+      ;;
+    esac
+  done
+
+  case "$ltecho" in
+  *'\$0 --fallback-echo"')
+    ltecho=`$echo "X$ltecho" | $Xsed -e 's/\\\\\\\$0 --fallback-echo"$/$0 --fallback-echo"/'`
+    ;;
+  esac
+
+  trap "$rm \"$ofile\"; exit 1" 1 2 15
+  echo "creating $ofile"
+  $rm "$ofile"
+  cat <<EOF > "$ofile"
+#! $SHELL
+
+# `$echo "$ofile" | sed 's%^.*/%%'` - Provide generalized library-building support services.
+# Generated automatically by $PROGRAM (GNU $PACKAGE $VERSION$TIMESTAMP)
+# NOTE: Changes made to this file will be lost: look at ltconfig or ltmain.sh.
+#
+# Copyright (C) 1996-1999 Free Software Foundation, Inc.
+# Originally by Gordon Matzigkeit <gord@gnu.ai.mit.edu>, 1996
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+#
+# As a special exception to the GNU General Public License, if you
+# distribute this file as part of a program that contains a
+# configuration script generated by Autoconf, you may include it under
+# the same distribution terms that you use for the rest of that program.
+
+# Sed that helps us avoid accidentally triggering echo(1) options like -n.
+Xsed="sed -e s/^X//"
+
+# The HP-UX ksh and POSIX shell print the target directory to stdout
+# if CDPATH is set.
+if test "X\${CDPATH+set}" = Xset; then CDPATH=:; export CDPATH; fi
+
+### BEGIN LIBTOOL CONFIG
+EOF
+  cfgfile="$ofile"
+  ;;
+
+*)
+  # Double-quote the variables that need it (for aesthetics).
+  for var in old_CC old_CFLAGS old_CPPFLAGS \
+    old_LD old_LDFLAGS old_LIBS \
+    old_NM old_RANLIB old_LN_S old_DLLTOOL old_OBJDUMP old_AS; do
+    eval "$var=\\\"\$var\\\""
+  done
+
+  # Just create a config file.
+  cfgfile="$ofile.cfg"
+  trap "$rm \"$cfgfile\"; exit 1" 1 2 15
+  echo "creating $cfgfile"
+  $rm "$cfgfile"
+  cat <<EOF > "$cfgfile"
+# `$echo "$cfgfile" | sed 's%^.*/%%'` - Libtool configuration file.
+# Generated automatically by $PROGRAM (GNU $PACKAGE $VERSION$TIMESTAMP)
+EOF
+  ;;
+esac
+
+cat <<EOF >> "$cfgfile"
+# Libtool was configured as follows, on host `(hostname || uname -n) 2>/dev/null | sed 1q`:
+#
+# CC=$old_CC CFLAGS=$old_CFLAGS CPPFLAGS=$old_CPPFLAGS \\
+# LD=$old_LD LDFLAGS=$old_LDFLAGS LIBS=$old_LIBS \\
+# NM=$old_NM RANLIB=$old_RANLIB LN_S=$old_LN_S \\
+# DLLTOOL=$old_DLLTOOL OBJDUMP=$old_OBJDUMP AS=$old_AS \\
+#   $0$ltconfig_args
+#
+# Compiler and other test output produced by $progname, useful for
+# debugging $progname, is in ./config.log if it exists.
+
+# The version of $progname that generated this script.
+LTCONFIG_VERSION=$LTCONFIG_VERSION
+
+# Shell to use when invoking shell scripts.
+SHELL=$LTSHELL
+
+# Whether or not to build shared libraries.
+build_libtool_libs=$enable_shared
+
+# Whether or not to build static libraries.
+build_old_libs=$enable_static
+
+# Whether or not to optimize for fast installation.
+fast_install=$enable_fast_install
+
+# The host system.
+host_alias=$host_alias
+host=$host
+
+# An echo program that does not interpret backslashes.
+echo=$ltecho
+
+# The archiver.
+AR=$AR
+
+# The default C compiler.
+CC=$CC
+
+# The linker used to build libraries.
+LD=$LD
+
+# Whether we need hard or soft links.
+LN_S=$LN_S
+
+# A BSD-compatible nm program.
+NM=$NM
+
+# Used on cygwin: DLL creation program.
+DLLTOOL="$DLLTOOL"
+
+# Used on cygwin: object dumper.
+OBJDUMP="$OBJDUMP"
+
+# Used on cygwin: assembler.
+AS="$AS"
+
+# The name of the directory that contains temporary libtool files.
+objdir=$objdir
+
+# How to create reloadable object files.
+reload_flag=$reload_flag
+reload_cmds=$reload_cmds
+
+# How to pass a linker flag through the compiler.
+wl=$wl
+
+# Object file suffix (normally "o").
+objext="$objext"
+
+# Old archive suffix (normally "a").
+libext="$libext"
+
+# Executable file suffix (normally "").
+exeext="$exeext"
+
+# Additional compiler flags for building library objects.
+pic_flag=$pic_flag
+
+# Does compiler simultaneously support -c and -o options?
+compiler_c_o=$compiler_c_o
+
+# Can we write directly to a .lo ?
+compiler_o_lo=$compiler_o_lo
+
+# Must we lock files when doing compilation ?
+need_locks=$need_locks
+
+# Do we need the lib prefix for modules?
+need_lib_prefix=$need_lib_prefix
+
+# Do we need a version for libraries?
+need_version=$need_version
+
+# Whether dlopen is supported.
+dlopen=$enable_dlopen
+
+# Whether dlopen of programs is supported.
+dlopen_self=$enable_dlopen_self
+
+# Whether dlopen of statically linked programs is supported.
+dlopen_self_static=$enable_dlopen_self_static
+
+# Compiler flag to prevent dynamic linking.
+link_static_flag=$link_static_flag
+
+# Compiler flag to turn off builtin functions.
+no_builtin_flag=$no_builtin_flag
+
+# Compiler flag to allow reflexive dlopens.
+export_dynamic_flag_spec=$export_dynamic_flag_spec
+
+# Compiler flag to generate shared objects directly from archives.
+whole_archive_flag_spec=$whole_archive_flag_spec
+
+# Compiler flag to generate thread-safe objects.
+thread_safe_flag_spec=$thread_safe_flag_spec
+
+# Library versioning type.
+version_type=$version_type
+
+# Format of library name prefix.
+libname_spec=$libname_spec
+
+# List of archive names.  First name is the real one, the rest are links.
+# The last name is the one that the linker finds with -lNAME.
+library_names_spec=$library_names_spec
+
+# The coded name of the library, if different from the real name.
+soname_spec=$soname_spec
+
+# Commands used to build and install an old-style archive.
+RANLIB=$RANLIB
+old_archive_cmds=$old_archive_cmds
+old_postinstall_cmds=$old_postinstall_cmds
+old_postuninstall_cmds=$old_postuninstall_cmds
+
+# Create an old-style archive from a shared archive.
+old_archive_from_new_cmds=$old_archive_from_new_cmds
+
+# Commands used to build and install a shared archive.
+archive_cmds=$archive_cmds
+archive_expsym_cmds=$archive_expsym_cmds
+postinstall_cmds=$postinstall_cmds
+postuninstall_cmds=$postuninstall_cmds
+
+# Method to check whether dependent libraries are shared objects.
+deplibs_check_method=$deplibs_check_method
+
+# Command to use when deplibs_check_method == file_magic.
+file_magic_cmd=$file_magic_cmd
+
+# Flag that allows shared libraries with undefined symbols to be built.
+allow_undefined_flag=$allow_undefined_flag
+
+# Flag that forces no undefined symbols.
+no_undefined_flag=$no_undefined_flag
+
+# Commands used to finish a libtool library installation in a directory.
+finish_cmds=$finish_cmds
+
+# Same as above, but a single script fragment to be evaled but not shown.
+finish_eval=$finish_eval
+
+# Take the output of nm and produce a listing of raw symbols and C names.
+global_symbol_pipe=$global_symbol_pipe
+
+# Transform the output of nm in a proper C declaration
+global_symbol_to_cdecl=$global_symbol_to_cdecl
+
+# This is the shared library runtime path variable.
+runpath_var=$runpath_var
+
+# This is the shared library path variable.
+shlibpath_var=$shlibpath_var
+
+# Is shlibpath searched before the hard-coded library search path?
+shlibpath_overrides_runpath=$shlibpath_overrides_runpath
+
+# How to hardcode a shared library path into an executable.
+hardcode_action=$hardcode_action
+
+# Flag to hardcode \$libdir into a binary during linking.
+# This must work even if \$libdir does not exist.
+hardcode_libdir_flag_spec=$hardcode_libdir_flag_spec
+
+# Whether we need a single -rpath flag with a separated argument.
+hardcode_libdir_separator=$hardcode_libdir_separator
+
+# Set to yes if using DIR/libNAME.so during linking hardcodes DIR into the
+# resulting binary.
+hardcode_direct=$hardcode_direct
+
+# Set to yes if using the -LDIR flag during linking hardcodes DIR into the
+# resulting binary.
+hardcode_minus_L=$hardcode_minus_L
+
+# Set to yes if using SHLIBPATH_VAR=DIR during linking hardcodes DIR into
+# the resulting binary.
+hardcode_shlibpath_var=$hardcode_shlibpath_var
+
+# Compile-time system search path for libraries
+sys_lib_search_path_spec=$sys_lib_search_path_spec
+
+# Run-time system search path for libraries
+sys_lib_dlsearch_path_spec=$sys_lib_dlsearch_path_spec
+
+# Fix the shell variable \$srcfile for the compiler.
+fix_srcfile_path="$fix_srcfile_path"
+
+# Set to yes if exported symbols are required.
+always_export_symbols=$always_export_symbols
+
+# The commands to list exported symbols.
+export_symbols_cmds=$export_symbols_cmds
+
+# Symbols that should not be listed in the preloaded symbols.
+exclude_expsyms=$exclude_expsyms
+
+# Symbols that must always be exported.
+include_expsyms=$include_expsyms
+
+EOF
+
+case "$ltmain" in
+*.sh)
+  echo '### END LIBTOOL CONFIG' >> "$ofile"
+  echo >> "$ofile"
+  case "$host_os" in
+  aix3*)
+    cat <<\EOF >> "$ofile"
+
+# AIX sometimes has problems with the GCC collect2 program.  For some
+# reason, if we set the COLLECT_NAMES environment variable, the problems
+# vanish in a puff of smoke.
+if test "X${COLLECT_NAMES+set}" != Xset; then
+  COLLECT_NAMES=
+  export COLLECT_NAMES
+fi
+EOF
+    ;;
+  esac
+
+  # Append the ltmain.sh script.
+  sed '$q' "$ltmain" >> "$ofile" || (rm -f "$ofile"; exit 1)
+  # We use sed instead of cat because bash on DJGPP gets confused if
+  # if finds mixed CR/LF and LF-only lines.  Since sed operates in
+  # text mode, it properly converts lines to CR/LF.  This bash problem
+  # is reportedly fixed, but why not run on old versions too?
+
+  chmod +x "$ofile"
+  ;;
+
+*)
+  # Compile the libtool program.
+  echo "FIXME: would compile $ltmain"
+  ;;
+esac
+
+test -n "$cache_file" || exit 0
+
+# AC_CACHE_SAVE
+trap '' 1 2 15
+cat > confcache <<\EOF
+# This file is a shell script that caches the results of configure
+# tests run on this system so they can be shared between configure
+# scripts and configure runs.  It is not useful on other systems.
+# If it contains results you don't want to keep, you may remove or edit it.
+#
+# By default, configure uses ./config.cache as the cache file,
+# creating it if it does not exist already.  You can give configure
+# the --cache-file=FILE option to use a different cache file; that is
+# what configure does when it calls configure scripts in
+# subdirectories, so they share the cache.
+# Giving --cache-file=/dev/null disables caching, for debugging configure.
+# config.status only pays attention to the cache file if you give it the
+# --recheck option to rerun configure.
+#
+EOF
+# The following way of writing the cache mishandles newlines in values,
+# but we know of no workaround that is simple, portable, and efficient.
+# So, don't put newlines in cache variables' values.
+# Ultrix sh set writes to stderr and can't be redirected directly,
+# and sets the high bit in the cache file unless we assign to the vars.
+(set) 2>&1 |
+  case `(ac_space=' '; set | grep ac_space) 2>&1` in
+  *ac_space=\ *)
+    # `set' does not quote correctly, so add quotes (double-quote substitution
+    # turns \\\\ into \\, and sed turns \\ into \).
+    sed -n \
+      -e "s/'/'\\\\''/g" \
+      -e "s/^\\([a-zA-Z0-9_]*_cv_[a-zA-Z0-9_]*\\)=\\(.*\\)/\\1=\${\\1='\\2'}/p"
+    ;;
+  *)
+    # `set' quotes correctly as required by POSIX, so do not add quotes.
+    sed -n -e 's/^\([a-zA-Z0-9_]*_cv_[a-zA-Z0-9_]*\)=\(.*\)/\1=${\1=\2}/p'
+    ;;
+  esac >> confcache
+if cmp -s $cache_file confcache; then
+  :
+else
+  if test -w $cache_file; then
+    echo "updating cache $cache_file"
+    cat confcache > $cache_file
+  else
+    echo "not updating unwritable cache $cache_file"
+  fi
+fi
+rm -f confcache
+
+exit 0
+
+# Local Variables:
+# mode:shell-script
+# sh-indentation:2
+# End:
Index: ossp-pkg/pth/ltmain.sh
RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/ltmain.sh,v
co -q -kk -p'1.9' '/v/ossp/cvs/ossp-pkg/pth/Attic/ltmain.sh,v' | diff -u /dev/null - -L'ossp-pkg/pth/ltmain.sh' 2>/dev/null
--- ossp-pkg/pth/ltmain.sh
+++ -	2024-05-14 08:38:00.863642245 +0200
@@ -0,0 +1,4024 @@
+# ltmain.sh - Provide generalized library-building support services.
+# NOTE: Changing this file will not affect anything until you rerun ltconfig.
+#
+# Copyright (C) 1996-1999 Free Software Foundation, Inc.
+# Originally by Gordon Matzigkeit <gord@gnu.ai.mit.edu>, 1996
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+#
+# As a special exception to the GNU General Public License, if you
+# distribute this file as part of a program that contains a
+# configuration script generated by Autoconf, you may include it under
+# the same distribution terms that you use for the rest of that program.
+
+# Check that we have a working $echo.
+if test "X$1" = X--no-reexec; then
+  # Discard the --no-reexec flag, and continue.
+  shift
+elif test "X$1" = X--fallback-echo; then
+  # Avoid inline document here, it may be left over
+  :
+elif test "X`($echo '\t') 2>/dev/null`" = 'X\t'; then
+  # Yippee, $echo works!
+  :
+else
+  # Restart under the correct shell, and then maybe $echo will work.
+  exec $SHELL "$0" --no-reexec ${1+"$@"}
+fi
+
+if test "X$1" = X--fallback-echo; then
+  # used as fallback echo
+  shift
+  cat <<EOF
+$*
+EOF
+  exit 0
+fi
+
+# The name of this program.
+progname=`$echo "$0" | sed 's%^.*/%%'`
+modename="$progname"
+
+# Constants.
+PROGRAM=ltmain.sh
+PACKAGE=libtool
+VERSION=1.3.5
+TIMESTAMP=" (1.385.2.206 2000/05/27 11:12:27)"
+
+default_mode=
+help="Try \`$progname --help' for more information."
+magic="%%%MAGIC variable%%%"
+mkdir="mkdir"
+mv="mv -f"
+rm="rm -f"
+
+# Sed substitution that helps us do robust quoting.  It backslashifies
+# metacharacters that are still active within double-quoted strings.
+Xsed='sed -e 1s/^X//'
+sed_quote_subst='s/\([\\`\\"$\\\\]\)/\\\1/g'
+SP2NL='tr \040 \012'
+NL2SP='tr \015\012 \040\040'
+
+# NLS nuisances.
+# Only set LANG and LC_ALL to C if already set.
+# These must not be set unconditionally because not all systems understand
+# e.g. LANG=C (notably SCO).
+# We save the old values to restore during execute mode.
+if test "${LC_ALL+set}" = set; then
+  save_LC_ALL="$LC_ALL"; LC_ALL=C; export LC_ALL
+fi
+if test "${LANG+set}" = set; then
+  save_LANG="$LANG"; LANG=C; export LANG
+fi
+
+if test "$LTCONFIG_VERSION" != "$VERSION"; then
+  echo "$modename: ltconfig version \`$LTCONFIG_VERSION' does not match $PROGRAM version \`$VERSION'" 1>&2
+  echo "Fatal configuration error.  See the $PACKAGE docs for more information." 1>&2
+  exit 1
+fi
+
+if test "$build_libtool_libs" != yes && test "$build_old_libs" != yes; then
+  echo "$modename: not configured to build any kind of library" 1>&2
+  echo "Fatal configuration error.  See the $PACKAGE docs for more information." 1>&2
+  exit 1
+fi
+
+# Global variables.
+mode=$default_mode
+nonopt=
+prev=
+prevopt=
+run=
+show="$echo"
+show_help=
+execute_dlfiles=
+lo2o="s/\\.lo\$/.${objext}/"
+o2lo="s/\\.${objext}\$/.lo/"
+
+# Parse our command line options once, thoroughly.
+while test $# -gt 0
+do
+  arg="$1"
+  shift
+
+  case "$arg" in
+  -*=*) optarg=`$echo "X$arg" | $Xsed -e 's/[-_a-zA-Z0-9]*=//'` ;;
+  *) optarg= ;;
+  esac
+
+  # If the previous option needs an argument, assign it.
+  if test -n "$prev"; then
+    case "$prev" in
+    execute_dlfiles)
+      eval "$prev=\"\$$prev \$arg\""
+      ;;
+    *)
+      eval "$prev=\$arg"
+      ;;
+    esac
+
+    prev=
+    prevopt=
+    continue
+  fi
+
+  # Have we seen a non-optional argument yet?
+  case "$arg" in
+  --help)
+    show_help=yes
+    ;;
+
+  --version)
+    echo "$PROGRAM (GNU $PACKAGE) $VERSION$TIMESTAMP"
+    exit 0
+    ;;
+
+  --config)
+    sed -e '1,/^### BEGIN LIBTOOL CONFIG/d' -e '/^### END LIBTOOL CONFIG/,$d' $0
+    exit 0
+    ;;
+
+  --debug)
+    echo "$progname: enabling shell trace mode"
+    set -x
+    ;;
+
+  --dry-run | -n)
+    run=:
+    ;;
+
+  --features)
+    echo "host: $host"
+    if test "$build_libtool_libs" = yes; then
+      echo "enable shared libraries"
+    else
+      echo "disable shared libraries"
+    fi
+    if test "$build_old_libs" = yes; then
+      echo "enable static libraries"
+    else
+      echo "disable static libraries"
+    fi
+    exit 0
+    ;;
+
+  --finish) mode="finish" ;;
+
+  --mode) prevopt="--mode" prev=mode ;;
+  --mode=*) mode="$optarg" ;;
+
+  --quiet | --silent)
+    show=:
+    ;;
+
+  -dlopen)
+    prevopt="-dlopen"
+    prev=execute_dlfiles
+    ;;
+
+  -*)
+    $echo "$modename: unrecognized option \`$arg'" 1>&2
+    $echo "$help" 1>&2
+    exit 1
+    ;;
+
+  *)
+    nonopt="$arg"
+    break
+    ;;
+  esac
+done
+
+if test -n "$prevopt"; then
+  $echo "$modename: option \`$prevopt' requires an argument" 1>&2
+  $echo "$help" 1>&2
+  exit 1
+fi
+
+if test -z "$show_help"; then
+
+  # Infer the operation mode.
+  if test -z "$mode"; then
+    case "$nonopt" in
+    *cc | *++ | gcc* | *-gcc*)
+      mode=link
+      for arg
+      do
+	case "$arg" in
+	-c)
+	   mode=compile
+	   break
+	   ;;
+	esac
+      done
+      ;;
+    *db | *dbx | *strace | *truss)
+      mode=execute
+      ;;
+    *install*|cp|mv)
+      mode=install
+      ;;
+    *rm)
+      mode=uninstall
+      ;;
+    *)
+      # If we have no mode, but dlfiles were specified, then do execute mode.
+      test -n "$execute_dlfiles" && mode=execute
+
+      # Just use the default operation mode.
+      if test -z "$mode"; then
+	if test -n "$nonopt"; then
+	  $echo "$modename: warning: cannot infer operation mode from \`$nonopt'" 1>&2
+	else
+	  $echo "$modename: warning: cannot infer operation mode without MODE-ARGS" 1>&2
+	fi
+      fi
+      ;;
+    esac
+  fi
+
+  # Only execute mode is allowed to have -dlopen flags.
+  if test -n "$execute_dlfiles" && test "$mode" != execute; then
+    $echo "$modename: unrecognized option \`-dlopen'" 1>&2
+    $echo "$help" 1>&2
+    exit 1
+  fi
+
+  # Change the help message to a mode-specific one.
+  generic_help="$help"
+  help="Try \`$modename --help --mode=$mode' for more information."
+
+  # These modes are in order of execution frequency so that they run quickly.
+  case "$mode" in
+  # libtool compile mode
+  compile)
+    modename="$modename: compile"
+    # Get the compilation command and the source file.
+    base_compile=
+    lastarg=
+    srcfile="$nonopt"
+    suppress_output=
+
+    user_target=no
+    for arg
+    do
+      # Accept any command-line options.
+      case "$arg" in
+      -o)
+	if test "$user_target" != "no"; then
+	  $echo "$modename: you cannot specify \`-o' more than once" 1>&2
+	  exit 1
+	fi
+	user_target=next
+	;;
+
+      -static)
+	build_old_libs=yes
+	continue
+	;;
+      esac
+
+      case "$user_target" in
+      next)
+	# The next one is the -o target name
+	user_target=yes
+	continue
+	;;
+      yes)
+	# We got the output file
+	user_target=set
+	libobj="$arg"
+	continue
+	;;
+      esac
+
+      # Accept the current argument as the source file.
+      lastarg="$srcfile"
+      srcfile="$arg"
+
+      # Aesthetically quote the previous argument.
+
+      # Backslashify any backslashes, double quotes, and dollar signs.
+      # These are the only characters that are still specially
+      # interpreted inside of double-quoted scrings.
+      lastarg=`$echo "X$lastarg" | $Xsed -e "$sed_quote_subst"`
+
+      # Double-quote args containing other shell metacharacters.
+      # Many Bourne shells cannot handle close brackets correctly in scan
+      # sets, so we specify it separately.
+      case "$lastarg" in
+      *[\[\~\#\^\&\*\(\)\{\}\|\;\<\>\?\'\ \	]*|*]*)
+	lastarg="\"$lastarg\""
+	;;
+      esac
+
+      # Add the previous argument to base_compile.
+      if test -z "$base_compile"; then
+	base_compile="$lastarg"
+      else
+	base_compile="$base_compile $lastarg"
+      fi
+    done
+
+    case "$user_target" in
+    set)
+      ;;
+    no)
+      # Get the name of the library object.
+      libobj=`$echo "X$srcfile" | $Xsed -e 's%^.*/%%'`
+      ;;
+    *)
+      $echo "$modename: you must specify a target with \`-o'" 1>&2
+      exit 1
+      ;;
+    esac
+
+    # Recognize several different file suffixes.
+    # If the user specifies -o file.o, it is replaced with file.lo
+    xform='[cCFSfmso]'
+    case "$libobj" in
+    *.ada) xform=ada ;;
+    *.adb) xform=adb ;;
+    *.ads) xform=ads ;;
+    *.asm) xform=asm ;;
+    *.c++) xform=c++ ;;
+    *.cc) xform=cc ;;
+    *.cpp) xform=cpp ;;
+    *.cxx) xform=cxx ;;
+    *.f90) xform=f90 ;;
+    *.for) xform=for ;;
+    esac
+
+    libobj=`$echo "X$libobj" | $Xsed -e "s/\.$xform$/.lo/"`
+
+    case "$libobj" in
+    *.lo) obj=`$echo "X$libobj" | $Xsed -e "$lo2o"` ;;
+    *)
+      $echo "$modename: cannot determine name of library object from \`$libobj'" 1>&2
+      exit 1
+      ;;
+    esac
+
+    if test -z "$base_compile"; then
+      $echo "$modename: you must specify a compilation command" 1>&2
+      $echo "$help" 1>&2
+      exit 1
+    fi
+
+    # Delete any leftover library objects.
+    if test "$build_old_libs" = yes; then
+      removelist="$obj $libobj"
+    else
+      removelist="$libobj"
+    fi
+
+    $run $rm $removelist
+    trap "$run $rm $removelist; exit 1" 1 2 15
+
+    # Calculate the filename of the output object if compiler does
+    # not support -o with -c
+    if test "$compiler_c_o" = no; then
+      output_obj=`$echo "X$srcfile" | $Xsed -e 's%^.*/%%' -e 's%\..*$%%'`.${objext}
+      lockfile="$output_obj.lock"
+      removelist="$removelist $output_obj $lockfile"
+      trap "$run $rm $removelist; exit 1" 1 2 15
+    else
+      need_locks=no
+      lockfile=
+    fi
+
+    # Lock this critical section if it is needed
+    # We use this script file to make the link, it avoids creating a new file
+    if test "$need_locks" = yes; then
+      until ln "$0" "$lockfile" 2>/dev/null; do
+	$show "Waiting for $lockfile to be removed"
+	sleep 2
+      done
+    elif test "$need_locks" = warn; then
+      if test -f "$lockfile"; then
+	echo "\
+*** ERROR, $lockfile exists and contains:
+`cat $lockfile 2>/dev/null`
+
+This indicates that another process is trying to use the same
+temporary object file, and libtool could not work around it because
+your compiler does not support \`-c' and \`-o' together.  If you
+repeat this compilation, it may succeed, by chance, but you had better
+avoid parallel builds (make -j) in this platform, or get a better
+compiler."
+
+	$run $rm $removelist
+	exit 1
+      fi
+      echo $srcfile > "$lockfile"
+    fi
+
+    if test -n "$fix_srcfile_path"; then
+      eval srcfile=\"$fix_srcfile_path\"
+    fi
+
+    # Only build a PIC object if we are building libtool libraries.
+    if test "$build_libtool_libs" = yes; then
+      # Without this assignment, base_compile gets emptied.
+      fbsd_hideous_sh_bug=$base_compile
+
+      # All platforms use -DPIC, to notify preprocessed assembler code.
+      command="$base_compile $srcfile $pic_flag -DPIC"
+      if test "$build_old_libs" = yes; then
+	lo_libobj="$libobj"
+	dir=`$echo "X$libobj" | $Xsed -e 's%/[^/]*$%%'`
+	if test "X$dir" = "X$libobj"; then
+	  dir="$objdir"
+	else
+	  dir="$dir/$objdir"
+	fi
+	libobj="$dir/"`$echo "X$libobj" | $Xsed -e 's%^.*/%%'`
+
+	if test -d "$dir"; then
+	  $show "$rm $libobj"
+	  $run $rm $libobj
+	else
+	  $show "$mkdir $dir"
+	  $run $mkdir $dir
+	  status=$?
+	  if test $status -ne 0 && test ! -d $dir; then
+	    exit $status
+	  fi
+	fi
+      fi
+      if test "$compiler_o_lo" = yes; then
+	output_obj="$libobj"
+	command="$command -o $output_obj"
+      elif test "$compiler_c_o" = yes; then
+	output_obj="$obj"
+	command="$command -o $output_obj"
+      fi
+
+      $run $rm "$output_obj"
+      $show "$command"
+      if $run eval "$command"; then :
+      else
+	test -n "$output_obj" && $run $rm $removelist
+	exit 1
+      fi
+
+      if test "$need_locks" = warn &&
+	 test x"`cat $lockfile 2>/dev/null`" != x"$srcfile"; then
+	echo "\
+*** ERROR, $lockfile contains:
+`cat $lockfile 2>/dev/null`
+
+but it should contain:
+$srcfile
+
+This indicates that another process is trying to use the same
+temporary object file, and libtool could not work around it because
+your compiler does not support \`-c' and \`-o' together.  If you
+repeat this compilation, it may succeed, by chance, but you had better
+avoid parallel builds (make -j) in this platform, or get a better
+compiler."
+
+	$run $rm $removelist
+	exit 1
+      fi
+
+      # Just move the object if needed, then go on to compile the next one
+      if test x"$output_obj" != x"$libobj"; then
+	$show "$mv $output_obj $libobj"
+	if $run $mv $output_obj $libobj; then :
+	else
+	  error=$?
+	  $run $rm $removelist
+	  exit $error
+	fi
+      fi
+
+      # If we have no pic_flag, then copy the object into place and finish.
+      if test -z "$pic_flag" && test "$build_old_libs" = yes; then
+	# Rename the .lo from within objdir to obj
+	if test -f $obj; then
+	  $show $rm $obj
+	  $run $rm $obj
+	fi
+
+	$show "$mv $libobj $obj"
+	if $run $mv $libobj $obj; then :
+	else
+	  error=$?
+	  $run $rm $removelist
+	  exit $error
+	fi
+
+	xdir=`$echo "X$obj" | $Xsed -e 's%/[^/]*$%%'`
+	if test "X$xdir" = "X$obj"; then
+	  xdir="."
+	else
+	  xdir="$xdir"
+	fi
+	baseobj=`$echo "X$obj" | $Xsed -e "s%.*/%%"`
+	libobj=`$echo "X$baseobj" | $Xsed -e "$o2lo"`
+	# Now arrange that obj and lo_libobj become the same file
+	$show "(cd $xdir && $LN_S $baseobj $libobj)"
+	if $run eval '(cd $xdir && $LN_S $baseobj $libobj)'; then
+	  exit 0
+	else
+	  error=$?
+	  $run $rm $removelist
+	  exit $error
+	fi
+      fi
+
+      # Allow error messages only from the first compilation.
+      suppress_output=' >/dev/null 2>&1'
+    fi
+
+    # Only build a position-dependent object if we build old libraries.
+    if test "$build_old_libs" = yes; then
+      command="$base_compile $srcfile"
+      if test "$compiler_c_o" = yes; then
+	command="$command -o $obj"
+	output_obj="$obj"
+      fi
+
+      # Suppress compiler output if we already did a PIC compilation.
+      command="$command$suppress_output"
+      $run $rm "$output_obj"
+      $show "$command"
+      if $run eval "$command"; then :
+      else
+	$run $rm $removelist
+	exit 1
+      fi
+
+      if test "$need_locks" = warn &&
+	 test x"`cat $lockfile 2>/dev/null`" != x"$srcfile"; then
+	echo "\
+*** ERROR, $lockfile contains:
+`cat $lockfile 2>/dev/null`
+
+but it should contain:
+$srcfile
+
+This indicates that another process is trying to use the same
+temporary object file, and libtool could not work around it because
+your compiler does not support \`-c' and \`-o' together.  If you
+repeat this compilation, it may succeed, by chance, but you had better
+avoid parallel builds (make -j) in this platform, or get a better
+compiler."
+
+	$run $rm $removelist
+	exit 1
+      fi
+
+      # Just move the object if needed
+      if test x"$output_obj" != x"$obj"; then
+	$show "$mv $output_obj $obj"
+	if $run $mv $output_obj $obj; then :
+	else
+	  error=$?
+	  $run $rm $removelist
+	  exit $error
+	fi
+      fi
+
+      # Create an invalid libtool object if no PIC, so that we do not
+      # accidentally link it into a program.
+      if test "$build_libtool_libs" != yes; then
+	$show "echo timestamp > $libobj"
+	$run eval "echo timestamp > \$libobj" || exit $?
+      else
+	# Move the .lo from within objdir
+	$show "$mv $libobj $lo_libobj"
+	if $run $mv $libobj $lo_libobj; then :
+	else
+	  error=$?
+	  $run $rm $removelist
+	  exit $error
+	fi
+      fi
+    fi
+
+    # Unlock the critical section if it was locked
+    if test "$need_locks" != no; then
+      $rm "$lockfile"
+    fi
+
+    exit 0
+    ;;
+
+  # libtool link mode
+  link)
+    modename="$modename: link"
+    case "$host" in
+    *-*-cygwin* | *-*-mingw* | *-*-os2*)
+      # It is impossible to link a dll without this setting, and
+      # we shouldn't force the makefile maintainer to figure out
+      # which system we are compiling for in order to pass an extra
+      # flag for every libtool invokation.
+      # allow_undefined=no
+
+      # FIXME: Unfortunately, there are problems with the above when trying
+      # to make a dll which has undefined symbols, in which case not
+      # even a static library is built.  For now, we need to specify
+      # -no-undefined on the libtool link line when we can be certain
+      # that all symbols are satisfied, otherwise we get a static library.
+      allow_undefined=yes
+
+      # This is a source program that is used to create dlls on Windows
+      # Don't remove nor modify the starting and closing comments
+# /* ltdll.c starts here */
+# #define WIN32_LEAN_AND_MEAN
+# #include <windows.h>
+# #undef WIN32_LEAN_AND_MEAN
+# #include <stdio.h>
+#
+# #ifndef __CYGWIN__
+# #  ifdef __CYGWIN32__
+# #    define __CYGWIN__ __CYGWIN32__
+# #  endif
+# #endif
+#
+# #ifdef __cplusplus
+# extern "C" {
+# #endif
+# BOOL APIENTRY DllMain (HINSTANCE hInst, DWORD reason, LPVOID reserved);
+# #ifdef __cplusplus
+# }
+# #endif
+#
+# #ifdef __CYGWIN__
+# #include <cygwin/cygwin_dll.h>
+# DECLARE_CYGWIN_DLL( DllMain );
+# #endif
+# HINSTANCE __hDllInstance_base;
+#
+# BOOL APIENTRY
+# DllMain (HINSTANCE hInst, DWORD reason, LPVOID reserved)
+# {
+#   __hDllInstance_base = hInst;
+#   return TRUE;
+# }
+# /* ltdll.c ends here */
+      # This is a source program that is used to create import libraries
+      # on Windows for dlls which lack them. Don't remove nor modify the
+      # starting and closing comments
+# /* impgen.c starts here */
+# /*   Copyright (C) 1999 Free Software Foundation, Inc.
+# 
+#  This file is part of GNU libtool.
+# 
+#  This program is free software; you can redistribute it and/or modify
+#  it under the terms of the GNU General Public License as published by
+#  the Free Software Foundation; either version 2 of the License, or
+#  (at your option) any later version.
+# 
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU General Public License for more details.
+# 
+#  You should have received a copy of the GNU General Public License
+#  along with this program; if not, write to the Free Software
+#  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+#  */
+# 
+#  #include <stdio.h>		/* for printf() */
+#  #include <unistd.h>		/* for open(), lseek(), read() */
+#  #include <fcntl.h>		/* for O_RDONLY, O_BINARY */
+#  #include <string.h>		/* for strdup() */
+# 
+#  static unsigned int
+#  pe_get16 (fd, offset)
+#       int fd;
+#       int offset;
+#  {
+#    unsigned char b[2];
+#    lseek (fd, offset, SEEK_SET);
+#    read (fd, b, 2);
+#    return b[0] + (b[1]<<8);
+#  }
+# 
+#  static unsigned int
+#  pe_get32 (fd, offset)
+#      int fd;
+#      int offset;
+#  {
+#    unsigned char b[4];
+#    lseek (fd, offset, SEEK_SET);
+#    read (fd, b, 4);
+#    return b[0] + (b[1]<<8) + (b[2]<<16) + (b[3]<<24);
+#  }
+# 
+#  static unsigned int
+#  pe_as32 (ptr)
+#       void *ptr;
+#  {
+#    unsigned char *b = ptr;
+#    return b[0] + (b[1]<<8) + (b[2]<<16) + (b[3]<<24);
+#  }
+# 
+#  int
+#  main (argc, argv)
+#      int argc;
+#      char *argv[];
+#  {
+#      int dll;
+#      unsigned long pe_header_offset, opthdr_ofs, num_entries, i;
+#      unsigned long export_rva, export_size, nsections, secptr, expptr;
+#      unsigned long name_rvas, nexp;
+#      unsigned char *expdata, *erva;
+#      char *filename, *dll_name;
+# 
+#      filename = argv[1];
+# 
+#      dll = open(filename, O_RDONLY|O_BINARY);
+#      if (!dll)
+#  	return 1;
+# 
+#      dll_name = filename;
+#    
+#      for (i=0; filename[i]; i++)
+#  	if (filename[i] == '/' || filename[i] == '\\'  || filename[i] == ':')
+#  	    dll_name = filename + i +1;
+# 
+#      pe_header_offset = pe_get32 (dll, 0x3c);
+#      opthdr_ofs = pe_header_offset + 4 + 20;
+#      num_entries = pe_get32 (dll, opthdr_ofs + 92);
+# 
+#      if (num_entries < 1) /* no exports */
+#  	return 1;
+# 
+#      export_rva = pe_get32 (dll, opthdr_ofs + 96);
+#      export_size = pe_get32 (dll, opthdr_ofs + 100);
+#      nsections = pe_get16 (dll, pe_header_offset + 4 +2);
+#      secptr = (pe_header_offset + 4 + 20 +
+#  	      pe_get16 (dll, pe_header_offset + 4 + 16));
+# 
+#      expptr = 0;
+#      for (i = 0; i < nsections; i++)
+#      {
+#  	char sname[8];
+#  	unsigned long secptr1 = secptr + 40 * i;
+#  	unsigned long vaddr = pe_get32 (dll, secptr1 + 12);
+#  	unsigned long vsize = pe_get32 (dll, secptr1 + 16);
+#  	unsigned long fptr = pe_get32 (dll, secptr1 + 20);
+#  	lseek(dll, secptr1, SEEK_SET);
+#  	read(dll, sname, 8);
+#  	if (vaddr <= export_rva && vaddr+vsize > export_rva)
+#  	{
+#  	    expptr = fptr + (export_rva - vaddr);
+#  	    if (export_rva + export_size > vaddr + vsize)
+#  		export_size = vsize - (export_rva - vaddr);
+#  	    break;
+#  	}
+#      }
+# 
+#      expdata = (unsigned char*)malloc(export_size);
+#      lseek (dll, expptr, SEEK_SET);
+#      read (dll, expdata, export_size);
+#      erva = expdata - export_rva;
+# 
+#      nexp = pe_as32 (expdata+24);
+#      name_rvas = pe_as32 (expdata+32);
+# 
+#      printf ("EXPORTS\n");
+#      for (i = 0; i<nexp; i++)
+#      {
+#  	unsigned long name_rva = pe_as32 (erva+name_rvas+i*4);
+#  	printf ("\t%s @ %ld ;\n", erva+name_rva, 1+ i);
+#      }
+# 
+#      return 0;
+#  }
+# /* impgen.c ends here */
+      ;;
+    *)
+      allow_undefined=yes
+      ;;
+    esac
+    compile_command="$nonopt"
+    finalize_command="$nonopt"
+
+    compile_rpath=
+    finalize_rpath=
+    compile_shlibpath=
+    finalize_shlibpath=
+    convenience=
+    old_convenience=
+    deplibs=
+    linkopts=
+
+    if test -n "$shlibpath_var"; then
+      # get the directories listed in $shlibpath_var
+      eval lib_search_path=\`\$echo \"X \${$shlibpath_var}\" \| \$Xsed -e \'s/:/ /g\'\`
+    else
+      lib_search_path=
+    fi
+    # now prepend the system-specific ones
+    eval lib_search_path=\"$sys_lib_search_path_spec\$lib_search_path\"
+    eval sys_lib_dlsearch_path=\"$sys_lib_dlsearch_path_spec\"
+    
+    avoid_version=no
+    dlfiles=
+    dlprefiles=
+    dlself=no
+    export_dynamic=no
+    export_symbols=
+    export_symbols_regex=
+    generated=
+    libobjs=
+    link_against_libtool_libs=
+    ltlibs=
+    module=no
+    objs=
+    prefer_static_libs=no
+    preload=no
+    prev=
+    prevarg=
+    release=
+    rpath=
+    xrpath=
+    perm_rpath=
+    temp_rpath=
+    thread_safe=no
+    vinfo=
+
+    # We need to know -static, to get the right output filenames.
+    for arg
+    do
+      case "$arg" in
+      -all-static | -static)
+	if test "X$arg" = "X-all-static"; then
+	  if test "$build_libtool_libs" = yes && test -z "$link_static_flag"; then
+	    $echo "$modename: warning: complete static linking is impossible in this configuration" 1>&2
+	  fi
+	  if test -n "$link_static_flag"; then
+	    dlopen_self=$dlopen_self_static
+	  fi
+	else
+	  if test -z "$pic_flag" && test -n "$link_static_flag"; then
+	    dlopen_self=$dlopen_self_static
+	  fi
+	fi
+	build_libtool_libs=no
+	build_old_libs=yes
+	prefer_static_libs=yes
+	break
+	;;
+      esac
+    done
+
+    # See if our shared archives depend on static archives.
+    test -n "$old_archive_from_new_cmds" && build_old_libs=yes
+
+    # Go through the arguments, transforming them on the way.
+    while test $# -gt 0; do
+      arg="$1"
+      shift
+
+      # If the previous option needs an argument, assign it.
+      if test -n "$prev"; then
+	case "$prev" in
+	output)
+	  compile_command="$compile_command @OUTPUT@"
+	  finalize_command="$finalize_command @OUTPUT@"
+	  ;;
+	esac
+
+	case "$prev" in
+	dlfiles|dlprefiles)
+	  if test "$preload" = no; then
+	    # Add the symbol object into the linking commands.
+	    compile_command="$compile_command @SYMFILE@"
+	    finalize_command="$finalize_command @SYMFILE@"
+	    preload=yes
+	  fi
+	  case "$arg" in
+	  *.la | *.lo) ;;  # We handle these cases below.
+	  force)
+	    if test "$dlself" = no; then
+	      dlself=needless
+	      export_dynamic=yes
+	    fi
+	    prev=
+	    continue
+	    ;;
+	  self)
+	    if test "$prev" = dlprefiles; then
+	      dlself=yes
+	    elif test "$prev" = dlfiles && test "$dlopen_self" != yes; then
+	      dlself=yes
+	    else
+	      dlself=needless
+	      export_dynamic=yes
+	    fi
+	    prev=
+	    continue
+	    ;;
+	  *)
+	    if test "$prev" = dlfiles; then
+	      dlfiles="$dlfiles $arg"
+	    else
+	      dlprefiles="$dlprefiles $arg"
+	    fi
+	    prev=
+	    ;;
+	  esac
+	  ;;
+	expsyms)
+	  export_symbols="$arg"
+	  if test ! -f "$arg"; then
+	    $echo "$modename: symbol file \`$arg' does not exist"
+	    exit 1
+	  fi
+	  prev=
+	  continue
+	  ;;
+	expsyms_regex)
+	  export_symbols_regex="$arg"
+	  prev=
+	  continue
+	  ;;
+	release)
+	  release="-$arg"
+	  prev=
+	  continue
+	  ;;
+	rpath | xrpath)
+	  # We need an absolute path.
+	  case "$arg" in
+	  [\\/]* | [A-Za-z]:[\\/]*) ;;
+	  *)
+	    $echo "$modename: only absolute run-paths are allowed" 1>&2
+	    exit 1
+	    ;;
+	  esac
+	  if test "$prev" = rpath; then
+	    case "$rpath " in
+	    *" $arg "*) ;;
+	    *) rpath="$rpath $arg" ;;
+	    esac
+	  else
+	    case "$xrpath " in
+	    *" $arg "*) ;;
+	    *) xrpath="$xrpath $arg" ;;
+	    esac
+	  fi
+	  prev=
+	  continue
+	  ;;
+	*)
+	  eval "$prev=\"\$arg\""
+	  prev=
+	  continue
+	  ;;
+	esac
+      fi
+
+      prevarg="$arg"
+
+      case "$arg" in
+      -all-static)
+	if test -n "$link_static_flag"; then
+	  compile_command="$compile_command $link_static_flag"
+	  finalize_command="$finalize_command $link_static_flag"
+	fi
+	continue
+	;;
+
+      -allow-undefined)
+	# FIXME: remove this flag sometime in the future.
+	$echo "$modename: \`-allow-undefined' is deprecated because it is the default" 1>&2
+	continue
+	;;
+
+      -avoid-version)
+	avoid_version=yes
+	continue
+	;;
+
+      -dlopen)
+	prev=dlfiles
+	continue
+	;;
+
+      -dlpreopen)
+	prev=dlprefiles
+	continue
+	;;
+
+      -export-dynamic)
+	export_dynamic=yes
+	continue
+	;;
+
+      -export-symbols | -export-symbols-regex)
+	if test -n "$export_symbols" || test -n "$export_symbols_regex"; then
+	  $echo "$modename: not more than one -exported-symbols argument allowed"
+	  exit 1
+	fi
+	if test "X$arg" = "X-export-symbols"; then
+	  prev=expsyms
+	else
+	  prev=expsyms_regex
+	fi
+	continue
+	;;
+
+      -L*)
+	dir=`$echo "X$arg" | $Xsed -e 's/^-L//'`
+	# We need an absolute path.
+	case "$dir" in
+	[\\/]* | [A-Za-z]:[\\/]*) ;;
+	*)
+	  absdir=`cd "$dir" && pwd`
+	  if test -z "$absdir"; then
+	    $echo "$modename: warning: cannot determine absolute directory name of \`$dir'" 1>&2
+	    $echo "$modename: passing it literally to the linker, although it might fail" 1>&2
+	    absdir="$dir"
+	  fi
+	  dir="$absdir"
+	  ;;
+	esac
+	case " $deplibs " in
+	*" $arg "*) ;;
+	*) deplibs="$deplibs $arg";;
+	esac
+	case " $lib_search_path " in
+	*" $dir "*) ;;
+	*) lib_search_path="$lib_search_path $dir";;
+	esac
+	case "$host" in
+	*-*-cygwin* | *-*-mingw* | *-*-os2*)
+	  dllsearchdir=`cd "$dir" && pwd || echo "$dir"`
+	  case ":$dllsearchpath:" in
+	  ::) dllsearchpath="$dllsearchdir";;
+	  *":$dllsearchdir:"*) ;;
+	  *) dllsearchpath="$dllsearchpath:$dllsearchdir";;
+	  esac
+	  ;;
+	esac
+	;;
+
+      -l*)
+	if test "$arg" = "-lc"; then
+	  case "$host" in
+	  *-*-cygwin* | *-*-mingw* | *-*-os2* | *-*-beos*)
+	    # These systems don't actually have c library (as such)
+	    continue
+	    ;;
+	  esac
+	elif test "$arg" = "-lm"; then
+	  case "$host" in
+	  *-*-cygwin* | *-*-beos*)
+	    # These systems don't actually have math library (as such)
+	    continue
+	    ;;
+	  esac
+	fi
+	deplibs="$deplibs $arg"
+	;;
+
+      -module)
+	module=yes
+	continue
+	;;
+
+      -no-undefined)
+	allow_undefined=no
+	continue
+	;;
+
+      -o) prev=output ;;
+
+      -release)
+	prev=release
+	continue
+	;;
+
+      -rpath)
+	prev=rpath
+	continue
+	;;
+
+      -R)
+	prev=xrpath
+	continue
+	;;
+
+      -R*)
+	dir=`$echo "X$arg" | $Xsed -e 's/^-R//'`
+	# We need an absolute path.
+	case "$dir" in
+	[\\/]* | [A-Za-z]:[\\/]*) ;;
+	*)
+	  $echo "$modename: only absolute run-paths are allowed" 1>&2
+	  exit 1
+	  ;;
+	esac
+	case "$xrpath " in
+	*" $dir "*) ;;
+	*) xrpath="$xrpath $dir" ;;
+	esac
+	continue
+	;;
+
+      -static)
+	# If we have no pic_flag, then this is the same as -all-static.
+	if test -z "$pic_flag" && test -n "$link_static_flag"; then
+	  compile_command="$compile_command $link_static_flag"
+	  finalize_command="$finalize_command $link_static_flag"
+	fi
+	continue
+	;;
+
+      -thread-safe)
+	thread_safe=yes
+	continue
+	;;
+
+      -version-info)
+	prev=vinfo
+	continue
+	;;
+
+      # Some other compiler flag.
+      -* | +*)
+	# Unknown arguments in both finalize_command and compile_command need
+	# to be aesthetically quoted because they are evaled later.
+	arg=`$echo "X$arg" | $Xsed -e "$sed_quote_subst"`
+	case "$arg" in
+	*[\[\~\#\^\&\*\(\)\{\}\|\;\<\>\?\'\ \	]*|*]*)
+	  arg="\"$arg\""
+	  ;;
+	esac
+	;;
+
+      *.o | *.obj | *.a | *.lib)
+	# A standard object.
+	objs="$objs $arg"
+	;;
+
+      *.lo)
+	# A library object.
+	if test "$prev" = dlfiles; then
+	  dlfiles="$dlfiles $arg"
+	  if test "$build_libtool_libs" = yes && test "$dlopen" = yes; then
+	    prev=
+	    continue
+	  else
+	    # If libtool objects are unsupported, then we need to preload.
+	    prev=dlprefiles
+	  fi
+	fi
+
+	if test "$prev" = dlprefiles; then
+	  # Preload the old-style object.
+	  dlprefiles="$dlprefiles "`$echo "X$arg" | $Xsed -e "$lo2o"`
+	  prev=
+	fi
+	libobjs="$libobjs $arg"
+	;;
+
+      *.la)
+	# A libtool-controlled library.
+
+	dlname=
+	libdir=
+	library_names=
+	old_library=
+
+	# Check to see that this really is a libtool archive.
+	if (sed -e '2q' $arg | egrep "^# Generated by .*$PACKAGE") >/dev/null 2>&1; then :
+	else
+	  $echo "$modename: \`$arg' is not a valid libtool archive" 1>&2
+	  exit 1
+	fi
+
+	# If the library was installed with an old release of libtool,
+	# it will not redefine variable installed.
+	installed=yes
+
+	# Read the .la file
+	# If there is no directory component, then add one.
+	case "$arg" in
+	*/* | *\\*) . $arg ;;
+	*) . ./$arg ;;
+	esac
+
+	# Get the name of the library we link against.
+	linklib=
+	for l in $old_library $library_names; do
+	  linklib="$l"
+	done
+
+	if test -z "$linklib"; then
+	  $echo "$modename: cannot find name of link library for \`$arg'" 1>&2
+	  exit 1
+	fi
+
+	# Find the relevant object directory and library name.
+	name=`$echo "X$arg" | $Xsed -e 's%^.*/%%' -e 's/\.la$//' -e 's/^lib//'`
+
+	if test "X$installed" = Xyes; then
+	  dir="$libdir"
+	else
+	  dir=`$echo "X$arg" | $Xsed -e 's%/[^/]*$%%'`
+	  if test "X$dir" = "X$arg"; then
+	    dir="$objdir"
+	  else
+	    dir="$dir/$objdir"
+	  fi
+	fi
+
+	if test -n "$dependency_libs"; then
+	  # Extract -R and -L from dependency_libs
+	  temp_deplibs=
+	  for deplib in $dependency_libs; do
+	    case "$deplib" in
+	    -R*) temp_xrpath=`$echo "X$deplib" | $Xsed -e 's/^-R//'`
+		 case " $rpath $xrpath " in
+		 *" $temp_xrpath "*) ;;
+		 *) xrpath="$xrpath $temp_xrpath";;
+		 esac;;
+	    -L*) case "$compile_command $temp_deplibs " in
+		 *" $deplib "*) ;;
+		 *) temp_deplibs="$temp_deplibs $deplib";;
+		 esac
+		 temp_dir=`$echo "X$deplib" | $Xsed -e 's/^-L//'`
+		 case " $lib_search_path " in
+		 *" $temp_dir "*) ;;
+		 *) lib_search_path="$lib_search_path $temp_dir";;
+		 esac
+		 ;;
+	    *) temp_deplibs="$temp_deplibs $deplib";;
+	    esac
+	  done
+	  dependency_libs="$temp_deplibs"
+	fi
+
+	if test -z "$libdir"; then
+	  # It is a libtool convenience library, so add in its objects.
+	  convenience="$convenience $dir/$old_library"
+	  old_convenience="$old_convenience $dir/$old_library"
+	  deplibs="$deplibs$dependency_libs"
+	  compile_command="$compile_command $dir/$old_library$dependency_libs"
+	  finalize_command="$finalize_command $dir/$old_library$dependency_libs"
+	  continue
+	fi
+
+	# This library was specified with -dlopen.
+	if test "$prev" = dlfiles; then
+	  dlfiles="$dlfiles $arg"
+	  if test -z "$dlname" || test "$dlopen" != yes || test "$build_libtool_libs" = no; then
+	    # If there is no dlname, no dlopen support or we're linking statically,
+	    # we need to preload.
+	    prev=dlprefiles
+	  else
+	    # We should not create a dependency on this library, but we
+	    # may need any libraries it requires.
+	    compile_command="$compile_command$dependency_libs"
+	    finalize_command="$finalize_command$dependency_libs"
+	    prev=
+	    continue
+	  fi
+	fi
+
+	# The library was specified with -dlpreopen.
+	if test "$prev" = dlprefiles; then
+	  # Prefer using a static library (so that no silly _DYNAMIC symbols
+	  # are required to link).
+	  if test -n "$old_library"; then
+	    dlprefiles="$dlprefiles $dir/$old_library"
+	  else
+	    dlprefiles="$dlprefiles $dir/$linklib"
+	  fi
+	  prev=
+	fi
+
+	if test -n "$library_names" &&
+	   { test "$prefer_static_libs" = no || test -z "$old_library"; }; then
+	  link_against_libtool_libs="$link_against_libtool_libs $arg"
+	  if test -n "$shlibpath_var"; then
+	    # Make sure the rpath contains only unique directories.
+	    case "$temp_rpath " in
+	    *" $dir "*) ;;
+	    *) temp_rpath="$temp_rpath $dir" ;;
+	    esac
+	  fi
+
+	  # We need an absolute path.
+	  case "$dir" in
+	  [\\/] | [A-Za-z]:[\\/]*) absdir="$dir" ;;
+	  *)
+	    absdir=`cd "$dir" && pwd`
+	    if test -z "$absdir"; then
+	      $echo "$modename: warning: cannot determine absolute directory name of \`$dir'" 1>&2
+	      $echo "$modename: passing it literally to the linker, although it might fail" 1>&2
+	      absdir="$dir"
+	    fi
+	    ;;
+	  esac
+	  
+	  # This is the magic to use -rpath.
+	  # Skip directories that are in the system default run-time
+	  # search path, unless they have been requested with -R.
+	  case " $sys_lib_dlsearch_path " in
+	  *" $absdir "*) ;;
+	  *)
+	    case "$compile_rpath " in
+	    *" $absdir "*) ;;
+	    *) compile_rpath="$compile_rpath $absdir" 
+	    esac
+	    ;;
+	  esac
+
+	  case " $sys_lib_dlsearch_path " in
+	  *" $libdir "*) ;;
+	  *)
+	    case "$finalize_rpath " in
+	    *" $libdir "*) ;;
+	    *) finalize_rpath="$finalize_rpath $libdir"
+	    esac
+	    ;;
+	  esac
+
+	  lib_linked=yes
+	  case "$hardcode_action" in
+	  immediate | unsupported)
+	    if test "$hardcode_direct" = no; then
+	      compile_command="$compile_command $dir/$linklib"
+	      deplibs="$deplibs $dir/$linklib"
+	      case "$host" in
+	      *-*-cygwin* | *-*-mingw* | *-*-os2*)
+		dllsearchdir=`cd "$dir" && pwd || echo "$dir"`
+		if test -n "$dllsearchpath"; then
+		  dllsearchpath="$dllsearchpath:$dllsearchdir"
+		else
+		  dllsearchpath="$dllsearchdir"
+		fi
+		;;
+	      esac
+	    elif test "$hardcode_minus_L" = no; then
+	      case "$host" in
+	      *-*-sunos*)
+		compile_shlibpath="$compile_shlibpath$dir:"
+		;;
+	      esac
+	      case "$compile_command " in
+	      *" -L$dir "*) ;;
+	      *) compile_command="$compile_command -L$dir";;
+	      esac
+	      compile_command="$compile_command -l$name"
+	      deplibs="$deplibs -L$dir -l$name"
+	    elif test "$hardcode_shlibpath_var" = no; then
+	      case ":$compile_shlibpath:" in
+	      *":$dir:"*) ;;
+	      *) compile_shlibpath="$compile_shlibpath$dir:";;
+	      esac
+	      compile_command="$compile_command -l$name"
+	      deplibs="$deplibs -l$name"
+	    else
+	      lib_linked=no
+	    fi
+	    ;;
+
+	  relink)
+	    if test "$hardcode_direct" = yes; then
+	      compile_command="$compile_command $absdir/$linklib"
+	      deplibs="$deplibs $absdir/$linklib"
+	    elif test "$hardcode_minus_L" = yes; then
+	      case "$compile_command " in
+	      *" -L$absdir "*) ;;
+	      *) compile_command="$compile_command -L$absdir";;
+	      esac
+	      compile_command="$compile_command -l$name"
+	      deplibs="$deplibs -L$absdir -l$name"
+	    elif test "$hardcode_shlibpath_var" = yes; then
+	      case ":$compile_shlibpath:" in
+	      *":$absdir:"*) ;;
+	      *) compile_shlibpath="$compile_shlibpath$absdir:";;
+	      esac
+	      compile_command="$compile_command -l$name"
+	      deplibs="$deplibs -l$name"
+	    else
+	      lib_linked=no
+	    fi
+	    ;;
+
+	  *)
+	    lib_linked=no
+	    ;;
+	  esac
+
+	  if test "$lib_linked" != yes; then
+	    $echo "$modename: configuration error: unsupported hardcode properties"
+	    exit 1
+	  fi
+
+	  # Finalize command for both is simple: just hardcode it.
+	  if test "$hardcode_direct" = yes; then
+	    finalize_command="$finalize_command $libdir/$linklib"
+	  elif test "$hardcode_minus_L" = yes; then
+	    case "$finalize_command " in
+	    *" -L$libdir "*) ;;
+	    *) finalize_command="$finalize_command -L$libdir";;
+	    esac
+	    finalize_command="$finalize_command -l$name"
+	  elif test "$hardcode_shlibpath_var" = yes; then
+	    case ":$finalize_shlibpath:" in
+	    *":$libdir:"*) ;;
+	    *) finalize_shlibpath="$finalize_shlibpath$libdir:";;
+	    esac
+	    finalize_command="$finalize_command -l$name"
+	  else
+	    # We cannot seem to hardcode it, guess we'll fake it.
+	    case "$finalize_command " in
+	    *" -L$dir "*) ;;
+	    *) finalize_command="$finalize_command -L$libdir";;
+	    esac
+	    finalize_command="$finalize_command -l$name"
+	  fi
+	else
+	  # Transform directly to old archives if we don't build new libraries.
+	  if test -n "$pic_flag" && test -z "$old_library"; then
+	    $echo "$modename: cannot find static library for \`$arg'" 1>&2
+	    exit 1
+	  fi
+
+	  # Here we assume that one of hardcode_direct or hardcode_minus_L
+	  # is not unsupported.  This is valid on all known static and
+	  # shared platforms.
+	  if test "$hardcode_direct" != unsupported; then
+	    test -n "$old_library" && linklib="$old_library"
+	    compile_command="$compile_command $dir/$linklib"
+	    finalize_command="$finalize_command $dir/$linklib"
+	  else
+	    case "$compile_command " in
+	    *" -L$dir "*) ;;
+	    *) compile_command="$compile_command -L$dir";;
+	    esac
+	    compile_command="$compile_command -l$name"
+	    case "$finalize_command " in
+	    *" -L$dir "*) ;;
+	    *) finalize_command="$finalize_command -L$dir";;
+	    esac
+	    finalize_command="$finalize_command -l$name"
+	  fi
+	fi
+
+	# Add in any libraries that this one depends upon.
+	compile_command="$compile_command$dependency_libs"
+	finalize_command="$finalize_command$dependency_libs"
+	continue
+	;;
+
+      # Some other compiler argument.
+      *)
+	# Unknown arguments in both finalize_command and compile_command need
+	# to be aesthetically quoted because they are evaled later.
+	arg=`$echo "X$arg" | $Xsed -e "$sed_quote_subst"`
+	case "$arg" in
+	*[\[\~\#\^\&\*\(\)\{\}\|\;\<\>\?\'\ \	]*|*]*)
+	  arg="\"$arg\""
+	  ;;
+	esac
+	;;
+      esac
+
+      # Now actually substitute the argument into the commands.
+      if test -n "$arg"; then
+	compile_command="$compile_command $arg"
+	finalize_command="$finalize_command $arg"
+      fi
+    done
+
+    if test -n "$prev"; then
+      $echo "$modename: the \`$prevarg' option requires an argument" 1>&2
+      $echo "$help" 1>&2
+      exit 1
+    fi
+
+    if test "$export_dynamic" = yes && test -n "$export_dynamic_flag_spec"; then
+      eval arg=\"$export_dynamic_flag_spec\"
+      compile_command="$compile_command $arg"
+      finalize_command="$finalize_command $arg"
+    fi
+
+    oldlibs=
+    # calculate the name of the file, without its directory
+    outputname=`$echo "X$output" | $Xsed -e 's%^.*/%%'`
+    libobjs_save="$libobjs"
+
+    case "$output" in
+    "")
+      $echo "$modename: you must specify an output file" 1>&2
+      $echo "$help" 1>&2
+      exit 1
+      ;;
+
+    *.a | *.lib)
+      if test -n "$link_against_libtool_libs"; then
+	$echo "$modename: error: cannot link libtool libraries into archives" 1>&2
+	exit 1
+      fi
+
+      if test -n "$deplibs"; then
+	$echo "$modename: warning: \`-l' and \`-L' are ignored for archives" 1>&2
+      fi
+
+      if test -n "$dlfiles$dlprefiles" || test "$dlself" != no; then
+	$echo "$modename: warning: \`-dlopen' is ignored for archives" 1>&2
+      fi
+
+      if test -n "$rpath"; then
+	$echo "$modename: warning: \`-rpath' is ignored for archives" 1>&2
+      fi
+
+      if test -n "$xrpath"; then
+	$echo "$modename: warning: \`-R' is ignored for archives" 1>&2
+      fi
+
+      if test -n "$vinfo"; then
+	$echo "$modename: warning: \`-version-info' is ignored for archives" 1>&2
+      fi
+
+      if test -n "$release"; then
+	$echo "$modename: warning: \`-release' is ignored for archives" 1>&2
+      fi
+
+      if test -n "$export_symbols" || test -n "$export_symbols_regex"; then
+	$echo "$modename: warning: \`-export-symbols' is ignored for archives" 1>&2
+      fi
+
+      # Now set the variables for building old libraries.
+      build_libtool_libs=no
+      oldlibs="$output"
+      ;;
+
+    *.la)
+      # Make sure we only generate libraries of the form `libNAME.la'.
+      case "$outputname" in
+      lib*)
+	name=`$echo "X$outputname" | $Xsed -e 's/\.la$//' -e 's/^lib//'`
+	eval libname=\"$libname_spec\"
+	;;
+      *)
+	if test "$module" = no; then
+	  $echo "$modename: libtool library \`$output' must begin with \`lib'" 1>&2
+	  $echo "$help" 1>&2
+	  exit 1
+	fi
+	if test "$need_lib_prefix" != no; then
+	  # Add the "lib" prefix for modules if required
+	  name=`$echo "X$outputname" | $Xsed -e 's/\.la$//'`
+	  eval libname=\"$libname_spec\"
+	else
+	  libname=`$echo "X$outputname" | $Xsed -e 's/\.la$//'`
+	fi
+	;;
+      esac
+
+      output_objdir=`$echo "X$output" | $Xsed -e 's%/[^/]*$%%'`
+      if test "X$output_objdir" = "X$output"; then
+	output_objdir="$objdir"
+      else
+	output_objdir="$output_objdir/$objdir"
+      fi
+
+      if test -n "$objs"; then
+	$echo "$modename: cannot build libtool library \`$output' from non-libtool objects:$objs" 2>&1
+	exit 1
+      fi
+
+      # How the heck are we supposed to write a wrapper for a shared library?
+      if test -n "$link_against_libtool_libs"; then
+	 $echo "$modename: error: cannot link shared libraries into libtool libraries" 1>&2
+	 exit 1
+      fi
+
+      if test -n "$dlfiles$dlprefiles" || test "$dlself" != no; then
+	$echo "$modename: warning: \`-dlopen' is ignored for libtool libraries" 1>&2
+      fi
+
+      set dummy $rpath
+      if test $# -gt 2; then
+	$echo "$modename: warning: ignoring multiple \`-rpath's for a libtool library" 1>&2
+      fi
+      install_libdir="$2"
+
+      oldlibs=
+      if test -z "$rpath"; then
+	if test "$build_libtool_libs" = yes; then
+	  # Building a libtool convenience library.
+	  libext=al
+	  oldlibs="$output_objdir/$libname.$libext $oldlibs"
+	  build_libtool_libs=convenience
+	  build_old_libs=yes
+	fi
+	dependency_libs="$deplibs"
+
+	if test -n "$vinfo"; then
+	  $echo "$modename: warning: \`-version-info' is ignored for convenience libraries" 1>&2
+	fi
+
+	if test -n "$release"; then
+	  $echo "$modename: warning: \`-release' is ignored for convenience libraries" 1>&2
+	fi
+      else
+
+	# Parse the version information argument.
+	IFS="${IFS= 	}"; save_ifs="$IFS"; IFS=':'
+	set dummy $vinfo 0 0 0
+	IFS="$save_ifs"
+
+	if test -n "$8"; then
+	  $echo "$modename: too many parameters to \`-version-info'" 1>&2
+	  $echo "$help" 1>&2
+	  exit 1
+	fi
+
+	current="$2"
+	revision="$3"
+	age="$4"
+
+	# Check that each of the things are valid numbers.
+	case "$current" in
+	0 | [1-9] | [1-9][0-9]*) ;;
+	*)
+	  $echo "$modename: CURRENT \`$current' is not a nonnegative integer" 1>&2
+	  $echo "$modename: \`$vinfo' is not valid version information" 1>&2
+	  exit 1
+	  ;;
+	esac
+
+	case "$revision" in
+	0 | [1-9] | [1-9][0-9]*) ;;
+	*)
+	  $echo "$modename: REVISION \`$revision' is not a nonnegative integer" 1>&2
+	  $echo "$modename: \`$vinfo' is not valid version information" 1>&2
+	  exit 1
+	  ;;
+	esac
+
+	case "$age" in
+	0 | [1-9] | [1-9][0-9]*) ;;
+	*)
+	  $echo "$modename: AGE \`$age' is not a nonnegative integer" 1>&2
+	  $echo "$modename: \`$vinfo' is not valid version information" 1>&2
+	  exit 1
+	  ;;
+	esac
+
+	if test $age -gt $current; then
+	  $echo "$modename: AGE \`$age' is greater than the current interface number \`$current'" 1>&2
+	  $echo "$modename: \`$vinfo' is not valid version information" 1>&2
+	  exit 1
+	fi
+
+	# Calculate the version variables.
+	major=
+	versuffix=
+	verstring=
+	case "$version_type" in
+	none) ;;
+
+	irix)
+	  major=`expr $current - $age + 1`
+	  versuffix="$major.$revision"
+	  verstring="sgi$major.$revision"
+
+	  # Add in all the interfaces that we are compatible with.
+	  loop=$revision
+	  while test $loop != 0; do
+	    iface=`expr $revision - $loop`
+	    loop=`expr $loop - 1`
+	    verstring="sgi$major.$iface:$verstring"
+	  done
+	  ;;
+
+	linux)
+	  major=.`expr $current - $age`
+	  versuffix="$major.$age.$revision"
+	  ;;
+
+	osf)
+	  major=`expr $current - $age`
+	  versuffix=".$current.$age.$revision"
+	  verstring="$current.$age.$revision"
+
+	  # Add in all the interfaces that we are compatible with.
+	  loop=$age
+	  while test $loop != 0; do
+	    iface=`expr $current - $loop`
+	    loop=`expr $loop - 1`
+	    verstring="$verstring:${iface}.0"
+	  done
+
+	  # Make executables depend on our current version.
+	  verstring="$verstring:${current}.0"
+	  ;;
+
+	sunos)
+	  major=".$current"
+	  versuffix=".$current.$revision"
+	  ;;
+
+	freebsd-aout)
+	  major=".$current"
+	  versuffix=".$current.$revision";
+	  ;;
+
+	freebsd-elf)
+	  major=".$current"
+	  versuffix=".$current";
+	  ;;
+
+	windows)
+	  # Like Linux, but with '-' rather than '.', since we only
+	  # want one extension on Windows 95.
+	  major=`expr $current - $age`
+	  versuffix="-$major-$age-$revision"
+	  ;;
+
+	*)
+	  $echo "$modename: unknown library version type \`$version_type'" 1>&2
+	  echo "Fatal configuration error.  See the $PACKAGE docs for more information." 1>&2
+	  exit 1
+	  ;;
+	esac
+
+	# Clear the version info if we defaulted, and they specified a release.
+	if test -z "$vinfo" && test -n "$release"; then
+	  major=
+	  verstring="0.0"
+	  if test "$need_version" = no; then
+	    versuffix=
+	  else
+	    versuffix=".0.0"
+	  fi
+	fi
+
+	# Remove version info from name if versioning should be avoided
+	if test "$avoid_version" = yes && test "$need_version" = no; then
+	  major=
+	  versuffix=
+	  verstring=""
+	fi
+	
+	# Check to see if the archive will have undefined symbols.
+	if test "$allow_undefined" = yes; then
+	  if test "$allow_undefined_flag" = unsupported; then
+	    $echo "$modename: warning: undefined symbols not allowed in $host shared libraries" 1>&2
+	    build_libtool_libs=no
+	    build_old_libs=yes
+	  fi
+	else
+	  # Don't allow undefined symbols.
+	  allow_undefined_flag="$no_undefined_flag"
+	fi
+
+	dependency_libs="$deplibs"
+	case "$host" in
+	*-*-cygwin* | *-*-mingw* | *-*-os2* | *-*-beos*)
+	  # these systems don't actually have a c library (as such)!
+	  ;;
+        *-*-rhapsody*)
+	  # rhapsody is a little odd...
+	  deplibs="$deplibs -framework System"
+	  ;;
+	*)
+	  # Add libc to deplibs on all other systems.
+	  deplibs="$deplibs -lc"
+	  ;;
+	esac
+      fi
+
+      # Create the output directory, or remove our outputs if we need to.
+      if test -d $output_objdir; then
+	$show "${rm}r $output_objdir/$outputname $output_objdir/$libname.* $output_objdir/${libname}${release}.*"
+	$run ${rm}r $output_objdir/$outputname $output_objdir/$libname.* $output_objdir/${libname}${release}.*
+      else
+	$show "$mkdir $output_objdir"
+	$run $mkdir $output_objdir
+	status=$?
+	if test $status -ne 0 && test ! -d $output_objdir; then
+	  exit $status
+	fi
+      fi
+
+      # Now set the variables for building old libraries.
+      if test "$build_old_libs" = yes && test "$build_libtool_libs" != convenience ; then
+	oldlibs="$oldlibs $output_objdir/$libname.$libext"
+
+	# Transform .lo files to .o files.
+	oldobjs="$objs "`$echo "X$libobjs" | $SP2NL | $Xsed -e '/\.'${libext}'$/d' -e "$lo2o" | $NL2SP`
+      fi
+
+      if test "$build_libtool_libs" = yes; then
+	# Transform deplibs into only deplibs that can be linked in shared.
+	name_save=$name
+	libname_save=$libname
+	release_save=$release
+	versuffix_save=$versuffix
+	major_save=$major
+	# I'm not sure if I'm treating the release correctly.  I think
+	# release should show up in the -l (ie -lgmp5) so we don't want to
+	# add it in twice.  Is that correct?
+	release=""
+	versuffix=""
+	major=""
+	newdeplibs=
+	droppeddeps=no
+	case "$deplibs_check_method" in
+	pass_all)
+	  # Don't check for shared/static.  Everything works.
+	  # This might be a little naive.  We might want to check
+	  # whether the library exists or not.  But this is on
+	  # osf3 & osf4 and I'm not really sure... Just
+	  # implementing what was already the behaviour.
+	  newdeplibs=$deplibs
+	  ;;
+	test_compile)
+	  # This code stresses the "libraries are programs" paradigm to its
+	  # limits. Maybe even breaks it.  We compile a program, linking it
+	  # against the deplibs as a proxy for the library.  Then we can check
+	  # whether they linked in statically or dynamically with ldd.
+	  $rm conftest.c
+	  cat > conftest.c <<EOF
+	  int main() { return 0; }
+EOF
+	  $rm conftest
+	  $CC -o conftest conftest.c $deplibs
+	  if test $? -eq 0 ; then
+	    ldd_output=`ldd conftest`
+	    for i in $deplibs; do
+	      name="`expr $i : '-l\(.*\)'`"
+	      # If $name is empty we are operating on a -L argument.
+	      if test "$name" != "" ; then
+		libname=`eval \\$echo \"$libname_spec\"`
+		deplib_matches=`eval \\$echo \"$library_names_spec\"`
+		set dummy $deplib_matches
+		deplib_match=$2
+		if test `expr "$ldd_output" : ".*$deplib_match"` -ne 0 ; then
+		  newdeplibs="$newdeplibs $i"
+		else
+		  droppeddeps=yes
+		  echo
+		  echo "*** Warning: This library needs some functionality provided by $i."
+		  echo "*** I have the capability to make that library automatically link in when"
+		  echo "*** you link to this library.  But I can only do this if you have a"
+		  echo "*** shared version of the library, which you do not appear to have."
+		fi
+	      else
+		newdeplibs="$newdeplibs $i"
+	      fi
+	    done
+	  else
+	    # Error occured in the first compile.  Let's try to salvage the situation:
+	    # Compile a seperate program for each library.
+	    for i in $deplibs; do
+	      name="`expr $i : '-l\(.*\)'`"
+	     # If $name is empty we are operating on a -L argument.
+	      if test "$name" != "" ; then
+		$rm conftest
+		$CC -o conftest conftest.c $i
+		# Did it work?
+		if test $? -eq 0 ; then
+		  ldd_output=`ldd conftest`
+		  libname=`eval \\$echo \"$libname_spec\"`
+		  deplib_matches=`eval \\$echo \"$library_names_spec\"`
+		  set dummy $deplib_matches
+		  deplib_match=$2
+		  if test `expr "$ldd_output" : ".*$deplib_match"` -ne 0 ; then
+		    newdeplibs="$newdeplibs $i"
+		  else
+		    droppeddeps=yes
+		    echo
+		    echo "*** Warning: This library needs some functionality provided by $i."
+		    echo "*** I have the capability to make that library automatically link in when"
+		    echo "*** you link to this library.  But I can only do this if you have a"
+		    echo "*** shared version of the library, which you do not appear to have."
+		  fi
+		else
+		  droppeddeps=yes
+		  echo
+		  echo "*** Warning!  Library $i is needed by this library but I was not able to"
+		  echo "***  make it link in!  You will probably need to install it or some"
+		  echo "*** library that it depends on before this library will be fully"
+		  echo "*** functional.  Installing it before continuing would be even better."
+		fi
+	      else
+		newdeplibs="$newdeplibs $i"
+	      fi
+	    done
+	  fi
+	  ;;
+	file_magic*)
+	  set dummy $deplibs_check_method
+	  file_magic_regex="`expr \"$deplibs_check_method\" : \"$2 \(.*\)\"`"
+	  for a_deplib in $deplibs; do
+	    name="`expr $a_deplib : '-l\(.*\)'`"
+	    # If $name is empty we are operating on a -L argument.
+	    if test "$name" != "" ; then
+	      libname=`eval \\$echo \"$libname_spec\"`
+	      for i in $lib_search_path; do
+		    potential_libs=`ls $i/$libname[.-]* 2>/dev/null`
+		    for potent_lib in $potential_libs; do
+		      # Follow soft links.
+		      if ls -lLd "$potent_lib" 2>/dev/null \
+			 | grep " -> " >/dev/null; then
+			continue 
+		      fi
+		      # The statement above tries to avoid entering an
+		      # endless loop below, in case of cyclic links.
+		      # We might still enter an endless loop, since a link
+		      # loop can be closed while we follow links,
+		      # but so what?
+		      potlib="$potent_lib"
+		      while test -h "$potlib" 2>/dev/null; do
+			potliblink=`ls -ld $potlib | sed 's/.* -> //'`
+			case "$potliblink" in
+			[\\/]* | [A-Za-z]:[\\/]*) potlib="$potliblink";;
+			*) potlib=`$echo "X$potlib" | $Xsed -e 's,[^/]*$,,'`"$potliblink";;
+			esac
+		      done
+		      if eval $file_magic_cmd \"\$potlib\" 2>/dev/null \
+			 | sed 10q \
+			 | egrep "$file_magic_regex" > /dev/null; then
+			newdeplibs="$newdeplibs $a_deplib"
+			a_deplib=""
+			break 2
+		      fi
+		    done
+	      done
+	      if test -n "$a_deplib" ; then
+		droppeddeps=yes
+		echo
+		echo "*** Warning: This library needs some functionality provided by $a_deplib."
+		echo "*** I have the capability to make that library automatically link in when"
+		echo "*** you link to this library.  But I can only do this if you have a"
+		echo "*** shared version of the library, which you do not appear to have."
+	      fi
+	    else
+	      # Add a -L argument.
+	      newdeplibs="$newdeplibs $a_deplib"
+	    fi
+	  done # Gone through all deplibs.
+	  ;;
+	none | unknown | *)
+	  newdeplibs=""
+	  if $echo "X $deplibs" | $Xsed -e 's/ -lc$//' \
+	       -e 's/ -[LR][^ ]*//g' -e 's/[ 	]//g' |
+	     grep . >/dev/null; then
+	    echo
+	    if test "X$deplibs_check_method" = "Xnone"; then
+	      echo "*** Warning: inter-library dependencies are not supported in this platform."
+	    else
+	      echo "*** Warning: inter-library dependencies are not known to be supported."
+	    fi
+	    echo "*** All declared inter-library dependencies are being dropped."
+	    droppeddeps=yes
+	  fi
+	  ;;
+	esac
+	versuffix=$versuffix_save
+	major=$major_save
+	release=$release_save
+	libname=$libname_save
+	name=$name_save
+
+	if test "$droppeddeps" = yes; then
+	  if test "$module" = yes; then
+	    echo
+	    echo "*** Warning: libtool could not satisfy all declared inter-library"
+	    echo "*** dependencies of module $libname.  Therefore, libtool will create"
+	    echo "*** a static module, that should work as long as the dlopening"
+	    echo "*** application is linked with the -dlopen flag."
+	    if test -z "$global_symbol_pipe"; then
+	      echo
+	      echo "*** However, this would only work if libtool was able to extract symbol"
+	      echo "*** lists from a program, using \`nm' or equivalent, but libtool could"
+	      echo "*** not find such a program.  So, this module is probably useless."
+	      echo "*** \`nm' from GNU binutils and a full rebuild may help."
+	    fi
+	    if test "$build_old_libs" = no; then
+	      oldlibs="$output_objdir/$libname.$libext"
+	      build_libtool_libs=module
+	      build_old_libs=yes
+	    else
+	      build_libtool_libs=no
+	    fi
+	  else
+	    echo "*** The inter-library dependencies that have been dropped here will be"
+	    echo "*** automatically added whenever a program is linked with this library"
+	    echo "*** or is declared to -dlopen it."
+	  fi
+	fi
+	# Done checking deplibs!
+	deplibs=$newdeplibs
+      fi
+
+      # All the library-specific variables (install_libdir is set above).
+      library_names=
+      old_library=
+      dlname=
+      
+      # Test again, we may have decided not to build it any more
+      if test "$build_libtool_libs" = yes; then
+	# Get the real and link names of the library.
+	eval library_names=\"$library_names_spec\"
+	set dummy $library_names
+	realname="$2"
+	shift; shift
+
+	if test -n "$soname_spec"; then
+	  eval soname=\"$soname_spec\"
+	else
+	  soname="$realname"
+	fi
+
+	lib="$output_objdir/$realname"
+	for link
+	do
+	  linknames="$linknames $link"
+	done
+
+	# Ensure that we have .o objects for linkers which dislike .lo
+	# (e.g. aix) in case we are running --disable-static
+	for obj in $libobjs; do
+	  xdir=`$echo "X$obj" | $Xsed -e 's%/[^/]*$%%'`
+	  if test "X$xdir" = "X$obj"; then
+	    xdir="."
+	  else
+	    xdir="$xdir"
+	  fi
+	  baseobj=`$echo "X$obj" | $Xsed -e 's%^.*/%%'`
+	  oldobj=`$echo "X$baseobj" | $Xsed -e "$lo2o"`
+	  if test ! -f $xdir/$oldobj; then
+	    $show "(cd $xdir && ${LN_S} $baseobj $oldobj)"
+	    $run eval '(cd $xdir && ${LN_S} $baseobj $oldobj)' || exit $?
+	  fi
+	done
+
+	# Use standard objects if they are pic
+	test -z "$pic_flag" && libobjs=`$echo "X$libobjs" | $SP2NL | $Xsed -e "$lo2o" | $NL2SP`
+
+	# Prepare the list of exported symbols
+	if test -z "$export_symbols"; then
+	  if test "$always_export_symbols" = yes || test -n "$export_symbols_regex"; then
+	    $show "generating symbol list for \`$libname.la'"
+	    export_symbols="$output_objdir/$libname.exp"
+	    $run $rm $export_symbols
+	    eval cmds=\"$export_symbols_cmds\"
+	    IFS="${IFS= 	}"; save_ifs="$IFS"; IFS='~'
+	    for cmd in $cmds; do
+	      IFS="$save_ifs"
+	      $show "$cmd"
+	      $run eval "$cmd" || exit $?
+	    done
+	    IFS="$save_ifs"
+	    if test -n "$export_symbols_regex"; then
+	      $show "egrep -e \"$export_symbols_regex\" \"$export_symbols\" > \"${export_symbols}T\""
+	      $run eval 'egrep -e "$export_symbols_regex" "$export_symbols" > "${export_symbols}T"'
+	      $show "$mv \"${export_symbols}T\" \"$export_symbols\""
+	      $run eval '$mv "${export_symbols}T" "$export_symbols"'
+	    fi
+	  fi
+	fi
+
+	if test -n "$export_symbols" && test -n "$include_expsyms"; then
+	  $run eval '$echo "X$include_expsyms" | $SP2NL >> "$export_symbols"'
+	fi
+
+	if test -n "$convenience"; then
+	  if test -n "$whole_archive_flag_spec"; then
+	    eval libobjs=\"\$libobjs $whole_archive_flag_spec\"
+	  else
+	    gentop="$output_objdir/${outputname}x"
+	    $show "${rm}r $gentop"
+	    $run ${rm}r "$gentop"
+	    $show "mkdir $gentop"
+	    $run mkdir "$gentop"
+	    status=$?
+	    if test $status -ne 0 && test ! -d "$gentop"; then
+	      exit $status
+	    fi
+	    generated="$generated $gentop"
+
+	    for xlib in $convenience; do
+	      # Extract the objects.
+	      case "$xlib" in
+	      [\\/]* | [A-Za-z]:[\\/]*) xabs="$xlib" ;;
+	      *) xabs=`pwd`"/$xlib" ;;
+	      esac
+	      xlib=`$echo "X$xlib" | $Xsed -e 's%^.*/%%'`
+	      xdir="$gentop/$xlib"
+
+	      $show "${rm}r $xdir"
+	      $run ${rm}r "$xdir"
+	      $show "mkdir $xdir"
+	      $run mkdir "$xdir"
+	      status=$?
+	      if test $status -ne 0 && test ! -d "$xdir"; then
+		exit $status
+	      fi
+	      $show "(cd $xdir && $AR x $xabs)"
+	      $run eval "(cd \$xdir && $AR x \$xabs)" || exit $?
+
+	      libobjs="$libobjs "`find $xdir -name \*.o -print -o -name \*.lo -print | $NL2SP`
+	    done
+	  fi
+	fi
+
+	if test "$thread_safe" = yes && test -n "$thread_safe_flag_spec"; then
+	  eval flag=\"$thread_safe_flag_spec\"
+	  linkopts="$linkopts $flag"
+	fi
+
+	# Do each of the archive commands.
+	if test -n "$export_symbols" && test -n "$archive_expsym_cmds"; then
+	  eval cmds=\"$archive_expsym_cmds\"
+	else
+	  eval cmds=\"$archive_cmds\"
+	fi
+	IFS="${IFS= 	}"; save_ifs="$IFS"; IFS='~'
+	for cmd in $cmds; do
+	  IFS="$save_ifs"
+	  $show "$cmd"
+	  $run eval "$cmd" || exit $?
+	done
+	IFS="$save_ifs"
+
+	# Create links to the real library.
+	for linkname in $linknames; do
+	  if test "$realname" != "$linkname"; then
+	    $show "(cd $output_objdir && $rm $linkname && $LN_S $realname $linkname)"
+	    $run eval '(cd $output_objdir && $rm $linkname && $LN_S $realname $linkname)' || exit $?
+	  fi
+	done
+
+	# If -module or -export-dynamic was specified, set the dlname.
+	if test "$module" = yes || test "$export_dynamic" = yes; then
+	  # On all known operating systems, these are identical.
+	  dlname="$soname"
+	fi
+      fi
+      ;;
+
+    *.lo | *.o | *.obj)
+      if test -n "$link_against_libtool_libs"; then
+	$echo "$modename: error: cannot link libtool libraries into objects" 1>&2
+	exit 1
+      fi
+
+      if test -n "$deplibs"; then
+	$echo "$modename: warning: \`-l' and \`-L' are ignored for objects" 1>&2
+      fi
+
+      if test -n "$dlfiles$dlprefiles" || test "$dlself" != no; then
+	$echo "$modename: warning: \`-dlopen' is ignored for objects" 1>&2
+      fi
+
+      if test -n "$rpath"; then
+	$echo "$modename: warning: \`-rpath' is ignored for objects" 1>&2
+      fi
+
+      if test -n "$xrpath"; then
+	$echo "$modename: warning: \`-R' is ignored for objects" 1>&2
+      fi
+
+      if test -n "$vinfo"; then
+	$echo "$modename: warning: \`-version-info' is ignored for objects" 1>&2
+      fi
+
+      if test -n "$release"; then
+	$echo "$modename: warning: \`-release' is ignored for objects" 1>&2
+      fi
+
+      case "$output" in
+      *.lo)
+	if test -n "$objs"; then
+	  $echo "$modename: cannot build library object \`$output' from non-libtool objects" 1>&2
+	  exit 1
+	fi
+	libobj="$output"
+	obj=`$echo "X$output" | $Xsed -e "$lo2o"`
+	;;
+      *)
+	libobj=
+	obj="$output"
+	;;
+      esac
+
+      # Delete the old objects.
+      $run $rm $obj $libobj
+
+      # Objects from convenience libraries.  This assumes
+      # single-version convenience libraries.  Whenever we create
+      # different ones for PIC/non-PIC, this we'll have to duplicate
+      # the extraction.
+      reload_conv_objs=
+      gentop=
+      # reload_cmds runs $LD directly, so let us get rid of
+      # -Wl from whole_archive_flag_spec
+      wl= 
+
+      if test -n "$convenience"; then
+	if test -n "$whole_archive_flag_spec"; then
+	  eval reload_conv_objs=\"\$reload_objs $whole_archive_flag_spec\"
+	else
+	  gentop="$output_objdir/${obj}x"
+	  $show "${rm}r $gentop"
+	  $run ${rm}r "$gentop"
+	  $show "mkdir $gentop"
+	  $run mkdir "$gentop"
+	  status=$?
+	  if test $status -ne 0 && test ! -d "$gentop"; then
+	    exit $status
+	  fi
+	  generated="$generated $gentop"
+
+	  for xlib in $convenience; do
+	    # Extract the objects.
+	    case "$xlib" in
+	    [\\/]* | [A-Za-z]:[\\/]*) xabs="$xlib" ;;
+	    *) xabs=`pwd`"/$xlib" ;;
+	    esac
+	    xlib=`$echo "X$xlib" | $Xsed -e 's%^.*/%%'`
+	    xdir="$gentop/$xlib"
+
+	    $show "${rm}r $xdir"
+	    $run ${rm}r "$xdir"
+	    $show "mkdir $xdir"
+	    $run mkdir "$xdir"
+	    status=$?
+	    if test $status -ne 0 && test ! -d "$xdir"; then
+	      exit $status
+	    fi
+	    $show "(cd $xdir && $AR x $xabs)"
+	    $run eval "(cd \$xdir && $AR x \$xabs)" || exit $?
+
+	    reload_conv_objs="$reload_objs "`find $xdir -name \*.o -print -o -name \*.lo -print | $NL2SP`
+	  done
+	fi
+      fi
+
+      # Create the old-style object.
+      reload_objs="$objs "`$echo "X$libobjs" | $SP2NL | $Xsed -e '/\.'${libext}$'/d' -e '/\.lib$/d' -e "$lo2o" | $NL2SP`" $reload_conv_objs"
+
+      output="$obj"
+      eval cmds=\"$reload_cmds\"
+      IFS="${IFS= 	}"; save_ifs="$IFS"; IFS='~'
+      for cmd in $cmds; do
+	IFS="$save_ifs"
+	$show "$cmd"
+	$run eval "$cmd" || exit $?
+      done
+      IFS="$save_ifs"
+
+      # Exit if we aren't doing a library object file.
+      if test -z "$libobj"; then
+	if test -n "$gentop"; then
+	  $show "${rm}r $gentop"
+	  $run ${rm}r $gentop
+	fi
+
+	exit 0
+      fi
+
+      if test "$build_libtool_libs" != yes; then
+	if test -n "$gentop"; then
+	  $show "${rm}r $gentop"
+	  $run ${rm}r $gentop
+	fi
+
+	# Create an invalid libtool object if no PIC, so that we don't
+	# accidentally link it into a program.
+	$show "echo timestamp > $libobj"
+	$run eval "echo timestamp > $libobj" || exit $?
+	exit 0
+      fi
+
+      if test -n "$pic_flag"; then
+	# Only do commands if we really have different PIC objects.
+	reload_objs="$libobjs $reload_conv_objs"
+	output="$libobj"
+	eval cmds=\"$reload_cmds\"
+	IFS="${IFS= 	}"; save_ifs="$IFS"; IFS='~'
+	for cmd in $cmds; do
+	  IFS="$save_ifs"
+	  $show "$cmd"
+	  $run eval "$cmd" || exit $?
+	done
+	IFS="$save_ifs"
+      else
+	# Just create a symlink.
+	$show $rm $libobj
+	$run $rm $libobj
+	xdir=`$echo "X$libobj" | $Xsed -e 's%/[^/]*$%%'`
+	if test "X$xdir" = "X$libobj"; then
+	  xdir="."
+	else
+	  xdir="$xdir"
+	fi
+	baseobj=`$echo "X$libobj" | $Xsed -e 's%^.*/%%'`
+	oldobj=`$echo "X$baseobj" | $Xsed -e "$lo2o"`
+	$show "(cd $xdir && $LN_S $oldobj $baseobj)"
+	$run eval '(cd $xdir && $LN_S $oldobj $baseobj)' || exit $?
+      fi
+
+      if test -n "$gentop"; then
+	$show "${rm}r $gentop"
+	$run ${rm}r $gentop
+      fi
+
+      exit 0
+      ;;
+
+    # Anything else should be a program.
+    *)
+      if test -n "$vinfo"; then
+	$echo "$modename: warning: \`-version-info' is ignored for programs" 1>&2
+      fi
+
+      if test -n "$release"; then
+	$echo "$modename: warning: \`-release' is ignored for programs" 1>&2
+      fi
+
+      if test "$preload" = yes; then
+	if test "$dlopen" = unknown && test "$dlopen_self" = unknown &&
+	   test "$dlopen_self_static" = unknown; then
+	  $echo "$modename: warning: \`AC_LIBTOOL_DLOPEN' not used. Assuming no dlopen support."
+	fi 
+      fi
+    
+      if test -n "$rpath$xrpath"; then
+	# If the user specified any rpath flags, then add them.
+	for libdir in $rpath $xrpath; do
+	  # This is the magic to use -rpath.
+	  case "$compile_rpath " in
+	  *" $libdir "*) ;;
+	  *) compile_rpath="$compile_rpath $libdir" ;;
+	  esac
+	  case "$finalize_rpath " in
+	  *" $libdir "*) ;;
+	  *) finalize_rpath="$finalize_rpath $libdir" ;;
+	  esac
+	done
+      fi
+
+      # Now hardcode the library paths
+      rpath=
+      hardcode_libdirs=
+      for libdir in $compile_rpath $finalize_rpath; do
+	if test -n "$hardcode_libdir_flag_spec"; then
+	  if test -n "$hardcode_libdir_separator"; then
+	    if test -z "$hardcode_libdirs"; then
+	      hardcode_libdirs="$libdir"
+	    else
+	      # Just accumulate the unique libdirs.
+	      case "$hardcode_libdir_separator$hardcode_libdirs$hardcode_libdir_separator" in
+	      *"$hardcode_libdir_separator$libdir$hardcode_libdir_separator"*)
+		;;
+	      *)
+		hardcode_libdirs="$hardcode_libdirs$hardcode_libdir_separator$libdir"
+		;;
+	      esac
+	    fi
+	  else
+	    eval flag=\"$hardcode_libdir_flag_spec\"
+	    rpath="$rpath $flag"
+	  fi
+	elif test -n "$runpath_var"; then
+	  case "$perm_rpath " in
+	  *" $libdir "*) ;;
+	  *) perm_rpath="$perm_rpath $libdir" ;;
+	  esac
+	fi
+      done
+      # Substitute the hardcoded libdirs into the rpath.
+      if test -n "$hardcode_libdir_separator" &&
+	 test -n "$hardcode_libdirs"; then
+	libdir="$hardcode_libdirs"
+	eval rpath=\" $hardcode_libdir_flag_spec\"
+      fi
+      compile_rpath="$rpath"
+
+      rpath=
+      hardcode_libdirs=
+      for libdir in $finalize_rpath; do
+	if test -n "$hardcode_libdir_flag_spec"; then
+	  if test -n "$hardcode_libdir_separator"; then
+	    if test -z "$hardcode_libdirs"; then
+	      hardcode_libdirs="$libdir"
+	    else
+	      # Just accumulate the unique libdirs.
+	      case "$hardcode_libdir_separator$hardcode_libdirs$hardcode_libdir_separator" in
+	      *"$hardcode_libdir_separator$libdir$hardcode_libdir_separator"*)
+		;;
+	      *)
+		hardcode_libdirs="$hardcode_libdirs$hardcode_libdir_separator$libdir"
+		;;
+	      esac
+	    fi
+	  else
+	    eval flag=\"$hardcode_libdir_flag_spec\"
+	    rpath="$rpath $flag"
+	  fi
+	elif test -n "$runpath_var"; then
+	  case "$finalize_perm_rpath " in
+	  *" $libdir "*) ;;
+	  *) finalize_perm_rpath="$finalize_perm_rpath $libdir" ;;
+	  esac
+	fi
+      done
+      # Substitute the hardcoded libdirs into the rpath.
+      if test -n "$hardcode_libdir_separator" &&
+	 test -n "$hardcode_libdirs"; then
+	libdir="$hardcode_libdirs"
+	eval rpath=\" $hardcode_libdir_flag_spec\"
+      fi
+      finalize_rpath="$rpath"
+
+      output_objdir=`$echo "X$output" | $Xsed -e 's%/[^/]*$%%'`
+      if test "X$output_objdir" = "X$output"; then
+	output_objdir="$objdir"
+      else
+	output_objdir="$output_objdir/$objdir"
+      fi
+
+      # Create the binary in the object directory, then wrap it.
+      if test ! -d $output_objdir; then
+	$show "$mkdir $output_objdir"
+	$run $mkdir $output_objdir
+	status=$?
+	if test $status -ne 0 && test ! -d $output_objdir; then
+	  exit $status
+	fi
+      fi
+
+      if test -n "$libobjs" && test "$build_old_libs" = yes; then
+	# Transform all the library objects into standard objects.
+	compile_command=`$echo "X$compile_command" | $SP2NL | $Xsed -e "$lo2o" | $NL2SP`
+	finalize_command=`$echo "X$finalize_command" | $SP2NL | $Xsed -e "$lo2o" | $NL2SP`
+      fi
+
+      dlsyms=
+      if test -n "$dlfiles$dlprefiles" || test "$dlself" != no; then
+	if test -n "$NM" && test -n "$global_symbol_pipe"; then
+	  dlsyms="${outputname}S.c"
+	else
+	  $echo "$modename: not configured to extract global symbols from dlpreopened files" 1>&2
+	fi
+      fi
+
+      if test -n "$dlsyms"; then
+	case "$dlsyms" in
+	"") ;;
+	*.c)
+	  # Discover the nlist of each of the dlfiles.
+	  nlist="$output_objdir/${outputname}.nm"
+
+	  $show "$rm $nlist ${nlist}S ${nlist}T"
+	  $run $rm "$nlist" "${nlist}S" "${nlist}T"
+
+	  # Parse the name list into a source file.
+	  $show "creating $output_objdir/$dlsyms"
+
+	  test -z "$run" && $echo > "$output_objdir/$dlsyms" "\
+/* $dlsyms - symbol resolution table for \`$outputname' dlsym emulation. */
+/* Generated by $PROGRAM - GNU $PACKAGE $VERSION$TIMESTAMP */
+
+#ifdef __cplusplus
+extern \"C\" {
+#endif
+
+/* Prevent the only kind of declaration conflicts we can make. */
+#define lt_preloaded_symbols some_other_symbol
+
+/* External symbol declarations for the compiler. */\
+"
+
+	  if test "$dlself" = yes; then
+	    $show "generating symbol list for \`$output'"
+
+	    test -z "$run" && $echo ': @PROGRAM@ ' > "$nlist"
+
+	    # Add our own program objects to the symbol list.
+	    progfiles=`$echo "X$objs" | $SP2NL | $Xsed -e "$lo2o" | $NL2SP`
+	    for arg in $progfiles; do
+	      $show "extracting global C symbols from \`$arg'"
+	      $run eval "$NM $arg | $global_symbol_pipe >> '$nlist'"
+	    done
+
+	    if test -n "$exclude_expsyms"; then
+	      $run eval 'egrep -v " ($exclude_expsyms)$" "$nlist" > "$nlist"T'
+	      $run eval '$mv "$nlist"T "$nlist"'
+	    fi
+	    
+	    if test -n "$export_symbols_regex"; then
+	      $run eval 'egrep -e "$export_symbols_regex" "$nlist" > "$nlist"T'
+	      $run eval '$mv "$nlist"T "$nlist"'
+	    fi
+
+	    # Prepare the list of exported symbols
+	    if test -z "$export_symbols"; then
+	      export_symbols="$output_objdir/$output.exp"
+	      $run $rm $export_symbols
+	      $run eval "sed -n -e '/^: @PROGRAM@$/d' -e 's/^.* \(.*\)$/\1/p' "'< "$nlist" > "$export_symbols"'
+	    else
+	      $run eval "sed -e 's/\([][.*^$]\)/\\\1/g' -e 's/^/ /' -e 's/$/$/'"' < "$export_symbols" > "$output_objdir/$output.exp"'
+	      $run eval 'grep -f "$output_objdir/$output.exp" < "$nlist" > "$nlist"T'
+	      $run eval 'mv "$nlist"T "$nlist"'
+	    fi
+	  fi
+
+	  for arg in $dlprefiles; do
+	    $show "extracting global C symbols from \`$arg'"
+	    name=`echo "$arg" | sed -e 's%^.*/%%'`
+	    $run eval 'echo ": $name " >> "$nlist"'
+	    $run eval "$NM $arg | $global_symbol_pipe >> '$nlist'"
+	  done
+
+	  if test -z "$run"; then
+	    # Make sure we have at least an empty file.
+	    test -f "$nlist" || : > "$nlist"
+
+	    if test -n "$exclude_expsyms"; then
+	      egrep -v " ($exclude_expsyms)$" "$nlist" > "$nlist"T
+	      $mv "$nlist"T "$nlist"
+	    fi
+
+	    # Try sorting and uniquifying the output.
+	    if grep -v "^: " < "$nlist" | sort +2 | uniq > "$nlist"S; then
+	      :
+	    else
+	      grep -v "^: " < "$nlist" > "$nlist"S
+	    fi
+
+	    if test -f "$nlist"S; then
+	      eval "$global_symbol_to_cdecl"' < "$nlist"S >> "$output_objdir/$dlsyms"'
+	    else
+	      echo '/* NONE */' >> "$output_objdir/$dlsyms"
+	    fi
+
+	    $echo >> "$output_objdir/$dlsyms" "\
+
+#undef lt_preloaded_symbols
+
+#if defined (__STDC__) && __STDC__
+# define lt_ptr_t void *
+#else
+# define lt_ptr_t char *
+# define const
+#endif
+
+/* The mapping between symbol names and symbols. */
+const struct {
+  const char *name;
+  lt_ptr_t address;
+}
+lt_preloaded_symbols[] =
+{\
+"
+
+	    sed -n -e 's/^: \([^ ]*\) $/  {\"\1\", (lt_ptr_t) 0},/p' \
+		-e 's/^. \([^ ]*\) \([^ ]*\)$/  {"\2", (lt_ptr_t) \&\2},/p' \
+		  < "$nlist" >> "$output_objdir/$dlsyms"
+
+	    $echo >> "$output_objdir/$dlsyms" "\
+  {0, (lt_ptr_t) 0}
+};
+
+/* This works around a problem in FreeBSD linker */
+#ifdef FREEBSD_WORKAROUND
+static const void *lt_preloaded_setup() {
+  return lt_preloaded_symbols;
+}
+#endif
+
+#ifdef __cplusplus
+}
+#endif\
+"
+	  fi
+
+	  pic_flag_for_symtable=
+	  case "$host" in
+	  # compiling the symbol table file with pic_flag works around
+	  # a FreeBSD bug that causes programs to crash when -lm is
+	  # linked before any other PIC object.  But we must not use
+	  # pic_flag when linking with -static.  The problem exists in
+	  # FreeBSD 2.2.6 and is fixed in FreeBSD 3.1.
+	  *-*-freebsd2*|*-*-freebsd3.0*|*-*-freebsdelf3.0*)
+	    case "$compile_command " in
+	    *" -static "*) ;;
+	    *) pic_flag_for_symtable=" $pic_flag -DPIC -DFREEBSD_WORKAROUND";;
+	    esac;;
+	  *-*-hpux*)
+	    case "$compile_command " in
+	    *" -static "*) ;;
+	    *) pic_flag_for_symtable=" $pic_flag -DPIC";;
+	    esac
+	  esac
+
+	  # Now compile the dynamic symbol file.
+	  $show "(cd $output_objdir && $CC -c$no_builtin_flag$pic_flag_for_symtable \"$dlsyms\")"
+	  $run eval '(cd $output_objdir && $CC -c$no_builtin_flag$pic_flag_for_symtable "$dlsyms")' || exit $?
+
+	  # Clean up the generated files.
+	  $show "$rm $output_objdir/$dlsyms $nlist ${nlist}S ${nlist}T"
+	  $run $rm "$output_objdir/$dlsyms" "$nlist" "${nlist}S" "${nlist}T"
+
+	  # Transform the symbol file into the correct name.
+	  compile_command=`$echo "X$compile_command" | $Xsed -e "s%@SYMFILE@%$output_objdir/${outputname}S.${objext}%"`
+	  finalize_command=`$echo "X$finalize_command" | $Xsed -e "s%@SYMFILE@%$output_objdir/${outputname}S.${objext}%"`
+	  ;;
+	*)
+	  $echo "$modename: unknown suffix for \`$dlsyms'" 1>&2
+	  exit 1
+	  ;;
+	esac
+      else
+	# We keep going just in case the user didn't refer to
+	# lt_preloaded_symbols.  The linker will fail if global_symbol_pipe
+	# really was required.
+
+	# Nullify the symbol file.
+	compile_command=`$echo "X$compile_command" | $Xsed -e "s% @SYMFILE@%%"`
+	finalize_command=`$echo "X$finalize_command" | $Xsed -e "s% @SYMFILE@%%"`
+      fi
+
+      if test -z "$link_against_libtool_libs" || test "$build_libtool_libs" != yes; then
+	# Replace the output file specification.
+	compile_command=`$echo "X$compile_command" | $Xsed -e 's%@OUTPUT@%'"$output"'%g'`
+	link_command="$compile_command$compile_rpath"
+
+	# We have no uninstalled library dependencies, so finalize right now.
+	$show "$link_command"
+	$run eval "$link_command"
+	status=$?
+	
+	# Delete the generated files.
+	if test -n "$dlsyms"; then
+	  $show "$rm $output_objdir/${outputname}S.${objext}"
+	  $run $rm "$output_objdir/${outputname}S.${objext}"
+	fi
+
+	exit $status
+      fi
+
+      if test -n "$shlibpath_var"; then
+	# We should set the shlibpath_var
+	rpath=
+	for dir in $temp_rpath; do
+	  case "$dir" in
+	  [\\/]* | [A-Za-z]:[\\/]*)
+	    # Absolute path.
+	    rpath="$rpath$dir:"
+	    ;;
+	  *)
+	    # Relative path: add a thisdir entry.
+	    rpath="$rpath\$thisdir/$dir:"
+	    ;;
+	  esac
+	done
+	temp_rpath="$rpath"
+      fi
+
+      if test -n "$compile_shlibpath$finalize_shlibpath"; then
+	compile_command="$shlibpath_var=\"$compile_shlibpath$finalize_shlibpath\$$shlibpath_var\" $compile_command"
+      fi
+      if test -n "$finalize_shlibpath"; then
+	finalize_command="$shlibpath_var=\"$finalize_shlibpath\$$shlibpath_var\" $finalize_command"
+      fi
+
+      compile_var=
+      finalize_var=
+      if test -n "$runpath_var"; then
+	if test -n "$perm_rpath"; then
+	  # We should set the runpath_var.
+	  rpath=
+	  for dir in $perm_rpath; do
+	    rpath="$rpath$dir:"
+	  done
+	  compile_var="$runpath_var=\"$rpath\$$runpath_var\" "
+	fi
+	if test -n "$finalize_perm_rpath"; then
+	  # We should set the runpath_var.
+	  rpath=
+	  for dir in $finalize_perm_rpath; do
+	    rpath="$rpath$dir:"
+	  done
+	  finalize_var="$runpath_var=\"$rpath\$$runpath_var\" "
+	fi
+      fi
+
+      if test "$hardcode_action" = relink; then
+	# Fast installation is not supported
+	link_command="$compile_var$compile_command$compile_rpath"
+	relink_command="$finalize_var$finalize_command$finalize_rpath"
+	
+	$echo "$modename: warning: this platform does not like uninstalled shared libraries" 1>&2
+	$echo "$modename: \`$output' will be relinked during installation" 1>&2
+      else
+	if test "$fast_install" != no; then
+	  link_command="$finalize_var$compile_command$finalize_rpath"
+	  if test "$fast_install" = yes; then
+	    relink_command=`$echo "X$compile_var$compile_command$compile_rpath" | $Xsed -e 's%@OUTPUT@%\$progdir/\$file%g'`
+	  else
+	    # fast_install is set to needless
+	    relink_command=
+	  fi
+	else
+	  link_command="$compile_var$compile_command$compile_rpath"
+	  relink_command="$finalize_var$finalize_command$finalize_rpath"
+	fi
+      fi
+
+      # Replace the output file specification.
+      link_command=`$echo "X$link_command" | $Xsed -e 's%@OUTPUT@%'"$output_objdir/$outputname"'%g'`
+      
+      # Delete the old output files.
+      $run $rm $output $output_objdir/$outputname $output_objdir/lt-$outputname
+
+      $show "$link_command"
+      $run eval "$link_command" || exit $?
+
+      # Now create the wrapper script.
+      $show "creating $output"
+
+      # Quote the relink command for shipping.
+      if test -n "$relink_command"; then
+	relink_command=`$echo "X$relink_command" | $Xsed -e "$sed_quote_subst"`
+      fi
+
+      # Quote $echo for shipping.
+      if test "X$echo" = "X$SHELL $0 --fallback-echo"; then
+	case "$0" in
+	[\\/]* | [A-Za-z]:[\\/]*) qecho="$SHELL $0 --fallback-echo";;
+	*) qecho="$SHELL `pwd`/$0 --fallback-echo";;
+	esac
+	qecho=`$echo "X$qecho" | $Xsed -e "$sed_quote_subst"`
+      else
+	qecho=`$echo "X$echo" | $Xsed -e "$sed_quote_subst"`
+      fi
+
+      # Only actually do things if our run command is non-null.
+      if test -z "$run"; then
+	# win32 will think the script is a binary if it has
+	# a .exe suffix, so we strip it off here.
+	case $output in
+	  *.exe) output=`echo $output|sed 's,.exe$,,'` ;;
+	esac
+	$rm $output
+	trap "$rm $output; exit 1" 1 2 15
+
+	$echo > $output "\
+#! $SHELL
+
+# $output - temporary wrapper script for $objdir/$outputname
+# Generated by $PROGRAM - GNU $PACKAGE $VERSION$TIMESTAMP
+#
+# The $output program cannot be directly executed until all the libtool
+# libraries that it depends on are installed.
+#
+# This wrapper script should never be moved out of the build directory.
+# If it is, it will not operate correctly.
+
+# Sed substitution that helps us do robust quoting.  It backslashifies
+# metacharacters that are still active within double-quoted strings.
+Xsed='sed -e 1s/^X//'
+sed_quote_subst='$sed_quote_subst'
+
+# The HP-UX ksh and POSIX shell print the target directory to stdout
+# if CDPATH is set.
+if test \"\${CDPATH+set}\" = set; then CDPATH=:; export CDPATH; fi
+
+relink_command=\"$relink_command\"
+
+# This environment variable determines our operation mode.
+if test \"\$libtool_install_magic\" = \"$magic\"; then
+  # install mode needs the following variable:
+  link_against_libtool_libs='$link_against_libtool_libs'
+else
+  # When we are sourced in execute mode, \$file and \$echo are already set.
+  if test \"\$libtool_execute_magic\" != \"$magic\"; then
+    echo=\"$qecho\"
+    file=\"\$0\"
+    # Make sure echo works.
+    if test \"X\$1\" = X--no-reexec; then
+      # Discard the --no-reexec flag, and continue.
+      shift
+    elif test \"X\`(\$echo '\t') 2>/dev/null\`\" = 'X\t'; then
+      # Yippee, \$echo works!
+      :
+    else
+      # Restart under the correct shell, and then maybe \$echo will work.
+      exec $SHELL \"\$0\" --no-reexec \${1+\"\$@\"}
+    fi
+  fi\
+"
+	$echo >> $output "\
+
+  # Find the directory that this script lives in.
+  thisdir=\`\$echo \"X\$file\" | \$Xsed -e 's%/[^/]*$%%'\`
+  test \"x\$thisdir\" = \"x\$file\" && thisdir=.
+
+  # Follow symbolic links until we get to the real thisdir.
+  file=\`ls -ld \"\$file\" | sed -n 's/.*-> //p'\`
+  while test -n \"\$file\"; do
+    destdir=\`\$echo \"X\$file\" | \$Xsed -e 's%/[^/]*\$%%'\`
+
+    # If there was a directory component, then change thisdir.
+    if test \"x\$destdir\" != \"x\$file\"; then
+      case \"\$destdir\" in
+      [\\/]* | [A-Za-z]:[\\/]*) thisdir=\"\$destdir\" ;;
+      *) thisdir=\"\$thisdir/\$destdir\" ;;
+      esac
+    fi
+
+    file=\`\$echo \"X\$file\" | \$Xsed -e 's%^.*/%%'\`
+    file=\`ls -ld \"\$thisdir/\$file\" | sed -n 's/.*-> //p'\`
+  done
+
+  # Try to get the absolute directory name.
+  absdir=\`cd \"\$thisdir\" && pwd\`
+  test -n \"\$absdir\" && thisdir=\"\$absdir\"
+"
+
+	if test "$fast_install" = yes; then
+	  echo >> $output "\
+  program=lt-'$outputname'
+  progdir=\"\$thisdir/$objdir\"
+  
+  if test ! -f \"\$progdir/\$program\" || \\
+     { file=\`ls -1dt \"\$progdir/\$program\" \"\$progdir/../\$program\" 2>/dev/null | sed 1q\`; \\
+       test \"X\$file\" != \"X\$progdir/\$program\"; }; then
+
+    file=\"\$\$-\$program\"
+
+    if test ! -d \"\$progdir\"; then
+      $mkdir \"\$progdir\"
+    else
+      $rm \"\$progdir/\$file\"
+    fi"
+
+	  echo >> $output "\
+
+    # relink executable if necessary
+    if test -n \"\$relink_command\"; then
+      if (cd \"\$thisdir\" && eval \$relink_command); then :
+      else
+	$rm \"\$progdir/\$file\"
+	exit 1
+      fi
+    fi
+
+    $mv \"\$progdir/\$file\" \"\$progdir/\$program\" 2>/dev/null ||
+    { $rm \"\$progdir/\$program\";
+      $mv \"\$progdir/\$file\" \"\$progdir/\$program\"; }
+    $rm \"\$progdir/\$file\"
+  fi"
+	else
+	  echo >> $output "\
+  program='$outputname'
+  progdir=\"\$thisdir/$objdir\"
+"
+	fi
+
+	echo >> $output "\
+
+  if test -f \"\$progdir/\$program\"; then"
+
+	# Export our shlibpath_var if we have one.
+	if test "$shlibpath_overrides_runpath" = yes && test -n "$shlibpath_var" && test -n "$temp_rpath"; then
+	  $echo >> $output "\
+    # Add our own library path to $shlibpath_var
+    $shlibpath_var=\"$temp_rpath\$$shlibpath_var\"
+
+    # Some systems cannot cope with colon-terminated $shlibpath_var
+    # The second colon is a workaround for a bug in BeOS R4 sed
+    $shlibpath_var=\`\$echo \"X\$$shlibpath_var\" | \$Xsed -e 's/::*\$//'\`
+
+    export $shlibpath_var
+"
+	fi
+
+	# fixup the dll searchpath if we need to.
+	if test -n "$dllsearchpath"; then
+	  $echo >> $output "\
+    # Add the dll search path components to the executable PATH
+    PATH=$dllsearchpath:\$PATH
+"
+	fi
+
+	$echo >> $output "\
+    if test \"\$libtool_execute_magic\" != \"$magic\"; then
+      # Run the actual program with our arguments.
+"
+	case $host in
+	  # win32 systems need to use the prog path for dll
+	  # lookup to work
+	*-*-cygwin*)
+	  $echo >> $output "\
+      exec \$progdir/\$program \${1+\"\$@\"}
+"
+	  ;;
+
+	# Backslashes separate directories on plain windows
+	*-*-mingw | *-*-os2*)
+	  $echo >> $output "\
+      exec \$progdir\\\\\$program \${1+\"\$@\"}
+"
+	  ;;
+
+	*)
+	  $echo >> $output "\
+      # Export the path to the program.
+      PATH=\"\$progdir:\$PATH\"
+      export PATH
+
+      exec \$program \${1+\"\$@\"}
+"
+	  ;;
+	esac
+	$echo >> $output "\
+      \$echo \"\$0: cannot exec \$program \${1+\"\$@\"}\"
+      exit 1
+    fi
+  else
+    # The program doesn't exist.
+    \$echo \"\$0: error: \$progdir/\$program does not exist\" 1>&2
+    \$echo \"This script is just a wrapper for \$program.\" 1>&2
+    echo \"See the $PACKAGE documentation for more information.\" 1>&2
+    exit 1
+  fi
+fi\
+"
+	chmod +x $output
+      fi
+      exit 0
+      ;;
+    esac
+
+    # See if we need to build an old-fashioned archive.
+    for oldlib in $oldlibs; do
+
+      if test "$build_libtool_libs" = convenience; then
+	oldobjs="$libobjs_save"
+	addlibs="$convenience"
+	build_libtool_libs=no
+      else
+	if test "$build_libtool_libs" = module; then
+	  oldobjs="$libobjs_save"
+	  build_libtool_libs=no
+	else
+	  oldobjs="$objs "`$echo "X$libobjs_save" | $SP2NL | $Xsed -e '/\.'${libext}'$/d' -e '/\.lib$/d' -e "$lo2o" | $NL2SP`
+	fi
+	addlibs="$old_convenience"
+      fi
+
+      if test -n "$addlibs"; then
+	gentop="$output_objdir/${outputname}x"
+	$show "${rm}r $gentop"
+	$run ${rm}r "$gentop"
+	$show "mkdir $gentop"
+	$run mkdir "$gentop"
+	status=$?
+	if test $status -ne 0 && test ! -d "$gentop"; then
+	  exit $status
+	fi
+	generated="$generated $gentop"
+	  
+	# Add in members from convenience archives.
+	for xlib in $addlibs; do
+	  # Extract the objects.
+	  case "$xlib" in
+	  [\\/]* | [A-Za-z]:[\\/]*) xabs="$xlib" ;;
+	  *) xabs=`pwd`"/$xlib" ;;
+	  esac
+	  xlib=`$echo "X$xlib" | $Xsed -e 's%^.*/%%'`
+	  xdir="$gentop/$xlib"
+
+	  $show "${rm}r $xdir"
+	  $run ${rm}r "$xdir"
+	  $show "mkdir $xdir"
+	  $run mkdir "$xdir"
+	  status=$?
+	  if test $status -ne 0 && test ! -d "$xdir"; then
+	    exit $status
+	  fi
+	  $show "(cd $xdir && $AR x $xabs)"
+	  $run eval "(cd \$xdir && $AR x \$xabs)" || exit $?
+
+	  oldobjs="$oldobjs "`find $xdir -name \*.${objext} -print -o -name \*.lo -print | $NL2SP`
+	done
+      fi
+
+      # Do each command in the archive commands.
+      if test -n "$old_archive_from_new_cmds" && test "$build_libtool_libs" = yes; then
+	eval cmds=\"$old_archive_from_new_cmds\"
+      else
+	# Ensure that we have .o objects in place in case we decided
+	# not to build a shared library, and have fallen back to building
+	# static libs even though --disable-static was passed!
+	for oldobj in $oldobjs; do
+	  if test ! -f $oldobj; then
+	    xdir=`$echo "X$oldobj" | $Xsed -e 's%/[^/]*$%%'`
+	    if test "X$xdir" = "X$oldobj"; then
+	      xdir="."
+	    else
+	      xdir="$xdir"
+	    fi
+	    baseobj=`$echo "X$oldobj" | $Xsed -e 's%^.*/%%'`
+	    obj=`$echo "X$baseobj" | $Xsed -e "$o2lo"`
+	    $show "(cd $xdir && ${LN_S} $obj $baseobj)"
+	    $run eval '(cd $xdir && ${LN_S} $obj $baseobj)' || exit $?
+	  fi
+	done
+
+	eval cmds=\"$old_archive_cmds\"
+      fi
+      IFS="${IFS= 	}"; save_ifs="$IFS"; IFS='~'
+      for cmd in $cmds; do
+	IFS="$save_ifs"
+	$show "$cmd"
+	$run eval "$cmd" || exit $?
+      done
+      IFS="$save_ifs"
+    done
+
+    if test -n "$generated"; then
+      $show "${rm}r$generated"
+      $run ${rm}r$generated
+    fi
+
+    # Now create the libtool archive.
+    case "$output" in
+    *.la)
+      old_library=
+      test "$build_old_libs" = yes && old_library="$libname.$libext"
+      $show "creating $output"
+
+      if test -n "$xrpath"; then
+	temp_xrpath=
+	for libdir in $xrpath; do
+	  temp_xrpath="$temp_xrpath -R$libdir"
+	done
+	dependency_libs="$temp_xrpath $dependency_libs"
+      fi
+
+      # Only create the output if not a dry run.
+      if test -z "$run"; then
+	for installed in no yes; do
+	  if test "$installed" = yes; then
+	    if test -z "$install_libdir"; then
+	      break
+	    fi
+	    output="$output_objdir/$outputname"i
+	  fi
+	  $rm $output
+	  $echo > $output "\
+# $outputname - a libtool library file
+# Generated by $PROGRAM - GNU $PACKAGE $VERSION$TIMESTAMP
+#
+# Please DO NOT delete this file!
+# It is necessary for linking the library.
+
+# The name that we can dlopen(3).
+dlname='$dlname'
+
+# Names of this library.
+library_names='$library_names'
+
+# The name of the static archive.
+old_library='$old_library'
+
+# Libraries that this one depends upon.
+dependency_libs='$dependency_libs'
+
+# Version information for $libname.
+current=$current
+age=$age
+revision=$revision
+
+# Is this an already installed library?
+installed=$installed
+
+# Directory that this library needs to be installed in:
+libdir='$install_libdir'\
+"
+	done
+      fi
+
+      # Do a symbolic link so that the libtool archive can be found in
+      # LD_LIBRARY_PATH before the program is installed.
+      $show "(cd $output_objdir && $rm $outputname && $LN_S ../$outputname $outputname)"
+      $run eval "(cd $output_objdir && $rm $outputname && $LN_S ../$outputname $outputname)" || exit $?
+      ;;
+    esac
+    exit 0
+    ;;
+
+  # libtool install mode
+  install)
+    modename="$modename: install"
+
+    # There may be an optional sh(1) argument at the beginning of
+    # install_prog (especially on Windows NT).
+    if test "$nonopt" = "$SHELL" || test "$nonopt" = /bin/sh || test ".`echo $nonopt | grep shtool`" != .;then
+      # Aesthetically quote it.
+      arg=`$echo "X$nonopt" | $Xsed -e "$sed_quote_subst"`
+      case "$arg" in
+      *[\[\~\#\^\&\*\(\)\{\}\|\;\<\>\?\'\ \	]*|*]*)
+	arg="\"$arg\""
+	;;
+      esac
+      install_prog="$arg "
+      arg="$1"
+      shift
+    else
+      install_prog=
+      arg="$nonopt"
+    fi
+
+    # The real first argument should be the name of the installation program.
+    # Aesthetically quote it.
+    arg=`$echo "X$arg" | $Xsed -e "$sed_quote_subst"`
+    case "$arg" in
+    *[\[\~\#\^\&\*\(\)\{\}\|\;\<\>\?\'\ \	]*|*]*)
+      arg="\"$arg\""
+      ;;
+    esac
+    install_prog="$install_prog$arg"
+
+    # We need to accept at least all the BSD install flags.
+    dest=
+    files=
+    opts=
+    prev=
+    install_type=
+    isdir=no
+    stripme=
+    for arg
+    do
+      if test -n "$dest"; then
+	files="$files $dest"
+	dest="$arg"
+	continue
+      fi
+
+      case "$arg" in
+      -d) isdir=yes ;;
+      -f) prev="-f" ;;
+      -g) prev="-g" ;;
+      -m) prev="-m" ;;
+      -o) prev="-o" ;;
+      -s)
+	stripme=" -s"
+	continue
+	;;
+      -*) ;;
+
+      *)
+	# If the previous option needed an argument, then skip it.
+	if test -n "$prev"; then
+	  prev=
+	else
+	  dest="$arg"
+	  continue
+	fi
+	;;
+      esac
+
+      # Aesthetically quote the argument.
+      arg=`$echo "X$arg" | $Xsed -e "$sed_quote_subst"`
+      case "$arg" in
+      *[\[\~\#\^\&\*\(\)\{\}\|\;\<\>\?\'\ \	]*|*]*)
+	arg="\"$arg\""
+	;;
+      esac
+      install_prog="$install_prog $arg"
+    done
+
+    if test -z "$install_prog"; then
+      $echo "$modename: you must specify an install program" 1>&2
+      $echo "$help" 1>&2
+      exit 1
+    fi
+
+    if test -n "$prev"; then
+      $echo "$modename: the \`$prev' option requires an argument" 1>&2
+      $echo "$help" 1>&2
+      exit 1
+    fi
+
+    if test -z "$files"; then
+      if test -z "$dest"; then
+	$echo "$modename: no file or destination specified" 1>&2
+      else
+	$echo "$modename: you must specify a destination" 1>&2
+      fi
+      $echo "$help" 1>&2
+      exit 1
+    fi
+
+    # Strip any trailing slash from the destination.
+    dest=`$echo "X$dest" | $Xsed -e 's%/$%%'`
+
+    # Check to see that the destination is a directory.
+    test -d "$dest" && isdir=yes
+    if test "$isdir" = yes; then
+      destdir="$dest"
+      destname=
+    else
+      destdir=`$echo "X$dest" | $Xsed -e 's%/[^/]*$%%'`
+      test "X$destdir" = "X$dest" && destdir=.
+      destname=`$echo "X$dest" | $Xsed -e 's%^.*/%%'`
+
+      # Not a directory, so check to see that there is only one file specified.
+      set dummy $files
+      if test $# -gt 2; then
+	$echo "$modename: \`$dest' is not a directory" 1>&2
+	$echo "$help" 1>&2
+	exit 1
+      fi
+    fi
+    case "$destdir" in
+    [\\/]* | [A-Za-z]:[\\/]*) ;;
+    *)
+      for file in $files; do
+	case "$file" in
+	*.lo) ;;
+	*)
+	  $echo "$modename: \`$destdir' must be an absolute directory name" 1>&2
+	  $echo "$help" 1>&2
+	  exit 1
+	  ;;
+	esac
+      done
+      ;;
+    esac
+
+    # This variable tells wrapper scripts just to set variables rather
+    # than running their programs.
+    libtool_install_magic="$magic"
+
+    staticlibs=
+    future_libdirs=
+    current_libdirs=
+    for file in $files; do
+
+      # Do each installation.
+      case "$file" in
+      *.a | *.lib)
+	# Do the static libraries later.
+	staticlibs="$staticlibs $file"
+	;;
+
+      *.la)
+	# Check to see that this really is a libtool archive.
+	if (sed -e '2q' $file | egrep "^# Generated by .*$PACKAGE") >/dev/null 2>&1; then :
+	else
+	  $echo "$modename: \`$file' is not a valid libtool archive" 1>&2
+	  $echo "$help" 1>&2
+	  exit 1
+	fi
+
+	library_names=
+	old_library=
+	# If there is no directory component, then add one.
+	case "$file" in
+	*/* | *\\*) . $file ;;
+	*) . ./$file ;;
+	esac
+
+	# Add the libdir to current_libdirs if it is the destination.
+	if test "X$destdir" = "X$libdir"; then
+	  case "$current_libdirs " in
+	  *" $libdir "*) ;;
+	  *) current_libdirs="$current_libdirs $libdir" ;;
+	  esac
+	else
+	  # Note the libdir as a future libdir.
+	  case "$future_libdirs " in
+	  *" $libdir "*) ;;
+	  *) future_libdirs="$future_libdirs $libdir" ;;
+	  esac
+	fi
+
+	dir="`$echo "X$file" | $Xsed -e 's%/[^/]*$%%'`/"
+	test "X$dir" = "X$file/" && dir=
+	dir="$dir$objdir"
+
+	# See the names of the shared library.
+	set dummy $library_names
+	if test -n "$2"; then
+	  realname="$2"
+	  shift
+	  shift
+
+	  # Install the shared library and build the symlinks.
+	  $show "$install_prog $dir/$realname $destdir/$realname"
+	  $run eval "$install_prog $dir/$realname $destdir/$realname" || exit $?
+
+	  if test $# -gt 0; then
+	    # Delete the old symlinks, and create new ones.
+	    for linkname
+	    do
+	      if test "$linkname" != "$realname"; then
+		$show "(cd $destdir && $rm $linkname && $LN_S $realname $linkname)"
+		$run eval "(cd $destdir && $rm $linkname && $LN_S $realname $linkname)"
+	      fi
+	    done
+	  fi
+
+	  # Do each command in the postinstall commands.
+	  lib="$destdir/$realname"
+	  eval cmds=\"$postinstall_cmds\"
+	  IFS="${IFS= 	}"; save_ifs="$IFS"; IFS='~'
+	  for cmd in $cmds; do
+	    IFS="$save_ifs"
+	    $show "$cmd"
+	    $run eval "$cmd" || exit $?
+	  done
+	  IFS="$save_ifs"
+	fi
+
+	# Install the pseudo-library for information purposes.
+	name=`$echo "X$file" | $Xsed -e 's%^.*/%%'`
+	instname="$dir/$name"i
+	$show "$install_prog $instname $destdir/$name"
+	$run eval "$install_prog $instname $destdir/$name" || exit $?
+
+	# Maybe install the static library, too.
+	test -n "$old_library" && staticlibs="$staticlibs $dir/$old_library"
+	;;
+
+      *.lo)
+	# Install (i.e. copy) a libtool object.
+
+	# Figure out destination file name, if it wasn't already specified.
+	if test -n "$destname"; then
+	  destfile="$destdir/$destname"
+	else
+	  destfile=`$echo "X$file" | $Xsed -e 's%^.*/%%'`
+	  destfile="$destdir/$destfile"
+	fi
+
+	# Deduce the name of the destination old-style object file.
+	case "$destfile" in
+	*.lo)
+	  staticdest=`$echo "X$destfile" | $Xsed -e "$lo2o"`
+	  ;;
+	*.o | *.obj)
+	  staticdest="$destfile"
+	  destfile=
+	  ;;
+	*)
+	  $echo "$modename: cannot copy a libtool object to \`$destfile'" 1>&2
+	  $echo "$help" 1>&2
+	  exit 1
+	  ;;
+	esac
+
+	# Install the libtool object if requested.
+	if test -n "$destfile"; then
+	  $show "$install_prog $file $destfile"
+	  $run eval "$install_prog $file $destfile" || exit $?
+	fi
+
+	# Install the old object if enabled.
+	if test "$build_old_libs" = yes; then
+	  # Deduce the name of the old-style object file.
+	  staticobj=`$echo "X$file" | $Xsed -e "$lo2o"`
+
+	  $show "$install_prog $staticobj $staticdest"
+	  $run eval "$install_prog \$staticobj \$staticdest" || exit $?
+	fi
+	exit 0
+	;;
+
+      *)
+	# Figure out destination file name, if it wasn't already specified.
+	if test -n "$destname"; then
+	  destfile="$destdir/$destname"
+	else
+	  destfile=`$echo "X$file" | $Xsed -e 's%^.*/%%'`
+	  destfile="$destdir/$destfile"
+	fi
+
+	# Do a test to see if this is really a libtool program.
+	if (sed -e '4q' $file | egrep "^# Generated by .*$PACKAGE") >/dev/null 2>&1; then
+	  link_against_libtool_libs=
+	  relink_command=
+
+	  # If there is no directory component, then add one.
+	  case "$file" in
+	  */* | *\\*) . $file ;;
+	  *) . ./$file ;;
+	  esac
+
+	  # Check the variables that should have been set.
+	  if test -z "$link_against_libtool_libs"; then
+	    $echo "$modename: invalid libtool wrapper script \`$file'" 1>&2
+	    exit 1
+	  fi
+
+	  finalize=yes
+	  for lib in $link_against_libtool_libs; do
+	    # Check to see that each library is installed.
+	    libdir=
+	    if test -f "$lib"; then
+	      # If there is no directory component, then add one.
+	      case "$lib" in
+	      */* | *\\*) . $lib ;;
+	      *) . ./$lib ;;
+	      esac
+	    fi
+	    libfile="$libdir/`$echo "X$lib" | $Xsed -e 's%^.*/%%g'`"
+	    if test -n "$libdir" && test ! -f "$libfile"; then
+	      $echo "$modename: warning: \`$lib' has not been installed in \`$libdir'" 1>&2
+	      finalize=no
+	    fi
+	  done
+
+	  outputname=
+	  if test "$fast_install" = no && test -n "$relink_command"; then
+	    if test "$finalize" = yes && test -z "$run"; then
+	      tmpdir="/tmp"
+	      test -n "$TMPDIR" && tmpdir="$TMPDIR"
+	      tmpdir="$tmpdir/libtool-$$"
+	      if $mkdir -p "$tmpdir" && chmod 700 "$tmpdir"; then :
+	      else
+		$echo "$modename: error: cannot create temporary directory \`$tmpdir'" 1>&2
+		continue
+	      fi
+	      outputname="$tmpdir/$file"
+	      # Replace the output file specification.
+	      relink_command=`$echo "X$relink_command" | $Xsed -e 's%@OUTPUT@%'"$outputname"'%g'`
+
+	      $show "$relink_command"
+	      if $run eval "$relink_command"; then :
+	      else
+		$echo "$modename: error: relink \`$file' with the above command before installing it" 1>&2
+		${rm}r "$tmpdir"
+		continue
+	      fi
+	      file="$outputname"
+	    else
+	      $echo "$modename: warning: cannot relink \`$file'" 1>&2
+	    fi
+	  else
+	    # Install the binary that we compiled earlier.
+	    file=`$echo "X$file" | $Xsed -e "s%\([^/]*\)$%$objdir/\1%"`
+	  fi
+	fi
+
+	$show "$install_prog$stripme $file $destfile"
+	$run eval "$install_prog\$stripme \$file \$destfile" || exit $?
+	test -n "$outputname" && ${rm}r "$tmpdir"
+	;;
+      esac
+    done
+
+    for file in $staticlibs; do
+      name=`$echo "X$file" | $Xsed -e 's%^.*/%%'`
+
+      # Set up the ranlib parameters.
+      oldlib="$destdir/$name"
+
+      $show "$install_prog $file $oldlib"
+      $run eval "$install_prog \$file \$oldlib" || exit $?
+
+      # Do each command in the postinstall commands.
+      eval cmds=\"$old_postinstall_cmds\"
+      IFS="${IFS= 	}"; save_ifs="$IFS"; IFS='~'
+      for cmd in $cmds; do
+	IFS="$save_ifs"
+	$show "$cmd"
+	$run eval "$cmd" || exit $?
+      done
+      IFS="$save_ifs"
+    done
+
+    if test -n "$future_libdirs"; then
+      $echo "$modename: warning: remember to run \`$progname --finish$future_libdirs'" 1>&2
+    fi
+
+    if test -n "$current_libdirs"; then
+      # Maybe just do a dry run.
+      test -n "$run" && current_libdirs=" -n$current_libdirs"
+      exit 0 #$current_libdirs
+      exit 1
+    fi
+
+    exit 0
+    ;;
+
+  # libtool finish mode
+  finish)
+    modename="$modename: finish"
+    libdirs="$nonopt"
+    admincmds=
+
+    if test -n "$finish_cmds$finish_eval" && test -n "$libdirs"; then
+      for dir
+      do
+	libdirs="$libdirs $dir"
+      done
+
+      for libdir in $libdirs; do
+	if test -n "$finish_cmds"; then
+	  # Do each command in the finish commands.
+	  eval cmds=\"$finish_cmds\"
+	  IFS="${IFS= 	}"; save_ifs="$IFS"; IFS='~'
+	  for cmd in $cmds; do
+	    IFS="$save_ifs"
+	    $show "$cmd"
+	    $run eval "$cmd" || admincmds="$admincmds
+       $cmd"
+	  done
+	  IFS="$save_ifs"
+	fi
+	if test -n "$finish_eval"; then
+	  # Do the single finish_eval.
+	  eval cmds=\"$finish_eval\"
+	  $run eval "$cmds" || admincmds="$admincmds
+       $cmds"
+	fi
+      done
+    fi
+
+    # Exit here if they wanted silent mode.
+    test "$show" = : && exit 0
+
+    echo "----------------------------------------------------------------------"
+    echo "Libraries have been installed in:"
+    for libdir in $libdirs; do
+      echo "   $libdir"
+    done
+    echo
+    echo "If you ever happen to want to link against installed libraries"
+    echo "in a given directory, LIBDIR, you must either use libtool, and"
+    echo "specify the full pathname of the library, or use \`-LLIBDIR'"
+    echo "flag during linking and do at least one of the following:"
+    if test -n "$shlibpath_var"; then
+      echo "   - add LIBDIR to the \`$shlibpath_var' environment variable"
+      echo "     during execution"
+    fi
+    if test -n "$runpath_var"; then
+      echo "   - add LIBDIR to the \`$runpath_var' environment variable"
+      echo "     during linking"
+    fi
+    if test -n "$hardcode_libdir_flag_spec"; then
+      libdir=LIBDIR
+      eval flag=\"$hardcode_libdir_flag_spec\"
+
+      echo "   - use the \`$flag' linker flag"
+    fi
+    if test -n "$admincmds"; then
+      echo "   - have your system administrator run these commands:$admincmds"
+    fi
+    if test -f /etc/ld.so.conf; then
+      echo "   - have your system administrator add LIBDIR to \`/etc/ld.so.conf'"
+    fi
+    echo
+    echo "See any operating system documentation about shared libraries for"
+    echo "more information, such as the ld(1) and ld.so(8) manual pages."
+    echo "----------------------------------------------------------------------"
+    exit 0
+    ;;
+
+  # libtool execute mode
+  execute)
+    modename="$modename: execute"
+
+    # The first argument is the command name.
+    cmd="$nonopt"
+    if test -z "$cmd"; then
+      $echo "$modename: you must specify a COMMAND" 1>&2
+      $echo "$help"
+      exit 1
+    fi
+
+    # Handle -dlopen flags immediately.
+    for file in $execute_dlfiles; do
+      if test ! -f "$file"; then
+	$echo "$modename: \`$file' is not a file" 1>&2
+	$echo "$help" 1>&2
+	exit 1
+      fi
+
+      dir=
+      case "$file" in
+      *.la)
+	# Check to see that this really is a libtool archive.
+	if (sed -e '2q' $file | egrep "^# Generated by .*$PACKAGE") >/dev/null 2>&1; then :
+	else
+	  $echo "$modename: \`$lib' is not a valid libtool archive" 1>&2
+	  $echo "$help" 1>&2
+	  exit 1
+	fi
+
+	# Read the libtool library.
+	dlname=
+	library_names=
+
+	# If there is no directory component, then add one.
+	case "$file" in
+	*/* | *\\*) . $file ;;
+	*) . ./$file ;;
+	esac
+
+	# Skip this library if it cannot be dlopened.
+	if test -z "$dlname"; then
+	  # Warn if it was a shared library.
+	  test -n "$library_names" && $echo "$modename: warning: \`$file' was not linked with \`-export-dynamic'"
+	  continue
+	fi
+
+	dir=`$echo "X$file" | $Xsed -e 's%/[^/]*$%%'`
+	test "X$dir" = "X$file" && dir=.
+
+	if test -f "$dir/$objdir/$dlname"; then
+	  dir="$dir/$objdir"
+	else
+	  $echo "$modename: cannot find \`$dlname' in \`$dir' or \`$dir/$objdir'" 1>&2
+	  exit 1
+	fi
+	;;
+
+      *.lo)
+	# Just add the directory containing the .lo file.
+	dir=`$echo "X$file" | $Xsed -e 's%/[^/]*$%%'`
+	test "X$dir" = "X$file" && dir=.
+	;;
+
+      *)
+	$echo "$modename: warning \`-dlopen' is ignored for non-libtool libraries and objects" 1>&2
+	continue
+	;;
+      esac
+
+      # Get the absolute pathname.
+      absdir=`cd "$dir" && pwd`
+      test -n "$absdir" && dir="$absdir"
+
+      # Now add the directory to shlibpath_var.
+      if eval "test -z \"\$$shlibpath_var\""; then
+	eval "$shlibpath_var=\"\$dir\""
+      else
+	eval "$shlibpath_var=\"\$dir:\$$shlibpath_var\""
+      fi
+    done
+
+    # This variable tells wrapper scripts just to set shlibpath_var
+    # rather than running their programs.
+    libtool_execute_magic="$magic"
+
+    # Check if any of the arguments is a wrapper script.
+    args=
+    for file
+    do
+      case "$file" in
+      -*) ;;
+      *)
+	# Do a test to see if this is really a libtool program.
+	if (sed -e '4q' $file | egrep "^# Generated by .*$PACKAGE") >/dev/null 2>&1; then
+	  # If there is no directory component, then add one.
+	  case "$file" in
+	  */* | *\\*) . $file ;;
+	  *) . ./$file ;;
+	  esac
+
+	  # Transform arg to wrapped name.
+	  file="$progdir/$program"
+	fi
+	;;
+      esac
+      # Quote arguments (to preserve shell metacharacters).
+      file=`$echo "X$file" | $Xsed -e "$sed_quote_subst"`
+      args="$args \"$file\""
+    done
+
+    if test -z "$run"; then
+      if test -n "$shlibpath_var"; then
+        # Export the shlibpath_var.
+        eval "export $shlibpath_var"
+      fi
+
+      # Restore saved enviroment variables
+      if test "${save_LC_ALL+set}" = set; then
+	LC_ALL="$save_LC_ALL"; export LC_ALL
+      fi
+      if test "${save_LANG+set}" = set; then
+	LANG="$save_LANG"; export LANG
+      fi
+
+      # Now actually exec the command.
+      eval "exec \$cmd$args"
+
+      $echo "$modename: cannot exec \$cmd$args"
+      exit 1
+    else
+      # Display what would be done.
+      if test -n "$shlibpath_var"; then
+        eval "\$echo \"\$shlibpath_var=\$$shlibpath_var\""
+        $echo "export $shlibpath_var"
+      fi
+      $echo "$cmd$args"
+      exit 0
+    fi
+    ;;
+
+  # libtool uninstall mode
+  uninstall)
+    modename="$modename: uninstall"
+    rm="$nonopt"
+    files=
+
+    for arg
+    do
+      case "$arg" in
+      -*) rm="$rm $arg" ;;
+      *) files="$files $arg" ;;
+      esac
+    done
+
+    if test -z "$rm"; then
+      $echo "$modename: you must specify an RM program" 1>&2
+      $echo "$help" 1>&2
+      exit 1
+    fi
+
+    for file in $files; do
+      dir=`$echo "X$file" | $Xsed -e 's%/[^/]*$%%'`
+      test "X$dir" = "X$file" && dir=.
+      name=`$echo "X$file" | $Xsed -e 's%^.*/%%'`
+
+      rmfiles="$file"
+
+      case "$name" in
+      *.la)
+	# Possibly a libtool archive, so verify it.
+	if (sed -e '2q' $file | egrep "^# Generated by .*$PACKAGE") >/dev/null 2>&1; then
+	  . $dir/$name
+
+	  # Delete the libtool libraries and symlinks.
+	  for n in $library_names; do
+	    rmfiles="$rmfiles $dir/$n"
+	  done
+	  test -n "$old_library" && rmfiles="$rmfiles $dir/$old_library"
+
+	  $show "$rm $rmfiles"
+	  $run $rm $rmfiles
+
+	  if test -n "$library_names"; then
+	    # Do each command in the postuninstall commands.
+	    eval cmds=\"$postuninstall_cmds\"
+	    IFS="${IFS= 	}"; save_ifs="$IFS"; IFS='~'
+	    for cmd in $cmds; do
+	      IFS="$save_ifs"
+	      $show "$cmd"
+	      $run eval "$cmd"
+	    done
+	    IFS="$save_ifs"
+	  fi
+
+	  if test -n "$old_library"; then
+	    # Do each command in the old_postuninstall commands.
+	    eval cmds=\"$old_postuninstall_cmds\"
+	    IFS="${IFS= 	}"; save_ifs="$IFS"; IFS='~'
+	    for cmd in $cmds; do
+	      IFS="$save_ifs"
+	      $show "$cmd"
+	      $run eval "$cmd"
+	    done
+	    IFS="$save_ifs"
+	  fi
+
+	  # FIXME: should reinstall the best remaining shared library.
+	fi
+	;;
+
+      *.lo)
+	if test "$build_old_libs" = yes; then
+	  oldobj=`$echo "X$name" | $Xsed -e "$lo2o"`
+	  rmfiles="$rmfiles $dir/$oldobj"
+	fi
+	$show "$rm $rmfiles"
+	$run $rm $rmfiles
+	;;
+
+      *)
+	$show "$rm $rmfiles"
+	$run $rm $rmfiles
+	;;
+      esac
+    done
+    exit 0
+    ;;
+
+  "")
+    $echo "$modename: you must specify a MODE" 1>&2
+    $echo "$generic_help" 1>&2
+    exit 1
+    ;;
+  esac
+
+  $echo "$modename: invalid operation mode \`$mode'" 1>&2
+  $echo "$generic_help" 1>&2
+  exit 1
+fi # test -z "$show_help"
+
+# We need to display help for each of the modes.
+case "$mode" in
+"") $echo \
+"Usage: $modename [OPTION]... [MODE-ARG]...
+
+Provide generalized library-building support services.
+
+    --config          show all configuration variables
+    --debug           enable verbose shell tracing
+-n, --dry-run         display commands without modifying any files
+    --features        display basic configuration information and exit
+    --finish          same as \`--mode=finish'
+    --help            display this help message and exit
+    --mode=MODE       use operation mode MODE [default=inferred from MODE-ARGS]
+    --quiet           same as \`--silent'
+    --silent          don't print informational messages
+    --version         print version information
+
+MODE must be one of the following:
+
+      compile         compile a source file into a libtool object
+      execute         automatically set library path, then run a program
+      finish          complete the installation of libtool libraries
+      install         install libraries or executables
+      link            create a library or an executable
+      uninstall       remove libraries from an installed directory
+
+MODE-ARGS vary depending on the MODE.  Try \`$modename --help --mode=MODE' for
+a more detailed description of MODE."
+  exit 0
+  ;;
+
+compile)
+  $echo \
+"Usage: $modename [OPTION]... --mode=compile COMPILE-COMMAND... SOURCEFILE
+
+Compile a source file into a libtool library object.
+
+This mode accepts the following additional options:
+
+  -o OUTPUT-FILE    set the output file name to OUTPUT-FILE
+  -static           always build a \`.o' file suitable for static linking
+
+COMPILE-COMMAND is a command to be used in creating a \`standard' object file
+from the given SOURCEFILE.
+
+The output file name is determined by removing the directory component from
+SOURCEFILE, then substituting the C source code suffix \`.c' with the
+library object suffix, \`.lo'."
+  ;;
+
+execute)
+  $echo \
+"Usage: $modename [OPTION]... --mode=execute COMMAND [ARGS]...
+
+Automatically set library path, then run a program.
+
+This mode accepts the following additional options:
+
+  -dlopen FILE      add the directory containing FILE to the library path
+
+This mode sets the library path environment variable according to \`-dlopen'
+flags.
+
+If any of the ARGS are libtool executable wrappers, then they are translated
+into their corresponding uninstalled binary, and any of their required library
+directories are added to the library path.
+
+Then, COMMAND is executed, with ARGS as arguments."
+  ;;
+
+finish)
+  $echo \
+"Usage: $modename [OPTION]... --mode=finish [LIBDIR]...
+
+Complete the installation of libtool libraries.
+
+Each LIBDIR is a directory that contains libtool libraries.
+
+The commands that this mode executes may require superuser privileges.  Use
+the \`--dry-run' option if you just want to see what would be executed."
+  ;;
+
+install)
+  $echo \
+"Usage: $modename [OPTION]... --mode=install INSTALL-COMMAND...
+
+Install executables or libraries.
+
+INSTALL-COMMAND is the installation command.  The first component should be
+either the \`install' or \`cp' program.
+
+The rest of the components are interpreted as arguments to that command (only
+BSD-compatible install options are recognized)."
+  ;;
+
+link)
+  $echo \
+"Usage: $modename [OPTION]... --mode=link LINK-COMMAND...
+
+Link object files or libraries together to form another library, or to
+create an executable program.
+
+LINK-COMMAND is a command using the C compiler that you would use to create
+a program from several object files.
+
+The following components of LINK-COMMAND are treated specially:
+
+  -all-static       do not do any dynamic linking at all
+  -avoid-version    do not add a version suffix if possible
+  -dlopen FILE      \`-dlpreopen' FILE if it cannot be dlopened at runtime
+  -dlpreopen FILE   link in FILE and add its symbols to lt_preloaded_symbols
+  -export-dynamic   allow symbols from OUTPUT-FILE to be resolved with dlsym(3)
+  -export-symbols SYMFILE
+		    try to export only the symbols listed in SYMFILE
+  -export-symbols-regex REGEX
+		    try to export only the symbols matching REGEX
+  -LLIBDIR          search LIBDIR for required installed libraries
+  -lNAME            OUTPUT-FILE requires the installed library libNAME
+  -module           build a library that can dlopened
+  -no-undefined     declare that a library does not refer to external symbols
+  -o OUTPUT-FILE    create OUTPUT-FILE from the specified objects
+  -release RELEASE  specify package release information
+  -rpath LIBDIR     the created library will eventually be installed in LIBDIR
+  -R[ ]LIBDIR       add LIBDIR to the runtime path of programs and libraries
+  -static           do not do any dynamic linking of libtool libraries
+  -version-info CURRENT[:REVISION[:AGE]]
+		    specify library version info [each variable defaults to 0]
+
+All other options (arguments beginning with \`-') are ignored.
+
+Every other argument is treated as a filename.  Files ending in \`.la' are
+treated as uninstalled libtool libraries, other files are standard or library
+object files.
+
+If the OUTPUT-FILE ends in \`.la', then a libtool library is created,
+only library objects (\`.lo' files) may be specified, and \`-rpath' is
+required, except when creating a convenience library.
+
+If OUTPUT-FILE ends in \`.a' or \`.lib', then a standard library is created
+using \`ar' and \`ranlib', or on Windows using \`lib'.
+
+If OUTPUT-FILE ends in \`.lo' or \`.${objext}', then a reloadable object file
+is created, otherwise an executable program is created."
+  ;;
+
+uninstall)
+  $echo \
+"Usage: $modename [OPTION]... --mode=uninstall RM [RM-OPTION]... FILE...
+
+Remove libraries from an installation directory.
+
+RM is the name of the program to use to delete files associated with each FILE
+(typically \`/bin/rm').  RM-OPTIONS are options (such as \`-f') to be passed
+to RM.
+
+If FILE is a libtool library, all the files associated with it are deleted.
+Otherwise, only FILE itself is deleted using RM."
+  ;;
+
+*)
+  $echo "$modename: invalid operation mode \`$mode'" 1>&2
+  $echo "$help" 1>&2
+  exit 1
+  ;;
+esac
+
+echo
+$echo "Try \`$modename --help' for more information about other modes."
+
+exit 0
+
+# Local Variables:
+# mode:shell-script
+# sh-indentation:2
+# End:
Index: ossp-pkg/pth/pth-config.1
RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/pth-config.1,v
co -q -kk -p'1.133' '/v/ossp/cvs/ossp-pkg/pth/Attic/pth-config.1,v' | diff -u - /dev/null -L'ossp-pkg/pth/pth-config.1' 2>/dev/null
--- ossp-pkg/pth/pth-config.1
+++ /dev/null	2024-05-14 08:37:11.000000000 +0200
@@ -1,247 +0,0 @@
-.\" Automatically generated by Pod::Man version 1.15
-.\" Sun Jan 27 17:13:12 2002
-.\"
-.\" Standard preamble:
-.\" ======================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.de Vb \" Begin verbatim text
-.ft CW
-.nf
-.ne \\$1
-..
-.de Ve \" End verbatim text
-.ft R
-
-.fi
-..
-.\" Set up some character translations and predefined strings.  \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote.  | will give a
-.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used
-.\" to do unbreakable dashes and therefore won't be available.  \*(C` and
-.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
-.tr \(*W-|\(bv\*(Tr
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.ie n \{\
-.    ds -- \(*W-
-.    ds PI pi
-.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
-.    ds L" ""
-.    ds R" ""
-.    ds C` ""
-.    ds C' ""
-'br\}
-.el\{\
-.    ds -- \|\(em\|
-.    ds PI \(*p
-.    ds L" ``
-.    ds R" ''
-'br\}
-.\"
-.\" If the F register is turned on, we'll generate index entries on stderr
-.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
-.\" index entries marked with X<> in POD.  Of course, you'll have to process
-.\" the output yourself in some meaningful fashion.
-.if \nF \{\
-.    de IX
-.    tm Index:\\$1\t\\n%\t"\\$2"
-..
-.    nr % 0
-.    rr F
-.\}
-.\"
-.\" For nroff, turn off justification.  Always turn off hyphenation; it
-.\" makes way too many mistakes in technical documents.
-.hy 0
-.if n .na
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
-.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
-.bd B 3
-.    \" fudge factors for nroff and troff
-.if n \{\
-.    ds #H 0
-.    ds #V .8m
-.    ds #F .3m
-.    ds #[ \f1
-.    ds #] \fP
-.\}
-.if t \{\
-.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-.    ds #V .6m
-.    ds #F 0
-.    ds #[ \&
-.    ds #] \&
-.\}
-.    \" simple accents for nroff and troff
-.if n \{\
-.    ds ' \&
-.    ds ` \&
-.    ds ^ \&
-.    ds , \&
-.    ds ~ ~
-.    ds /
-.\}
-.if t \{\
-.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-.    \" troff and (daisy-wheel) nroff accents
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-.    \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-.    \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-.    ds : e
-.    ds 8 ss
-.    ds o a
-.    ds d- d\h'-1'\(ga
-.    ds D- D\h'-1'\(hy
-.    ds th \o'bp'
-.    ds Th \o'LP'
-.    ds ae ae
-.    ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
-.\" ======================================================================
-.\"
-.IX Title "PTH-CONFIG 1"
-.TH PTH-CONFIG 1 "27-Jan-2002" "GNU Pth 1.5b1" "GNU Portable Threads"
-.UC
-.SH "NAME"
-\&\fBpth-config\fR \- Pth library build utility
-.SH "VERSION"
-.IX Header "VERSION"
-\&\s-1GNU\s0 Pth \s-11.5b1 (27-Jan-2002)\s0
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-\&\fBpth-config\fR
-[\fB\*(--help\fR]
-[\fB\*(--version\fR]
-[\fB\*(--all\fR]
-[\fB\*(--prefix\fR]
-[\fB\*(--exec-prefix\fR]
-[\fB\*(--bindir\fR]
-[\fB\*(--libdir\fR]
-[\fB\*(--includedir\fR]
-[\fB\*(--mandir\fR]
-[\fB\*(--datadir\fR]
-[\fB\*(--acdir\fR]
-[\fB\*(--cflags\fR]
-[\fB\*(--ldflags\fR]
-[\fB\*(--libs\fR]
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The \fBpth-config\fR program is a little helper utility for easy configuring and
-building applications based on the \fIpth\fR\|(3) library.  It can be used to query the
-C compiler and linker flags which are required to correctly compile and link
-the application against the \fIpth\fR\|(3) library.
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-\&\fBpth-config\fR accepts the following options:
-.Ip "\fB\*(--help\fR" 4
-.IX Item "help"
-Prints the short usage information.
-.Ip "\fB\*(--version\fR" 4
-.IX Item "version"
-Prints the version number and date of the installed \fIpth\fR\|(3) library.
-.Ip "\fB\*(--all\fR" 4
-.IX Item "all"
-Forces the output of all flags, that is, including extra flags which are not
-\&\fBPth\fR specific.
-.Ip "\fB\*(--prefix\fR" 4
-.IX Item "prefix"
-Prints the installation prefix of architecture independent files
-.Ip "\fB\*(--exec-prefix\fR" 4
-.IX Item "exec-prefix"
-Prints the installation prefix of architecture dependent files.
-.Ip "\fB\*(--bindir\fR" 4
-.IX Item "bindir"
-Prints the installation directory of binaries.
-.Ip "\fB\*(--libdir\fR" 4
-.IX Item "libdir"
-Prints the installation directory of libraries.
-.Ip "\fB\*(--includedir\fR" 4
-.IX Item "includedir"
-Prints the installation directory of include headers.
-.Ip "\fB\*(--mandir\fR" 4
-.IX Item "mandir"
-Prints the installation directory of manual pages.
-.Ip "\fB\*(--datadir\fR" 4
-.IX Item "datadir"
-Prints the installation directory of shared data.
-.Ip "\fB\*(--acdir\fR" 4
-.IX Item "acdir"
-Prints the installation directory of \fBautoconf\fR data.
-.Ip "\fB\*(--cflags\fR" 4
-.IX Item "cflags"
-Prints the C compiler flags which are needed to compile the \fIpth\fR\|(3)\-based
-application. The output is usually added to the \f(CW\*(C`CFLAGS\*(C'\fR variable of the
-applications \f(CW\*(C`Makefile\*(C'\fR.
-.Ip "\fB\*(--ldflags\fR" 4
-.IX Item "ldflags"
-Prints the linker flags (\f(CW\*(C`\-L\*(C'\fR) which are needed to link the application with
-the \fIpth\fR\|(3) library. The output is usually added to the \f(CW\*(C`LDFLAGS\*(C'\fR variable of
-the applications \f(CW\*(C`Makefile\*(C'\fR.
-.Ip "\fB\*(--libs\fR" 4
-.IX Item "libs"
-Prints the library flags (\f(CW\*(C`\-l\*(C'\fR) which are needed to link the application with
-the \fIpth\fR\|(3) library. The output is usually added to the \f(CW\*(C`LIBS\*(C'\fR variable of the
-applications \f(CW\*(C`Makefile\*(C'\fR.
-.SH "EXAMPLE"
-.IX Header "EXAMPLE"
-.Vb 4
-\& CC      = cc
-\& CFLAGS  = -O `pth-config --cflags`
-\& LDFLAGS = `pth-config --ldflags`
-\& LIBS    = -lm `pth-config --libs`
-.Ve
-.Vb 5
-\& all: foo
-\& foo: foo.o
-\&     $(CC) $(LDFLAGS) -o foo foo.o $(LIBS)
-\& foo.o: foo.c
-\&     $(CC) $(CFLAGS) -c foo.c
-.Ve
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fIpth\fR\|(3), \fIcc\fR\|(1).
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-.Vb 3
-\& Ralf S. Engelschall
-\& rse@engelschall.com
-\& www.engelschall.com
-.Ve
Index: ossp-pkg/pth/pth.3
RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/pth.3,v
co -q -kk -p'1.233' '/v/ossp/cvs/ossp-pkg/pth/Attic/pth.3,v' | diff -u - /dev/null -L'ossp-pkg/pth/pth.3' 2>/dev/null
--- ossp-pkg/pth/pth.3
+++ /dev/null	2024-05-14 08:37:11.000000000 +0200
@@ -1,2239 +0,0 @@
-.\" Automatically generated by Pod::Man version 1.15
-.\" Sun Jan 27 17:13:13 2002
-.\"
-.\" Standard preamble:
-.\" ======================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.de Vb \" Begin verbatim text
-.ft CW
-.nf
-.ne \\$1
-..
-.de Ve \" End verbatim text
-.ft R
-
-.fi
-..
-.\" Set up some character translations and predefined strings.  \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote.  | will give a
-.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used
-.\" to do unbreakable dashes and therefore won't be available.  \*(C` and
-.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
-.tr \(*W-|\(bv\*(Tr
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.ie n \{\
-.    ds -- \(*W-
-.    ds PI pi
-.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
-.    ds L" ""
-.    ds R" ""
-.    ds C` ""
-.    ds C' ""
-'br\}
-.el\{\
-.    ds -- \|\(em\|
-.    ds PI \(*p
-.    ds L" ``
-.    ds R" ''
-'br\}
-.\"
-.\" If the F register is turned on, we'll generate index entries on stderr
-.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
-.\" index entries marked with X<> in POD.  Of course, you'll have to process
-.\" the output yourself in some meaningful fashion.
-.if \nF \{\
-.    de IX
-.    tm Index:\\$1\t\\n%\t"\\$2"
-..
-.    nr % 0
-.    rr F
-.\}
-.\"
-.\" For nroff, turn off justification.  Always turn off hyphenation; it
-.\" makes way too many mistakes in technical documents.
-.hy 0
-.if n .na
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
-.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
-.bd B 3
-.    \" fudge factors for nroff and troff
-.if n \{\
-.    ds #H 0
-.    ds #V .8m
-.    ds #F .3m
-.    ds #[ \f1
-.    ds #] \fP
-.\}
-.if t \{\
-.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-.    ds #V .6m
-.    ds #F 0
-.    ds #[ \&
-.    ds #] \&
-.\}
-.    \" simple accents for nroff and troff
-.if n \{\
-.    ds ' \&
-.    ds ` \&
-.    ds ^ \&
-.    ds , \&
-.    ds ~ ~
-.    ds /
-.\}
-.if t \{\
-.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-.    \" troff and (daisy-wheel) nroff accents
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-.    \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-.    \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-.    ds : e
-.    ds 8 ss
-.    ds o a
-.    ds d- d\h'-1'\(ga
-.    ds D- D\h'-1'\(hy
-.    ds th \o'bp'
-.    ds Th \o'LP'
-.    ds ae ae
-.    ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
-.\" ======================================================================
-.\"
-.IX Title "pth 3"
-.TH pth 3 "27-Jan-2002" "GNU Pth 1.5b1" "GNU Portable Threads"
-.UC
-.SH "NAME"
-\&\fBpth\fR \- \s-1GNU\s0 Portable Threads
-.SH "VERSION"
-.IX Header "VERSION"
-\&\s-1GNU\s0 Pth \s-11.5b1 (27-Jan-2002)\s0
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-.Ip "\fBGlobal Library Management\fR" 4
-.IX Item "Global Library Management"
-pth_init,
-pth_kill,
-pth_ctrl,
-pth_version.
-.Ip "\fBThread Attribute Handling\fR" 4
-.IX Item "Thread Attribute Handling"
-pth_attr_of,
-pth_attr_new,
-pth_attr_init,
-pth_attr_set,
-pth_attr_get,
-pth_attr_destroy.
-.Ip "\fBThread Control\fR" 4
-.IX Item "Thread Control"
-pth_spawn,
-pth_once,
-pth_self,
-pth_suspend,
-pth_resume,
-pth_yield,
-pth_nap,
-pth_wait,
-pth_cancel,
-pth_abort,
-pth_raise,
-pth_join,
-pth_exit.
-.Ip "\fBUtilities\fR" 4
-.IX Item "Utilities"
-pth_fdmode,
-pth_time,
-pth_timeout,
-pth_sfiodisc.
-.Ip "\fBCancellation Management\fR" 4
-.IX Item "Cancellation Management"
-pth_cancel_point,
-pth_cancel_state.
-.Ip "\fBEvent Handling\fR" 4
-.IX Item "Event Handling"
-pth_event,
-pth_event_typeof,
-pth_event_extract,
-pth_event_concat,
-pth_event_isolate,
-pth_event_walk,
-pth_event_occurred,
-pth_event_free.
-.Ip "\fBKey-Based Storage\fR" 4
-.IX Item "Key-Based Storage"
-pth_key_create,
-pth_key_delete,
-pth_key_setdata,
-pth_key_getdata.
-.Ip "\fBMessage Port Communication\fR" 4
-.IX Item "Message Port Communication"
-pth_msgport_create,
-pth_msgport_destroy,
-pth_msgport_find,
-pth_msgport_pending,
-pth_msgport_put,
-pth_msgport_get,
-pth_msgport_reply.
-.Ip "\fBThread Cleanups\fR" 4
-.IX Item "Thread Cleanups"
-pth_cleanup_push,
-pth_cleanup_pop.
-.Ip "\fBProcess Forking\fR" 4
-.IX Item "Process Forking"
-pth_atfork_push,
-pth_atfork_pop,
-pth_fork.
-.Ip "\fBSynchronization\fR" 4
-.IX Item "Synchronization"
-pth_mutex_init,
-pth_mutex_acquire,
-pth_mutex_release,
-pth_rwlock_init,
-pth_rwlock_acquire,
-pth_rwlock_release,
-pth_cond_init,
-pth_cond_await,
-pth_cond_notify,
-pth_barrier_init,
-pth_barrier_reach.
-.Ip "\fBGeneralized \s-1POSIX\s0 Replacement \s-1API\s0\fR" 4
-.IX Item "Generalized POSIX Replacement API"
-pth_sigwait_ev,
-pth_accept_ev,
-pth_connect_ev,
-pth_select_ev,
-pth_poll_ev,
-pth_read_ev,
-pth_readv_ev,
-pth_write_ev,
-pth_writev_ev,
-pth_recv_ev,
-pth_recvfrom_ev,
-pth_send_ev,
-pth_sendto_ev.
-.Ip "\fBStandard \s-1POSIX\s0 Replacement \s-1API\s0\fR" 4
-.IX Item "Standard POSIX Replacement API"
-pth_usleep,
-pth_sleep,
-pth_waitpid,
-pth_system,
-pth_sigmask,
-pth_sigwait,
-pth_accept,
-pth_connect,
-pth_select,
-pth_poll,
-pth_read,
-pth_readv,
-pth_write,
-pth_writev,
-pth_pread,
-pth_pwrite,
-pth_recv,
-pth_recvfrom,
-pth_send,
-pth_sendto.
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-.Vb 5
-\&  ____  _   _
-\& |  _ \e| |_| |__
-\& | |_) | __| '_ \e         ``Only those who attempt
-\& |  __/| |_| | | |          the absurd can achieve
-\& |_|    \e__|_| |_|          the impossible.''
-.Ve
-\&\fBPth\fR is a very portable \s-1POSIX/ANSI-C\s0 based library for Unix platforms which
-provides non-preemptive priority-based scheduling for multiple threads of
-execution (aka `multithreading') inside event-driven applications. All threads
-run in the same address space of the application process, but each thread has
-its own individual program counter, run-time stack, signal mask and \f(CW\*(C`errno\*(C'\fR
-variable.
-.PP
-The thread scheduling itself is done in a cooperative way, i.e., the threads
-are managed and dispatched by a priority- and event-driven non-preemptive
-scheduler. The intention is that this way both better portability and run-time
-performance is achieved than with preemptive scheduling. The event facility
-allows threads to wait until various types of internal and external events
-occur, including pending I/O on file descriptors, asynchronous signals,
-elapsed timers, pending I/O on message ports, thread and process termination,
-and even results of customized callback functions.
-.PP
-\&\fBPth\fR also provides an optional emulation \s-1API\s0 for \s-1POSIX\s0.1c threads
-(`Pthreads') which can be used for backward compatibility to existing
-multithreaded applications. See \fBPth\fR's \fIpthread\fR\|(3) manual page for
-details.
-.Sh "Threading Background"
-.IX Subsection "Threading Background"
-When programming event-driven applications, usually servers, lots of
-regular jobs and one-shot requests have to be processed in parallel.
-To efficiently simulate this parallel processing on uniprocessor
-machines, we use `multitasking' \*(-- that is, we have the application
-ask the operating system to spawn multiple instances of itself. On
-Unix, typically the kernel implements multitasking in a preemptive and
-priority-based way through heavy-weight processes spawned with \fIfork\fR\|(2).
-These processes usually do \fInot\fR share a common address space. Instead
-they are clearly separated from each other, and are created by direct
-cloning a process address space (although modern kernels use memory
-segment mapping and copy-on-write semantics to avoid unnecessary copying
-of physical memory).
-.PP
-The drawbacks are obvious: Sharing data between the processes is
-complicated, and can usually only be done efficiently through shared
-memory (but which itself is not very portable). Synchronization is
-complicated because of the preemptive nature of the Unix scheduler
-(one has to use \fIatomic\fR locks, etc). The machine's resources can be
-exhausted very quickly when the server application has to serve too many
-long-running requests (heavy-weight processes cost memory). And when
-each request spawns a sub-process to handle it, the server performance
-and responsiveness is horrible (heavy-weight processes cost time to
-spawn). Finally, the server application doesn't scale very well with the
-load because of these resource problems. In practice, lots of tricks
-are usually used to overcome these problems \- ranging from pre-forked
-sub-process pools to semi-serialized processing, etc.
-.PP
-One of the most elegant ways to solve these resource- and data-sharing
-problems is to have multiple \fIlight-weight\fR threads of execution
-inside a single (heavy-weight) process, i.e., to use \fImultithreading\fR.
-Those \fIthreads\fR usually improve responsiveness and performance of the
-application, often improve and simplify the internal program structure,
-and most important, require less system resources than heavy-weight
-processes. Threads are neither the optimal run-time facility for all
-types of applications, nor can all applications benefit from them. But
-at least event-driven server applications usually benefit greatly from
-using threads.
-.Sh "The World of Threading"
-.IX Subsection "The World of Threading"
-Even though lots of documents exists which describe and define the world
-of threading, to understand \fBPth\fR, you need only basic knowledge about
-threading. The following definitions of thread-related terms should at
-least help you understand thread programming enough to allow you to use
-\&\fBPth\fR.
-.Ip "\fBo\fR \fBprocess\fR vs. \fBthread\fR" 2
-.IX Item "o process vs. thread"
-A process on Unix systems consists of at least the following fundamental
-ingredients: \fIvirtual memory table\fR, \fIprogram code\fR, \fIprogram
-counter\fR, \fIheap memory\fR, \fIstack memory\fR, \fIstack pointer\fR, \fIfile
-descriptor set\fR, \fIsignal table\fR. On every process switch, the kernel
-saves and restores these ingredients for the individual processes. On
-the other hand, a thread consists of only a private program counter,
-stack memory, stack pointer and signal table. All other ingredients, in
-particular the virtual memory, it shares with the other threads of the
-same process.
-.Ip "\fBo\fR \fBkernel-space\fR vs. \fBuser-space\fR threading" 2
-.IX Item "o kernel-space vs. user-space threading"
-Threads on a Unix platform traditionally can be implemented either
-inside kernel-space or user-space. When threads are implemented by the
-kernel, the thread context switches are performed by the kernel without
-the application's knowledge. Similarly, when threads are implemented in
-user-space, the thread context switches are performed by an application
-library, without the kernel's knowledge. There also are hybrid threading
-approaches where, typically, a user-space library binds one or more
-user-space threads to one or more kernel-space threads (there usually
-called light-weight processes \- or in short LWPs).
-.Sp
-User-space threads are usually more portable and can perform faster
-and cheaper context switches (for instance via \fIswapcontext\fR\|(2) or
-\&\fIsetjmp\fR\|(3)/\fIlongjmp\fR\|(3)) than kernel based threads. On the other hand,
-kernel-space threads can take advantage of multiprocessor machines and
-don't have any inherent I/O blocking problems. Kernel-space threads are
-usually scheduled in preemptive way side-by-side with the underlying
-processes. User-space threads on the other hand use either preemptive or
-non-preemptive scheduling.
-.Ip "\fBo\fR \fBpreemptive\fR vs. \fBnon-preemptive\fR thread scheduling" 2
-.IX Item "o preemptive vs. non-preemptive thread scheduling"
-In preemptive scheduling, the scheduler lets a thread execute until a
-blocking situation occurs (usually a function call which would block)
-or the assigned timeslice elapses. Then it detracts control from the
-thread without a chance for the thread to object. This is usually
-realized by interrupting the thread through a hardware interrupt
-signal (for kernel-space threads) or a software interrupt signal (for
-user-space threads), like \f(CW\*(C`SIGALRM\*(C'\fR or \f(CW\*(C`SIGVTALRM\*(C'\fR. In non-preemptive
-scheduling, once a thread received control from the scheduler it keeps
-it until either a blocking situation occurs (again a function call which
-would block and instead switches back to the scheduler) or the thread
-explicitly yields control back to the scheduler in a cooperative way.
-.Ip "\fBo\fR \fBconcurrency\fR vs. \fBparallelism\fR" 2
-.IX Item "o concurrency vs. parallelism"
-Concurrency exists when at least two threads are \fIin progress\fR at the
-same time. Parallelism arises when at least two threads are \fIexecuting\fR
-simultaneously. Real parallelism can be only achieved on multiprocessor
-machines, of course. But one also usually speaks of parallelism or
-\&\fIhigh concurrency\fR in the context of preemptive thread scheduling
-and of \fIlow concurrency\fR in the context of non-preemptive thread
-scheduling.
-.Ip "\fBo\fR \fBresponsiveness\fR" 2
-.IX Item "o responsiveness"
-The responsiveness of a system can be described by the user visible
-delay until the system responses to an external request. When this delay
-is small enough and the user doesn't recognize a noticeable delay,
-the responsiveness of the system is considered good. When the user
-recognizes or is even annoyed by the delay, the responsiveness of the
-system is considered bad.
-.Ip "\fBo\fR \fBreentrant\fR, \fBthread-safe\fR and \fBasynchronous-safe\fR functions" 2
-.IX Item "o reentrant, thread-safe and asynchronous-safe functions"
-A reentrant function is one that behaves correctly if it is called
-simultaneously by several threads and then also executes simultaneously.
-Functions that access global state, such as memory or files, of course,
-need to be carefully designed in order to be reentrant. Two traditional
-approaches to solve these problems are caller-supplied states and
-thread-specific data.
-.Sp
-Thread-safety is the avoidance of \fIdata races\fR, i.e., situations
-in which data is set to either correct or incorrect value depending
-upon the (unpredictable) order in which multiple threads access and
-modify the data. So a function is thread-safe when it still behaves
-semantically correct when called simultaneously by several threads (it
-is not required that the functions also execute simultaneously). The
-traditional approach to achieve thread-safety is to wrap a function body
-with an internal mutual exclusion lock (aka `mutex'). As you should
-recognize, reentrant is a stronger attribute than thread-safe, because
-it is harder to achieve and results especially in no run-time contention
-between threads. So, a reentrant function is always thread-safe, but not
-vice versa.
-.Sp
-Additionally there is a related attribute for functions named
-asynchronous-safe, which comes into play in conjunction with signal
-handlers. This is very related to the problem of reentrant functions. An
-asynchronous-safe function is one that can be called safe and without
-side-effects from within a signal handler context. Usually very few
-functions are of this type, because an application is very restricted in
-what it can perform from within a signal handler (especially what system
-functions it is allowed to call). The reason mainly is, because only a
-few system functions are officially declared by \s-1POSIX\s0 as guaranteed to
-be asynchronous-safe. Asynchronous-safe functions usually have to be
-already reentrant.
-.Sh "User-Space Threads"
-.IX Subsection "User-Space Threads"
-User-space threads can be implemented in various way. The two
-traditional approaches are:
-.Ip "\fB1.\fR" 3
-.IX Item "1."
-\&\fBMatrix-based explicit dispatching between small units of execution:\fR
-.Sp
-Here the global procedures of the application are split into small
-execution units (each is required to not run for more than a few
-milliseconds) and those units are implemented by separate functions.
-Then a global matrix is defined which describes the execution (and
-perhaps even dependency) order of these functions. The main server
-procedure then just dispatches between these units by calling one
-function after each other controlled by this matrix. The threads are
-created by more than one jump-trail through this matrix and by switching
-between these jump-trails controlled by corresponding occurred events.
-.Sp
-This approach gives the best possible performance, because one can
-fine-tune the threads of execution by adjusting the matrix, and the
-scheduling is done explicitly by the application itself. It is also very
-portable, because the matrix is just an ordinary data structure, and
-functions are a standard feature of \s-1ANSI\s0 C.
-.Sp
-The disadvantage of this approach is that it is complicated to write
-large applications with this approach, because in those applications
-one quickly gets \fIhundreds\fR\|(!) of execution units and the control flow
-inside such an application is very hard to understand (because it is
-interrupted by function borders and one always has to remember the
-global dispatching matrix to follow it). Additionally, all threads
-operate on the same execution stack. Although this saves memory, it is
-often nasty, because one cannot switch between threads in the middle of
-a function. Thus the scheduling borders are the function borders.
-.Ip "\fB2.\fR" 3
-.IX Item "2."
-\&\fBContext-based implicit scheduling between threads of execution:\fR
-.Sp
-Here the idea is that one programs the application as with forked
-processes, i.e., one spawns a thread of execution and this runs from the
-begin to the end without an interrupted control flow. But the control
-flow can be still interrupted \- even in the middle of a function.
-Actually in a preemptive way, similar to what the kernel does for the
-heavy-weight processes, i.e., every few milliseconds the user-space
-scheduler switches between the threads of execution. But the thread
-itself doesn't recognize this and usually (except for synchronization
-issues) doesn't have to care about this.
-.Sp
-The advantage of this approach is that it's very easy to program,
-because the control flow and context of a thread directly follows
-a procedure without forced interrupts through function borders.
-Additionally, the programming is very similar to a traditional and well
-understood \fIfork\fR\|(2) based approach.
-.Sp
-The disadvantage is that although the general performance is increased,
-compared to using approaches based on heavy-weight processes, it is decreased
-compared to the matrix-approach above. Because the implicit preemptive
-scheduling does usually a lot more context switches (every user-space context
-switch costs some overhead even when it is a lot cheaper than a kernel-level
-context switch) than the explicit cooperative/non-preemptive scheduling.
-Finally, there is no really portable \s-1POSIX/ANSI-C\s0 based way to implement
-user-space preemptive threading. Either the platform already has threads,
-or one has to hope that some semi-portable package exists for it. And
-even those semi-portable packages usually have to deal with assembler
-code and other nasty internals and are not easy to port to forthcoming
-platforms.
-.PP
-So, in short: the matrix-dispatching approach is portable and fast, but
-nasty to program. The thread scheduling approach is easy to program,
-but suffers from synchronization and portability problems caused by its
-preemptive nature.
-.Sh "The Compromise of Pth"
-.IX Subsection "The Compromise of Pth"
-But why not combine the good aspects of both approaches while avoiding
-their bad aspects? That's the goal of \fBPth\fR. \fBPth\fR implements
-easy-to-program threads of execution, but avoids the problems of
-preemptive scheduling by using non-preemptive scheduling instead.
-.PP
-This sounds like, and is, a useful approach. Nevertheless, one has to
-keep the implications of non-preemptive thread scheduling in mind when
-working with \fBPth\fR. The following list summarizes a few essential
-points:
-.Ip "\fBo\fR" 2
-.IX Item "o"
-\&\fBPth provides maximum portability, but \s-1NOT\s0 the fanciest features\fR.
-.Sp
-This is, because it uses a nifty and portable \s-1POSIX/ANSI-C\s0 approach for
-thread creation (and this way doesn't require any platform dependent
-assembler hacks) and schedules the threads in non-preemptive way (which
-doesn't require unportable facilities like \f(CW\*(C`SIGVTALRM\*(C'\fR). On the other
-hand, this way not all fancy threading features can be implemented.
-Nevertheless the available facilities are enough to provide a robust and
-full-featured threading system.
-.Ip "\fBo\fR" 2
-.IX Item "o"
-\&\fBPth increases the responsiveness and concurrency of an event-driven
-application, but \s-1NOT\s0 the concurrency of number-crunching applications\fR.
-.Sp
-The reason is the non-preemptive scheduling. Number-crunching
-applications usually require preemptive scheduling to achieve
-concurrency because of their long \s-1CPU\s0 bursts. For them, non-preemptive
-scheduling (even together with explicit yielding) provides only the old
-concept of `coroutines'. On the other hand, event driven applications
-benefit greatly from non-preemptive scheduling. They have only short
-\&\s-1CPU\s0 bursts and lots of events to wait on, and this way run faster under
-non-preemptive scheduling because no unnecessary context switching
-occurs, as it is the case for preemptive scheduling. That's why \fBPth\fR
-is mainly intended for server type applications, although there is no
-technical restriction.
-.Ip "\fBo\fR" 2
-.IX Item "o"
-\&\fBPth requires thread-safe functions, but \s-1NOT\s0 reentrant functions\fR.
-.Sp
-This nice fact exists again because of the nature of non-preemptive
-scheduling, where a function isn't interrupted and this way cannot be
-reentered before it returned. This is a great portability benefit,
-because thread-safety can be achieved more easily than reentrance
-possibility. Especially this means that under \fBPth\fR more existing
-third-party libraries can be used without side-effects than its the case
-for other threading systems.
-.Ip "\fBo\fR" 2
-.IX Item "o"
-\&\fBPth doesn't require any kernel support, but can \s-1NOT\s0
-benefit from multiprocessor machines\fR.
-.Sp
-This means that \fBPth\fR runs on almost all Unix kernels, because the
-kernel does not need to be aware of the \fBPth\fR threads (because they
-are implemented entirely in user-space). On the other hand, it cannot
-benefit from the existence of multiprocessors, because for this, kernel
-support would be needed. In practice, this is no problem, because
-multiprocessor systems are rare, and portability is almost more
-important than highest concurrency.
-.Sh "The life cycle of a thread"
-.IX Subsection "The life cycle of a thread"
-To understand the \fBPth\fR Application Programming Interface (\s-1API\s0), it
-helps to first understand the life cycle of a thread in the \fBPth\fR
-threading system. It can be illustrated with the following directed
-graph:
-.PP
-.Vb 10
-\&             NEW
-\&              |
-\&              V
-\&      +---> READY ---+
-\&      |       ^      |
-\&      |       |      V
-\&   WAITING <--+-- RUNNING
-\&                     |
-\&      :              V
-\&   SUSPENDED       DEAD
-.Ve
-When a new thread is created, it is moved into the \fB\s-1NEW\s0\fR queue of the
-scheduler. On the next dispatching for this thread, the scheduler picks
-it up from there and moves it to the \fB\s-1READY\s0\fR queue. This is a queue
-containing all threads which want to perform a \s-1CPU\s0 burst. There they are
-queued in priority order. On each dispatching step, the scheduler always
-removes the thread with the highest priority only. It then increases the
-priority of all remaining threads by 1, to prevent them from `starving'.
-.PP
-The thread which was removed from the \fB\s-1READY\s0\fR queue is the new
-\&\fB\s-1RUNNING\s0\fR thread (there is always just one \fB\s-1RUNNING\s0\fR thread, of
-course). The \fB\s-1RUNNING\s0\fR thread is assigned execution control. After
-this thread yields execution (either explicitly by yielding execution
-or implicitly by calling a function which would block) there are three
-possibilities: Either it has terminated, then it is moved to the \fB\s-1DEAD\s0\fR
-queue, or it has events on which it wants to wait, then it is moved into
-the \fB\s-1WAITING\s0\fR queue. Else it is assumed it wants to perform more \s-1CPU\s0
-bursts and immediately enters the \fB\s-1READY\s0\fR queue again.
-.PP
-Before the next thread is taken out of the \fB\s-1READY\s0\fR queue, the
-\&\fB\s-1WAITING\s0\fR queue is checked for pending events. If one or more events
-occurred, the threads that are waiting on them are immediately moved to
-the \fB\s-1READY\s0\fR queue.
-.PP
-The purpose of the \fB\s-1NEW\s0\fR queue has to do with the fact that in \fBPth\fR
-a thread never directly switches to another thread. A thread always
-yields execution to the scheduler and the scheduler dispatches to the
-next thread. So a freshly spawned thread has to be kept somewhere until
-the scheduler gets a chance to pick it up for scheduling. That is for
-what the \fB\s-1NEW\s0\fR queue is for. 
-.PP
-The purpose of the \fB\s-1DEAD\s0\fR queue is to support thread joining. When a
-thread is marked to be unjoinable, it is directly kicked out of the
-system after it terminated. But when it is joinable, it enters the
-\&\fB\s-1DEAD\s0\fR queue. There it remains until another thread joins it.
-.PP
-Finally, there is a special separated queue named \fB\s-1SUSPENDED\s0\fR, to where
-threads can be manually moved from the \fB\s-1NEW\s0\fR, \fB\s-1READY\s0\fR or \fB\s-1WAITING\s0\fR
-queues by the application. The purpose of this special queue is to
-temporarily absorb suspended threads until they are again resumed by
-the application. Suspended threads do not cost scheduling or event
-handling resources, because they are temporarily completely out of the
-scheduler's scope. If a thread is resumed, it is moved back to the queue
-from where it originally came and this way again enters the schedulers
-scope.
-.SH "APPLICATION PROGRAMMING INTERFACE (API)"
-.IX Header "APPLICATION PROGRAMMING INTERFACE (API)"
-In the following the \fBPth\fR \fIApplication Programming Interface\fR (\s-1API\s0)
-is discussed in detail. With the knowledge given above, it should be
-now easy to understand how to program threads with this \s-1API\s0. In good
-Unix tradition, \fBPth\fR functions use special return values (\f(CW\*(C`NULL\*(C'\fR
-in pointer context, \f(CW\*(C`FALSE\*(C'\fR in boolean context and \f(CW\*(C`\-1\*(C'\fR in integer
-context) to indicate an error condition and set (or pass through) the
-\&\f(CW\*(C`errno\*(C'\fR system variable to pass more details about the error to the
-caller.
-.Sh "Global Library Management"
-.IX Subsection "Global Library Management"
-The following functions act on the library as a whole.  They are used to
-initialize and shutdown the scheduler and fetch information from it.
-.Ip "int \fBpth_init\fR(void);" 4
-.IX Item "int pth_init(void);"
-This initializes the \fBPth\fR library. It has to be the first \fBPth\fR \s-1API\s0
-function call in an application, and is mandatory. It's usually done at
-the begin of the \fImain()\fR function of the application. This implicitly
-spawns the internal scheduler thread and transforms the single execution
-unit of the current process into a thread (the `main' thread). It
-returns \f(CW\*(C`TRUE\*(C'\fR on success and \f(CW\*(C`FALSE\*(C'\fR on error.
-.Ip "int \fBpth_kill\fR(void);" 4
-.IX Item "int pth_kill(void);"
-This kills the \fBPth\fR library. It should be the last \fBPth\fR \s-1API\s0 function call
-in an application, but is not really required. It's usually done at the end of
-the main function of the application. At least, it has to be called from within
-the main thread. It implicitly kills all threads and transforms back the
-calling thread into the single execution unit of the underlying process.  The
-usual way to terminate a \fBPth\fR application is either a simple
-`\f(CW\*(C`pth_exit(0);\*(C'\fR' in the main thread (which waits for all other threads to
-terminate, kills the threading system and then terminates the process) or a
-`\f(CW\*(C`pth_kill(); exit(0)\*(C'\fR' (which immediately kills the threading system and
-terminates the process). The \fIpth_kill()\fR return immediately with a return
-code of \f(CW\*(C`FALSE\*(C'\fR if it is called not from within the main thread. Else
-kills the threading system and returns \f(CW\*(C`TRUE\*(C'\fR.
-.Ip "long \fBpth_ctrl\fR(unsigned long \fIquery\fR, ...);" 4
-.IX Item "long pth_ctrl(unsigned long query, ...);"
-This is a generalized query/control function for the \fBPth\fR library.  The
-argument \fIquery\fR is a bitmask formed out of one or more \f(CW\*(C`PTH_CTRL_\*(C'\fR\fI\s-1XXXX\s0\fR
-queries. Currently the following queries are supported:
-.RS 4
-.if n .Ip "\f(CW""""PTH_CTRL_GETTHREADS""""\fR" 4
-.el .Ip "\f(CWPTH_CTRL_GETTHREADS\fR" 4
-.IX Item "PTH_CTRL_GETTHREADS"
-This returns the total number of threads currently in existence.  This query
-actually is formed out of the combination of queries for threads in a
-particular state, i.e., the \f(CW\*(C`PTH_CTRL_GETTHREADS\*(C'\fR query is equal to the
-OR-combination of all the following specialized queries:
-.Sp
-\&\f(CW\*(C`PTH_CTRL_GETTHREADS_NEW\*(C'\fR for the number of threads in the
-new queue (threads created via \fIpth_spawn\fR\|(3) but still not
-scheduled once), \f(CW\*(C`PTH_CTRL_GETTHREADS_READY\*(C'\fR for the number of
-threads in the ready queue (threads who want to do \s-1CPU\s0 bursts),
-\&\f(CW\*(C`PTH_CTRL_GETTHREADS_RUNNING\*(C'\fR for the number of running threads
-(always just one thread!), \f(CW\*(C`PTH_CTRL_GETTHREADS_WAITING\*(C'\fR for
-the number of threads in the waiting queue (threads waiting for
-events), \f(CW\*(C`PTH_CTRL_GETTHREADS_SUSPENDED\*(C'\fR for the number of
-threads in the suspended queue (threads waiting to be resumed) and
-\&\f(CW\*(C`PTH_CTRL_GETTHREADS_DEAD\*(C'\fR for the number of threads in the new queue
-(terminated threads waiting for a join).
-.if n .Ip "\f(CW""""PTH_CTRL_GETAVLOAD""""\fR" 4
-.el .Ip "\f(CWPTH_CTRL_GETAVLOAD\fR" 4
-.IX Item "PTH_CTRL_GETAVLOAD"
-This requires a second argument of type `\f(CW\*(C`float *\*(C'\fR' (pointer to a floating
-point variable).  It stores a floating point value describing the exponential
-averaged load of the scheduler in this variable. The load is a function from
-the number of threads in the ready queue of the schedulers dispatching unit.
-So a load around 1.0 means there is only one ready thread (the standard
-situation when the application has no high load). A higher load value means
-there a more threads ready who want to do \s-1CPU\s0 bursts. The average load value
-updates once per second only. The return value for this query is always 0.
-.if n .Ip "\f(CW""""PTH_CTRL_GETPRIO""""\fR" 4
-.el .Ip "\f(CWPTH_CTRL_GETPRIO\fR" 4
-.IX Item "PTH_CTRL_GETPRIO"
-This requires a second argument of type `\f(CW\*(C`pth_t\*(C'\fR' which identifies a
-thread.  It returns the priority (ranging from \f(CW\*(C`PTH_PRIO_MIN\*(C'\fR to
-\&\f(CW\*(C`PTH_PRIO_MAX\*(C'\fR) of the given thread.
-.if n .Ip "\f(CW""""PTH_CTRL_GETNAME""""\fR" 4
-.el .Ip "\f(CWPTH_CTRL_GETNAME\fR" 4
-.IX Item "PTH_CTRL_GETNAME"
-This requires a second argument of type `\f(CW\*(C`pth_t\*(C'\fR' which identifies a
-thread. It returns the name of the given thread, i.e., the return value of
-\&\fIpth_ctrl\fR\|(3) should be casted to a `\f(CW\*(C`char *\*(C'\fR'.
-.if n .Ip "\f(CW""""PTH_CTRL_DUMPSTATE""""\fR" 4
-.el .Ip "\f(CWPTH_CTRL_DUMPSTATE\fR" 4
-.IX Item "PTH_CTRL_DUMPSTATE"
-This requires a second argument of type `\f(CW\*(C`FILE *\*(C'\fR' to which a summary
-of the internal \fBPth\fR library state is written to. The main information
-which is currently written out is the current state of the thread pool.
-.RE
-.RS 4
-.Sp
-The function returns \f(CW\*(C`\-1\*(C'\fR on error.
-.RE
-.Ip "long \fBpth_version\fR(void);" 4
-.IX Item "long pth_version(void);"
-This function returns a hex-value `0x\fIV\fR\fI\s-1RR\s0\fR\fIT\fR\fI\s-1LL\s0\fR' which describes the
-current \fBPth\fR library version. \fIV\fR is the version, \fI\s-1RR\s0\fR the revisions,
-\&\fI\s-1LL\s0\fR the level and \fIT\fR the type of the level (alphalevel=0, betalevel=1,
-patchlevel=2, etc). For instance \fBPth\fR version 1.0b1 is encoded as 0x100101.
-The reason for this unusual mapping is that this way the version number is
-steadily \fIincreasing\fR. The same value is also available under compile time as
-\&\f(CW\*(C`PTH_VERSION\*(C'\fR.
-.Sh "Thread Attribute Handling"
-.IX Subsection "Thread Attribute Handling"
-Attribute objects are used in \fBPth\fR for two things: First stand-alone/unbound
-attribute objects are used to store attributes for to be spawned threads.
-Bounded attribute objects are used to modify attributes of already existing
-threads. The following attribute fields exists in attribute objects:
-.if n .Ip "\f(CW""""PTH_ATTR_PRIO""""\fR (read-write) [\f(CW""""int""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_PRIO\fR (read-write) [\f(CWint\fR]" 4
-.IX Item "PTH_ATTR_PRIO (read-write) [int]"
-Thread Priority between \f(CW\*(C`PTH_PRIO_MIN\*(C'\fR and \f(CW\*(C`PTH_PRIO_MAX\*(C'\fR.
-The default is \f(CW\*(C`PTH_PRIO_STD\*(C'\fR.
-.if n .Ip "\f(CW""""PTH_ATTR_NAME""""\fR (read-write) [\f(CW""""char *""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_NAME\fR (read-write) [\f(CWchar *\fR]" 4
-.IX Item "PTH_ATTR_NAME (read-write) [char *]"
-Name of thread (up to 40 characters are stored only), mainly for debugging
-purposes.
-.if n .Ip "\f(CW""""PTH_ATTR_JOINABLE""""\fR (read-write> [\f(CW""""int""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_JOINABLE\fR (read-write> [\f(CWint\fR]" 4
-.IX Item "PTH_ATTR_JOINABLE (read-write> [int]"
-The thread detachment type, \f(CW\*(C`TRUE\*(C'\fR indicates a joinable thread,
-\&\f(CW\*(C`FALSE\*(C'\fR indicates a detached thread. When a thread is detached,
-after termination it is immediately kicked out of the system instead of
-inserted into the dead queue.
-.if n .Ip "\f(CW""""PTH_ATTR_CANCEL_STATE""""\fR (read-write) [\f(CW""""unsigned int""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_CANCEL_STATE\fR (read-write) [\f(CWunsigned int\fR]" 4
-.IX Item "PTH_ATTR_CANCEL_STATE (read-write) [unsigned int]"
-The thread cancellation state, i.e., a combination of \f(CW\*(C`PTH_CANCEL_ENABLE\*(C'\fR or
-\&\f(CW\*(C`PTH_CANCEL_DISABLE\*(C'\fR and \f(CW\*(C`PTH_CANCEL_DEFERRED\*(C'\fR or
-\&\f(CW\*(C`PTH_CANCEL_ASYNCHRONOUS\*(C'\fR.
-.if n .Ip "\f(CW""""PTH_ATTR_STACK_SIZE""""\fR (read-write) [\f(CW""""unsigned int""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_STACK_SIZE\fR (read-write) [\f(CWunsigned int\fR]" 4
-.IX Item "PTH_ATTR_STACK_SIZE (read-write) [unsigned int]"
-The thread stack size in bytes. Use lower values than 64 \s-1KB\s0 with great care!
-.if n .Ip "\f(CW""""PTH_ATTR_STACK_ADDR""""\fR (read-write) [\f(CW""""char *""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_STACK_ADDR\fR (read-write) [\f(CWchar *\fR]" 4
-.IX Item "PTH_ATTR_STACK_ADDR (read-write) [char *]"
-A pointer to the lower address of a chunk of \fImalloc\fR\|(3)'ed memory for the
-stack.
-.if n .Ip "\f(CW""""PTH_ATTR_TIME_SPAWN""""\fR (read-only) [\f(CW""""pth_time_t""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_TIME_SPAWN\fR (read-only) [\f(CWpth_time_t\fR]" 4
-.IX Item "PTH_ATTR_TIME_SPAWN (read-only) [pth_time_t]"
-The time when the thread was spawned.
-This can be queried only when the attribute object is bound to a thread.
-.if n .Ip "\f(CW""""PTH_ATTR_TIME_LAST""""\fR (read-only) [\f(CW""""pth_time_t""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_TIME_LAST\fR (read-only) [\f(CWpth_time_t\fR]" 4
-.IX Item "PTH_ATTR_TIME_LAST (read-only) [pth_time_t]"
-The time when the thread was last dispatched.
-This can be queried only when the attribute object is bound to a thread.
-.if n .Ip "\f(CW""""PTH_ATTR_TIME_RAN""""\fR (read-only) [\f(CW""""pth_time_t""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_TIME_RAN\fR (read-only) [\f(CWpth_time_t\fR]" 4
-.IX Item "PTH_ATTR_TIME_RAN (read-only) [pth_time_t]"
-The total time the thread was running.
-This can be queried only when the attribute object is bound to a thread.
-.if n .Ip "\f(CW""""PTH_ATTR_START_FUNC""""\fR (read-only) [\f(CW""""void *(*)(void *)""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_START_FUNC\fR (read-only) [\f(CWvoid *(*)(void *)\fR]" 4
-.IX Item "PTH_ATTR_START_FUNC (read-only) [void *(*)(void *)]"
-The thread start function.
-This can be queried only when the attribute object is bound to a thread.
-.if n .Ip "\f(CW""""PTH_ATTR_START_ARG""""\fR (read-only) [\f(CW""""void *""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_START_ARG\fR (read-only) [\f(CWvoid *\fR]" 4
-.IX Item "PTH_ATTR_START_ARG (read-only) [void *]"
-The thread start argument.
-This can be queried only when the attribute object is bound to a thread.
-.if n .Ip "\f(CW""""PTH_ATTR_STATE""""\fR (read-only) [\f(CW""""pth_state_t""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_STATE\fR (read-only) [\f(CWpth_state_t\fR]" 4
-.IX Item "PTH_ATTR_STATE (read-only) [pth_state_t]"
-The scheduling state of the thread, i.e., either \f(CW\*(C`PTH_STATE_NEW\*(C'\fR,
-\&\f(CW\*(C`PTH_STATE_READY\*(C'\fR, \f(CW\*(C`PTH_STATE_WAITING\*(C'\fR, or \f(CW\*(C`PTH_STATE_DEAD\*(C'\fR
-This can be queried only when the attribute object is bound to a thread.
-.if n .Ip "\f(CW""""PTH_ATTR_EVENTS""""\fR (read-only) [\f(CW""""pth_event_t""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_EVENTS\fR (read-only) [\f(CWpth_event_t\fR]" 4
-.IX Item "PTH_ATTR_EVENTS (read-only) [pth_event_t]"
-The event ring the thread is waiting for.
-This can be queried only when the attribute object is bound to a thread.
-.if n .Ip "\f(CW""""PTH_ATTR_BOUND""""\fR (read-only) [\f(CW""""int""""\fR]" 4
-.el .Ip "\f(CWPTH_ATTR_BOUND\fR (read-only) [\f(CWint\fR]" 4
-.IX Item "PTH_ATTR_BOUND (read-only) [int]"
-Whether the attribute object is bound (\f(CW\*(C`TRUE\*(C'\fR) to a thread or not (\f(CW\*(C`FALSE\*(C'\fR).
-.PP
-The following \s-1API\s0 functions exists to handle the attribute objects:
-.Ip "pth_attr_t \fBpth_attr_of\fR(pth_t \fItid\fR);" 4
-.IX Item "pth_attr_t pth_attr_of(pth_t tid);"
-This returns a new attribute object \fIbound\fR to thread \fItid\fR.  Any queries on
-this object directly fetch attributes from \fItid\fR. And attribute modifications
-directly change \fItid\fR. Use such attribute objects to modify existing threads.
-.Ip "pth_attr_t \fBpth_attr_new\fR(void);" 4
-.IX Item "pth_attr_t pth_attr_new(void);"
-This returns a new \fIunbound\fR attribute object. An implicit \fIpth_attr_init()\fR is
-done on it. Any queries on this object just fetch stored attributes from it.
-And attribute modifications just change the stored attributes.  Use such
-attribute objects to pre-configure attributes for to be spawned threads.
-.Ip "int \fBpth_attr_init\fR(pth_attr_t \fIattr\fR);" 4
-.IX Item "int pth_attr_init(pth_attr_t attr);"
-This initializes an attribute object \fIattr\fR to the default values:
-\&\f(CW\*(C`PTH_ATTR_PRIO\*(C'\fR := \f(CW\*(C`PTH_PRIO_STD\*(C'\fR, \f(CW\*(C`PTH_ATTR_NAME\*(C'\fR := `\f(CW\*(C`unknown\*(C'\fR',
-\&\f(CW\*(C`PTH_ATTR_JOINABLE\*(C'\fR := \f(CW\*(C`TRUE\*(C'\fR, \f(CW\*(C`PTH_ATTR_CANCELSTATE\*(C'\fR :=
-\&\f(CW\*(C`PTH_CANCEL_DEFAULT\*(C'\fR, \f(CW\*(C`PTH_ATTR_STACK_SIZE\*(C'\fR := 64*1024 and
-\&\f(CW\*(C`PTH_ATTR_STACK_ADDR\*(C'\fR := \f(CW\*(C`NULL\*(C'\fR. All other \f(CW\*(C`PTH_ATTR_*\*(C'\fR attributes are
-read-only attributes and don't receive default values in \fIattr\fR, because they
-exists only for bounded attribute objects.
-.Ip "int \fBpth_attr_set\fR(pth_attr_t \fIattr\fR, int \fIfield\fR, ...);" 4
-.IX Item "int pth_attr_set(pth_attr_t attr, int field, ...);"
-This sets the attribute field \fIfield\fR in \fIattr\fR to a value
-specified as an additional argument on the variable argument
-list. The following attribute \fIfields\fR and argument pairs can
-be used: 
-.Sp
-.Vb 6
-\& PTH_ATTR_PRIO           int
-\& PTH_ATTR_NAME           char *
-\& PTH_ATTR_JOINABLE       int
-\& PTH_ATTR_CANCEL_STATE   unsigned int
-\& PTH_ATTR_STACK_SIZE     unsigned int 
-\& PTH_ATTR_STACK_ADDR     char *
-.Ve
-.Ip "int \fBpth_attr_get\fR(pth_attr_t \fIattr\fR, int \fIfield\fR, ...);" 4
-.IX Item "int pth_attr_get(pth_attr_t attr, int field, ...);"
-This retrieves the attribute field \fIfield\fR in \fIattr\fR and stores its
-value in the variable specified through a pointer in an additional
-argument on the variable argument list. The following \fIfields\fR and
-argument pairs can be used:
-.Sp
-.Vb 14
-\& PTH_ATTR_PRIO           int *
-\& PTH_ATTR_NAME           char **
-\& PTH_ATTR_JOINABLE       int *
-\& PTH_ATTR_CANCEL_STATE   unsigned int *
-\& PTH_ATTR_STACK_SIZE     unsigned int *
-\& PTH_ATTR_STACK_ADDR     char **
-\& PTH_ATTR_TIME_SPAWN     pth_time_t *
-\& PTH_ATTR_TIME_LAST      pth_time_t *
-\& PTH_ATTR_TIME_RAN       pth_time_t *
-\& PTH_ATTR_START_FUNC     void *(**)(void *)
-\& PTH_ATTR_START_ARG      void **
-\& PTH_ATTR_STATE          pth_state_t *
-\& PTH_ATTR_EVENTS         pth_event_t *
-\& PTH_ATTR_BOUND          int *
-.Ve
-.Ip "int \fBpth_attr_destroy\fR(pth_attr_t \fIattr\fR);" 4
-.IX Item "int pth_attr_destroy(pth_attr_t attr);"
-This destroys a attribute object \fIattr\fR. After this \fIattr\fR is no
-longer a valid attribute object.
-.Sh "Thread Control"
-.IX Subsection "Thread Control"
-The following functions control the threading itself and form the main \s-1API\s0 of
-the \fBPth\fR library.
-.Ip "pth_t \fBpth_spawn\fR(pth_attr_t \fIattr\fR, void *(*\fIentry\fR)(void *), void *\fIarg\fR);" 4
-.IX Item "pth_t pth_spawn(pth_attr_t attr, void *(*entry)(void *), void *arg);"
-This spawns a new thread with the attributes given in \fIattr\fR (or
-\&\f(CW\*(C`PTH_ATTR_DEFAULT\*(C'\fR for default attributes \- which means that thread priority,
-joinability and cancel state are inherited from the current thread) with the
-starting point at routine \fIentry\fR. This entry routine is called as
-`pth_exit(\fIentry\fR(\fIarg\fR))' inside the new thread unit, i.e., \fIentry\fR's
-return value is fed to an implicit \fIpth_exit\fR\|(3). So the thread usually can exit
-by just returning. Nevertheless the thread can also exit explicitly at any
-time by calling \fIpth_exit\fR\|(3). But keep in mind that calling the \s-1POSIX\s0 function
-\&\fIexit\fR\|(3) still terminates the complete process and not just the current thread.
-.Sp
-There is no \fBPth\fR\-internal limit on the number of threads one can spawn,
-except the limit implied by the available virtual memory. \fBPth\fR internally
-keeps track of thread in dynamic data structures. The function returns
-\&\f(CW\*(C`NULL\*(C'\fR on error.
-.Ip "int \fBpth_once\fR(pth_once_t *\fIctrlvar\fR, void (*\fIfunc\fR)(void *), void *\fIarg\fR);" 4
-.IX Item "int pth_once(pth_once_t *ctrlvar, void (*func)(void *), void *arg);"
-This is a convenience function which uses a control variable of type
-\&\f(CW\*(C`pth_once_t\*(C'\fR to make sure a constructor function \fIfunc\fR is called only once
-as `\fIfunc\fR(\fIarg\fR)' in the system. In other words: Only the first call to
-\&\fIpth_once\fR\|(3) by any thread in the system succeeds. The variable referenced via
-\&\fIctrlvar\fR should be declared as `\f(CW\*(C`pth_once_t\*(C'\fR \fIvariable-name\fR =
-\&\f(CW\*(C`PTH_ONCE_INIT\*(C'\fR;' before calling this function.
-.Ip "pth_t \fBpth_self\fR(void);" 4
-.IX Item "pth_t pth_self(void);"
-This just returns the unique thread handle of the currently running thread.
-This handle itself has to be treated as an opaque entity by the application.
-It's usually used as an argument to other functions who require an argument of
-type \f(CW\*(C`pth_t\*(C'\fR.
-.Ip "int \fBpth_suspend\fR(pth_t \fItid\fR);" 4
-.IX Item "int pth_suspend(pth_t tid);"
-This suspends a thread \fItid\fR until it is manually resumed again via
-\&\fIpth_resume\fR\|(3). For this, the thread is moved to the \fB\s-1SUSPENDED\s0\fR queue
-and this way is completely out of the scheduler's event handling and
-thread dispatching scope. Suspending the current thread is not allowed.
-The function returns \f(CW\*(C`TRUE\*(C'\fR on success and \f(CW\*(C`FALSE\*(C'\fR on errors.
-.Ip "int \fBpth_resume\fR(pth_t \fItid\fR);" 4
-.IX Item "int pth_resume(pth_t tid);"
-This function resumes a previously suspended thread \fItid\fR, i.e. \fItid\fR
-has to stay on the \fB\s-1SUSPENDED\s0\fR queue. The thread is moved to the
-\&\fB\s-1NEW\s0\fR, \fB\s-1READY\s0\fR or \fB\s-1WAITING\s0\fR queue (dependent on what its state was
-when the \fIpth_suspend\fR\|(3) call were made) and this way again enters the
-event handling and thread dispatching scope of the scheduler. The
-function returns \f(CW\*(C`TRUE\*(C'\fR on success and \f(CW\*(C`FALSE\*(C'\fR on errors.
-.Ip "int \fBpth_raise\fR(pth_t \fItid\fR, int \fIsig\fR)" 4
-.IX Item "int pth_raise(pth_t tid, int sig)"
-This function raises a signal for delivery to thread \fItid\fR only.  When one
-just raises a signal via \fIraise\fR\|(3) or \fIkill\fR\|(2), its delivered to an arbitrary
-thread which has this signal not blocked.  With \fIpth_raise\fR\|(3) one can send a
-signal to a thread and its guarantees that only this thread gets the signal
-delivered. But keep in mind that nevertheless the signals \fIaction\fR is still
-configured \fIprocess\fR\-wide.  When \fIsig\fR is 0 plain thread checking is
-performed, i.e., `\f(CW\*(C`pth_raise(tid, 0)\*(C'\fR' returns \f(CW\*(C`TRUE\*(C'\fR when thread \fItid\fR
-still exists in the \fB\s-1PTH\s0\fR system but doesn't send any signal to it.
-.Ip "int \fBpth_yield\fR(pth_t \fItid\fR);" 4
-.IX Item "int pth_yield(pth_t tid);"
-This explicitly yields back the execution control to the scheduler thread.
-Usually the execution is implicitly transferred back to the scheduler when a
-thread waits for an event. But when a thread has to do larger \s-1CPU\s0 bursts, it
-can be reasonable to interrupt it explicitly by doing a few \fIpth_yield\fR\|(3) calls
-to give other threads a chance to execute, too.  This obviously is the
-cooperating part of \fBPth\fR.  A thread \fIhas not\fR to yield execution, of
-course. But when you want to program a server application with good response
-times the threads should be cooperative, i.e., when they should split their \s-1CPU\s0
-bursts into smaller units with this call.
-.Sp
-Usually one specifies \fItid\fR as \f(CW\*(C`NULL\*(C'\fR to indicate to the scheduler that it
-can freely decide which thread to dispatch next.  But if one wants to indicate
-to the scheduler that a particular thread should be favored on the next
-dispatching step, one can specify this thread explicitly. This allows the
-usage of the old concept of \fIcoroutines\fR where a thread/routine switches to a
-particular cooperating thread. If \fItid\fR is not \f(CW\*(C`NULL\*(C'\fR and points to a \fInew\fR
-or \fIready\fR thread, it is guaranteed that this thread receives execution
-control on the next dispatching step. If \fItid\fR is in a different state (that
-is, not in \f(CW\*(C`PTH_STATE_NEW\*(C'\fR or \f(CW\*(C`PTH_STATE_READY\*(C'\fR) an error is reported.
-.Sp
-The function usually returns \f(CW\*(C`TRUE\*(C'\fR for success and only \f(CW\*(C`FALSE\*(C'\fR (with
-\&\f(CW\*(C`errno\*(C'\fR set to \f(CW\*(C`EINVAL\*(C'\fR) if \fItid\fR specified and invalid or still not
-new or ready thread.
-.Ip "int \fBpth_nap\fR(pth_time_t \fInaptime\fR);" 4
-.IX Item "int pth_nap(pth_time_t naptime);"
-This functions suspends the execution of the current thread until \fInaptime\fR
-is elapsed. \fInaptime\fR is of type \f(CW\*(C`pth_time_t\*(C'\fR and this way has theoretically
-a resolution of one microsecond. In practice you should neither rely on this
-nor that the thread is awakened exactly after \fInaptime\fR has elapsed. It's
-only guarantees that the thread will sleep at least \fInaptime\fR. But because
-of the non-preemptive nature of \fBPth\fR it can last longer (when another thread
-kept the \s-1CPU\s0 for a long time). Additionally the resolution is dependent of the
-implementation of timers by the operating system and these usually have only a
-resolution of 10 microseconds or larger. But usually this isn't important for
-an application unless it tries to use this facility for real time tasks.
-.Ip "int \fBpth_wait\fR(pth_event_t \fIev\fR);" 4
-.IX Item "int pth_wait(pth_event_t ev);"
-This is the link between the scheduler and the event facility (see below for
-the various \fIpth_event_xxx()\fR functions). It's modeled like \fIselect\fR\|(2), i.e., one
-gives this function one or more events (in the event ring specified by \fIev\fR)
-on which the current thread wants to wait.  The scheduler awakes the thread
-when one ore more of them occurred after tagging them as occurred. The \fIev\fR
-argument is a \fIpointer\fR to an event ring which isn't changed except for the
-tagging. \fIpth_wait\fR\|(3) returns the number of occurred events and the application
-can use \fIpth_event_occurred\fR\|(3) to test which events occurred.
-.Ip "int \fBpth_cancel\fR(pth_t \fItid\fR);" 4
-.IX Item "int pth_cancel(pth_t tid);"
-This cancels a thread \fItid\fR. How the cancellation is done depends on the
-cancellation state of \fItid\fR which the thread can configure itself. When its
-state is \f(CW\*(C`PTH_CANCEL_DISABLE\*(C'\fR a cancellation request is just made pending.
-When it is \f(CW\*(C`PTH_CANCEL_ENABLE\*(C'\fR it depends on the cancellation type what is
-performed. When its \f(CW\*(C`PTH_CANCEL_DEFERRED\*(C'\fR again the cancellation request is
-just made pending. But when its \f(CW\*(C`PTH_CANCEL_ASYNCHRONOUS\*(C'\fR the thread is
-immediately canceled before \fIpth_cancel\fR\|(3) returns. The effect of a thread
-cancellation is equal to implicitly forcing the thread to call
-`\f(CW\*(C`pth_exit(PTH_CANCELED)\*(C'\fR' at one of his cancellation points.  In \fBPth\fR
-thread enter a cancellation point either explicitly via \fIpth_cancel_point\fR\|(3) or
-implicitly by waiting for an event.
-.Ip "int \fBpth_abort\fR(pth_t \fItid\fR);" 4
-.IX Item "int pth_abort(pth_t tid);"
-This is the cruel way to cancel a thread \fItid\fR. When it's already dead and
-waits to be joined it just joins it (via `\f(CW\*(C`pth_join(\*(C'\fR\fItid\fR\f(CW\*(C`, NULL)\*(C'\fR') and
-this way kicks it out of the system.  Else it forces the thread to be not
-joinable and to allow asynchronous cancellation and then cancels it via
-`\f(CW\*(C`pth_cancel(\*(C'\fR\fItid\fR\f(CW\*(C`)\*(C'\fR'.
-.Ip "int \fBpth_join\fR(pth_t \fItid\fR, void **\fIvalue\fR);" 4
-.IX Item "int pth_join(pth_t tid, void **value);"
-This joins the current thread with the thread specified via \fItid\fR.
-It first suspends the current thread until the \fItid\fR thread has
-terminated. Then it is awakened and stores the value of \fItid\fR's
-\&\fIpth_exit\fR\|(3) call into *\fIvalue\fR (if \fIvalue\fR and not \f(CW\*(C`NULL\*(C'\fR) and
-returns to the caller. A thread can be joined only when it has the
-attribute \f(CW\*(C`PTH_ATTR_JOINABLE\*(C'\fR set to \f(CW\*(C`TRUE\*(C'\fR (the default). A thread
-can only be joined once, i.e., after the \fIpth_join\fR\|(3) call the thread
-\&\fItid\fR is completely removed from the system.
-.Ip "void \fBpth_exit\fR(void *\fIvalue\fR);" 4
-.IX Item "void pth_exit(void *value);"
-This terminates the current thread. Whether it's immediately removed
-from the system or inserted into the dead queue of the scheduler depends
-on its join type which was specified at spawning time. If it has the
-attribute \f(CW\*(C`PTH_ATTR_JOINABLE\*(C'\fR set to \f(CW\*(C`FALSE\*(C'\fR, it's immediately removed
-and \fIvalue\fR is ignored. Else the thread is inserted into the dead queue
-and \fIvalue\fR remembered for a subsequent \fIpth_join\fR\|(3) call by another
-thread.
-.Sh "Utilities"
-.IX Subsection "Utilities"
-The following functions are utility functions.
-.Ip "int \fBpth_fdmode\fR(int \fIfd\fR, int \fImode\fR);" 4
-.IX Item "int pth_fdmode(int fd, int mode);"
-This switches the non-blocking mode flag on file descriptor \fIfd\fR.  The
-argument \fImode\fR can be \f(CW\*(C`PTH_FDMODE_BLOCK\*(C'\fR for switching \fIfd\fR into blocking
-I/O mode, \f(CW\*(C`PTH_FDMODE_NONBLOCK\*(C'\fR for switching \fIfd\fR into non-blocking I/O
-mode or \f(CW\*(C`PTH_FDMODE_POLL\*(C'\fR for just polling the current mode. The current mode
-is returned (either \f(CW\*(C`PTH_FDMODE_BLOCK\*(C'\fR or \f(CW\*(C`PTH_FDMODE_NONBLOCK\*(C'\fR) or
-\&\f(CW\*(C`PTH_FDMODE_ERROR\*(C'\fR on error. Keep in mind that since \fBPth\fR 1.1 there is no
-longer a requirement to manually switch a file descriptor into non-blocking
-mode in order to use it. This is automatically done temporarily inside \fBPth\fR.
-Instead when you now switch a file descriptor explicitly into non-blocking
-mode, \fIpth_read\fR\|(3) or \fIpth_write\fR\|(3) will never block the current thread.
-.Ip "pth_time_t \fBpth_time\fR(long \fIsec\fR, long \fIusec\fR);" 4
-.IX Item "pth_time_t pth_time(long sec, long usec);"
-This is a constructor for a \f(CW\*(C`pth_time_t\*(C'\fR structure which is a convenient
-function to avoid temporary structure values. It returns a \fIpth_time_t\fR
-structure which holds the absolute time value specified by \fIsec\fR and \fIusec\fR.
-.Ip "pth_time_t \fBpth_timeout\fR(long \fIsec\fR, long \fIusec\fR);" 4
-.IX Item "pth_time_t pth_timeout(long sec, long usec);"
-This is a constructor for a \f(CW\*(C`pth_time_t\*(C'\fR structure which is a convenient
-function to avoid temporary structure values.  It returns a \fIpth_time_t\fR
-structure which holds the absolute time value calculated by adding \fIsec\fR and
-\&\fIusec\fR to the current time.
-.Ip "Sfdisc_t *\fBpth_sfiodisc\fR(void);" 4
-.IX Item "Sfdisc_t *pth_sfiodisc(void);"
-This functions is always available, but only reasonably usable when \fBPth\fR
-was built with \fBSfio\fR support (\f(CW\*(C`\-\-with\-sfio\*(C'\fR option) and \f(CW\*(C`PTH_EXT_SFIO\*(C'\fR is
-then defined by \f(CW\*(C`pth.h\*(C'\fR. It is useful for applications which want to use the
-comprehensive \fBSfio\fR I/O library with the \fBPth\fR threading library. Then this
-function can be used to get an \fBSfio\fR discipline structure (\f(CW\*(C`Sfdisc_t\*(C'\fR)
-which can be pushed onto \fBSfio\fR streams (\f(CW\*(C`Sfio_t\*(C'\fR) in order to let this
-stream use \fIpth_read\fR\|(3)/\fIpth_write\fR\|(2) instead of \fIread\fR\|(2)/\fIwrite\fR\|(2). The benefit
-is that this way I/O on the \fBSfio\fR stream does only block the current thread
-instead of the whole process. The application has to \fIfree\fR\|(3) the \f(CW\*(C`Sfdisc_t\*(C'\fR
-structure when it is no longer needed. The Sfio package can be found at
-http://www.research.att.com/sw/tools/sfio/.
-.Sh "Cancellation Management"
-.IX Subsection "Cancellation Management"
-\&\fBPth\fR supports \s-1POSIX\s0 style thread cancellation via \fIpth_cancel\fR\|(3) and the
-following two related functions:
-.Ip "void \fBpth_cancel_state\fR(int \fInewstate\fR, int *\fIoldstate\fR);" 4
-.IX Item "void pth_cancel_state(int newstate, int *oldstate);"
-This manages the cancellation state of the current thread.  When \fIoldstate\fR
-is not \f(CW\*(C`NULL\*(C'\fR the function stores the old cancellation state under the
-variable pointed to by \fIoldstate\fR. When \fInewstate\fR is not \f(CW\*(C`0\*(C'\fR it sets the
-new cancellation state. \fIoldstate\fR is created before \fInewstate\fR is set.  A
-state is a combination of \f(CW\*(C`PTH_CANCEL_ENABLE\*(C'\fR or \f(CW\*(C`PTH_CANCEL_DISABLE\*(C'\fR and
-\&\f(CW\*(C`PTH_CANCEL_DEFERRED\*(C'\fR or \f(CW\*(C`PTH_CANCEL_ASYNCHRONOUS\*(C'\fR.
-\&\f(CW\*(C`PTH_CANCEL_ENABLE|PTH_CANCEL_DEFERRED\*(C'\fR (or \f(CW\*(C`PTH_CANCEL_DEFAULT\*(C'\fR) is the
-default state where cancellation is possible but only at cancellation points.
-Use \f(CW\*(C`PTH_CANCEL_DISABLE\*(C'\fR to complete disable cancellation for a thread and
-\&\f(CW\*(C`PTH_CANCEL_ASYNCHRONOUS\*(C'\fR for allowing asynchronous cancellations, i.e.,
-cancellations which can happen at any time.
-.Ip "void \fBpth_cancel_point\fR(void);" 4
-.IX Item "void pth_cancel_point(void);"
-This explicitly enter a cancellation point. When the current cancellation
-state is \f(CW\*(C`PTH_CANCEL_DISABLE\*(C'\fR or no cancellation request is pending, this has
-no side-effect and returns immediately. Else it calls
-`\f(CW\*(C`pth_exit(PTH_CANCELED)\*(C'\fR'.
-.Sh "Event Handling"
-.IX Subsection "Event Handling"
-\&\fBPth\fR has a very flexible event facility which is linked into the scheduler
-through the \fIpth_wait\fR\|(3) function. The following functions provide the handling
-of event rings.
-.Ip "pth_event_t \fBpth_event\fR(unsigned long \fIspec\fR, ...);" 4
-.IX Item "pth_event_t pth_event(unsigned long spec, ...);"
-This creates a new event ring consisting of a single initial event.  The type
-of the generated event is specified by \fIspec\fR. The following types are
-available:
-.RS 4
-.if n .Ip "\f(CW""""PTH_EVENT_FD""""\fR" 4
-.el .Ip "\f(CWPTH_EVENT_FD\fR" 4
-.IX Item "PTH_EVENT_FD"
-This is a file descriptor event. One or more of \f(CW\*(C`PTH_UNTIL_FD_READABLE\*(C'\fR,
-\&\f(CW\*(C`PTH_UNTIL_FD_WRITEABLE\*(C'\fR or \f(CW\*(C`PTH_UNTIL_FD_EXCEPTION\*(C'\fR have to be OR-ed into
-\&\fIspec\fR to specify on which state of the file descriptor you want to wait.  The
-file descriptor itself has to be given as an additional argument.  Example:
-`\f(CW\*(C`pth_event(PTH_EVENT_FD|PTH_UNTIL_FD_READABLE, fd)\*(C'\fR'.
-.if n .Ip "\f(CW""""PTH_EVENT_SELECT""""\fR" 4
-.el .Ip "\f(CWPTH_EVENT_SELECT\fR" 4
-.IX Item "PTH_EVENT_SELECT"
-This is a multiple file descriptor event modeled directly after the \fIselect\fR\|(2)
-call (actually it is also used to implement \fIpth_select\fR\|(3) internally).  It's a
-convenient way to wait for a large set of file descriptors at once and at each
-file descriptor for a different type of state. Additionally as a nice
-side-effect one receives the number of file descriptors which causes the event
-to be occurred (using \s-1BSD\s0 semantics, i.e., when a file descriptor occurred in
-two sets it's counted twice). The arguments correspond directly to the
-\&\fIselect\fR\|(2) function arguments except that there is no timeout argument (because
-timeouts already can be handled via \f(CW\*(C`PTH_EVENT_TIME\*(C'\fR events).
-.Sp
-Example: `\f(CW\*(C`pth_event(PTH_EVENT_SELECT, &rc, nfd, rfds, wfds, efds)\*(C'\fR' where
-\&\f(CW\*(C`rc\*(C'\fR has to be of type `\f(CW\*(C`int *\*(C'\fR', \f(CW\*(C`nfd\*(C'\fR has to be of type `\f(CW\*(C`int\*(C'\fR' and
-\&\f(CW\*(C`rfds\*(C'\fR, \f(CW\*(C`wfds\*(C'\fR and \f(CW\*(C`efds\*(C'\fR have to be of type `\f(CW\*(C`fd_set *\*(C'\fR' (see
-\&\fIselect\fR\|(2)). The number of occurred file descriptors are stored in \f(CW\*(C`rc\*(C'\fR.
-.if n .Ip "\f(CW""""PTH_EVENT_SIGS""""\fR" 4
-.el .Ip "\f(CWPTH_EVENT_SIGS\fR" 4
-.IX Item "PTH_EVENT_SIGS"
-This is a signal set event. The two additional arguments have to be a pointer
-to a signal set (type `\f(CW\*(C`sigset_t *\*(C'\fR') and a pointer to a signal number
-variable (type `\f(CW\*(C`int *\*(C'\fR').  This event waits until one of the signals in
-the signal set occurred.  As a result the occurred signal number is stored in
-the second additional argument. Keep in mind that the \fBPth\fR scheduler doesn't
-block signals automatically.  So when you want to wait for a signal with this
-event you've to block it via \fIsigprocmask\fR\|(2) or it will be delivered without
-your notice. Example: `\f(CW\*(C`sigemptyset(&set); sigaddset(&set, SIGINT);
-pth_event(PTH_EVENT_SIG, &set, &sig);\*(C'\fR'.
-.if n .Ip "\f(CW""""PTH_EVENT_TIME""""\fR" 4
-.el .Ip "\f(CWPTH_EVENT_TIME\fR" 4
-.IX Item "PTH_EVENT_TIME"
-This is a time point event. The additional argument has to be of type
-\&\f(CW\*(C`pth_time_t\*(C'\fR (usually on-the-fly generated via \fIpth_time\fR\|(3)). This events
-waits until the specified time point has elapsed. Keep in mind that the value
-is an absolute time point and not an offset. When you want to wait for a
-specified amount of time, you've to add the current time to the offset
-(usually on-the-fly achieved via \fIpth_timeout\fR\|(3)).  Example:
-`\f(CW\*(C`pth_event(PTH_EVENT_TIME, pth_timeout(2,0))\*(C'\fR'.
-.if n .Ip "\f(CW""""PTH_EVENT_MSG""""\fR" 4
-.el .Ip "\f(CWPTH_EVENT_MSG\fR" 4
-.IX Item "PTH_EVENT_MSG"
-This is a message port event. The additional argument has to be of type
-\&\f(CW\*(C`pth_msgport_t\*(C'\fR. This events waits until one or more messages were received
-on the specified message port.  Example: `\f(CW\*(C`pth_event(PTH_EVENT_MSG, mp)\*(C'\fR'.
-.if n .Ip "\f(CW""""PTH_EVENT_TID""""\fR" 4
-.el .Ip "\f(CWPTH_EVENT_TID\fR" 4
-.IX Item "PTH_EVENT_TID"
-This is a thread event. The additional argument has to be of type \f(CW\*(C`pth_t\*(C'\fR.
-One of \f(CW\*(C`PTH_UNTIL_TID_NEW\*(C'\fR, \f(CW\*(C`PTH_UNTIL_TID_READY\*(C'\fR, \f(CW\*(C`PTH_UNTIL_TID_WAITING\*(C'\fR
-or \f(CW\*(C`PTH_UNTIL_TID_DEAD\*(C'\fR has to be OR-ed into \fIspec\fR to specify on which
-state of the thread you want to wait.  Example:
-`\f(CW\*(C`pth_event(PTH_EVENT_TID|PTH_UNTIL_TID_DEAD, tid)\*(C'\fR'.
-.if n .Ip "\f(CW""""PTH_EVENT_FUNC""""\fR" 4
-.el .Ip "\f(CWPTH_EVENT_FUNC\fR" 4
-.IX Item "PTH_EVENT_FUNC"
-This is a custom callback function event. Three additional arguments
-have to be given with the following types: `\f(CW\*(C`int (*)(void *)\*(C'\fR',
-`\f(CW\*(C`void *\*(C'\fR' and `\f(CW\*(C`pth_time_t\*(C'\fR'. The first is a function pointer to
-a check function and the second argument is a user-supplied context
-value which is passed to this function. The scheduler calls this
-function on a regular basis (on his own scheduler stack, so be very
-careful!) and the thread is kept sleeping while the function returns
-\&\f(CW\*(C`FALSE\*(C'\fR. Once it returned \f(CW\*(C`TRUE\*(C'\fR the thread will be awakened. The
-check interval is defined by the third argument, i.e., the check
-function is polled again not until this amount of time elapsed. Example:
-`\f(CW\*(C`pth_event(PTH_EVENT_FUNC, func, arg, pth_time(0,500000))\*(C'\fR'.
-.RE
-.RS 4
-.RE
-.Ip "unsigned long \fBpth_event_typeof\fR(pth_event_t \fIev\fR);" 4
-.IX Item "unsigned long pth_event_typeof(pth_event_t ev);"
-This returns the type of event \fIev\fR. It's a combination of the describing
-\&\f(CW\*(C`PTH_EVENT_XX\*(C'\fR and \f(CW\*(C`PTH_UNTIL_XX\*(C'\fR value. This is especially useful to know
-which arguments have to be supplied to the \fIpth_event_extract\fR\|(3) function.
-.Ip "int \fBpth_event_extract\fR(pth_event_t \fIev\fR, ...);" 4
-.IX Item "int pth_event_extract(pth_event_t ev, ...);"
-When \fIpth_event\fR\|(3) is treated like \fIsprintf\fR\|(3), then this function is
-\&\fIsscanf\fR\|(3), i.e., it is the inverse operation of \fIpth_event\fR\|(3). This means that
-it can be used to extract the ingredients of an event.  The ingredients are
-stored into variables which are given as pointers on the variable argument
-list.  Which pointers have to be present depends on the event type and has to
-be determined by the caller before via \fIpth_event_typeof\fR\|(3).
-.Sp
-To make it clear, when you constructed \fIev\fR via `\f(CW\*(C`ev =
-pth_event(PTH_EVENT_FD, fd);\*(C'\fR' you have to extract it via
-`\f(CW\*(C`pth_event_extract(ev, &fd)\*(C'\fR', etc. For multiple arguments of an event the
-order of the pointer arguments is the same as for \fIpth_event\fR\|(3). But always
-keep in mind that you have to always supply \fIpointers\fR to \fIvariables\fR and
-these variables have to be of the same type as the argument of \fIpth_event\fR\|(3)
-required.
-.Ip "pth_event_t \fBpth_event_concat\fR(pth_event_t \fIev\fR, ...);" 4
-.IX Item "pth_event_t pth_event_concat(pth_event_t ev, ...);"
-This concatenates one or more additional event rings to the event ring \fIev\fR
-and returns \fIev\fR. The end of the argument list has to be marked with a
-\&\f(CW\*(C`NULL\*(C'\fR argument. Use this function to create real events rings out of the
-single-event rings created by \fIpth_event\fR\|(3).
-.Ip "pth_event_t \fBpth_event_isolate\fR(pth_event_t \fIev\fR);" 4
-.IX Item "pth_event_t pth_event_isolate(pth_event_t ev);"
-This isolates the event \fIev\fR from possibly appended events in the event ring.
-When in \fIev\fR only one event exists, this returns \f(CW\*(C`NULL\*(C'\fR. When remaining
-events exists, they form a new event ring which is returned.
-.Ip "pth_event_t \fBpth_event_walk\fR(pth_event_t \fIev\fR, int \fIdirection\fR);" 4
-.IX Item "pth_event_t pth_event_walk(pth_event_t ev, int direction);"
-This walks to the next (when \fIdirection\fR is \f(CW\*(C`PTH_WALK_NEXT\*(C'\fR) or previews
-(when \fIdirection\fR is \f(CW\*(C`PTH_WALK_PREV\*(C'\fR) event in the event ring \fIev\fR and
-returns this new reached event. Additionally \f(CW\*(C`PTH_UNTIL_OCCURRED\*(C'\fR can be
-OR-ed into \fIdirection\fR to walk to the next/previous occurred event in the
-ring \fIev\fR.
-.Ip "int \fBpth_event_occurred\fR(pth_event_t \fIev\fR);" 4
-.IX Item "int pth_event_occurred(pth_event_t ev);"
-This checks whether the event \fIev\fR occurred. This is a fast operation because
-only a tag on \fIev\fR is checked which was either set or still not set by the
-scheduler. In other words: This doesn't check the event itself, it just checks
-the last knowledge of the scheduler.
-.Ip "int \fBpth_event_free\fR(pth_event_t \fIev\fR, int \fImode\fR);" 4
-.IX Item "int pth_event_free(pth_event_t ev, int mode);"
-This deallocates the event \fIev\fR (when \fImode\fR is \f(CW\*(C`PTH_FREE_THIS\*(C'\fR) or all
-events appended to the event ring under \fIev\fR (when \fImode\fR is
-\&\f(CW\*(C`PTH_FREE_ALL\*(C'\fR).
-.Sh "Key-Based Storage"
-.IX Subsection "Key-Based Storage"
-The following functions provide thread-local storage through unique keys
-similar to the \s-1POSIX\s0 \fBPthread\fR \s-1API\s0. Use this for thread specific global data.
-.Ip "int \fBpth_key_create\fR(pth_key_t *\fIkey\fR, void (*\fIfunc\fR)(void *));" 4
-.IX Item "int pth_key_create(pth_key_t *key, void (*func)(void *));"
-This created a new unique key and stores it in \fIkey\fR.  Additionally \fIfunc\fR
-can specify a destructor function which is called on the current threads
-termination with the \fIkey\fR.
-.Ip "int \fBpth_key_delete\fR(pth_key_t \fIkey\fR);" 4
-.IX Item "int pth_key_delete(pth_key_t key);"
-This explicitly destroys a key \fIkey\fR.
-.Ip "int \fBpth_key_setdata\fR(pth_key_t \fIkey\fR, const void *\fIvalue\fR);" 4
-.IX Item "int pth_key_setdata(pth_key_t key, const void *value);"
-This stores \fIvalue\fR under \fIkey\fR.
-.Ip "void *\fBpth_key_getdata\fR(pth_key_t \fIkey\fR);" 4
-.IX Item "void *pth_key_getdata(pth_key_t key);"
-This retrieves the value under \fIkey\fR.
-.Sh "Message Port Communication"
-.IX Subsection "Message Port Communication"
-The following functions provide message ports which can be used for efficient
-and flexible inter-thread communication.
-.Ip "pth_msgport_t \fBpth_msgport_create\fR(const char *\fIname\fR);" 4
-.IX Item "pth_msgport_t pth_msgport_create(const char *name);"
-This returns a pointer to a new message port with name \fIname\fR. The \fIname\fR
-can be used by other threads via \fIpth_msgport_find\fR\|(3) to find the message port
-in case they do not know directly the pointer to the message port.
-.Ip "void \fBpth_msgport_destroy\fR(pth_msgport_t \fImp\fR);" 4
-.IX Item "void pth_msgport_destroy(pth_msgport_t mp);"
-This destroys a message port \fImp\fR. Before all pending messages on it are
-replied to their origin message port.
-.Ip "pth_msgport_t \fBpth_msgport_find\fR(const char *\fIname\fR);" 4
-.IX Item "pth_msgport_t pth_msgport_find(const char *name);"
-This finds a message port in the system by \fIname\fR and returns the pointer to
-it.
-.Ip "int \fBpth_msgport_pending\fR(pth_msgport_t \fImp\fR);" 4
-.IX Item "int pth_msgport_pending(pth_msgport_t mp);"
-This returns the number of pending messages on message port \fImp\fR.
-.Ip "int \fBpth_msgport_put\fR(pth_msgport_t \fImp\fR, pth_message_t *\fIm\fR);" 4
-.IX Item "int pth_msgport_put(pth_msgport_t mp, pth_message_t *m);"
-This puts (or sends) a message \fIm\fR to message port \fImp\fR.
-.Ip "pth_message_t *\fBpth_msgport_get\fR(pth_msgport_t \fImp\fR);" 4
-.IX Item "pth_message_t *pth_msgport_get(pth_msgport_t mp);"
-This gets (or receives) the top message from message port \fImp\fR.  Incoming
-messages are always kept in a queue, so there can be more pending messages, of
-course.
-.Ip "int \fBpth_msgport_reply\fR(pth_message_t *\fIm\fR);" 4
-.IX Item "int pth_msgport_reply(pth_message_t *m);"
-This replies a message \fIm\fR to the message port of the sender.
-.Sh "Thread Cleanups"
-.IX Subsection "Thread Cleanups"
-The following functions provide per-thread cleanup functions.
-.Ip "int \fBpth_cleanup_push\fR(void (*\fIhandler\fR)(void *), void *\fIarg\fR);" 4
-.IX Item "int pth_cleanup_push(void (*handler)(void *), void *arg);"
-This pushes the routine \fIhandler\fR onto the stack of cleanup routines for the
-current thread.  These routines are called in \s-1LIFO\s0 order when the thread
-terminates.
-.Ip "int \fBpth_cleanup_pop\fR(int \fIexecute\fR);" 4
-.IX Item "int pth_cleanup_pop(int execute);"
-This pops the top-most routine from the stack of cleanup routines for the
-current thread. When \fIexecute\fR is \f(CW\*(C`TRUE\*(C'\fR the routine is additionally called.
-.Sh "Process Forking"
-.IX Subsection "Process Forking"
-The following functions provide some special support for process forking
-situations inside the threading environment.
-.Ip "int \fBpth_atfork_push\fR(void (*\fIprepare\fR)(void *), void (*)(void *\fIparent\fR), void (*)(void *\fIchild\fR), void *\fIarg\fR);" 4
-.IX Item "int pth_atfork_push(void (*prepare)(void *), void (*)(void *parent), void (*)(void *child), void *arg);"
-This function declares forking handlers to be called before and after
-\&\fIpth_fork\fR\|(3), in the context of the thread that called \fIpth_fork\fR\|(3). The
-\&\fIprepare\fR handler is called before \fIfork\fR\|(2) processing commences. The
-\&\fIparent\fR handler is called   after \fIfork\fR\|(2) processing completes in the parent
-process.  The \fIchild\fR handler is called after \fIfork\fR\|(2) processing completed in
-the child process. If no handling is desired at one or more of these three
-points, the corresponding handler can be given as \f(CW\*(C`NULL\*(C'\fR.  Each handler is
-called with \fIarg\fR as the argument.
-.Sp
-The order of calls to \fIpth_atfork_push\fR\|(3) is significant. The \fIparent\fR and
-\&\fIchild\fR handlers are called in the order in which they were established by
-calls to \fIpth_atfork_push\fR\|(3), i.e., \s-1FIFO\s0. The \fIprepare\fR fork handlers are
-called in the opposite order, i.e., \s-1LIFO\s0.
-.Ip "int \fBpth_atfork_pop\fR(void);" 4
-.IX Item "int pth_atfork_pop(void);"
-This removes the top-most handlers on the forking handler stack which were
-established with the last \fIpth_atfork_push\fR\|(3) call. It returns \f(CW\*(C`FALSE\*(C'\fR when no
-more handlers couldn't be removed from the stack.
-.Ip "pid_t \fBpth_fork\fR(void);" 4
-.IX Item "pid_t pth_fork(void);"
-This is a variant of \fIfork\fR\|(2) with the difference that the current thread only
-is forked into a separate process, i.e., in the parent process nothing changes
-while in the child process all threads are gone except for the scheduler and
-the calling thread. When you really want to duplicate all threads in the
-current process you should use \fIfork\fR\|(2) directly. But this is usually not
-reasonable. Additionally this function takes care of forking handlers as
-established by \fIpth_fork_push\fR\|(3).
-.Sh "Synchronization"
-.IX Subsection "Synchronization"
-The following functions provide synchronization support via mutual exclusion
-locks (\fBmutex\fR), read-write locks (\fBrwlock\fR), condition variables (\fBcond\fR)
-and barriers (\fBbarrier\fR). Keep in mind that in a non-preemptive threading
-system like \fBPth\fR this might sound unnecessary at the first look, because a
-thread isn't interrupted by the system. Actually when you have a critical code
-section which doesn't contain any \fIpth_xxx()\fR functions, you don't need any
-mutex to protect it, of course.
-.PP
-But when your critical code section contains any \fIpth_xxx()\fR function the chance
-is high that these temporarily switch to the scheduler. And this way other
-threads can make progress and enter your critical code section, too.  This is
-especially true for critical code sections which implicitly or explicitly use
-the event mechanism.
-.Ip "int \fBpth_mutex_init\fR(pth_mutex_t *\fImutex\fR);" 4
-.IX Item "int pth_mutex_init(pth_mutex_t *mutex);"
-This dynamically initializes a mutex variable of type `\f(CW\*(C`pth_mutex_t\*(C'\fR'.
-Alternatively one can also use static initialization via `\f(CW\*(C`pth_mutex_t
-mutex = PTH_MUTEX_INIT\*(C'\fR'.
-.Ip "int \fBpth_mutex_acquire\fR(pth_mutex_t *\fImutex\fR, int \fItry\fR, pth_event_t \fIev\fR);" 4
-.IX Item "int pth_mutex_acquire(pth_mutex_t *mutex, int try, pth_event_t ev);"
-This acquires a mutex \fImutex\fR.  If the mutex is already locked by another
-thread, the current threads execution is suspended until the mutex is unlocked
-again or additionally the extra events in \fIev\fR occurred (when \fIev\fR is not
-\&\f(CW\*(C`NULL\*(C'\fR).  Recursive locking is explicitly supported, i.e., a thread is allowed
-to acquire a mutex more than once before its released. But it then also has be
-released the same number of times until the mutex is again lockable by others.
-When \fItry\fR is \f(CW\*(C`TRUE\*(C'\fR this function never suspends execution. Instead it
-returns \f(CW\*(C`FALSE\*(C'\fR with \f(CW\*(C`errno\*(C'\fR set to \f(CW\*(C`EBUSY\*(C'\fR.
-.Ip "int \fBpth_mutex_release\fR(pth_mutex_t *\fImutex\fR);" 4
-.IX Item "int pth_mutex_release(pth_mutex_t *mutex);"
-This decrements the recursion locking count on \fImutex\fR and when it is zero it
-releases the mutex \fImutex\fR.
-.Ip "int \fBpth_rwlock_init\fR(pth_rwlock_t *\fIrwlock\fR);" 4
-.IX Item "int pth_rwlock_init(pth_rwlock_t *rwlock);"
-This dynamically initializes a read-write lock variable of type
-`\f(CW\*(C`pth_rwlock_t\*(C'\fR'.  Alternatively one can also use static initialization
-via `\f(CW\*(C`pth_rwlock_t rwlock = PTH_RWLOCK_INIT\*(C'\fR'.
-.Ip "int \fBpth_rwlock_acquire\fR(pth_rwlock_t *\fIrwlock\fR, int \fIop\fR, int \fItry\fR, pth_event_t \fIev\fR);" 4
-.IX Item "int pth_rwlock_acquire(pth_rwlock_t *rwlock, int op, int try, pth_event_t ev);"
-This acquires a read-only (when \fIop\fR is \f(CW\*(C`PTH_RWLOCK_RD\*(C'\fR) or a read-write
-(when \fIop\fR is \f(CW\*(C`PTH_RWLOCK_RW\*(C'\fR) lock \fIrwlock\fR. When the lock is only locked
-by other threads in read-only mode, the lock succeeds.  But when one thread
-holds a read-write lock, all locking attempts suspend the current thread until
-this lock is released again. Additionally in \fIev\fR events can be given to let
-the locking timeout, etc. When \fItry\fR is \f(CW\*(C`TRUE\*(C'\fR this function never suspends
-execution. Instead it returns \f(CW\*(C`FALSE\*(C'\fR with \f(CW\*(C`errno\*(C'\fR set to \f(CW\*(C`EBUSY\*(C'\fR.
-.Ip "int \fBpth_rwlock_release\fR(pth_rwlock_t *\fIrwlock\fR);" 4
-.IX Item "int pth_rwlock_release(pth_rwlock_t *rwlock);"
-This releases a previously acquired (read-only or read-write) lock.
-.Ip "int \fBpth_cond_init\fR(pth_cond_t *\fIcond\fR);" 4
-.IX Item "int pth_cond_init(pth_cond_t *cond);"
-This dynamically initializes a condition variable variable of type
-`\f(CW\*(C`pth_cond_t\*(C'\fR'.  Alternatively one can also use static initialization via
-`\f(CW\*(C`pth_cond_t cond = PTH_COND_INIT\*(C'\fR'.
-.Ip "int \fBpth_cond_await\fR(pth_cond_t *\fIcond\fR, pth_mutex_t *\fImutex\fR, pth_event_t \fIev\fR);" 4
-.IX Item "int pth_cond_await(pth_cond_t *cond, pth_mutex_t *mutex, pth_event_t ev);"
-This awaits a condition situation. The caller has to follow the semantics of
-the \s-1POSIX\s0 condition variables: \fImutex\fR has to be acquired before this
-function is called. The execution of the current thread is then suspended
-either until the events in \fIev\fR occurred (when \fIev\fR is not \f(CW\*(C`NULL\*(C'\fR) or
-\&\fIcond\fR was notified by another thread via \fIpth_cond_notify\fR\|(3).  While the
-thread is waiting, \fImutex\fR is released. Before it returns \fImutex\fR is
-reacquired.
-.Ip "int \fBpth_cond_notify\fR(pth_cond_t *\fIcond\fR, int \fIbroadcast\fR);" 4
-.IX Item "int pth_cond_notify(pth_cond_t *cond, int broadcast);"
-This notified one or all threads which are waiting on \fIcond\fR.  When
-\&\fIbroadcast\fR is \f(CW\*(C`TRUE\*(C'\fR all thread are notified, else only a single
-(unspecified) one.
-.Ip "int \fBpth_barrier_init\fR(pth_barrier_t *\fIbarrier\fR, int \fIthreshold\fR);" 4
-.IX Item "int pth_barrier_init(pth_barrier_t *barrier, int threshold);"
-This dynamically initializes a barrier variable of type `\f(CW\*(C`pth_barrier_t\*(C'\fR'.
-Alternatively one can also use static initialization via `\f(CW\*(C`pth_barrier_t
-barrier = PTH_BARRIER_INIT(\*(C'\fR\fIthreadhold\fR\f(CW\*(C`)\*(C'\fR'.
-.Ip "int \fBpth_barrier_reach\fR(pth_barrier_t *\fIbarrier\fR);" 4
-.IX Item "int pth_barrier_reach(pth_barrier_t *barrier);"
-This function reaches a barrier \fIbarrier\fR. If this is the last thread (as
-specified by \fIthreshold\fR on init of \fIbarrier\fR) all threads are awakened.
-Else the current thread is suspended until the last thread reached the barrier
-and this way awakes all threads. The function returns (beside \f(CW\*(C`FALSE\*(C'\fR on
-error) the value \f(CW\*(C`TRUE\*(C'\fR for any thread which neither reached the barrier as
-the first nor the last thread; \f(CW\*(C`PTH_BARRIER_HEADLIGHT\*(C'\fR for the thread which
-reached the barrier as the first thread and \f(CW\*(C`PTH_BARRIER_TAILLIGHT\*(C'\fR for the
-thread which reached the barrier as the last thread.
-.Sh "Generalized \s-1POSIX\s0 Replacement \s-1API\s0"
-.IX Subsection "Generalized POSIX Replacement API"
-The following functions are generalized replacements functions for the \s-1POSIX\s0
-\&\s-1API\s0, i.e., they are similar to the functions under `\fBStandard \s-1POSIX\s0
-Replacement \s-1API\s0\fR' but all have an additional event argument which can be used
-for timeouts, etc.
-.Ip "int \fBpth_sigwait_ev\fR(const sigset_t *\fIset\fR, int *\fIsig\fR, pth_event_t \fIev\fR);" 4
-.IX Item "int pth_sigwait_ev(const sigset_t *set, int *sig, pth_event_t ev);"
-This is equal to \fIpth_sigwait\fR\|(3) (see below), but has an additional event
-argument \fIev\fR. When \fIpth_sigwait\fR\|(3) suspends the current threads execution it
-usually only uses the signal event on \fIset\fR to awake. With this function any
-number of extra events can be used to awake the current thread (remember that
-\&\fIev\fR actually is an event \fIring\fR).
-.Ip "int \fBpth_connect_ev\fR(int \fIs\fR, const struct sockaddr *\fIaddr\fR, socklen_t \fIaddrlen\fR, pth_event_t \fIev\fR);" 4
-.IX Item "int pth_connect_ev(int s, const struct sockaddr *addr, socklen_t addrlen, pth_event_t ev);"
-This is equal to \fIpth_connect\fR\|(3) (see below), but has an additional event
-argument \fIev\fR. When \fIpth_connect\fR\|(3) suspends the current threads execution it
-usually only uses the I/O event on \fIs\fR to awake. With this function any
-number of extra events can be used to awake the current thread (remember that
-\&\fIev\fR actually is an event \fIring\fR).
-.Ip "int \fBpth_accept_ev\fR(int \fIs\fR, struct sockaddr *\fIaddr\fR, socklen_t *\fIaddrlen\fR, pth_event_t \fIev\fR);" 4
-.IX Item "int pth_accept_ev(int s, struct sockaddr *addr, socklen_t *addrlen, pth_event_t ev);"
-This is equal to \fIpth_accept\fR\|(3) (see below), but has an additional event
-argument \fIev\fR. When \fIpth_accept\fR\|(3) suspends the current threads execution it
-usually only uses the I/O event on \fIs\fR to awake. With this function any
-number of extra events can be used to awake the current thread (remember that
-\&\fIev\fR actually is an event \fIring\fR).
-.Ip "int \fBpth_select_ev\fR(int \fInfd\fR, fd_set *\fIrfds\fR, fd_set *\fIwfds\fR, fd_set *\fIefds\fR, struct timeval *\fItimeout\fR, pth_event_t \fIev\fR);" 4
-.IX Item "int pth_select_ev(int nfd, fd_set *rfds, fd_set *wfds, fd_set *efds, struct timeval *timeout, pth_event_t ev);"
-This is equal to \fIpth_select\fR\|(3) (see below), but has an additional event
-argument \fIev\fR. When \fIpth_select\fR\|(3) suspends the current threads execution it
-usually only uses the I/O event on \fIrfds\fR, \fIwfds\fR and \fIefds\fR to awake. With
-this function any number of extra events can be used to awake the current
-thread (remember that \fIev\fR actually is an event \fIring\fR).
-.Ip "int \fBpth_poll_ev\fR(struct pollfd *\fIfds\fR, unsigned int \fInfd\fR, int \fItimeout\fR, pth_event_t \fIev\fR);" 4
-.IX Item "int pth_poll_ev(struct pollfd *fds, unsigned int nfd, int timeout, pth_event_t ev);"
-This is equal to \fIpth_poll\fR\|(3) (see below), but has an additional event argument
-\&\fIev\fR. When \fIpth_poll\fR\|(3) suspends the current threads execution it usually only
-uses the I/O event on \fIfds\fR to awake. With this function any number of extra
-events can be used to awake the current thread (remember that \fIev\fR actually
-is an event \fIring\fR).
-.Ip "ssize_t \fBpth_read_ev\fR(int \fIfd\fR, void *\fIbuf\fR, size_t \fInbytes\fR, pth_event_t \fIev\fR);" 4
-.IX Item "ssize_t pth_read_ev(int fd, void *buf, size_t nbytes, pth_event_t ev);"
-This is equal to \fIpth_read\fR\|(3) (see below), but has an additional event argument
-\&\fIev\fR. When \fIpth_read\fR\|(3) suspends the current threads execution it usually only
-uses the I/O event on \fIfd\fR to awake. With this function any number of extra
-events can be used to awake the current thread (remember that \fIev\fR actually
-is an event \fIring\fR).
-.Ip "ssize_t \fBpth_readv_ev\fR(int \fIfd\fR, const struct iovec *\fIiovec\fR, int \fIiovcnt\fR, pth_event_t \fIev\fR);" 4
-.IX Item "ssize_t pth_readv_ev(int fd, const struct iovec *iovec, int iovcnt, pth_event_t ev);"
-This is equal to \fIpth_readv\fR\|(3) (see below), but has an additional event
-argument \fIev\fR. When \fIpth_readv\fR\|(3) suspends the current threads execution it
-usually only uses the I/O event on \fIfd\fR to awake. With this function any
-number of extra events can be used to awake the current thread (remember that
-\&\fIev\fR actually is an event \fIring\fR).
-.Ip "ssize_t \fBpth_write_ev\fR(int \fIfd\fR, const void *\fIbuf\fR, size_t \fInbytes\fR, pth_event_t \fIev\fR);" 4
-.IX Item "ssize_t pth_write_ev(int fd, const void *buf, size_t nbytes, pth_event_t ev);"
-This is equal to \fIpth_write\fR\|(3) (see below), but has an additional event argument
-\&\fIev\fR. When \fIpth_write\fR\|(3) suspends the current threads execution it usually
-only uses the I/O event on \fIfd\fR to awake. With this function any number of
-extra events can be used to awake the current thread (remember that \fIev\fR
-actually is an event \fIring\fR).
-.Ip "ssize_t \fBpth_writev_ev\fR(int \fIfd\fR, const struct iovec *\fIiovec\fR, int \fIiovcnt\fR, pth_event_t \fIev\fR);" 4
-.IX Item "ssize_t pth_writev_ev(int fd, const struct iovec *iovec, int iovcnt, pth_event_t ev);"
-This is equal to \fIpth_writev\fR\|(3) (see below), but has an additional event
-argument \fIev\fR. When \fIpth_writev\fR\|(3) suspends the current threads execution it
-usually only uses the I/O event on \fIfd\fR to awake. With this function any
-number of extra events can be used to awake the current thread (remember that
-\&\fIev\fR actually is an event \fIring\fR).
-.Ip "ssize_t \fBpth_recv_ev\fR(int \fIfd\fR, void *\fIbuf\fR, size_t \fInbytes\fR, int \fIflags\fR, pth_event_t \fIev\fR);" 4
-.IX Item "ssize_t pth_recv_ev(int fd, void *buf, size_t nbytes, int flags, pth_event_t ev);"
-This is equal to \fIpth_recv\fR\|(3) (see below), but has an additional event
-argument \fIev\fR. When \fIpth_recv\fR\|(3) suspends the current threads execution it
-usually only uses the I/O event on \fIfd\fR to awake. With this function any
-number of extra events can be used to awake the current thread (remember that
-\&\fIev\fR actually is an event \fIring\fR).
-.Ip "ssize_t \fBpth_recvfrom_ev\fR(int \fIfd\fR, void *\fIbuf\fR, size_t \fInbytes\fR, int \fIflags\fR, struct sockaddr *\fIfrom\fR, socklen_t *\fIfromlen\fR, pth_event_t \fIev\fR);" 4
-.IX Item "ssize_t pth_recvfrom_ev(int fd, void *buf, size_t nbytes, int flags, struct sockaddr *from, socklen_t *fromlen, pth_event_t ev);"
-This is equal to \fIpth_recvfrom\fR\|(3) (see below), but has an additional event
-argument \fIev\fR. When \fIpth_recvfrom\fR\|(3) suspends the current threads execution it
-usually only uses the I/O event on \fIfd\fR to awake. With this function any
-number of extra events can be used to awake the current thread (remember that
-\&\fIev\fR actually is an event \fIring\fR).
-.Ip "ssize_t \fBpth_send_ev\fR(int \fIfd\fR, const void *\fIbuf\fR, size_t \fInbytes\fR, int \fIflags\fR, pth_event_t \fIev\fR);" 4
-.IX Item "ssize_t pth_send_ev(int fd, const void *buf, size_t nbytes, int flags, pth_event_t ev);"
-This is equal to \fIpth_send\fR\|(3) (see below), but has an additional event
-argument \fIev\fR. When \fIpth_send\fR\|(3) suspends the current threads execution it
-usually only uses the I/O event on \fIfd\fR to awake. With this function any
-number of extra events can be used to awake the current thread (remember that
-\&\fIev\fR actually is an event \fIring\fR).
-.Ip "ssize_t \fBpth_sendto_ev\fR(int \fIfd\fR, const void *\fIbuf\fR, size_t \fInbytes\fR, int \fIflags\fR, const struct sockaddr *\fIto\fR, socklen_t \fItolen\fR, pth_event_t \fIev\fR);" 4
-.IX Item "ssize_t pth_sendto_ev(int fd, const void *buf, size_t nbytes, int flags, const struct sockaddr *to, socklen_t tolen, pth_event_t ev);"
-This is equal to \fIpth_sendto\fR\|(3) (see below), but has an additional event
-argument \fIev\fR. When \fIpth_sendto\fR\|(3) suspends the current threads execution it
-usually only uses the I/O event on \fIfd\fR to awake. With this function any
-number of extra events can be used to awake the current thread (remember that
-\&\fIev\fR actually is an event \fIring\fR).
-.Sh "Standard \s-1POSIX\s0 Replacement \s-1API\s0"
-.IX Subsection "Standard POSIX Replacement API"
-The following functions are standard replacements functions for the \s-1POSIX\s0 \s-1API\s0.
-The difference is mainly that they suspend the current thread only instead of
-the whole process in case the file descriptors will block.
-.Ip "int \fBpth_usleep\fR(unsigned int \fIusec\fR);" 4
-.IX Item "int pth_usleep(unsigned int usec);"
-This is a variant of the 4.3BSD \fIusleep\fR\|(3) function. It suspends the current
-threads execution until \fIusec\fR microseconds (= \fIusec\fR*1/1000000 sec)
-elapsed.  The thread is guaranteed to not awakened before this time, but
-because of the non-preemptive scheduling nature of \fBPth\fR, it can be awakened
-later, of course.  The difference between \fIusleep\fR\|(3) and \fIpth_usleep\fR\|(3) is that
-that \fIpth_usleep\fR\|(3) suspends only the execution of the current thread and not
-the whole process.
-.Ip "unsigned int \fBpth_sleep\fR(unsigned int \fIsec\fR);" 4
-.IX Item "unsigned int pth_sleep(unsigned int sec);"
-This is a variant of the \s-1POSIX\s0 \fIsleep\fR\|(3) function. It suspends the current
-threads execution until \fIsec\fR seconds elapsed.  The thread is guaranteed to
-not awakened before this time, but because of the non-preemptive scheduling
-nature of \fBPth\fR, it can be awakened later, of course.  The difference between
-\&\fIsleep\fR\|(3) and \fIpth_sleep\fR\|(3) is that that \fIpth_sleep\fR\|(3) suspends only the
-execution of the current thread and not the whole process.
-.Ip "pid_t \fBpth_waitpid\fR(pid_t \fIpid\fR, int *\fIstatus\fR, int \fIoptions\fR);" 4
-.IX Item "pid_t pth_waitpid(pid_t pid, int *status, int options);"
-This is a variant of the \s-1POSIX\s0 \fIwaitpid\fR\|(2) function. It suspends the
-current threads execution until \fIstatus\fR information is available for a
-terminated child process \fIpid\fR.  The difference between \fIwaitpid\fR\|(2) and
-\&\fIpth_waitpid\fR\|(3) is that that \fIpth_waitpid\fR\|(3) suspends only the execution of the
-current thread and not the whole process.  For more details about the
-arguments and return code semantics see \fIwaitpid\fR\|(2).
-.Ip "int \fBpth_system\fR(const char *\fIcmd\fR);" 4
-.IX Item "int pth_system(const char *cmd);"
-This is a variant of the \s-1POSIX\s0 \fIsystem\fR\|(3) function. It executes the
-shell command \fIcmd\fR with Bourne Shell (\f(CW\*(C`sh\*(C'\fR) and suspends the current
-threads execution until this command terminates. The difference between
-\&\fIsystem\fR\|(3) and \fIpth_system\fR\|(3) is that that \fIpth_system\fR\|(3) suspends only
-the execution of the current thread and not the whole process. For more
-details about the arguments and return code semantics see \fIsystem\fR\|(3).
-.Ip "int \fBpth_sigmask\fR(int \fIhow\fR, const sigset_t *\fIset\fR, sigset_t *\fIoset\fR)" 4
-.IX Item "int pth_sigmask(int how, const sigset_t *set, sigset_t *oset)"
-This is the \fBPth\fR thread-related equivalent of \s-1POSIX\s0 \fIsigprocmask\fR\|(2) respectively
-\&\fIpthread_sigmask\fR\|(3). The arguments \fIhow\fR, \fIset\fR and \fIoset\fR directly relate
-to \fIsigprocmask\fR\|(2), because \fBPth\fR internally just uses \fIsigprocmask\fR\|(2) here. So
-alternatively you can also directly call \fIsigprocmask\fR\|(2), but for consistency
-reasons you should use this function \fIpth_sigmask\fR\|(3).
-.Ip "int \fBpth_sigwait\fR(const sigset_t *\fIset\fR, int *\fIsig\fR);" 4
-.IX Item "int pth_sigwait(const sigset_t *set, int *sig);"
-This is a variant of the \s-1POSIX\s0.1c \fIsigwait\fR\|(3) function. It suspends the current
-threads execution until a signal in \fIset\fR occurred and stores the signal
-number in \fIsig\fR. The important point is that the signal is not delivered to a
-signal handler. Instead it's caught by the scheduler only in order to awake
-the \fIpth_sigwait()\fR call. The trick and noticeable point here is that this way
-you get an asynchronous aware application that is written completely
-synchronously. When you think about the problem of \fIasynchronous safe\fR
-functions you should recognize that this is a great benefit.
-.Ip "int \fBpth_connect\fR(int \fIs\fR, const struct sockaddr *\fIaddr\fR, socklen_t \fIaddrlen\fR);" 4
-.IX Item "int pth_connect(int s, const struct sockaddr *addr, socklen_t addrlen);"
-This is a variant of the 4.2BSD \fIconnect\fR\|(2) function. It establishes a
-connection on a socket \fIs\fR to target specified in \fIaddr\fR and \fIaddrlen\fR.
-The difference between \fIconnect\fR\|(2) and \fIpth_connect\fR\|(3) is that that
-\&\fIpth_connect\fR\|(3) suspends only the execution of the current thread and not the
-whole process.  For more details about the arguments and return code semantics
-see \fIconnect\fR\|(2).
-.Ip "int \fBpth_accept\fR(int \fIs\fR, struct sockaddr *\fIaddr\fR, socklen_t *\fIaddrlen\fR);" 4
-.IX Item "int pth_accept(int s, struct sockaddr *addr, socklen_t *addrlen);"
-This is a variant of the 4.2BSD \fIaccept\fR\|(2) function. It accepts a connection on
-a socket by extracting the first connection request on the queue of pending
-connections, creating a new socket with the same properties of \fIs\fR and
-allocates a new file descriptor for the socket (which is returned).  The
-difference between \fIaccept\fR\|(2) and \fIpth_accept\fR\|(3) is that that \fIpth_accept\fR\|(3)
-suspends only the execution of the current thread and not the whole process.
-For more details about the arguments and return code semantics see \fIaccept\fR\|(2).
-.Ip "int \fBpth_select\fR(int \fInfd\fR, fd_set *\fIrfds\fR, fd_set *\fIwfds\fR, fd_set *\fIefds\fR, struct timeval *\fItimeout\fR);" 4
-.IX Item "int pth_select(int nfd, fd_set *rfds, fd_set *wfds, fd_set *efds, struct timeval *timeout);"
-This is a variant of the 4.2BSD \fIselect\fR\|(2) function.  It examines the I/O
-descriptor sets whose addresses are passed in \fIrfds\fR, \fIwfds\fR, and \fIefds\fR to
-see if some of their descriptors are ready for reading, are ready for writing,
-or have an exceptional condition pending, respectively.  For more details
-about the arguments and return code semantics see \fIselect\fR\|(2).
-.Ip "int \fBpth_poll\fR(struct pollfd *\fIfds\fR, unsigned int \fInfd\fR, int \fItimeout\fR);" 4
-.IX Item "int pth_poll(struct pollfd *fds, unsigned int nfd, int timeout);"
-This is a variant of the SysV \fIpoll\fR\|(2) function. It examines the I/O
-descriptors which are passed in the array \fIfds\fR to see if some of them are
-ready for reading, are ready for writing, or have an exceptional condition
-pending, respectively. For more details about the arguments and return code
-semantics see \fIpoll\fR\|(2).
-.Ip "ssize_t \fBpth_read\fR(int \fIfd\fR, void *\fIbuf\fR, size_t \fInbytes\fR);" 4
-.IX Item "ssize_t pth_read(int fd, void *buf, size_t nbytes);"
-This is a variant of the \s-1POSIX\s0 \fIread\fR\|(2) function. It reads up to \fInbytes\fR
-bytes into \fIbuf\fR from file descriptor \fIfd\fR.  The difference between \fIread\fR\|(2)
-and \fIpth_read\fR\|(2) is that that \fIpth_read\fR\|(2) suspends execution of the current
-thread until the file descriptor is ready for reading. For more details about
-the arguments and return code semantics see \fIread\fR\|(2).
-.Ip "ssize_t \fBpth_readv\fR(int \fIfd\fR, const struct iovec *\fIiovec\fR, int \fIiovcnt\fR);" 4
-.IX Item "ssize_t pth_readv(int fd, const struct iovec *iovec, int iovcnt);"
-This is a variant of the \s-1POSIX\s0 \fIreadv\fR\|(2) function. It reads data from
-file descriptor \fIfd\fR into the first \fIiovcnt\fR rows of the \fIiov\fR vector.  The
-difference between \fIreadv\fR\|(2) and \fIpth_readv\fR\|(2) is that that \fIpth_readv\fR\|(2)
-suspends execution of the current thread until the file descriptor is ready for
-reading. For more details about the arguments and return code semantics see
-\&\fIreadv\fR\|(2).
-.Ip "ssize_t \fBpth_write\fR(int \fIfd\fR, const void *\fIbuf\fR, size_t \fInbytes\fR);" 4
-.IX Item "ssize_t pth_write(int fd, const void *buf, size_t nbytes);"
-This is a variant of the \s-1POSIX\s0 \fIwrite\fR\|(2) function. It writes \fInbytes\fR bytes
-from \fIbuf\fR to file descriptor \fIfd\fR.  The difference between \fIwrite\fR\|(2) and
-\&\fIpth_write\fR\|(2) is that that \fIpth_write\fR\|(2) suspends execution of the current
-thread until the file descriptor is ready for writing.  For more details about
-the arguments and return code semantics see \fIwrite\fR\|(2).
-.Ip "ssize_t \fBpth_writev\fR(int \fIfd\fR, const struct iovec *\fIiovec\fR, int \fIiovcnt\fR);" 4
-.IX Item "ssize_t pth_writev(int fd, const struct iovec *iovec, int iovcnt);"
-This is a variant of the \s-1POSIX\s0 \fIwritev\fR\|(2) function. It writes data to
-file descriptor \fIfd\fR from the first \fIiovcnt\fR rows of the \fIiov\fR vector.  The
-difference between \fIwritev\fR\|(2) and \fIpth_writev\fR\|(2) is that that \fIpth_writev\fR\|(2)
-suspends execution of the current thread until the file descriptor is ready for
-reading. For more details about the arguments and return code semantics see
-\&\fIwritev\fR\|(2).
-.Ip "ssize_t \fBpth_pread\fR(int \fIfd\fR, void *\fIbuf\fR, size_t \fInbytes\fR, off_t \fIoffset\fR);" 4
-.IX Item "ssize_t pth_pread(int fd, void *buf, size_t nbytes, off_t offset);"
-This is a variant of the \s-1POSIX\s0 \fIpread\fR\|(3) function.  It performs the same action
-as a regular \fIread\fR\|(2), except that it reads from a given position in the file
-without changing the file pointer.  The first three arguments are the same as
-for \fIpth_read\fR\|(3) with the addition of a fourth argument \fIoffset\fR for the
-desired position inside the file.
-.Ip "ssize_t \fBpth_pwrite\fR(int \fIfd\fR, const void *\fIbuf\fR, size_t \fInbytes\fR, off_t \fIoffset\fR);" 4
-.IX Item "ssize_t pth_pwrite(int fd, const void *buf, size_t nbytes, off_t offset);"
-This is a variant of the \s-1POSIX\s0 \fIpwrite\fR\|(3) function.  It performs the same
-action as a regular \fIwrite\fR\|(2), except that it writes to a given position in the
-file without changing the file pointer. The first three arguments are the same
-as for \fIpth_write\fR\|(3) with the addition of a fourth argument \fIoffset\fR for the
-desired position inside the file.
-.Ip "ssize_t \fBpth_recv\fR(int \fIfd\fR, void *\fIbuf\fR, size_t \fInbytes\fR, int \fIflags\fR);" 4
-.IX Item "ssize_t pth_recv(int fd, void *buf, size_t nbytes, int flags);"
-This is a variant of the SUSv2 \fIrecv\fR\|(2) function and equal to
-``pth_recvfrom(fd, buf, nbytes, flags, \s-1NULL\s0, 0)''.
-.Ip "ssize_t \fBpth_recvfrom\fR(int \fIfd\fR, void *\fIbuf\fR, size_t \fInbytes\fR, int \fIflags\fR, struct sockaddr *\fIfrom\fR, socklen_t *\fIfromlen\fR);" 4
-.IX Item "ssize_t pth_recvfrom(int fd, void *buf, size_t nbytes, int flags, struct sockaddr *from, socklen_t *fromlen);"
-This is a variant of the SUSv2 \fIrecvfrom\fR\|(2) function. It reads up to
-\&\fInbytes\fR bytes into \fIbuf\fR from file descriptor \fIfd\fR while using
-\&\fIflags\fR and \fIfrom\fR/\fIfromlen\fR. The difference between \fIrecvfrom\fR\|(2) and
-\&\fIpth_recvfrom\fR\|(2) is that that \fIpth_recvfrom\fR\|(2) suspends execution of the
-current thread until the file descriptor is ready for reading. For more
-details about the arguments and return code semantics see \fIrecvfrom\fR\|(2).
-.Ip "ssize_t \fBpth_send\fR(int \fIfd\fR, const void *\fIbuf\fR, size_t \fInbytes\fR, int \fIflags\fR);" 4
-.IX Item "ssize_t pth_send(int fd, const void *buf, size_t nbytes, int flags);"
-This is a variant of the SUSv2 \fIsend\fR\|(2) function and equal to
-``pth_sendto(fd, buf, nbytes, flags, \s-1NULL\s0, 0)''.
-.Ip "ssize_t \fBpth_sendto\fR(int \fIfd\fR, const void *\fIbuf\fR, size_t \fInbytes\fR, int \fIflags\fR, const struct sockaddr *\fIto\fR, socklen_t \fItolen\fR);" 4
-.IX Item "ssize_t pth_sendto(int fd, const void *buf, size_t nbytes, int flags, const struct sockaddr *to, socklen_t tolen);"
-This is a variant of the SUSv2 \fIsendto\fR\|(2) function. It writes \fInbytes\fR
-bytes from \fIbuf\fR to file descriptor \fIfd\fR while using \fIflags\fR and
-\&\fIto\fR/\fItolen\fR. The difference between \fIsendto\fR\|(2) and \fIpth_sendto\fR\|(2) is
-that that \fIpth_sendto\fR\|(2) suspends execution of the current thread until
-the file descriptor is ready for writing. For more details about the
-arguments and return code semantics see \fIsendto\fR\|(2).
-.SH "EXAMPLE"
-.IX Header "EXAMPLE"
-The following example is a useless server which does nothing more than
-listening on \s-1TCP\s0 port 12345 and displaying the current time to the
-socket when a connection was established. For each incoming connection a
-thread is spawned. Additionally, to see more multithreading, a useless
-ticker thread runs simultaneously which outputs the current time to
-\&\f(CW\*(C`stderr\*(C'\fR every 5 seconds. The example contains \fIno\fR error checking and
-is \fIonly\fR intended to show you the look and feel of \fBPth\fR.
-.PP
-.Vb 11
-\& #include <stdio.h>
-\& #include <stdlib.h>
-\& #include <errno.h>
-\& #include <sys/types.h>
-\& #include <sys/socket.h>
-\& #include <netinet/in.h>
-\& #include <arpa/inet.h>
-\& #include <signal.h>
-\& #include <netdb.h>
-\& #include <unistd.h>
-\& #include "pth.h"
-.Ve
-.Vb 1
-\& #define PORT 12345
-.Ve
-.Vb 6
-\& /* the socket connection handler thread */
-\& static void *handler(void *_arg)
-\& {
-\&     int fd = (int)_arg;
-\&     time_t now;
-\&     char *ct;
-.Ve
-.Vb 6
-\&     now = time(NULL);
-\&     ct = ctime(&now);
-\&     pth_write(fd, ct, strlen(ct));
-\&     close(fd);
-\&     return NULL;
-\& }
-.Ve
-.Vb 6
-\& /* the stderr time ticker thread */
-\& static void *ticker(void *_arg)
-\& {
-\&     time_t now;
-\&     char *ct;
-\&     float load;
-.Ve
-.Vb 9
-\&     for (;;) {
-\&         pth_sleep(5);
-\&         now = time(NULL);
-\&         ct = ctime(&now);
-\&         ct[strlen(ct)-1] = '\e0';
-\&         pth_ctrl(PTH_CTRL_GETAVLOAD, &load);
-\&         printf("ticker: time: %s, average load: %.2f\en", ct, load);
-\&     }
-\& }
-.Ve
-.Vb 10
-\& /* the main thread/procedure */
-\& int main(int argc, char *argv[])
-\& {
-\&     pth_attr_t attr;
-\&     struct sockaddr_in sar;
-\&     struct protoent *pe;
-\&     struct sockaddr_in peer_addr;
-\&     int peer_len;
-\&     int sa, sw;
-\&     int port;
-.Ve
-.Vb 2
-\&     pth_init();
-\&     signal(SIGPIPE, SIG_IGN);
-.Ve
-.Vb 5
-\&     attr = pth_attr_new();
-\&     pth_attr_set(attr, PTH_ATTR_NAME, "ticker");
-\&     pth_attr_set(attr, PTH_ATTR_STACK_SIZE, 64*1024);
-\&     pth_attr_set(attr, PTH_ATTR_JOINABLE, FALSE);
-\&     pth_spawn(attr, ticker, NULL);
-.Ve
-.Vb 7
-\&     pe = getprotobyname("tcp");
-\&     sa = socket(AF_INET, SOCK_STREAM, pe->p_proto);
-\&     sar.sin_family = AF_INET;
-\&     sar.sin_addr.s_addr = INADDR_ANY;
-\&     sar.sin_port = htons(PORT);
-\&     bind(sa, (struct sockaddr *)&sar, sizeof(struct sockaddr_in));
-\&     listen(sa, 10);
-.Ve
-.Vb 7
-\&     pth_attr_set(attr, PTH_ATTR_NAME, "handler");
-\&     for (;;) {
-\&         peer_len = sizeof(peer_addr);
-\&         sw = pth_accept(sa, (struct sockaddr *)&peer_addr, &peer_len);
-\&         pth_spawn(attr, handler, (void *)sw);
-\&     }
-\& }
-.Ve
-.SH "BUILD ENVIRONMENTS"
-.IX Header "BUILD ENVIRONMENTS"
-In this section we will discuss the canonical ways to establish the build
-environment for a \fBPth\fR based program. The possibilities supported by \fBPth\fR
-range from very simple environments to rather complex ones.
-.Sh "Manual Build Environment (Novice)"
-.IX Subsection "Manual Build Environment (Novice)"
-As a first example, assume we have the above test program staying in the
-source file \f(CW\*(C`foo.c\*(C'\fR. Then we can create a very simple build environment by
-just adding the following \f(CW\*(C`Makefile\*(C'\fR:
-.PP
-.Vb 13
-\& $ vi Makefile
-\& | CC      = cc
-\& | CFLAGS  = `pth-config --cflags`
-\& | LDFLAGS = `pth-config --ldflags`
-\& | LIBS    = `pth-config --libs`
-\& |
-\& | all: foo
-\& | foo: foo.o
-\& |     $(CC) $(LDFLAGS) -o foo foo.o $(LIBS)
-\& | foo.o: foo.c
-\& |     $(CC) $(CFLAGS) -c foo.c
-\& | clean:
-\& |     rm -f foo foo.o
-.Ve
-This imports the necessary compiler and linker flags on-the-fly from the
-\&\fBPth\fR installation via its \f(CW\*(C`pth\-config\*(C'\fR program. This approach is
-straight-forward and works fine for small projects.
-.Sh "Autoconf Build Environment (Advanced)"
-.IX Subsection "Autoconf Build Environment (Advanced)"
-The previous approach is simple but unflexible. First, to speed up
-building, it would be nice to not expand the compiler and linker flags
-every time the compiler is started. Second, it would be useful to
-also be able to build against an uninstalled \fBPth\fR, that is, against
-a \fBPth\fR source tree which was just configured and built, but not
-installed. Third, it would be also useful to allow checking of the
-\&\fBPth\fR version to make sure it is at least a minimum required version.
-And finally, it would be also great to make sure \fBPth\fR works correctly
-by first performing some sanity compile and run-time checks. All this
-can be done if we use \s-1GNU\s0 \fBautoconf\fR and the \f(CW\*(C`AC_CHECK_PTH\*(C'\fR macro
-provided by \fBPth\fR. For this, we establish the following three files:
-.PP
-First we again need the \f(CW\*(C`Makefile\*(C'\fR, but this time it contains \fBautoconf\fR
-placeholders and additional cleanup targets. And we create it under the name
-\&\f(CW\*(C`Makefile.in\*(C'\fR, because it is now an input file for \fBautoconf\fR:
-.PP
-.Vb 17
-\& $ vi Makefile.in
-\& | CC      = @CC@
-\& | CFLAGS  = @CFLAGS@
-\& | LDFLAGS = @LDFLAGS@
-\& | LIBS    = @LIBS@
-\& |
-\& | all: foo
-\& | foo: foo.o
-\& |     $(CC) $(LDFLAGS) -o foo foo.o $(LIBS)
-\& | foo.o: foo.c
-\& |     $(CC) $(CFLAGS) -c foo.c
-\& | clean:
-\& |     rm -f foo foo.o
-\& | distclean:
-\& |     rm -f foo foo.o
-\& |     rm -f config.log config.status config.cache
-\& |     rm -f Makefile
-.Ve
-Because \fBautoconf\fR generates additional files, we added a canonical
-\&\f(CW\*(C`distclean\*(C'\fR target which cleans this up. Secondly, we wrote
-\&\f(CW\*(C`configure.in\*(C'\fR, a (minimal) \fBautoconf\fR script specification:
-.PP
-.Vb 4
-\& $ vi configure.in
-\& | AC_INIT(Makefile.in)
-\& | AC_CHECK_PTH(1.3.0)
-\& | AC_OUTPUT(Makefile)
-.Ve
-Then we let \fBautoconf\fR's \f(CW\*(C`aclocal\*(C'\fR program generate for us an \f(CW\*(C`aclocal.m4\*(C'\fR
-file containing \fBPth\fR's \f(CW\*(C`AC_CHECK_PTH\*(C'\fR macro. Then we generate the final
-\&\f(CW\*(C`configure\*(C'\fR script out of this \f(CW\*(C`aclocal.m4\*(C'\fR file and the \f(CW\*(C`configure.in\*(C'\fR
-file:
-.PP
-.Vb 2
-\& $ aclocal --acdir=`pth-config --acdir`
-\& $ autoconf
-.Ve
-After these steps, the working directory should look similar to this:
-.PP
-.Vb 6
-\& $ ls -l
-\& -rw-r--r--  1 rse  users    176 Nov  3 11:11 Makefile.in
-\& -rw-r--r--  1 rse  users  15314 Nov  3 11:16 aclocal.m4
-\& -rwxr-xr-x  1 rse  users  52045 Nov  3 11:16 configure
-\& -rw-r--r--  1 rse  users     63 Nov  3 11:11 configure.in
-\& -rw-r--r--  1 rse  users   4227 Nov  3 11:11 foo.c
-.Ve
-If we now run \f(CW\*(C`configure\*(C'\fR we get a correct \f(CW\*(C`Makefile\*(C'\fR which
-immediately can be used to build \f(CW\*(C`foo\*(C'\fR (assuming that \fBPth\fR is already
-installed somewhere, so that \f(CW\*(C`pth\-config\*(C'\fR is in \f(CW\*(C`$PATH\*(C'\fR):
-.PP
-.Vb 16
-\& $ ./configure
-\& creating cache ./config.cache
-\& checking for gcc... gcc
-\& checking whether the C compiler (gcc   ) works... yes
-\& checking whether the C compiler (gcc   ) is a cross-compiler... no
-\& checking whether we are using GNU C... yes
-\& checking whether gcc accepts -g... yes
-\& checking how to run the C preprocessor... gcc -E
-\& checking for GNU Pth... version 1.3.0, installed under /usr/local
-\& updating cache ./config.cache
-\& creating ./config.status
-\& creating Makefile
-\& rse@en1:/e/gnu/pth/ac
-\& $ make
-\& gcc -g -O2 -I/usr/local/include -c foo.c
-\& gcc -L/usr/local/lib -o foo foo.o -lpth
-.Ve
-If \fBPth\fR is installed in non-standard locations or \f(CW\*(C`pth\-config\*(C'\fR
-is not in \f(CW\*(C`$PATH\*(C'\fR, one just has to drop the \f(CW\*(C`configure\*(C'\fR script
-a note about the location by running \f(CW\*(C`configure\*(C'\fR with the option
-\&\f(CW\*(C`\-\-with\-pth=\*(C'\fR\fIdir\fR (where \fIdir\fR is the argument which was used with
-the \f(CW\*(C`\-\-prefix\*(C'\fR option when \fBPth\fR was installed).
-.Sh "Autoconf Build Environment with Local Copy of Pth (Expert)"
-.IX Subsection "Autoconf Build Environment with Local Copy of Pth (Expert)"
-Finally let us assume the \f(CW\*(C`foo\*(C'\fR program stays under either a \fI\s-1GPL\s0\fR or
-\&\fI\s-1LGPL\s0\fR distribution license and we want to make it a stand-alone package for
-easier distribution and installation.  That is, we don't want to oblige the
-end-user to install \fBPth\fR just to allow our \f(CW\*(C`foo\*(C'\fR package to
-compile. For this, it is a convenient practice to include the required
-libraries (here \fBPth\fR) into the source tree of the package (here \f(CW\*(C`foo\*(C'\fR).
-\&\fBPth\fR ships with all necessary support to allow us to easily achieve this
-approach. Say, we want \fBPth\fR in a subdirectory named \f(CW\*(C`pth/\*(C'\fR and this
-directory should be seamlessly integrated into the configuration and build
-process of \f(CW\*(C`foo\*(C'\fR.
-.PP
-First we again start with the \f(CW\*(C`Makefile.in\*(C'\fR, but this time it is a more
-advanced version which supports subdirectory movement:
-.PP
-.Vb 34
-\& $ vi Makefile.in
-\& | CC      = @CC@
-\& | CFLAGS  = @CFLAGS@
-\& | LDFLAGS = @LDFLAGS@
-\& | LIBS    = @LIBS@
-\& |
-\& | SUBDIRS = pth
-\& |
-\& | all: subdirs_all foo
-\& |
-\& | subdirs_all:
-\& |     @$(MAKE) $(MFLAGS) subdirs TARGET=all
-\& | subdirs_clean:
-\& |     @$(MAKE) $(MFLAGS) subdirs TARGET=clean
-\& | subdirs_distclean:
-\& |     @$(MAKE) $(MFLAGS) subdirs TARGET=distclean
-\& | subdirs:
-\& |     @for subdir in $(SUBDIRS); do \e
-\& |         echo "===> $$subdir ($(TARGET))"; \e
-\& |         (cd $$subdir; $(MAKE) $(MFLAGS) $(TARGET) || exit 1) || exit 1; \e
-\& |         echo "<=== $$subdir"; \e
-\& |     done
-\& |
-\& | foo: foo.o
-\& |     $(CC) $(LDFLAGS) -o foo foo.o $(LIBS)
-\& | foo.o: foo.c
-\& |     $(CC) $(CFLAGS) -c foo.c
-\& |
-\& | clean: subdirs_clean
-\& |     rm -f foo foo.o
-\& | distclean: subdirs_distclean
-\& |     rm -f foo foo.o
-\& |     rm -f config.log config.status config.cache
-\& |     rm -f Makefile
-.Ve
-Then we create a slightly different \fBautoconf\fR script \f(CW\*(C`configure.in\*(C'\fR:
-.PP
-.Vb 6
-\& $ vi configure.in
-\& | AC_INIT(Makefile.in)
-\& | AC_CONFIG_AUX_DIR(pth)
-\& | AC_CHECK_PTH(1.3.0, subdir:pth --disable-tests)
-\& | AC_CONFIG_SUBDIRS(pth)
-\& | AC_OUTPUT(Makefile)
-.Ve
-Here we provided a default value for \f(CW\*(C`foo\*(C'\fR's \f(CW\*(C`\-\-with\-pth\*(C'\fR option as the
-second argument to \f(CW\*(C`AC_CHECK_PTH\*(C'\fR which indicates that \fBPth\fR can be found in
-the subdirectory named \f(CW\*(C`pth/\*(C'\fR. Additionally we specified that the
-\&\f(CW\*(C`\-\-disable\-tests\*(C'\fR option of \fBPth\fR should be passed to the \f(CW\*(C`pth/\*(C'\fR
-subdirectory, because we need only to build the \fBPth\fR library itself. And we
-added a \f(CW\*(C`AC_CONFIG_SUBDIR\*(C'\fR call which indicates to \fBautoconf\fR that it should
-configure the \f(CW\*(C`pth/\*(C'\fR subdirectory, too. The \f(CW\*(C`AC_CONFIG_AUX_DIR\*(C'\fR directive
-was added just to make \fBautoconf\fR happy, because it wants to find a
-\&\f(CW\*(C`install.sh\*(C'\fR or \f(CW\*(C`shtool\*(C'\fR script if \f(CW\*(C`AC_CONFIG_SUBDIRS\*(C'\fR is used.
-.PP
-Now we let \fBautoconf\fR's \f(CW\*(C`aclocal\*(C'\fR program again generate for us an
-\&\f(CW\*(C`aclocal.m4\*(C'\fR file with the contents of \fBPth\fR's \f(CW\*(C`AC_CHECK_PTH\*(C'\fR macro.
-Finally we generate the \f(CW\*(C`configure\*(C'\fR script out of this \f(CW\*(C`aclocal.m4\*(C'\fR
-file and the \f(CW\*(C`configure.in\*(C'\fR file.
-.PP
-.Vb 2
-\& $ aclocal --acdir=`pth-config --acdir`
-\& $ autoconf
-.Ve
-Now we have to create the \f(CW\*(C`pth/\*(C'\fR subdirectory itself. For this, we extract the
-\&\fBPth\fR distribution to the \f(CW\*(C`foo\*(C'\fR source tree and just rename it to \f(CW\*(C`pth/\*(C'\fR:
-.PP
-.Vb 2
-\& $ gunzip <pth-X.Y.Z.tar.gz | tar xvf -
-\& $ mv pth-X.Y.Z pth
-.Ve
-Optionally to reduce the size of the \f(CW\*(C`pth/\*(C'\fR subdirectory, we can strip down
-the \fBPth\fR sources to a minimum with the \fIstriptease\fR feature:
-.PP
-.Vb 4
-\& $ cd pth
-\& $ ./configure
-\& $ make striptease
-\& $ cd ..
-.Ve
-After this the source tree of \f(CW\*(C`foo\*(C'\fR should look similar to this:
-.PP
-.Vb 24
-\& $ ls -l
-\& -rw-r--r--  1 rse  users    709 Nov  3 11:51 Makefile.in
-\& -rw-r--r--  1 rse  users  16431 Nov  3 12:20 aclocal.m4
-\& -rwxr-xr-x  1 rse  users  57403 Nov  3 12:21 configure
-\& -rw-r--r--  1 rse  users    129 Nov  3 12:21 configure.in
-\& -rw-r--r--  1 rse  users   4227 Nov  3 11:11 foo.c
-\& drwxr-xr-x  2 rse  users   3584 Nov  3 12:36 pth
-\& $ ls -l pth/
-\& -rw-rw-r--  1 rse  users   26344 Nov  1 20:12 COPYING
-\& -rw-rw-r--  1 rse  users    2042 Nov  3 12:36 Makefile.in
-\& -rw-rw-r--  1 rse  users    3967 Nov  1 19:48 README
-\& -rw-rw-r--  1 rse  users     340 Nov  3 12:36 README.1st
-\& -rw-rw-r--  1 rse  users   28719 Oct 31 17:06 config.guess
-\& -rw-rw-r--  1 rse  users   24274 Aug 18 13:31 config.sub
-\& -rwxrwxr-x  1 rse  users  155141 Nov  3 12:36 configure
-\& -rw-rw-r--  1 rse  users  162021 Nov  3 12:36 pth.c
-\& -rw-rw-r--  1 rse  users   18687 Nov  2 15:19 pth.h.in
-\& -rw-rw-r--  1 rse  users    5251 Oct 31 12:46 pth_acdef.h.in
-\& -rw-rw-r--  1 rse  users    2120 Nov  1 11:27 pth_acmac.h.in
-\& -rw-rw-r--  1 rse  users    2323 Nov  1 11:27 pth_p.h.in
-\& -rw-rw-r--  1 rse  users     946 Nov  1 11:27 pth_vers.c
-\& -rw-rw-r--  1 rse  users   26848 Nov  1 11:27 pthread.c
-\& -rw-rw-r--  1 rse  users   18772 Nov  1 11:27 pthread.h.in
-\& -rwxrwxr-x  1 rse  users   26188 Nov  3 12:36 shtool
-.Ve
-Now when we configure and build the \f(CW\*(C`foo\*(C'\fR package it looks similar to this:
-.PP
-.Vb 31
-\& $ ./configure
-\& creating cache ./config.cache
-\& checking for gcc... gcc
-\& checking whether the C compiler (gcc   ) works... yes
-\& checking whether the C compiler (gcc   ) is a cross-compiler... no
-\& checking whether we are using GNU C... yes
-\& checking whether gcc accepts -g... yes
-\& checking how to run the C preprocessor... gcc -E
-\& checking for GNU Pth... version 1.3.0, local under pth
-\& updating cache ./config.cache
-\& creating ./config.status
-\& creating Makefile
-\& configuring in pth
-\& running /bin/sh ./configure  --enable-subdir --enable-batch
-\& --disable-tests --cache-file=.././config.cache --srcdir=.
-\& loading cache .././config.cache
-\& checking for gcc... (cached) gcc
-\& checking whether the C compiler (gcc   ) works... yes
-\& checking whether the C compiler (gcc   ) is a cross-compiler... no
-\& [...]
-\& $ make
-\& ===> pth (all)
-\& ./shtool scpp -o pth_p.h -t pth_p.h.in -Dcpp -Cintern -M '==#==' pth.c
-\& pth_vers.c
-\& gcc -c -I. -O2 -pipe pth.c
-\& gcc -c -I. -O2 -pipe pth_vers.c
-\& ar rc libpth.a pth.o pth_vers.o
-\& ranlib libpth.a
-\& <=== pth
-\& gcc -g -O2 -Ipth -c foo.c
-\& gcc -Lpth -o foo foo.o -lpth
-.Ve
-As you can see, \fBautoconf\fR now automatically configures the local
-(stripped down) copy of \fBPth\fR in the subdirectory \f(CW\*(C`pth/\*(C'\fR and the
-\&\f(CW\*(C`Makefile\*(C'\fR automatically builds the subdirectory, too.
-.SH "SYSTEM CALL WRAPPER FACILITY"
-.IX Header "SYSTEM CALL WRAPPER FACILITY"
-\&\fBPth\fR per default uses an explicit \s-1API\s0, including the system calls. For
-instance you've to explicitly use \fIpth_read\fR\|(3) when you need a thread-aware
-\&\fIread\fR\|(3) and cannot expect that by just calling \fIread\fR\|(3) only the current thread
-is blocked. Instead with the standard \fIread\fR\|(3) call the whole process will be
-blocked. But because for some applications (mainly those consisting of lots of
-third-party stuff) this can be inconvenient.  Here it's required that a call
-to \fIread\fR\|(3) `magically' means \fIpth_read\fR\|(3). The problem here is that such
-magic \fBPth\fR cannot provide per default because it's not really portable.
-Nevertheless \fBPth\fR provides a two step approach to solve this problem:
-.Sh "Soft System Call Mapping"
-.IX Subsection "Soft System Call Mapping"
-This variant is available on all platforms and can \fIalways\fR be enabled by
-building \fBPth\fR with \f(CW\*(C`\-\-enable\-syscall\-soft\*(C'\fR. This then triggers some
-\&\f(CW\*(C`#define\*(C'\fR's in the \f(CW\*(C`pth.h\*(C'\fR header which map for instance \fIread\fR\|(3) to
-\&\fIpth_read\fR\|(3), etc. Currently the following functions are mapped: \fIfork\fR\|(2),
-\&\fIsleep\fR\|(3), \fIsigwait\fR\|(3), \fIwaitpid\fR\|(2), \fIsystem\fR\|(3), \fIselect\fR\|(2), \fIpoll\fR\|(2),
-\&\fIconnect\fR\|(2), \fIaccept\fR\|(2), \fIread\fR\|(2), \fIwrite\fR\|(2), \fIrecv\fR\|(2), \fIsend\fR\|(2), \fIrecvfrom\fR\|(2),
-\&\fIsendto\fR\|(2).
-.PP
-The drawback of this approach is just that really all source files
-of the application where these function calls occur have to include
-\&\f(CW\*(C`pth.h\*(C'\fR, of course. And this also means that existing libraries,
-including the vendor's \fBstdio\fR, usually will still block the whole
-process if one of its I/O functions block.
-.Sh "Hard System Call Mapping"
-.IX Subsection "Hard System Call Mapping"
-This variant is available only on those platforms where the \fIsyscall\fR\|(2)
-function exists and there it can be enabled by building \fBPth\fR with
-\&\f(CW\*(C`\-\-enable\-syscall\-hard\*(C'\fR. This then builds wrapper functions (for instances
-\&\fIread\fR\|(3)) into the \fBPth\fR library which internally call the real \fBPth\fR
-replacement functions (\fIpth_read\fR\|(3)). Currently the following functions
-are mapped: \fIfork\fR\|(2), \fIsleep\fR\|(3), \fIwaitpid\fR\|(2), \fIsystem\fR\|(3), \fIselect\fR\|(2),
-\&\fIpoll\fR\|(2), \fIconnect\fR\|(2), \fIaccept\fR\|(2), \fIread\fR\|(2), \fIwrite\fR\|(2).
-.PP
-The drawback of this approach is that it depends on \fIsyscall\fR\|(2) interface
-and prototype conflicts can occur while building the wrapper functions
-due to different function signatures in the vendor C header files.
-But the advantage of this mapping variant is that the source files of
-the application where these function calls occur have not to include
-\&\f(CW\*(C`pth.h\*(C'\fR and that existing libraries, including the vendor's \fBstdio\fR,
-magically become thread-aware (and then block only the current thread).
-.SH "IMPLEMENTATION NOTES"
-.IX Header "IMPLEMENTATION NOTES"
-\&\fBPth\fR is very portable because it has only one part which perhaps has
-to be ported to new platforms (the machine context initialization). But
-it is written in a way which works on mostly all Unix platforms which
-support \fImakecontext\fR\|(2) or at least \fIsigstack\fR\|(2) or \fIsigaltstack\fR\|(2) [see
-\&\f(CW\*(C`pth_mctx.c\*(C'\fR for details]. Any other \fBPth\fR code is \s-1POSIX\s0 and \s-1ANSI\s0 C
-based only.
-.PP
-The context switching is done via either SUSv2 \fImakecontext\fR\|(2) or \s-1POSIX\s0
-make[sig]\fIsetjmp\fR\|(3) and [sig]\fIlongjmp\fR\|(3). Here all \s-1CPU\s0 registers, the
-program counter and the stack pointer are switched. Additionally the
-\&\fBPth\fR dispatcher switches also the global Unix \f(CW\*(C`errno\*(C'\fR variable [see
-\&\f(CW\*(C`pth_mctx.c\*(C'\fR for details] and the signal mask (either implicitly via
-\&\fIsigsetjmp\fR\|(3) or in an emulated way via explicit \fIsetprocmask\fR\|(2) calls).
-.PP
-The \fBPth\fR event manager is mainly \fIselect\fR\|(2) and \fIgettimeofday\fR\|(2) based,
-i.e., the current time is fetched via \fIgettimeofday\fR\|(2) once per context
-switch for time calculations and all I/O events are implemented via a
-single central \fIselect\fR\|(2) call [see \f(CW\*(C`pth_sched.c\*(C'\fR for details].
-.PP
-The thread control block management is done via virtual priority
-queues without any additional data structure overhead. For this, the
-queue linkage attributes are part of the thread control blocks and the
-queues are actually implemented as rings with a selected element as the
-entry point [see \f(CW\*(C`pth_tcb.h\*(C'\fR and \f(CW\*(C`pth_pqueue.c\*(C'\fR for details].
-.PP
-Most time critical code sections (especially the dispatcher and event
-manager) are speeded up by inlined functions (implemented as \s-1ANSI\s0 C
-pre-processor macros). Additionally any debugging code is \fIcompletely\fR
-removed from the source when not built with \f(CW\*(C`\-DPTH_DEBUG\*(C'\fR (see Autoconf
-\&\f(CW\*(C`\-\-enable\-debug\*(C'\fR option), i.e., not only stub functions remain [see
-\&\f(CW\*(C`pth_debug.c\*(C'\fR for details].
-.SH "RESTRICTIONS"
-.IX Header "RESTRICTIONS"
-\&\fBPth\fR (intentionally) provides no replacements for non-thread-safe
-functions (like \fIstrtok\fR\|(3) which uses a static internal buffer) or
-synchronous system functions (like \fIgethostbyname\fR\|(3) which doesn't
-provide an asynchronous mode where it doesn't block). When you want to
-use those functions in your server application together with threads,
-you've to either link the application against special third-party
-libraries (or for thread-safe/reentrant functions possibly against an
-existing \f(CW\*(C`libc_r\*(C'\fR of the platform vendor). For an asynchronous \s-1DNS\s0
-resolver library use the \s-1GNU\s0 \fBadns\fR package from Ian Jackson ( see
-http://www.gnu.org/software/adns/adns.html ).
-.SH "HISTORY"
-.IX Header "HISTORY"
-The \fBPth\fR library was designed and implemented between February and
-July 1999 by \fIRalf S. Engelschall\fR after evaluating numerous (mostly
-preemptive) thread libraries and after intensive discussions with
-\&\fIPeter Simons\fR, \fIMartin Kraemer\fR, \fILars Eilebrecht\fR and \fIRalph
-Babel\fR related to an experimental (matrix based) non-preemptive \*(C+
-scheduler class written by \fIPeter Simons\fR.
-.PP
-\&\fBPth\fR was then implemented in order to combine the \fInon-preemptive\fR
-approach of multithreading (which provides better portability and
-performance) with an \s-1API\s0 similar to the popular one found in \fBPthread\fR
-libraries (which provides easy programming).
-.PP
-So the essential idea of the non-preemptive approach was taken over from
-\&\fIPeter Simons\fR scheduler. The priority based scheduling algorithm was
-suggested by \fIMartin Kraemer\fR. Some code inspiration also came from
-an experimental threading library (\fBrsthreads\fR) written by \fIRobert
-S. Thau\fR for an ancient internal test version of the Apache webserver.
-The concept and \s-1API\s0 of message ports was borrowed from AmigaOS' \fBExec\fR
-subsystem. The concept and idea for the flexible event mechanism came
-from \fIPaul Vixie\fR's \fBeventlib\fR (which can be found as a part of
-\&\fB\s-1BIND\s0\fR v8).
-.SH "BUG REPORTS AND SUPPORT"
-.IX Header "BUG REPORTS AND SUPPORT"
-If you think you have found a bug in \fBPth\fR, you should send a report as
-complete as possible to \fIbug-pth@gnu.org\fR. If you can, please try to
-fix the problem and include a patch, made with '\f(CW\*(C`diff \-u3\*(C'\fR', in your
-report. Always, at least, include a reasonable amount of description in
-your report to allow the author to deterministically reproduce the bug.
-.PP
-For further support you additionally can subscribe to the
-\&\fIpth-users@gnu.org\fR mailing list by sending an Email to
-\&\fIpth-users-request@gnu.org\fR with `\f(CW\*(C`subscribe pth\-users\*(C'\fR' (or
-`\f(CW\*(C`subscribe pth\-users\*(C'\fR \fIaddress\fR' if you want to subscribe
-from a particular Email \fIaddress\fR) in the body. Then you can
-discuss your issues with other \fBPth\fR users by sending messages to
-\&\fIpth-users@gnu.org\fR. Currently (as of August 2000) you can reach about
-110 Pth users on this mailing list. Old postings you can find at
-\&\fIhttp://www.mail-archive.com/pth-users@gnu.org/\fR.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-.Sh "Related Web Locations"
-.IX Subsection "Related Web Locations"
-`comp.programming.threads Newsgroup Archive',
-http://www.deja.com/topics_if.xp?
-search=topic&group=comp.programming.threads
-.PP
-`comp.programming.threads Frequently Asked Questions (F.A.Q.)',
-http://www.lambdacs.com/newsgroup/FAQ.html
-.PP
-`\fIMultithreading \- Definitions and Guidelines\fR',
-Numeric Quest Inc 1998;
-http://www.numeric-quest.com/lang/multi-frame.html
-.PP
-`\fIThe Single \s-1UNIX\s0 Specification, Version 2 \- Threads\fR',
-The Open Group 1997;
-http://www.opengroup.org/onlinepubs /007908799/xsh/threads.html
-.PP
-\&\s-1SMI\s0 Thread Resources,
-Sun Microsystems Inc;
-http://www.sun.com/workshop/threads/
-.PP
-Bibliography on threads and multithreading,
-Torsten Amundsen;
-http://liinwww.ira.uka.de/bibliography/Os/threads.html
-.Sh "Related Books"
-.IX Subsection "Related Books"
-B. Nichols, D. Buttlar, J.P. Farrel:
-`\fIPthreads Programming \- A \s-1POSIX\s0 Standard for Better Multiprocessing\fR',
-O'Reilly 1996;
-\&\s-1ISBN\s0 1\-56592\-115\-1
-.PP
-B. Lewis, D. J. Berg:
-`\fIMultithreaded Programming with Pthreads\fR',
-Sun Microsystems Press, Prentice Hall 1998;
-\&\s-1ISBN\s0 0\-13\-680729\-1
-.PP
-B. Lewis, D. J. Berg:
-`\fIThreads Primer \- A Guide To Multithreaded Programming\fR',
-Prentice Hall 1996;
-\&\s-1ISBN\s0 0\-13\-443698\-9
-.PP
-S. J. Norton, M. D. Dipasquale:
-`\fIThread Time \- The Multithreaded Programming Guide\fR',
-Prentice Hall 1997;
-\&\s-1ISBN\s0 0\-13\-190067\-6
-.PP
-D. R. Butenhof:
-`\fIProgramming with \s-1POSIX\s0 Threads\fR',
-Addison Wesley 1997;
-\&\s-1ISBN\s0 0\-201\-63392\-2
-.Sh "Related Manpages"
-.IX Subsection "Related Manpages"
-\&\fIpth-config\fR\|(1), \fIpthread\fR\|(3).
-.PP
-\&\fIgetcontext\fR\|(2), \fIsetcontext\fR\|(2), \fImakecontext\fR\|(2), \fIswapcontext\fR\|(2),
-\&\fIsigstack\fR\|(2), \fIsigaltstack\fR\|(2), \fIsigaction\fR\|(2), \fIsigemptyset\fR\|(2), \fIsigaddset\fR\|(2),
-\&\fIsigprocmask\fR\|(2), \fIsigsuspend\fR\|(2), \fIsigsetjmp\fR\|(3), \fIsiglongjmp\fR\|(3), \fIsetjmp\fR\|(3),
-\&\fIlongjmp\fR\|(3), \fIselect\fR\|(2), \fIgettimeofday\fR\|(2).
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-.Vb 3
-\& Ralf S. Engelschall
-\& rse@engelschall.com
-\& www.engelschall.com
-.Ve
Index: ossp-pkg/pth/pth.m4
RCS File: /v/ossp/cvs/ossp-pkg/pth/pth.m4,v
rcsdiff -q -kk '-r1.8' '-r1.9' -u '/v/ossp/cvs/ossp-pkg/pth/pth.m4,v' 2>/dev/null
--- pth.m4	2002/01/27 11:03:40	1.8
+++ pth.m4	2002/01/30 12:54:24	1.9
@@ -21,7 +21,7 @@
 dnl ##  USA, or contact Ralf S. Engelschall <rse@engelschall.com>.
 dnl ##
 dnl ##  pth.m4: Autoconf macro for locating GNU Pth from within
-dnl ##          configure.in of third-party software packages
+dnl ##          configure.ac of third-party software packages
 dnl ##
 
 dnl ##
Index: ossp-pkg/pth/pth.pod
RCS File: /v/ossp/cvs/ossp-pkg/pth/pth.pod,v
rcsdiff -q -kk '-r1.151' '-r1.152' -u '/v/ossp/cvs/ossp-pkg/pth/pth.pod,v' 2>/dev/null
--- pth.pod	2002/01/27 11:03:40	1.151
+++ pth.pod	2002/01/30 12:54:24	1.152
@@ -1914,16 +1914,16 @@
 
 Because B<autoconf> generates additional files, we added a canonical
 C<distclean> target which cleans this up. Secondly, we wrote
-C<configure.in>, a (minimal) B<autoconf> script specification:
+C<configure.ac>, a (minimal) B<autoconf> script specification:
 
- $ vi configure.in
+ $ vi configure.ac
  | AC_INIT(Makefile.in)
  | AC_CHECK_PTH(1.3.0)
  | AC_OUTPUT(Makefile)
 
 Then we let B<autoconf>'s C<aclocal> program generate for us an C<aclocal.m4>
 file containing B<Pth>'s C<AC_CHECK_PTH> macro. Then we generate the final
-C<configure> script out of this C<aclocal.m4> file and the C<configure.in>
+C<configure> script out of this C<aclocal.m4> file and the C<configure.ac>
 file:
 
  $ aclocal --acdir=`pth-config --acdir`
@@ -1935,7 +1935,7 @@
  -rw-r--r--  1 rse  users    176 Nov  3 11:11 Makefile.in
  -rw-r--r--  1 rse  users  15314 Nov  3 11:16 aclocal.m4
  -rwxr-xr-x  1 rse  users  52045 Nov  3 11:16 configure
- -rw-r--r--  1 rse  users     63 Nov  3 11:11 configure.in
+ -rw-r--r--  1 rse  users     63 Nov  3 11:11 configure.ac
  -rw-r--r--  1 rse  users   4227 Nov  3 11:11 foo.c
 
 If we now run C<configure> we get a correct C<Makefile> which
@@ -2016,9 +2016,9 @@
  |     rm -f config.log config.status config.cache
  |     rm -f Makefile
 
-Then we create a slightly different B<autoconf> script C<configure.in>:
+Then we create a slightly different B<autoconf> script C<configure.ac>:
 
- $ vi configure.in
+ $ vi configure.ac
  | AC_INIT(Makefile.in)
  | AC_CONFIG_AUX_DIR(pth)
  | AC_CHECK_PTH(1.3.0, subdir:pth --disable-tests)
@@ -2038,7 +2038,7 @@
 Now we let B<autoconf>'s C<aclocal> program again generate for us an
 C<aclocal.m4> file with the contents of B<Pth>'s C<AC_CHECK_PTH> macro.
 Finally we generate the C<configure> script out of this C<aclocal.m4>
-file and the C<configure.in> file.
+file and the C<configure.ac> file.
 
  $ aclocal --acdir=`pth-config --acdir`
  $ autoconf
@@ -2063,7 +2063,7 @@
  -rw-r--r--  1 rse  users    709 Nov  3 11:51 Makefile.in
  -rw-r--r--  1 rse  users  16431 Nov  3 12:20 aclocal.m4
  -rwxr-xr-x  1 rse  users  57403 Nov  3 12:21 configure
- -rw-r--r--  1 rse  users    129 Nov  3 12:21 configure.in
+ -rw-r--r--  1 rse  users    129 Nov  3 12:21 configure.ac
  -rw-r--r--  1 rse  users   4227 Nov  3 11:11 foo.c
  drwxr-xr-x  2 rse  users   3584 Nov  3 12:36 pth
  $ ls -l pth/
Index: ossp-pkg/pth/pth_acdef.h.in
RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/pth_acdef.h.in,v
rcsdiff -q -kk '-r1.17' '-r1.18' -u '/v/ossp/cvs/ossp-pkg/pth/Attic/pth_acdef.h.in,v' 2>/dev/null
--- pth_acdef.h.in	2002/01/27 11:03:40	1.17
+++ pth_acdef.h.in	2002/01/30 12:54:24	1.18
@@ -28,8 +28,6 @@
 #define _PTH_ACDEF_H_
 
 
-/* Define if you have the ANSI C header files.  */
-#undef STDC_HEADERS
 
 /* the custom Autoconf defines */
 #undef HAVE_SIG_ATOMIC_T
@@ -56,164 +54,171 @@
 #undef PTH_STACKGROWTH
 #undef PTH_DMALLOC
 
-/* Define if you have the _longjmp function.  */
-#undef HAVE__LONGJMP
 
-/* Define if you have the _setjmp function.  */
-#undef HAVE__SETJMP
+/* Define if you have the <dlfcn.h> header file. */
+#undef HAVE_DLFCN_H
+
+/* Define if you have the <dmalloc.h> header file. */
+#undef HAVE_DMALLOC_H
 
-/* Define if you have the getcontext function.  */
+/* Define if you have the <errno.h> header file. */
+#undef HAVE_ERRNO_H
+
+/* Define if you have the <fcntl.h> header file. */
+#undef HAVE_FCNTL_H
+
+/* Define if you have the `getcontext' function. */
 #undef HAVE_GETCONTEXT
 
-/* Define if you have the gettimeofday function.  */
+/* Define if you have the `gettimeofday' function. */
 #undef HAVE_GETTIMEOFDAY
 
-/* Define if you have the longjmp function.  */
+/* Define if you have the `dmalloc' library (-ldmalloc). */
+#undef HAVE_LIBDMALLOC
+
+/* Define if you have the `nsl' library (-lnsl). */
+#undef HAVE_LIBNSL
+
+/* Define if you have the `sfio' library (-lsfio). */
+#undef HAVE_LIBSFIO
+
+/* Define if you have the `socket' library (-lsocket). */
+#undef HAVE_LIBSOCKET
+
+/* Define if you have the `longjmp' function. */
 #undef HAVE_LONGJMP
 
-/* Define if you have the makecontext function.  */
+/* Define if you have the `makecontext' function. */
 #undef HAVE_MAKECONTEXT
 
-/* Define if you have the poll function.  */
+/* Define if you have the <net/errno.h> header file. */
+#undef HAVE_NET_ERRNO_H
+
+/* Define if you have the <paths.h> header file. */
+#undef HAVE_PATHS_H
+
+/* Define if you have the `poll' function. */
 #undef HAVE_POLL
 
-/* Define if you have the readv function.  */
+/* Define if you have the <pthread.h> header file. */
+#undef HAVE_PTHREAD_H
+
+/* Define if you have the `readv' function. */
 #undef HAVE_READV
 
-/* Define if you have the select function.  */
+/* Define if you have the `select' function. */
 #undef HAVE_SELECT
 
-/* Define if you have the setcontext function.  */
+/* Define if you have the `setcontext' function. */
 #undef HAVE_SETCONTEXT
 
-/* Define if you have the setjmp function.  */
+/* Define if you have the `setjmp' function. */
 #undef HAVE_SETJMP
 
-/* Define if you have the sigaction function.  */
+/* Define if you have the <setjmp.h> header file. */
+#undef HAVE_SETJMP_H
+
+/* Define if you have the <sfio.h> header file. */
+#undef HAVE_SFIO_H
+
+/* Define if you have the `sigaction' function. */
 #undef HAVE_SIGACTION
 
-/* Define if you have the sigaltstack function.  */
+/* Define if you have the `sigaltstack' function. */
 #undef HAVE_SIGALTSTACK
 
-/* Define if you have the siglongjmp function.  */
+/* Define if you have the `siglongjmp' function. */
 #undef HAVE_SIGLONGJMP
 
-/* Define if you have the sigpending function.  */
+/* Define if you have the <signal.h> header file. */
+#undef HAVE_SIGNAL_H
+
+/* Define if you have the `sigpending' function. */
 #undef HAVE_SIGPENDING
 
-/* Define if you have the sigprocmask function.  */
+/* Define if you have the `sigprocmask' function. */
 #undef HAVE_SIGPROCMASK
 
-/* Define if you have the sigsetjmp function.  */
+/* Define if you have the `sigsetjmp' function. */
 #undef HAVE_SIGSETJMP
 
-/* Define if you have the sigstack function.  */
+/* Define if you have the `sigstack' function. */
 #undef HAVE_SIGSTACK
 
-/* Define if you have the sigsuspend function.  */
+/* Define if you have the `sigsuspend' function. */
 #undef HAVE_SIGSUSPEND
 
-/* Define if you have the strerror function.  */
-#undef HAVE_STRERROR
-
-/* Define if you have the swapcontext function.  */
-#undef HAVE_SWAPCONTEXT
-
-/* Define if you have the syscall function.  */
-#undef HAVE_SYSCALL
-
-/* Define if you have the usleep function.  */
-#undef HAVE_USLEEP
-
-/* Define if you have the writev function.  */
-#undef HAVE_WRITEV
-
-/* Define if you have the <dmalloc.h> header file.  */
-#undef HAVE_DMALLOC_H
-
-/* Define if you have the <errno.h> header file.  */
-#undef HAVE_ERRNO_H
-
-/* Define if you have the <fcntl.h> header file.  */
-#undef HAVE_FCNTL_H
-
-/* Define if you have the <net/errno.h> header file.  */
-#undef HAVE_NET_ERRNO_H
-
-/* Define if you have the <paths.h> header file.  */
-#undef HAVE_PATHS_H
-
-/* Define if you have the <pthread.h> header file.  */
-#undef HAVE_PTHREAD_H
-
-/* Define if you have the <setjmp.h> header file.  */
-#undef HAVE_SETJMP_H
-
-/* Define if you have the <sfio.h> header file.  */
-#undef HAVE_SFIO_H
-
-/* Define if you have the <signal.h> header file.  */
-#undef HAVE_SIGNAL_H
-
-/* Define if you have the <stdarg.h> header file.  */
+/* Define if you have the <stdarg.h> header file. */
 #undef HAVE_STDARG_H
 
-/* Define if you have the <stdio.h> header file.  */
+/* Define if you have the <stdio.h> header file. */
 #undef HAVE_STDIO_H
 
-/* Define if you have the <stdlib.h> header file.  */
+/* Define if you have the <stdlib.h> header file. */
 #undef HAVE_STDLIB_H
 
-/* Define if you have the <string.h> header file.  */
+/* Define if you have the `strerror' function. */
+#undef HAVE_STRERROR
+
+/* Define if you have the <string.h> header file. */
 #undef HAVE_STRING_H
 
-/* Define if you have the <sys/resource.h> header file.  */
+/* Define if you have the `swapcontext' function. */
+#undef HAVE_SWAPCONTEXT
+
+/* Define if you have the `syscall' function. */
+#undef HAVE_SYSCALL
+
+/* Define if you have the <sys/resource.h> header file. */
 #undef HAVE_SYS_RESOURCE_H
 
-/* Define if you have the <sys/select.h> header file.  */
+/* Define if you have the <sys/select.h> header file. */
 #undef HAVE_SYS_SELECT_H
 
-/* Define if you have the <sys/socket.h> header file.  */
-#undef HAVE_SYS_SOCKET_H
-
-/* Define if you have the <sys/socketcall.h> header file.  */
+/* Define if you have the <sys/socketcall.h> header file. */
 #undef HAVE_SYS_SOCKETCALL_H
 
-/* Define if you have the <sys/stat.h> header file.  */
+/* Define if you have the <sys/socket.h> header file. */
+#undef HAVE_SYS_SOCKET_H
+
+/* Define if you have the <sys/stat.h> header file. */
 #undef HAVE_SYS_STAT_H
 
-/* Define if you have the <sys/syscall.h> header file.  */
+/* Define if you have the <sys/syscall.h> header file. */
 #undef HAVE_SYS_SYSCALL_H
 
-/* Define if you have the <sys/time.h> header file.  */
+/* Define if you have the <sys/time.h> header file. */
 #undef HAVE_SYS_TIME_H
 
-/* Define if you have the <sys/types.h> header file.  */
+/* Define if you have the <sys/types.h> header file. */
 #undef HAVE_SYS_TYPES_H
 
-/* Define if you have the <sys/uio.h> header file.  */
+/* Define if you have the <sys/uio.h> header file. */
 #undef HAVE_SYS_UIO_H
 
-/* Define if you have the <sys/wait.h> header file.  */
+/* Define if you have the <sys/wait.h> header file. */
 #undef HAVE_SYS_WAIT_H
 
-/* Define if you have the <ucontext.h> header file.  */
+/* Define if you have the <ucontext.h> header file. */
 #undef HAVE_UCONTEXT_H
 
-/* Define if you have the <unistd.h> header file.  */
+/* Define if you have the <unistd.h> header file. */
 #undef HAVE_UNISTD_H
 
-/* Define if you have the dmalloc library (-ldmalloc).  */
-#undef HAVE_LIBDMALLOC
+/* Define if you have the `usleep' function. */
+#undef HAVE_USLEEP
 
-/* Define if you have the nsl library (-lnsl).  */
-#undef HAVE_LIBNSL
+/* Define if you have the `writev' function. */
+#undef HAVE_WRITEV
 
-/* Define if you have the sfio library (-lsfio).  */
-#undef HAVE_LIBSFIO
+/* Define if you have the `_longjmp' function. */
+#undef HAVE__LONGJMP
 
-/* Define if you have the socket library (-lsocket).  */
-#undef HAVE_LIBSOCKET
+/* Define if you have the `_setjmp' function. */
+#undef HAVE__SETJMP
+
+/* Define if you have the ANSI C header files. */
+#undef STDC_HEADERS
 
 #endif /* _PTH_ACDEF_H_ */
 
Index: ossp-pkg/pth/pthread-config.1
RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/pthread-config.1,v
co -q -kk -p'1.98' '/v/ossp/cvs/ossp-pkg/pth/Attic/pthread-config.1,v' | diff -u - /dev/null -L'ossp-pkg/pth/pthread-config.1' 2>/dev/null
--- ossp-pkg/pth/pthread-config.1
+++ /dev/null	2024-05-14 08:37:11.000000000 +0200
@@ -1,240 +0,0 @@
-.\" Automatically generated by Pod::Man version 1.15
-.\" Sun Jan 27 17:13:14 2002
-.\"
-.\" Standard preamble:
-.\" ======================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.de Vb \" Begin verbatim text
-.ft CW
-.nf
-.ne \\$1
-..
-.de Ve \" End verbatim text
-.ft R
-
-.fi
-..
-.\" Set up some character translations and predefined strings.  \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote.  | will give a
-.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used
-.\" to do unbreakable dashes and therefore won't be available.  \*(C` and
-.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
-.tr \(*W-|\(bv\*(Tr
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.ie n \{\
-.    ds -- \(*W-
-.    ds PI pi
-.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
-.    ds L" ""
-.    ds R" ""
-.    ds C` ""
-.    ds C' ""
-'br\}
-.el\{\
-.    ds -- \|\(em\|
-.    ds PI \(*p
-.    ds L" ``
-.    ds R" ''
-'br\}
-.\"
-.\" If the F register is turned on, we'll generate index entries on stderr
-.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
-.\" index entries marked with X<> in POD.  Of course, you'll have to process
-.\" the output yourself in some meaningful fashion.
-.if \nF \{\
-.    de IX
-.    tm Index:\\$1\t\\n%\t"\\$2"
-..
-.    nr % 0
-.    rr F
-.\}
-.\"
-.\" For nroff, turn off justification.  Always turn off hyphenation; it
-.\" makes way too many mistakes in technical documents.
-.hy 0
-.if n .na
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
-.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
-.bd B 3
-.    \" fudge factors for nroff and troff
-.if n \{\
-.    ds #H 0
-.    ds #V .8m
-.    ds #F .3m
-.    ds #[ \f1
-.    ds #] \fP
-.\}
-.if t \{\
-.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-.    ds #V .6m
-.    ds #F 0
-.    ds #[ \&
-.    ds #] \&
-.\}
-.    \" simple accents for nroff and troff
-.if n \{\
-.    ds ' \&
-.    ds ` \&
-.    ds ^ \&
-.    ds , \&
-.    ds ~ ~
-.    ds /
-.\}
-.if t \{\
-.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-.    \" troff and (daisy-wheel) nroff accents
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-.    \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-.    \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-.    ds : e
-.    ds 8 ss
-.    ds o a
-.    ds d- d\h'-1'\(ga
-.    ds D- D\h'-1'\(hy
-.    ds th \o'bp'
-.    ds Th \o'LP'
-.    ds ae ae
-.    ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
-.\" ======================================================================
-.\"
-.IX Title "PTHREAD-CONFIG 1"
-.TH PTHREAD-CONFIG 1 "27-Jan-2002" "GNU Pth 1.5b1" "POSIX Threading API of GNU Pth"
-.UC
-.SH "NAME"
-\&\fBpthread-config\fR \- Pth pthread library build utility
-.SH "VERSION"
-.IX Header "VERSION"
-\&\s-1GNU\s0 Pth \s-11.5b1 (27-Jan-2002)\s0
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-\&\fBpthread-config\fR
-[\fB\*(--help\fR]
-[\fB\*(--version\fR]
-[\fB\*(--all\fR]
-[\fB\*(--prefix\fR]
-[\fB\*(--exec-prefix\fR]
-[\fB\*(--bindir\fR]
-[\fB\*(--libdir\fR]
-[\fB\*(--includedir\fR]
-[\fB\*(--mandir\fR]
-[\fB\*(--cflags\fR]
-[\fB\*(--ldflags\fR]
-[\fB\*(--libs\fR]
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The \fBpthread-config\fR program is a little helper utility for easy configuring
-and building applications based on the pthread emulation \s-1API\s0 of the \s-1GNU\s0
-Portable Threads (pth) library.  It can be used to query the C compiler and
-linker flags which are required to correctly compile and link the application
-against the \fIpth\fR\|(3) library.
-.SH "OPTIONS"
-.IX Header "OPTIONS"
-\&\fBpthread-config\fR accepts the following options:
-.Ip "\fB\*(--help\fR" 4
-.IX Item "help"
-Prints the short usage information.
-.Ip "\fB\*(--version\fR" 4
-.IX Item "version"
-Prints the version number and date of the installed \fIpth\fR\|(3) library.
-.Ip "\fB\*(--all\fR" 4
-.IX Item "all"
-Forces the output of all flags, that is, including extra flags which are not
-\&\fBPth\fR specific.
-.Ip "\fB\*(--prefix\fR" 4
-.IX Item "prefix"
-Prints the installation prefix of architecture independent files
-.Ip "\fB\*(--exec-prefix\fR" 4
-.IX Item "exec-prefix"
-Prints the installation prefix of architecture dependent files.
-.Ip "\fB\*(--bindir\fR" 4
-.IX Item "bindir"
-Prints the installation directory of binaries.
-.Ip "\fB\*(--libdir\fR" 4
-.IX Item "libdir"
-Prints the installation directory of libraries.
-.Ip "\fB\*(--includedir\fR" 4
-.IX Item "includedir"
-Prints the installation directory of include headers.
-.Ip "\fB\*(--mandir\fR" 4
-.IX Item "mandir"
-Prints the installation directory of manual pages.
-.Ip "\fB\*(--cflags\fR" 4
-.IX Item "cflags"
-Prints the C compiler flags which are needed to compile the \fIpth\fR\|(3)\-based
-application. The output is usually added to the \f(CW\*(C`CFLAGS\*(C'\fR variable of the
-applications \f(CW\*(C`Makefile\*(C'\fR.
-.Ip "\fB\*(--ldflags\fR" 4
-.IX Item "ldflags"
-Prints the linker flags (\f(CW\*(C`\-L\*(C'\fR) which are needed to link the application with
-the \fIpth\fR\|(3) library. The output is usually added to the \f(CW\*(C`LDFLAGS\*(C'\fR variable of
-the applications \f(CW\*(C`Makefile\*(C'\fR.
-.Ip "\fB\*(--libs\fR" 4
-.IX Item "libs"
-Prints the library flags (\f(CW\*(C`\-l\*(C'\fR) which are needed to link the application with
-the \fIpth\fR\|(3) library. The output is usually added to the \f(CW\*(C`LIBS\*(C'\fR variable of the
-applications \f(CW\*(C`Makefile\*(C'\fR.
-.SH "EXAMPLE"
-.IX Header "EXAMPLE"
-.Vb 4
-\& CC      = cc
-\& CFLAGS  = -O `pthread-config --cflags`
-\& LDFLAGS = `pthread-config --ldflags`
-\& LIBS    = -lm `pthread-config --libs`
-.Ve
-.Vb 5
-\& all: foo
-\& foo: foo.o
-\&     $(CC) $(LDFLAGS) -o foo foo.o $(LIBS)
-\& foo.o: foo.c
-\&     $(CC) $(CFLAGS) -c foo.c
-.Ve
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fIpthread\fR\|(3), \fIcc\fR\|(1).
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-.Vb 3
-\& Ralf S. Engelschall
-\& rse@engelschall.com
-\& www.engelschall.com
-.Ve
Index: ossp-pkg/pth/pthread.3
RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/pthread.3,v
co -q -kk -p'1.103' '/v/ossp/cvs/ossp-pkg/pth/Attic/pthread.3,v' | diff -u - /dev/null -L'ossp-pkg/pth/pthread.3' 2>/dev/null
--- ossp-pkg/pth/pthread.3
+++ /dev/null	2024-05-14 08:37:11.000000000 +0200
@@ -1,8318 +0,0 @@
-.\" Automatically generated by Pod::Man version 1.15
-.\" Sun Jan 27 17:13:15 2002
-.\"
-.\" Standard preamble:
-.\" ======================================================================
-.de Sh \" Subsection heading
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.de Vb \" Begin verbatim text
-.ft CW
-.nf
-.ne \\$1
-..
-.de Ve \" End verbatim text
-.ft R
-
-.fi
-..
-.\" Set up some character translations and predefined strings.  \*(-- will
-.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
-.\" double quote, and \*(R" will give a right double quote.  | will give a
-.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used
-.\" to do unbreakable dashes and therefore won't be available.  \*(C` and
-.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
-.tr \(*W-|\(bv\*(Tr
-.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
-.ie n \{\
-.    ds -- \(*W-
-.    ds PI pi
-.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
-.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
-.    ds L" ""
-.    ds R" ""
-.    ds C` ""
-.    ds C' ""
-'br\}
-.el\{\
-.    ds -- \|\(em\|
-.    ds PI \(*p
-.    ds L" ``
-.    ds R" ''
-'br\}
-.\"
-.\" If the F register is turned on, we'll generate index entries on stderr
-.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
-.\" index entries marked with X<> in POD.  Of course, you'll have to process
-.\" the output yourself in some meaningful fashion.
-.if \nF \{\
-.    de IX
-.    tm Index:\\$1\t\\n%\t"\\$2"
-..
-.    nr % 0
-.    rr F
-.\}
-.\"
-.\" For nroff, turn off justification.  Always turn off hyphenation; it
-.\" makes way too many mistakes in technical documents.
-.hy 0
-.if n .na
-.\"
-.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
-.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
-.bd B 3
-.    \" fudge factors for nroff and troff
-.if n \{\
-.    ds #H 0
-.    ds #V .8m
-.    ds #F .3m
-.    ds #[ \f1
-.    ds #] \fP
-.\}
-.if t \{\
-.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
-.    ds #V .6m
-.    ds #F 0
-.    ds #[ \&
-.    ds #] \&
-.\}
-.    \" simple accents for nroff and troff
-.if n \{\
-.    ds ' \&
-.    ds ` \&
-.    ds ^ \&
-.    ds , \&
-.    ds ~ ~
-.    ds /
-.\}
-.if t \{\
-.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
-.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
-.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
-.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
-.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
-.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
-.\}
-.    \" troff and (daisy-wheel) nroff accents
-.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
-.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
-.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
-.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
-.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
-.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
-.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
-.ds ae a\h'-(\w'a'u*4/10)'e
-.ds Ae A\h'-(\w'A'u*4/10)'E
-.    \" corrections for vroff
-.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
-.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
-.    \" for low resolution devices (crt and lpr)
-.if \n(.H>23 .if \n(.V>19 \
-\{\
-.    ds : e
-.    ds 8 ss
-.    ds o a
-.    ds d- d\h'-1'\(ga
-.    ds D- D\h'-1'\(hy
-.    ds th \o'bp'
-.    ds Th \o'LP'
-.    ds ae ae
-.    ds Ae AE
-.\}
-.rm #[ #] #H #V #F C
-.\" ======================================================================
-.\"
-.IX Title "pthread 3"
-.TH pthread 3 "27-Jan-2002" "GNU Pth 1.5b1" "POSIX Threading API of GNU Pth"
-.UC
-.SH "NAME"
-\&\fBpthread\fR \- \s-1POSIX\s0.1c Threading \s-1API\s0 of \s-1GNU\s0 Pth
-.SH "VERSION"
-.IX Header "VERSION"
-\&\s-1GNU\s0 Pth \s-11.5b1 (27-Jan-2002)\s0
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-\&\fBApplication Makefiles:\fR
-.PP
-.Vb 4
-\& #   manually
-\& CFLAGS=-I/path/to/pth/include
-\& LDFLAGS=-L/path/to/pth/lib
-\& LIBS=-lpthread
-.Ve
-.Vb 4
-\& #   automatically
-\& CFLAGS=`pthread-config --cflags`
-\& LDFLAGS=`pthread-config --ldflags`
-\& LIBS=`pthread-config --libs`
-.Ve
-\&\fBApplication source files:\fR
-.PP
-.Vb 1
-\& #include <pthread.h>
-.Ve
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-.Sh "Overview"
-.IX Subsection "Overview"
-This is the \s-1IEEE\s0 Std. 1003.1c (\*(L"\s-1POSIX\s0.1c\*(R") conforming threading \s-1API\s0 of
-\&\s-1GNU\s0 Portable Threads (\fBPth\fR). This \s-1API\s0 is commonly known as ``\fI\s-1POSIX\s0
-threads\fR'' or in short ``\fIPthreads\fR''. It is provided by \fBPth\fR with
-the intention of backward compatibility to existing multithreaded
-applications. It is implemented by mapping the various Pthread \s-1API\s0
-functions to the corresponding native \fBPth\fR \s-1API\s0 functions.
-.Sh "Supported Features"
-.IX Subsection "Supported Features"
-The following defined feature macros in \f(CW\*(C`pthread.h\*(C'\fR indicate supported
-features:
-.PP
-.Vb 3
-\& #define _POSIX_THREADS
-\& #define _POSIX_THREAD_ATTR_STACKADDR
-\& #define _POSIX_THREAD_ATTR_STACKSIZE
-.Ve
-The following undefined feature macros in \f(CW\*(C`pthread.h\*(C'\fR indicate (still)
-unsupported features:
-.PP
-.Vb 5
-\& #undef  _POSIX_THREAD_PRIORITY_SCHEDULING
-\& #undef  _POSIX_THREAD_PRIO_INHERIT
-\& #undef  _POSIX_THREAD_PRIO_PROTECT
-\& #undef  _POSIX_THREAD_PROCESS_SHARED
-\& #undef  _POSIX_THREAD_SAFE_FUNCTIONS
-.Ve
-.Sh "Notes"
-.IX Subsection "Notes"
-A few notes which you should keep in mind when working with the \fBPth\fR Pthread
-\&\s-1API\s0.
-.Ip "\fBNon-Preemptive Scheduling\fR" 4
-.IX Item "Non-Preemptive Scheduling"
-First you have to always remember when working with this Pthread library that
-it uses non-preemptive scheduling, because it is directly based on \fBPth\fR
-(\fBPth\fR for portability reasons is a pure non-preemptive thread scheduling
-system). So there is no implicit yielding of execution control unless you can
-\&\f(CW\*(C`pthread_*\*(C'\fR functions which could block and you cannot expect granular
-concurrency in your application, of course.  Nevertheless the responsiveness
-and concurrency of an event driven application is increased greatly because of
-overlapping I/O.
-.Ip "\fBConflicts with Vendor Implementation\fR" 4
-.IX Item "Conflicts with Vendor Implementation"
-There can be a conflict between the \fBPth\fR \f(CW\*(C`pthread.h\*(C'\fR header and a possibly
-existing vendor \f(CW\*(C`/usr/include/pthread.h\*(C'\fR header which was implicitly included
-by some standard vendor headers (like \f(CW\*(C`/usr/include/unistd.h\*(C'\fR). When this
-occurs try to ``\f(CW\*(C`#define\*(C'\fR'' header-dependent values which prevent the
-inclusion of the vendor header.
-.Sh "Further Reading"
-.IX Subsection "Further Reading"
-There is ``\fIThe Single \s-1UNIX\s0 Specification, Version
-2 \- Threads\fR'', from \fIThe Open Group\fR of 1997 under
-http://www.opengroup.org/onlinepubs/007908799/xsh/threads.html. This is
-a very complete publically available description of the Pthread \s-1API\s0. For
-convinience reasons, a translated copy of these freely available \s-1HTML\s0
-pages are appended to this manpage below. These are \fICopyright (C) 1997
-The Open Group\fR.
-.PP
-Second, you can also buy the official standard from \s-1IEEE\s0. It is the \s-1IEEE\s0
-\&\s-1POSIX\s0 1003.1c-1995 standard (also known as \s-1ISO/IEC\s0 9945\-1:1996), which
-is available as part of the \s-1ANSI/IEEE\s0 1003.1, 1996 edition, standard.
-.PP
-Finally you can look at the files \f(CW\*(C`pthread.c\*(C'\fR and \f(CW\*(C`pthread.h\*(C'\fR in the \fBPth\fR
-source tree for details of the implementation, of course.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fIpthread-config\fR\|(1), \fIpth\fR\|(3).
-.SH "AUTHOR"
-.IX Header "AUTHOR"
-.Vb 3
-\& Ralf S. Engelschall
-\& rse@engelschall.com
-\& www.engelschall.com
-.Ve
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread.h\fR \- threads
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI<pthread.h\fR>
-header defines the following symbols:
-.PP
-.Vb 24
-\& PTHREAD_CANCEL_ASYNCHRONOUS
-\& PTHREAD_CANCEL_ENABLE
-\& PTHREAD_CANCEL_DEFERRED
-\& PTHREAD_CANCEL_DISABLE
-\& PTHREAD_CANCELED
-\& PTHREAD_COND_INITIALIZER
-\& PTHREAD_CREATE_DETACHED
-\& PTHREAD_CREATE_JOINABLE
-\& PTHREAD_EXPLICIT_SCHED
-\& PTHREAD_INHERIT_SCHED
-\& PTHREAD_MUTEX_DEFAULT
-\& PTHREAD_MUTEX_ERRORCHECK
-\& PTHREAD_MUTEX_NORMAL
-\& PTHREAD_MUTEX_INITIALIZER
-\& PTHREAD_MUTEX_RECURSIVE
-\& PTHREAD_ONCE_INIT
-\& PTHREAD_PRIO_INHERIT
-\& PTHREAD_PRIO_NONE
-\& PTHREAD_PRIO_PROTECT
-\& PTHREAD_PROCESS_SHARED
-\& PTHREAD_PROCESS_PRIVATE
-\& PTHREAD_RWLOCK_INITIALIZER
-\& PTHREAD_SCOPE_PROCESS
-\& PTHREAD_SCOPE_SYSTEM
-.Ve
-The \fBpthread_attr_t\fR, \fBpthread_cond_t\fR, \fBpthread_condattr_t\fR,
-\&\fBpthread_key_t\fR, \fBpthread_mutex_t\fR, \fBpthread_mutexattr_t\fR,
-\&\fBpthread_once_t\fR, \fBpthread_rwlock_t\fR, \fBpthread_rwlockattr_t\fR and
-\&\fBpthread_t\fR types are defined as described in \fI<sys/types.h\fR>.
-.PP
-The following are declared as functions and may also be declared as
-macros. Function prototypes must be provided for use with an \s-1ISO\s0 C
-compiler.
-.PP
-.Vb 77
-\& int   pthread_attr_destroy(pthread_attr_t *);
-\& int   pthread_attr_getdetachstate(const pthread_attr_t *, int *);
-\& int   pthread_attr_getguardsize(const pthread_attr_t *, size_t *);
-\& int   pthread_attr_getinheritsched(const pthread_attr_t *, int *);
-\& int   pthread_attr_getschedparam(const pthread_attr_t *, struct sched_param *);
-\& int   pthread_attr_getschedpolicy(const pthread_attr_t *, int *);
-\& int   pthread_attr_getscope(const pthread_attr_t *, int *);
-\& int   pthread_attr_getstackaddr(const pthread_attr_t *, void **);
-\& int   pthread_attr_getstacksize(const pthread_attr_t *, size_t *);
-\& int   pthread_attr_init(pthread_attr_t *);
-\& int   pthread_attr_setdetachstate(pthread_attr_t *, int);
-\& int   pthread_attr_setguardsize(pthread_attr_t *, size_t);
-\& int   pthread_attr_setinheritsched(pthread_attr_t *, int);
-\& int   pthread_attr_setschedparam(pthread_attr_t *, const struct sched_param *);
-\& int   pthread_attr_setschedpolicy(pthread_attr_t *, int);
-\& int   pthread_attr_setscope(pthread_attr_t *, int);
-\& int   pthread_attr_setstackaddr(pthread_attr_t *, void *);
-\& int   pthread_attr_setstacksize(pthread_attr_t *, size_t);
-\& int   pthread_cancel(pthread_t);
-\& void  pthread_cleanup_push(void*), void *);
-\& void  pthread_cleanup_pop(int);
-\& int   pthread_cond_broadcast(pthread_cond_t *);
-\& int   pthread_cond_destroy(pthread_cond_t *);
-\& int   pthread_cond_init(pthread_cond_t *, const pthread_condattr_t *);
-\& int   pthread_cond_signal(pthread_cond_t *);
-\& int   pthread_cond_timedwait(pthread_cond_t *, pthread_mutex_t *, const struct timespec *);
-\& int   pthread_cond_wait(pthread_cond_t *, pthread_mutex_t *);
-\& int   pthread_condattr_destroy(pthread_condattr_t *);
-\& int   pthread_condattr_getpshared(const pthread_condattr_t *, int *);
-\& int   pthread_condattr_init(pthread_condattr_t *);
-\& int   pthread_condattr_setpshared(pthread_condattr_t *, int);
-\& int   pthread_create(pthread_t *, const pthread_attr_t *, void *(*)(void *), void *);
-\& int   pthread_detach(pthread_t);
-\& int   pthread_equal(pthread_t, pthread_t);
-\& void  pthread_exit(void *);
-\& int   pthread_getconcurrency(void);
-\& int   pthread_getschedparam(pthread_t, int *, struct sched_param *);
-\& void *pthread_getspecific(pthread_key_t);
-\& int   pthread_join(pthread_t, void **);
-\& int   pthread_key_create(pthread_key_t *, void (*)(void *));
-\& int   pthread_key_delete(pthread_key_t);
-\& int   pthread_mutex_destroy(pthread_mutex_t *);
-\& int   pthread_mutex_getprioceiling(const pthread_mutex_t *, int *);
-\& int   pthread_mutex_init(pthread_mutex_t *, const pthread_mutexattr_t *);
-\& int   pthread_mutex_lock(pthread_mutex_t *);
-\& int   pthread_mutex_setprioceiling(pthread_mutex_t *, int, int *);
-\& int   pthread_mutex_trylock(pthread_mutex_t *);
-\& int   pthread_mutex_unlock(pthread_mutex_t *);
-\& int   pthread_mutexattr_destroy(pthread_mutexattr_t *);
-\& int   pthread_mutexattr_getprioceiling(const pthread_mutexattr_t *, int *);
-\& int   pthread_mutexattr_getprotocol(const pthread_mutexattr_t *, int *);
-\& int   pthread_mutexattr_getpshared(const pthread_mutexattr_t *, int *);
-\& int   pthread_mutexattr_gettype(const pthread_mutexattr_t *, int *);
-\& int   pthread_mutexattr_init(pthread_mutexattr_t *);
-\& int   pthread_mutexattr_setprioceiling(pthread_mutexattr_t *, int);
-\& int   pthread_mutexattr_setprotocol(pthread_mutexattr_t *, int);
-\& int   pthread_mutexattr_setpshared(pthread_mutexattr_t *, int);
-\& int   pthread_mutexattr_settype(pthread_mutexattr_t *, int);
-\& int   pthread_once(pthread_once_t *, void (*)(void));
-\& int   pthread_rwlock_destroy(pthread_rwlock_t *);
-\& int   pthread_rwlock_init(pthread_rwlock_t *, const pthread_rwlockattr_t *);
-\& int   pthread_rwlock_rdlock(pthread_rwlock_t *);
-\& int   pthread_rwlock_tryrdlock(pthread_rwlock_t *);
-\& int   pthread_rwlock_trywrlock(pthread_rwlock_t *);
-\& int   pthread_rwlock_unlock(pthread_rwlock_t *);
-\& int   pthread_rwlock_wrlock(pthread_rwlock_t *);
-\& int   pthread_rwlockattr_destroy(pthread_rwlockattr_t *);
-\& int   pthread_rwlockattr_getpshared(const pthread_rwlockattr_t *, int *);
-\& int   pthread_rwlockattr_init(pthread_rwlockattr_t *);
-\& int   pthread_rwlockattr_setpshared(pthread_rwlockattr_t *, int);
-\& pthread_t pthread_self(void);
-\& int   pthread_setcancelstate(int, int *);
-\& int   pthread_setcanceltype(int, int *);
-\& int   pthread_setconcurrency(int);
-\& int   pthread_setschedparam(pthread_t, int, const struct sched_param *);
-\& int   pthread_setspecific(pthread_key_t, const void *);
-\& void  pthread_testcancel(void);
-.Ve
-Inclusion of the \fI<pthread.h\fR> header will make visible symbols defined
-in the headers \fI<sched.h\fR> and \fI<time.h\fR>.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-An interpretation request has been filed with \s-1IEEE\s0 \s-1PASC\s0 concerning
-requirements for visibility of symbols in this header.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_getguardsize()\fI\fR,
-\&\fI\fIpthread_attr_setscope()\fI\fR,
-\&\fI\fIpthread_cancel()\fI\fR,
-\&\fI\fIpthread_cleanup_push()\fI\fR,
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI\fIpthread_cond_signal()\fI\fR,
-\&\fI\fIpthread_cond_wait()\fI\fR,
-\&\fI\fIpthread_condattr_init()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_detach()\fI\fR,
-\&\fI\fIpthread_equal()\fI\fR,
-\&\fI\fIpthread_exit()\fI\fR,
-\&\fI\fIpthread_getconcurrency()\fI\fR,
-\&\fI\fIpthread_getschedparam()\fI\fR,
-\&\fI\fIpthread_join()\fI\fR,
-\&\fI\fIpthread_key_create()\fI\fR,
-\&\fI\fIpthread_key_delete()\fI\fR,
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_mutex_lock()\fI\fR,
-\&\fI\fIpthread_mutex_setprioceiling()\fI\fR,
-\&\fI\fIpthread_mutexattr_init()\fI\fR,
-\&\fI\fIpthread_mutexattr_gettype()\fI\fR,
-\&\fI\fIpthread_mutexattr_setprotocol()\fI\fR,
-\&\fI\fIpthread_once()\fI\fR,
-\&\fI\fIpthread_self()\fI\fR,
-\&\fI\fIpthread_setcancelstate()\fI\fR,
-\&\fI\fIpthread_setspecific()\fI\fR,
-\&\fI\fIpthread_rwlock_init()\fI\fR,
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR,
-\&\fI\fIpthread_rwlock_unlock()\fI\fR,
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR,
-\&\fI\fIpthread_rwlockattr_init()\fI\fR,
-\&\fI<sched.h\fR>,
-\&\fI<time.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_atfork\fR \- register fork handlers
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <sys/types.h>
-.PP
-#include <unistd.h>
-.PP
-int pthread_atfork(void (*\fIprepare\fR)(void), void (*\fIparent\fR)(void),
-void (*\fIchild\fR)(void));
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The \fI\fIpthread_atfork()\fI\fR function declares fork handlers to be called
-before and after \fI\fIfork()\fI\fR, in the context of the thread that called
-\&\fI\fIfork()\fI\fR. The \fIprepare\fR fork handler is called before \fI\fIfork()\fI\fR
-processing commences. The \fIparent\fR fork handle is called after
-\&\fI\fIfork()\fI\fR processing completes in the parent process. The \fIchild\fR fork
-handler is called after \fI\fIfork()\fI\fR processing completes in the child
-process. If no handling is desired at one or more of these three points,
-the corresponding fork handler address(es) may be set to \s-1NULL\s0.
-.PP
-The order of calls to \fI\fIpthread_atfork()\fI\fR is significant. The \fIparent\fR
-and \fIchild\fR fork handlers are called in the order in which they were
-established by calls to \fI\fIpthread_atfork()\fI\fR. The \fIprepare\fR fork
-handlers are called in the opposite order.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion, \fI\fIpthread_atfork()\fI\fR returns a value of zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The \fI\fIpthread_atfork()\fI\fR function will fail if:
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient table space exists to record the fork handler addresses.
-.PP
-The \fI\fIpthread_atfork()\fI\fR function will not return an error code of
-[\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIatexit()\fI\fR,
-\&\fI\fIfork()\fI\fR,
-\&\fI<sys/types.h\fR>
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_init,\fR \fBpthread_attr_destroy\fR
-\&\- initialise and destroy threads attribute object
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_init(pthread_attr_t *\fIattr\fR);
-.PP
-int pthread_attr_destroy(pthread_attr_t *\fIattr\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The function \fI\fIpthread_attr_init()\fI\fR initialises a thread attributes
-object \fIattr\fR with the default value for all of the individual
-attributes used by a given implementation.
-.PP
-The resulting attribute object (possibly modified by setting individual
-attribute values), when used by \fI\fIpthread_create()\fI\fR, defines the
-attributes of the thread created. A single attributes object can be used
-in multiple simultaneous calls to \fI\fIpthread_create()\fI\fR.
-.PP
-The \fI\fIpthread_attr_destroy()\fI\fR function is used to destroy a thread
-attributes object. An implementation may cause \fI\fIpthread_attr_destroy()\fI\fR
-to set \fIattr\fR to an implementation-dependent invalid value. The
-behaviour of using the attribute after it has been destroyed is
-undefined.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion, \fI\fIpthread_attr_init()\fI\fR and
-\&\fI\fIpthread_attr_destroy()\fI\fR return a value of 0. Otherwise, an error
-number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The \fI\fIpthread_attr_init()\fI\fR function will fail if:
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the thread attributes object.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_setstackaddr()\fI\fR,
-\&\fI\fIpthread_attr_setstacksize()\fI\fR,
-\&\fI\fIpthread_attr_setdetachstate()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setdetachstate,\fR \fBpthread_attr_getdetachstate\fR
-\&\- set and get detachstate attribute
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setdetachstate(pthread_attr_t *\fIattr\fR, int \fIdetachstate\fR);
-.PP
-int pthread_attr_getdetachstate(const pthread_attr_t *\fIattr\fR, int *\fIdetachstate\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The \fIdetachstate\fR attribute controls whether the thread is created in a
-detached state. If the thread is created detached, then use of the \s-1ID\s0 of
-the newly created thread by the \fI\fIpthread_detach()\fI\fR or \fI\fIpthread_join()\fI\fR
-function is an error.
-.PP
-The \fI\fIpthread_attr_setdetachstate()\fI\fR and
-\&\fI\fIpthread_attr_getdetachstate()\fI\fR, respectively, set and get the
-\&\fIdetachstate\fR attribute in the \fIattr\fR object.
-.PP
-The \fIdetachstate\fR can be set to either \s-1PTHREAD_CREATE_DETACHED\s0 or
-\&\s-1PTHREAD_CREATE_JOINABLE\s0. A value of \s-1PTHREAD_CREATE_DETACHED\s0 causes
-all threads created with \fIattr\fR to be in the detached state, whereas
-using a value of \s-1PTHREAD_CREATE_JOINABLE\s0 causes all threads created
-with \fIattr\fR to be in the joinable state. The default value of the
-\&\fIdetachstate\fR attribute is \s-1PTHREAD_CREATE_JOINABLE\s0 .
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion, \fI\fIpthread_attr_setdetachstate()\fI\fR and
-\&\fI\fIpthread_attr_getdetachstate()\fI\fR return a value of 0. Otherwise, an
-error number is returned to indicate the error.
-.PP
-The \fI\fIpthread_attr_getdetachstate()\fI\fR function stores the value of the
-\&\fIdetachstate\fR attribute in \fIdetachstate\fR if successful.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The \fI\fIpthread_attr_setdetachstate()\fI\fR function will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value of \fIdetachstate\fR was not valid
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setstackaddr()\fI\fR,
-\&\fI\fIpthread_attr_setstacksize()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_getguardsize,\fR \fBpthread_attr_setguardsize\fR \-
-get or set the thread guardsize attribute
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_getguardsize(const pthread_attr_t \fI*attr\fR, size_t
-\&\fI*guardsize\fR); int pthread_attr_setguardsize(pthread_attr_t \fI*attr\fR,
-size_t \fIguardsize\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The \fIguardsize\fR attribute controls the size of the guard area for the
-created thread's stack. The \fIguardsize\fR attribute provides protection
-against overflow of the stack pointer. If a thread's stack is created
-with guard protection, the implementation allocates extra memory at the
-overflow end of the stack as a buffer against stack overflow of the
-stack pointer. If an application overflows into this buffer an error
-results (possibly in a \s-1SIGSEGV\s0 signal being delivered to the thread).
-.PP
-The \fIguardsize\fR attribute is provided to the application
-for two reasons:
-.Ip "1." 4
-Overflow protection can potentially result in wasted system resources.
-An application that creates a large number of threads, and which knows
-its threads will never overflow their stack, can save system resources
-by turning off guard areas.
-.Ip "2." 4
-When threads allocate large data structures on the stack,
-large guard areas may be needed to detect stack overflow.
-.PP
-The \fI\fIpthread_attr_getguardsize()\fI\fR function gets the \fIguardsize\fR
-attribute in the \fIattr\fR object. This attribute is returned in the
-\&\fIguardsize\fR parameter.
-.PP
-The \fI\fIpthread_attr_setguardsize()\fI\fR function sets the \fIguardsize\fR
-attribute in the \fIattr\fR object. The new value of this attribute is
-obtained from the \fIguardsize\fR parameter. If \fIguardsize\fR is zero,
-a guard area will not be provided for threads created with \fIattr\fR.
-If \fIguardsize\fR is greater than zero, a guard area of at least size
-\&\fIguardsize\fR bytes is provided for each thread created with \fIattr\fR.
-.PP
-A conforming implementation is permitted to round up the value
-contained in \fIguardsize\fR to a multiple of the configurable system
-variable \s-1PAGESIZE\s0 (see \fI<sys/mman.h\fR>). If an implementation rounds
-up the value of \fIguardsize\fR to a multiple of \s-1PAGESIZE\s0, a call to
-\&\fI\fIpthread_attr_getguardsize()\fI\fR specifying \fIattr\fR will store in the
-\&\fIguardsize\fR parameter the guard size specified by the previous
-\&\fI\fIpthread_attr_setguardsize()\fI\fR function call.
-.PP
-The default value of the \fIguardsize\fR attribute is \s-1PAGESIZE\s0 bytes. The
-actual value of \s-1PAGESIZE\s0 is implementation-dependent and may not be the
-same on all implementations.
-.PP
-If the \fIstackaddr\fR attribute has been set (that is, the caller is
-allocating and managing its own thread stacks), the \fIguardsize\fR
-attribute is ignored and no protection will be provided by the
-implementation. It is the responsibility of the application to manage
-stack overflow along with stack allocation and management in this case.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the \fI\fIpthread_attr_getguardsize()\fI\fR and
-\&\fI\fIpthread_attr_setguardsize()\fI\fR functions return zero. Otherwise, an
-error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The \fI\fIpthread_attr_getguardsize()\fI\fR and \fI\fIpthread_attr_setguardsize()\fI\fR
-functions will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The attribute \fIattr\fR is invalid.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The parameter \fIguardsize\fR is invalid.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The parameter \fIguardsize\fR contains an invalid value.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setinheritsched,\fR \fBpthread_attr_getinheritsched\fR
-\&\- set and get inheritsched attribute
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setinheritsched(pthread_attr_t *\fIattr\fR,
-int \fIinheritsched\fR);
-int pthread_attr_getinheritsched(const pthread_attr_t *\fIattr\fR,
-int *\fIinheritsched\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The functions \fI\fIpthread_attr_setinheritsched()\fI\fR and
-\&\fI\fIpthread_attr_getinheritsched()\fI\fR, respectively, set and get the
-\&\fIinheritsched\fR attribute in the \fIattr\fR argument.
-.PP
-When the attribute objects are used by \fI\fIpthread_create()\fI\fR, the
-\&\fIinheritsched\fR attribute determines how the other scheduling attributes
-of the created thread are to be set:
-.Ip "\s-1PTHREAD_INHERIT_SCHED\s0" 4
-.IX Item "PTHREAD_INHERIT_SCHED"
-Specifies that the scheduling policy and associated attributes are to
-be inherited from the creating thread, and the scheduling attributes in
-this \fIattr\fR argument are to be ignored.
-.Ip "\s-1PTHREAD_EXPLICIT_SCHED\s0" 4
-.IX Item "PTHREAD_EXPLICIT_SCHED"
-Specifies that the scheduling policy and associated attributes
-are to be set to the corresponding values from this attribute object.
-.PP
-The symbols \s-1PTHREAD_INHERIT_SCHED\s0 and \s-1PTHREAD_EXPLICIT_SCHED\s0 are defined
-in the header \fI<pthread.h\fR>.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the \fI\fIpthread_attr_setinheritsched()\fI\fR and
-\&\fI\fIpthread_attr_getinheritsched()\fI\fR functions return zero. Otherwise, an
-error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The \fI\fIpthread_attr_setinheritsched()\fI\fR and
-\&\fI\fIpthread_attr_getinheritsched()\fI\fR functions will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The option _POSIX_THREAD_PRIORITY_SCHEDULING is not defined and the
-implementation does not support the function.
-.PP
-The \fI\fIpthread_attr_setinheritsched()\fI\fR function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value of the attribute being set is not valid.
-.Ip "[\s-1ENOTSUP\s0]" 4
-.IX Item "[ENOTSUP]"
-An attempt was made to set the attribute to an unsupported value.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-After these attributes have been set, a thread can be created with the
-specified attributes using \fI\fIpthread_create()\fI\fR. Using these routines
-does not affect the current running thread.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setscope()\fI\fR,
-\&\fI\fIpthread_attr_setschedpolicy()\fI\fR,
-\&\fI\fIpthread_attr_setschedparam()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_setschedparam()\fI\fR,
-\&\fI<sched.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setschedparam,\fR \fBpthread_attr_getschedparam\fR
-\&\- set and get schedparam attribute
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setschedparam(pthread_attr_t *\fIattr\fR, const struct sched_param *\fIparam\fR);
-.PP
-int pthread_attr_getschedparam(const pthread_attr_t *\fIattr\fR, struct sched_param *\fIparam\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The functions \fI\fIpthread_attr_setschedparam()\fI\fR and
-\&\fI\fIpthread_attr_getschedparam()\fI\fR, respectively, set and get the
-scheduling parameter attributes in the \fIattr\fR argument. The contents of
-the \fIparam\fR structure are defined in \fI<sched.h\fR>. For the \s-1SCHED_FIFO\s0
-and \s-1SCHED_RR\s0 policies, the only required member of \fIparam\fR is
-\&\fIsched_priority\fR.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the \fI\fIpthread_attr_setschedparam()\fI\fR and
-\&\fI\fIpthread_attr_getschedparam()\fI\fR functions return zero. Otherwise, an
-error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The \fI\fIpthread_attr_setschedparam()\fI\fR function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value of the attribute being set is not valid.
-.Ip "[\s-1ENOTSUP\s0]" 4
-.IX Item "[ENOTSUP]"
-An attempt was made to set the attribute to an unsupported value.
-.PP
-The
-\&\fI\fIpthread_attr_setschedparam()\fI\fR
-and
-\&\fI\fIpthread_attr_getschedparam()\fI\fR
-functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-After these attributes have been set, a thread can be created with the
-specified attributes using \fI\fIpthread_create()\fI\fR. Using these routines
-does not affect the current running thread.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setscope()\fI\fR,
-\&\fI\fIpthread_attr_setinheritsched()\fI\fR,
-\&\fI\fIpthread_attr_setschedpolicy()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_setschedparam()\fI\fR,
-\&\fI<sched.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setschedpolicy,\fR \fBpthread_attr_getschedpolicy\fR
-\&\- set and get schedpolicy attribute
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setschedpolicy(pthread_attr_t *\fIattr\fR, int \fIpolicy\fR);
-int pthread_attr_getschedpolicy(const pthread_attr_t *\fIattr\fR,
-int *\fIpolicy\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The functions \fI\fIpthread_attr_setschedpolicy()\fI\fR and
-\&\fI\fIpthread_attr_getschedpolicy()\fI\fR, respectively, set and get the
-\&\fIschedpolicy\fR attribute in the \fIattr\fR argument.
-.PP
-The supported values of \fIpolicy\fR include \s-1SCHED_FIFO\s0, \s-1SCHED_RR\s0 and
-\&\s-1SCHED_OTHER\s0, which are defined by the header \fI<sched.h\fR>. When threads
-executing with the scheduling policy \s-1SCHED_FIFO\s0 or \s-1SCHED_RR\s0 are waiting
-on a mutex, they acquire the mutex in priority order when the mutex is
-unlocked.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the \fI\fIpthread_attr_setschedpolicy()\fI\fR and
-\&\fI\fIpthread_attr_getschedpolicy()\fI\fR functions return zero. Otherwise, an
-error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The \fI\fIpthread_attr_setschedpolicy()\fI\fR and
-\&\fI\fIpthread_attr_getschedpolicy()\fI\fR functions will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The option _POSIX_THREAD_PRIORITY_SCHEDULING is not defined and the
-implementation does not support the function.
-.PP
-The \fI\fIpthread_attr_setschedpolicy()\fI\fR function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value of the attribute being set is not valid.
-.Ip "[\s-1ENOTSUP\s0]" 4
-.IX Item "[ENOTSUP]"
-An attempt was made to set the attribute to an unsupported value.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-After these attributes have been set, a thread can be created with the
-specified attributes using \fI\fIpthread_create()\fI\fR. Using these routines
-does not affect the current running thread.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setscope()\fI\fR,
-\&\fI\fIpthread_attr_setinheritsched()\fI\fR,
-\&\fI\fIpthread_attr_setschedparam()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_setschedparam()\fI\fR,
-\&\fI<sched.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setscope,\fR \fBpthread_attr_getscope\fR
-\&\- set and get contentionscope attribute
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setscope(pthread_attr_t *\fIattr\fR, int \fIcontentionscope\fR);
-int pthread_attr_getscope(const pthread_attr_t *\fIattr\fR,
-int *\fIcontentionscope\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The \fI\fIpthread_attr_setscope()\fI\fR and \fI\fIpthread_attr_getscope()\fI\fR functions
-are used to set and get the \fIcontentionscope\fR attribute in the \fIattr\fR
-object.
-.PP
-The \fIcontentionscope\fR attribute may have the values
-\&\s-1PTHREAD_SCOPE_SYSTEM\s0, signifying system scheduling contention scope, or
-\&\s-1PTHREAD_SCOPE_PROCESS\s0, signifying process scheduling contention scope.
-The symbols \s-1PTHREAD_SCOPE_SYSTEM\s0 and \s-1PTHREAD_SCOPE_PROCESS\s0 are defined
-by the header \fI<pthread.h\fR>.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the \fI\fIpthread_attr_setscope()\fI\fR and
-\&\fI\fIpthread_attr_getscope()\fI\fR functions return zero. Otherwise, an error
-number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The \fI\fIpthread_attr_setscope()\fI\fR and \fI\fIpthread_attr_getscope()\fI\fR functions
-will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The option _POSIX_THREAD_PRIORITY_SCHEDULING is not defined and the
-implementation does not support the function.
-.PP
-The
-\&\fI\fIpthread_attr_setscope()\fI\fR,
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value of the attribute being set is not valid.
-.Ip "[\s-1ENOTSUP\s0]" 4
-.IX Item "[ENOTSUP]"
-An attempt was made to set the attribute to an unsupported value.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-After these attributes have been set, a thread can be created with the
-specified attributes using \fI\fIpthread_create()\fI\fR. Using these routines
-does not affect the current running thread.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setinheritsched()\fI\fR,
-\&\fI\fIpthread_attr_setschedpolicy()\fI\fR,
-\&\fI\fIpthread_attr_setschedparam()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_setschedparam()\fI\fR,
-\&\fI<sched.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setstackaddr,\fR \fBpthread_attr_getstackaddr\fR
-\&\- set and get stackaddr attribute
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setstackaddr(pthread_attr_t *\fIattr\fR, void *\fIstackaddr\fR);
-.PP
-int pthread_attr_getstackaddr(const pthread_attr_t *\fIattr\fR, void **\fIstackaddr\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The functions \fI\fIpthread_attr_setstackaddr()\fI\fR and
-\&\fI\fIpthread_attr_getstackaddr()\fI\fR, respectively, set and get the thread
-creation \fIstackaddr\fR attribute in the \fIattr\fR object.
-.PP
-The \fIstackaddr\fR attribute specifies the location of storage to be used
-for the created thread's stack. The size of the storage is at least
-\&\s-1PTHREAD_STACK_MIN\s0.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion, \fI\fIpthread_attr_setstackaddr()\fI\fR and
-\&\fI\fIpthread_attr_getstackaddr()\fI\fR return a value of 0. Otherwise, an error
-number is returned to indicate the error.
-.PP
-The \fI\fIpthread_attr_getstackaddr()\fI\fR function stores the \fIstackaddr\fR
-attribute value in \fIstackaddr\fR if successful.
-.SH "ERRORS"
-.IX Header "ERRORS"
-No errors are defined.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setdetachstate()\fI\fR,
-\&\fI\fIpthread_attr_setstacksize()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<limits.h\fR>,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setstacksize,\fR \fBpthread_attr_getstacksize\fR
-\&\- set and get stacksize attribute
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setstacksize(pthread_attr_t *\fIattr\fR, size_t \fIstacksize\fR);
-int pthread_attr_getstacksize(const pthread_attr_t *\fIattr\fR,
-size_t *\fIstacksize\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The functions
-\&\fI\fIpthread_attr_setstacksize()\fI\fR
-and
-\&\fI\fIpthread_attr_getstacksize()\fI\fR,
-respectively, set and get the thread creation
-\&\fIstacksize\fR
-attribute in the
-\&\fIattr\fR
-object.
-.PP
-The
-\&\fIstacksize\fR
-attribute defines the minimum stack size (in bytes) allocated for
-the created threads stack.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion,
-\&\fI\fIpthread_attr_setstacksize()\fI\fR
-and
-\&\fI\fIpthread_attr_getstacksize()\fI\fR
-return a value of 0.
-Otherwise, an error number is returned to indicate the error.
-The
-\&\fI\fIpthread_attr_getstacksize()\fI\fR
-function stores the
-\&\fIstacksize\fR
-attribute value in
-\&\fIstacksize\fR
-if successful.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_attr_setstacksize()\fI\fR
-function will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value of
-\&\fIstacksize\fR
-is less than \s-1PTHREAD_STACK_MIN\s0 or exceeds a system-imposed limit.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setstackaddr()\fI\fR,
-\&\fI\fIpthread_attr_setdetachstate()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<limits.h\fR>,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_init,\fR \fBpthread_attr_destroy\fR
-\&\- initialise and destroy threads attribute object
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_init(pthread_attr_t *\fIattr\fR);
-int pthread_attr_destroy(pthread_attr_t *\fIattr\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The function
-\&\fI\fIpthread_attr_init()\fI\fR
-initialises a thread attributes object
-\&\fIattr\fR
-with the default value for all of the individual attributes
-used by a given implementation.
-.PP
-The resulting attribute object
-(possibly modified by setting individual attribute values),
-when used by
-\&\fI\fIpthread_create()\fI\fR,
-defines the attributes of the thread created.
-A single attributes object can be used in multiple simultaneous calls to
-\&\fI\fIpthread_create()\fI\fR.
-.PP
-The
-\&\fI\fIpthread_attr_destroy()\fI\fR
-function is used to destroy a thread attributes object.
-An implementation may cause
-\&\fI\fIpthread_attr_destroy()\fI\fR
-to set
-\&\fIattr\fR
-to an implementation-dependent invalid value.
-The behaviour of using the attribute after it has been destroyed is undefined.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion,
-\&\fI\fIpthread_attr_init()\fI\fR
-and
-\&\fI\fIpthread_attr_destroy()\fI\fR
-return a value of 0.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_attr_init()\fI\fR
-function will fail if:
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the thread attributes object.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_setstackaddr()\fI\fR,
-\&\fI\fIpthread_attr_setstacksize()\fI\fR,
-\&\fI\fIpthread_attr_setdetachstate()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setdetachstate,\fR \fBpthread_attr_getdetachstate\fR
-\&\- set and get detachstate attribute
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setdetachstate(pthread_attr_t *\fIattr\fR, int \fIdetachstate\fR);
-int pthread_attr_getdetachstate(const pthread_attr_t *\fIattr\fR,
-int *\fIdetachstate\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fIdetachstate\fR
-attribute controls whether the thread is created in a detached state.
-If the thread is created detached,
-then use of the \s-1ID\s0 of the newly created thread by the
-\&\fI\fIpthread_detach()\fI\fR
-or
-\&\fI\fIpthread_join()\fI\fR
-function is an error.
-.PP
-The
-\&\fI\fIpthread_attr_setdetachstate()\fI\fR
-and
-\&\fI\fIpthread_attr_getdetachstate()\fI\fR,
-respectively, set and get the
-\&\fIdetachstate\fR
-attribute in the
-\&\fIattr\fR
-object.
-.PP
-The
-\&\fIdetachstate\fR
-can be set to either \s-1PTHREAD_CREATE_DETACHED\s0 or \s-1PTHREAD_CREATE_JOINABLE\s0.
-A value of \s-1PTHREAD_CREATE_DETACHED\s0 causes all threads created with
-\&\fIattr\fR
-to be in the detached state, whereas using a value of
-\&\s-1PTHREAD_CREATE_JOINABLE\s0
-causes all threads created with
-\&\fIattr\fR
-to be in the joinable state.
-The default value of the
-\&\fIdetachstate\fR
-attribute is
-\&\s-1PTHREAD_CREATE_JOINABLE\s0 .
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion,
-\&\fI\fIpthread_attr_setdetachstate()\fI\fR
-and
-\&\fI\fIpthread_attr_getdetachstate()\fI\fR
-return a value of 0.
-Otherwise, an error number is returned to indicate the error.
-.PP
-The
-\&\fI\fIpthread_attr_getdetachstate()\fI\fR
-function stores the value of the
-\&\fIdetachstate\fR
-attribute in
-\&\fIdetachstate\fR
-if successful.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_attr_setdetachstate()\fI\fR
-function will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value of
-\&\fIdetachstate\fR
-was not valid
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setstackaddr()\fI\fR,
-\&\fI\fIpthread_attr_setstacksize()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_getguardsize,\fR \fBpthread_attr_setguardsize\fR \-
-get or set the thread guardsize attribute
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_getguardsize(const pthread_attr_t \fI*attr\fR,
-size_t \fI*guardsize\fR);
-int pthread_attr_setguardsize(pthread_attr_t \fI*attr\fR,
-size_t \fIguardsize\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The \fIguardsize\fR attribute controls the size
-of the guard area for the created thread's stack. The \fIguardsize\fR
-attribute provides protection against overflow of the
-stack pointer. If a thread's stack is created with guard
-protection, the implementation allocates extra
-memory at the overflow end of the stack as a buffer against
-stack overflow of the stack pointer. If an application
-overflows into this buffer an error results (possibly
-in a \s-1SIGSEGV\s0 signal being delivered to the thread).
-.PP
-The \fIguardsize\fR attribute is provided to the application
-for two reasons:
-.Ip "1." 4
-Overflow protection can potentially
-result in wasted system resources. An application that creates a large
-number of threads, and which knows its threads will never overflow
-their stack, can save system resources by turning off guard areas.
-.Ip "2." 4
-When threads allocate large data structures on the stack,
-large guard areas may be needed to detect stack overflow.
-.PP
-The
-\&\fI\fIpthread_attr_getguardsize()\fI\fR
-function gets the
-\&\fIguardsize\fR attribute in the \fIattr\fR object. This attribute is
-returned in the \fIguardsize\fR parameter.
-.PP
-The
-\&\fI\fIpthread_attr_setguardsize()\fI\fR
-function sets the
-\&\fIguardsize\fR attribute in the \fIattr\fR object. The new value of
-this attribute is obtained from the \fIguardsize\fR parameter.
-If \fIguardsize\fR is zero, a guard area will not be
-provided for threads created with \fIattr\fR. If \fIguardsize\fR is
-greater
-than zero, a guard area of at least size \fIguardsize\fR
-bytes is provided for each thread created with \fIattr\fR.
-.PP
-A conforming implementation is permitted to round up
-the value contained in \fIguardsize\fR to a multiple
-of the configurable system variable \s-1PAGESIZE\s0 (see
-\&\fI<sys/mman.h\fR>).
-If an implementation rounds up the
-value of \fIguardsize\fR to a multiple of \s-1PAGESIZE\s0, a call to
-\&\fI\fIpthread_attr_getguardsize()\fI\fR
-specifying \fIattr\fR will
-store in the \fIguardsize\fR parameter the guard size specified by the
-previous
-\&\fI\fIpthread_attr_setguardsize()\fI\fR
-function call.
-.PP
-The default value of the \fIguardsize\fR attribute is \s-1PAGESIZE\s0 bytes.
-The actual value of \s-1PAGESIZE\s0 is
-implementation-dependent and may not be the same on all implementations.
-.PP
-If the \fIstackaddr\fR attribute has been set (that is, the caller
-is allocating and managing its own thread stacks), the
-\&\fIguardsize\fR attribute is ignored and no protection
-will be provided by the implementation. It is the
-responsibility of the application to manage stack overflow
-along with stack allocation and management in this
-case.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_attr_getguardsize()\fI\fR
-and
-\&\fI\fIpthread_attr_setguardsize()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_attr_getguardsize()\fI\fR
-and
-\&\fI\fIpthread_attr_setguardsize()\fI\fR
-functions will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The attribute \fIattr\fR is invalid.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The parameter \fIguardsize\fR is invalid.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The parameter \fIguardsize\fR contains an invalid value.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setinheritsched,\fR \fBpthread_attr_getinheritsched\fR
-\&\- set and get inheritsched attribute
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setinheritsched(pthread_attr_t *\fIattr\fR,
-int \fIinheritsched\fR);
-int pthread_attr_getinheritsched(const pthread_attr_t *\fIattr\fR,
-int *\fIinheritsched\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The functions
-\&\fI\fIpthread_attr_setinheritsched()\fI\fR
-and
-\&\fI\fIpthread_attr_getinheritsched()\fI\fR,
-respectively, set and get the
-\&\fIinheritsched\fR
-attribute in the
-\&\fIattr\fR
-argument.
-.PP
-When the attribute objects are used by
-\&\fI\fIpthread_create()\fI\fR,
-the
-\&\fIinheritsched\fR
-attribute determines how the other scheduling attributes of
-the created thread are to be set:
-.Ip "\s-1PTHREAD_INHERIT_SCHED\s0" 4
-.IX Item "PTHREAD_INHERIT_SCHED"
-Specifies that the scheduling policy and associated attributes
-are to be inherited from the creating thread, and the scheduling
-attributes in this
-\&\fIattr\fR
-argument are to be ignored.
-.Ip "\s-1PTHREAD_EXPLICIT_SCHED\s0" 4
-.IX Item "PTHREAD_EXPLICIT_SCHED"
-Specifies that the scheduling policy and associated attributes
-are to be set to the corresponding values from this attribute object.
-.PP
-The symbols \s-1PTHREAD_INHERIT_SCHED\s0 and \s-1PTHREAD_EXPLICIT_SCHED\s0
-are defined in the header
-\&\fI<pthread.h\fR>.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_attr_setinheritsched()\fI\fR
-and
-\&\fI\fIpthread_attr_getinheritsched()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_attr_setinheritsched()\fI\fR
-and
-\&\fI\fIpthread_attr_getinheritsched()\fI\fR
-functions will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The option _POSIX_THREAD_PRIORITY_SCHEDULING is not defined and the
-implementation does not support the function.
-.PP
-The
-\&\fI\fIpthread_attr_setinheritsched()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value of the attribute being set is not valid.
-.Ip "[\s-1ENOTSUP\s0]" 4
-.IX Item "[ENOTSUP]"
-An attempt was made to set the attribute to an unsupported value.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-After these attributes have been set, a thread can be created with
-the specified attributes using
-\&\fI\fIpthread_create()\fI\fR.
-Using these routines does not affect the current running thread.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setscope()\fI\fR,
-\&\fI\fIpthread_attr_setschedpolicy()\fI\fR,
-\&\fI\fIpthread_attr_setschedparam()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_setschedparam()\fI\fR,
-\&\fI<sched.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setschedparam,\fR \fBpthread_attr_getschedparam\fR
-\&\- set and get schedparam attribute
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setschedparam(pthread_attr_t *\fIattr\fR,
-const struct sched_param *\fIparam\fR);
-int pthread_attr_getschedparam(const pthread_attr_t *\fIattr\fR,
-struct sched_param *\fIparam\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The functions
-\&\fI\fIpthread_attr_setschedparam()\fI\fR
-and
-\&\fI\fIpthread_attr_getschedparam()\fI\fR,
-respectively, set and get the scheduling parameter
-attributes in the
-\&\fIattr\fR
-argument.
-The contents of the
-\&\fIparam\fR
-structure are defined in
-\&\fI<sched.h\fR>.
-For the \s-1SCHED_FIFO\s0 and \s-1SCHED_RR\s0 policies,
-the only required member of
-\&\fIparam\fR
-is
-\&\fIsched_priority\fR.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_attr_setschedparam()\fI\fR
-and
-\&\fI\fIpthread_attr_getschedparam()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_attr_setschedparam()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value of the attribute being set is not valid.
-.Ip "[\s-1ENOTSUP\s0]" 4
-.IX Item "[ENOTSUP]"
-An attempt was made to set the attribute to an unsupported value.
-.PP
-The
-\&\fI\fIpthread_attr_setschedparam()\fI\fR
-and
-\&\fI\fIpthread_attr_getschedparam()\fI\fR
-functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-After these attributes have been set, a thread can be created with
-the specified attributes using
-\&\fI\fIpthread_create()\fI\fR.
-Using these routines does not affect the current running thread.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setscope()\fI\fR,
-\&\fI\fIpthread_attr_setinheritsched()\fI\fR,
-\&\fI\fIpthread_attr_setschedpolicy()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_setschedparam()\fI\fR,
-\&\fI<sched.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setschedpolicy,\fR \fBpthread_attr_getschedpolicy\fR
-\&\- set and get schedpolicy attribute
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setschedpolicy(pthread_attr_t *\fIattr\fR, int \fIpolicy\fR);
-int pthread_attr_getschedpolicy(const pthread_attr_t *\fIattr\fR,
-int *\fIpolicy\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The functions
-\&\fI\fIpthread_attr_setschedpolicy()\fI\fR
-and
-\&\fI\fIpthread_attr_getschedpolicy()\fI\fR,
-respectively, set and get the
-\&\fIschedpolicy\fR
-attribute in the
-\&\fIattr\fR
-argument.
-.PP
-The supported values of
-\&\fIpolicy\fR
-include \s-1SCHED_FIFO\s0, \s-1SCHED_RR\s0 and \s-1SCHED_OTHER\s0,
-which are defined by the header
-\&\fI<sched.h\fR>.
-When threads executing with the scheduling policy
-\&\s-1SCHED_FIFO\s0 or \s-1SCHED_RR\s0 are waiting on a mutex,
-they acquire the mutex in priority order when the mutex is unlocked.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_attr_setschedpolicy()\fI\fR
-and
-\&\fI\fIpthread_attr_getschedpolicy()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_attr_setschedpolicy()\fI\fR
-and
-\&\fI\fIpthread_attr_getschedpolicy()\fI\fR
-functions will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The option _POSIX_THREAD_PRIORITY_SCHEDULING is not defined and the
-implementation does not support the function.
-.PP
-The
-\&\fI\fIpthread_attr_setschedpolicy()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value of the attribute being set is not valid.
-.Ip "[\s-1ENOTSUP\s0]" 4
-.IX Item "[ENOTSUP]"
-An attempt was made to set the attribute to an unsupported value.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-After these attributes have been set, a thread can be created with
-the specified attributes using
-\&\fI\fIpthread_create()\fI\fR.
-Using these routines does not affect the current running thread.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setscope()\fI\fR,
-\&\fI\fIpthread_attr_setinheritsched()\fI\fR,
-\&\fI\fIpthread_attr_setschedparam()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_setschedparam()\fI\fR,
-\&\fI<sched.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setscope,\fR \fBpthread_attr_getscope\fR
-\&\- set and get contentionscope attribute
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setscope(pthread_attr_t *\fIattr\fR, int \fIcontentionscope\fR);
-int pthread_attr_getscope(const pthread_attr_t *\fIattr\fR,
-int *\fIcontentionscope\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_attr_setscope()\fI\fR
-and
-\&\fI\fIpthread_attr_getscope()\fI\fR
-functions are used to set and get the
-\&\fIcontentionscope\fR
-attribute in the
-\&\fIattr\fR
-object.
-.PP
-The
-\&\fIcontentionscope\fR
-attribute may have the values
-\&\s-1PTHREAD_SCOPE_SYSTEM\s0,
-signifying system scheduling contention scope,
-or \s-1PTHREAD_SCOPE_PROCESS\s0,
-signifying process scheduling contention scope.
-The symbols \s-1PTHREAD_SCOPE_SYSTEM\s0 and \s-1PTHREAD_SCOPE_PROCESS\s0
-are defined by the header
-\&\fI<pthread.h\fR>.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_attr_setscope()\fI\fR
-and
-\&\fI\fIpthread_attr_getscope()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_attr_setscope()\fI\fR
-and
-\&\fI\fIpthread_attr_getscope()\fI\fR
-functions will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The option _POSIX_THREAD_PRIORITY_SCHEDULING is not defined and the
-implementation does not support the function.
-.PP
-The
-\&\fI\fIpthread_attr_setscope()\fI\fR,
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value of the attribute being set is not valid.
-.Ip "[\s-1ENOTSUP\s0]" 4
-.IX Item "[ENOTSUP]"
-An attempt was made to set the attribute to an unsupported value.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-After these attributes have been set, a thread can be created with
-the specified attributes using
-\&\fI\fIpthread_create()\fI\fR.
-Using these routines does not affect the current running thread.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setinheritsched()\fI\fR,
-\&\fI\fIpthread_attr_setschedpolicy()\fI\fR,
-\&\fI\fIpthread_attr_setschedparam()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_setschedparam()\fI\fR,
-\&\fI<sched.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setstackaddr,\fR \fBpthread_attr_getstackaddr\fR
-\&\- set and get stackaddr attribute
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setstackaddr(pthread_attr_t *\fIattr\fR, void *\fIstackaddr\fR);
-int pthread_attr_getstackaddr(const pthread_attr_t *\fIattr\fR,
-void **\fIstackaddr\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The functions
-\&\fI\fIpthread_attr_setstackaddr()\fI\fR
-and
-\&\fI\fIpthread_attr_getstackaddr()\fI\fR,
-respectively, set and get the thread creation
-\&\fIstackaddr\fR
-attribute in the
-\&\fIattr\fR
-object.
-.PP
-The
-\&\fIstackaddr\fR
-attribute specifies the location of storage
-to be used for the created thread's stack.
-The size of the storage is at least \s-1PTHREAD_STACK_MIN\s0.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion,
-\&\fI\fIpthread_attr_setstackaddr()\fI\fR
-and
-\&\fI\fIpthread_attr_getstackaddr()\fI\fR
-return a value of 0.
-Otherwise, an error number is returned to indicate the error.
-.PP
-The
-\&\fI\fIpthread_attr_getstackaddr()\fI\fR
-function stores the
-\&\fIstackaddr\fR
-attribute value in
-\&\fIstackaddr\fR
-if successful.
-.SH "ERRORS"
-.IX Header "ERRORS"
-No errors are defined.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setdetachstate()\fI\fR,
-\&\fI\fIpthread_attr_setstacksize()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<limits.h\fR>,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_attr_setstacksize,\fR \fBpthread_attr_getstacksize\fR
-\&\- set and get stacksize attribute
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_attr_setstacksize(pthread_attr_t *\fIattr\fR, size_t \fIstacksize\fR);
-int pthread_attr_getstacksize(const pthread_attr_t *\fIattr\fR,
-size_t *\fIstacksize\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The functions
-\&\fI\fIpthread_attr_setstacksize()\fI\fR
-and
-\&\fI\fIpthread_attr_getstacksize()\fI\fR,
-respectively, set and get the thread creation
-\&\fIstacksize\fR
-attribute in the
-\&\fIattr\fR
-object.
-.PP
-The
-\&\fIstacksize\fR
-attribute defines the minimum stack size (in bytes) allocated for
-the created threads stack.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion,
-\&\fI\fIpthread_attr_setstacksize()\fI\fR
-and
-\&\fI\fIpthread_attr_getstacksize()\fI\fR
-return a value of 0.
-Otherwise, an error number is returned to indicate the error.
-The
-\&\fI\fIpthread_attr_getstacksize()\fI\fR
-function stores the
-\&\fIstacksize\fR
-attribute value in
-\&\fIstacksize\fR
-if successful.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_attr_setstacksize()\fI\fR
-function will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value of
-\&\fIstacksize\fR
-is less than \s-1PTHREAD_STACK_MIN\s0 or exceeds a system-imposed limit.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_attr_init()\fI\fR,
-\&\fI\fIpthread_attr_setstackaddr()\fI\fR,
-\&\fI\fIpthread_attr_setdetachstate()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI<limits.h\fR>,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_cancel\fR \- cancel execution of a thread
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_cancel(pthread_t \fIthread\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_cancel()\fI\fR
-function requests that
-\&\fIthread\fR
-be canceled.
-The target threads cancelability state and type
-determines when the cancellation takes effect.
-When the cancellation is acted on, the
-cancellation cleanup handlers for
-\&\fIthread\fR
-are called.
-When the last cancellation cleanup handler returns,
-the thread-specific data destructor functions are called for
-\&\fIthread\fR.
-When the last destructor function returns,
-\&\fIthread\fR
-is terminated.
-.PP
-The cancellation processing in the target thread runs asynchronously
-with respect to the calling thread returning from
-\&\fI\fIpthread_cancel()\fI\fR.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_cancel()\fI\fR
-function returns zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_cancel()\fI\fR
-function may fail if:
-.Ip "[\s-1ESRCH\s0]" 4
-.IX Item "[ESRCH]"
-No thread could be found corresponding to that specified
-by the given thread \s-1ID\s0.
-.PP
-The
-\&\fI\fIpthread_cancel()\fI\fR
-function will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_exit()\fI\fR,
-\&\fI\fIpthread_join()\fI\fR,
-\&\fI\fIpthread_setcancelstate()\fI\fR,
-\&\fI\fIpthread_cond_wait()\fI\fR,
-\&\fI\fIpthread_cond_timedwait()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_cleanup_push,\fR \fBpthread_cleanup_pop\fR \- establish cancellation handlers
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-void pthread_cleanup_push(void (*\fIroutine\fR)(void*), void *\fIarg\fR);
-void pthread_cleanup_pop(int \fIexecute\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_cleanup_push()\fI\fR
-function pushes the specified cancellation cleanup handler
-\&\fIroutine\fR
-onto the calling thread's cancellation cleanup stack.
-The cancellation cleanup handler is popped from the
-cancellation cleanup stack and invoked with the argument
-\&\fIarg\fR
-when: (a) the thread exits (that is, calls
-\&\fI\fIpthread_exit()\fI\fR),
-(b) the thread acts upon a cancellation request, or
-(c) the thread calls
-\&\fI\fIpthread_cleanup_pop()\fI\fR
-with a non-zero
-\&\fIexecute\fR
-argument.
-.PP
-The
-\&\fI\fIpthread_cleanup_pop()\fI\fR
-function removes the routine at the top of the calling thread's
-cancellation cleanup stack and optionally invokes it (if
-\&\fIexecute\fR
-is non-zero).
-.PP
-These functions may be implemented as macros and will
-appear as statements and in pairs within the same lexical scope (that is, the
-\&\fI\fIpthread_cleanup_push()\fI\fR
-macro may be thought to expand to a token list whose first
-token is
-\&\fB`{'\fR
-with
-\&\fI\fIpthread_cleanup_pop()\fI\fR
-expanding to a token list whose last token is the corresponding
-\&\fB`}'\fR.
-.PP
-The effect of calling
-\&\fI\fIlongjmp()\fI\fR
-or
-\&\fI\fIsiglongjmp()\fI\fR
-is undefined if there have been any calls to
-\&\fI\fIpthread_cleanup_push()\fI\fR
-or
-\&\fI\fIpthread_cleanup_pop()\fI\fR
-made without the matching call
-since the jump buffer was filled.
-The effect of calling
-\&\fI\fIlongjmp()\fI\fR
-or
-\&\fI\fIsiglongjmp()\fI\fR
-from inside a cancellation cleanup handler is also
-undefined unless the jump buffer was also filled in the
-cancellation cleanup handler.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-The
-\&\fI\fIpthread_cleanup_push()\fI\fR
-and
-\&\fI\fIpthread_cleanup_pop()\fI\fR
-functions return no value.
-.SH "ERRORS"
-.IX Header "ERRORS"
-No errors are defined.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_cancel()\fI\fR,
-\&\fI\fIpthread_setcancelstate()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_cleanup_push,\fR \fBpthread_cleanup_pop\fR \- establish cancellation handlers
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-void pthread_cleanup_push(void (*\fIroutine\fR)(void*), void *\fIarg\fR);
-void pthread_cleanup_pop(int \fIexecute\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_cleanup_push()\fI\fR
-function pushes the specified cancellation cleanup handler
-\&\fIroutine\fR
-onto the calling thread's cancellation cleanup stack.
-The cancellation cleanup handler is popped from the
-cancellation cleanup stack and invoked with the argument
-\&\fIarg\fR
-when: (a) the thread exits (that is, calls
-\&\fI\fIpthread_exit()\fI\fR),
-(b) the thread acts upon a cancellation request, or
-(c) the thread calls
-\&\fI\fIpthread_cleanup_pop()\fI\fR
-with a non-zero
-\&\fIexecute\fR
-argument.
-.PP
-The
-\&\fI\fIpthread_cleanup_pop()\fI\fR
-function removes the routine at the top of the calling thread's
-cancellation cleanup stack and optionally invokes it (if
-\&\fIexecute\fR
-is non-zero).
-.PP
-These functions may be implemented as macros and will
-appear as statements and in pairs within the same lexical scope (that is, the
-\&\fI\fIpthread_cleanup_push()\fI\fR
-macro may be thought to expand to a token list whose first
-token is
-\&\fB`{'\fR
-with
-\&\fI\fIpthread_cleanup_pop()\fI\fR
-expanding to a token list whose last token is the corresponding
-\&\fB`}'\fR.
-.PP
-The effect of calling
-\&\fI\fIlongjmp()\fI\fR
-or
-\&\fI\fIsiglongjmp()\fI\fR
-is undefined if there have been any calls to
-\&\fI\fIpthread_cleanup_push()\fI\fR
-or
-\&\fI\fIpthread_cleanup_pop()\fI\fR
-made without the matching call
-since the jump buffer was filled.
-The effect of calling
-\&\fI\fIlongjmp()\fI\fR
-or
-\&\fI\fIsiglongjmp()\fI\fR
-from inside a cancellation cleanup handler is also
-undefined unless the jump buffer was also filled in the
-cancellation cleanup handler.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-The
-\&\fI\fIpthread_cleanup_push()\fI\fR
-and
-\&\fI\fIpthread_cleanup_pop()\fI\fR
-functions return no value.
-.SH "ERRORS"
-.IX Header "ERRORS"
-No errors are defined.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_cancel()\fI\fR,
-\&\fI\fIpthread_setcancelstate()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_cond_signal,\fR \fBpthread_cond_broadcast\fR \- signal or broadcast a
-condition
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_cond_signal(pthread_cond_t *\fIcond\fR);
-int pthread_cond_broadcast(pthread_cond_t *\fIcond\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-These two functions are used to unblock
-threads blocked on a condition variable.
-.PP
-The
-\&\fI\fIpthread_cond_signal()\fI\fR
-call unblocks at least one of the threads that are blocked on the
-specified condition variable
-\&\fIcond\fR
-(if any threads are blocked on
-\&\fIcond\fR).
-.PP
-The
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-call unblocks all threads currently blocked on the specified condition variable
-\&\fIcond\fR.
-.PP
-If more than one thread is blocked on a condition variable,
-the scheduling policy determines the order in which threads are unblocked.
-When each thread unblocked as a result of a
-\&\fI\fIpthread_cond_signal()\fI\fR
-or
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-returns from its call to
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR,
-the thread owns the mutex with which it called
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR.
-The \fIthread\fR\|(s) that are unblocked contend for the mutex
-according to the scheduling policy (if applicable),
-and as if each had called
-\&\fI\fIpthread_mutex_lock()\fI\fR.
-.PP
-The
-\&\fI\fIpthread_cond_signal()\fI\fR
-or
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-functions may be called by a thread whether or not it
-currently owns the mutex that threads calling
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-have associated with the condition variable during their waits;
-however, if predictable scheduling behaviour is required,
-then that mutex is locked by the thread calling
-\&\fI\fIpthread_cond_signal()\fI\fR
-or
-\&\fI\fIpthread_cond_broadcast()\fI\fR.
-.PP
-The
-\&\fI\fIpthread_cond_signal()\fI\fR
-and
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-functions have no effect if there are no threads
-currently blocked on
-\&\fIcond\fR.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_cond_signal()\fI\fR
-and
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_cond_signal()\fI\fR
-and
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value
-\&\fIcond\fR
-does not refer to an initialised condition variable.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI\fIpthread_cond_wait()\fI\fR,
-\&\fI\fIpthread_cond_timedwait()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_cond_init,\fR \fBpthread_cond_destroy\fR \- initialise and destroy
-condition variables
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_cond_init(pthread_cond_t *\fIcond\fR,
-const pthread_condattr_t *\fIattr\fR);
-int pthread_cond_destroy(pthread_cond_t *\fIcond\fR);
-pthread_cond_t \fIcond\fR = \s-1PTHREAD_COND_INITIALIZER\s0;
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The function
-\&\fI\fIpthread_cond_init()\fI\fR
-initialises the condition variable referenced by
-\&\fIcond\fR
-with attributes referenced by
-\&\fIattr\fR.
-If
-\&\fIattr\fR
-is \s-1NULL\s0,
-the default condition variable attributes are used;
-the effect is the same as passing the address
-of a default condition variable attributes object.
-Upon successful initialisation,
-the state of the condition variable becomes initialised.
-.PP
-Attempting to initialise an already initialised
-condition variable
-results in undefined behaviour.
-.PP
-The function
-\&\fI\fIpthread_cond_destroy()\fI\fR
-destroys the given condition variable specified by
-\&\fIcond\fR;
-the object becomes, in effect, uninitialised.
-An implementation may cause
-\&\fI\fIpthread_cond_destroy()\fI\fR
-to set the object referenced by
-\&\fIcond\fR
-to an invalid value.
-A destroyed condition variable object
-can be re-initialised using
-\&\fI\fIpthread_cond_init()\fI\fR;
-the results of otherwise referencing the object after it has been destroyed
-are undefined.
-.PP
-It is safe to destroy an initialised condition variable
-upon which no threads are currently blocked.
-Attempting to destroy a condition variable
-upon which other threads are currently blocked
-results in undefined behaviour.
-.PP
-In cases where default condition variable attributes are appropriate,
-the macro \s-1PTHREAD_COND_INITIALIZER\s0
-can be used to initialise condition variables that are statically allocated.
-The effect is equivalent to dynamic initialisation by a call to
-\&\fI\fIpthread_cond_init()\fI\fR
-with parameter
-\&\fIattr\fR
-specified as \s-1NULL\s0, except that no error checks are performed.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_cond_init()\fI\fR
-and
-\&\fI\fIpthread_cond_destroy()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-The [\s-1EBUSY\s0] and [\s-1EINVAL\s0]
-error checks, if implemented,
-act as if they were performed immediately
-at the beginning of processing for the function
-and caused an error return
-prior to modifying the state of the condition variable specified by
-\&\fIcond\fR.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_cond_init()\fI\fR
-function will fail if:
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The system lacked the necessary resources (other
-than memory) to initialise another condition variable.
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the condition variable.
-.PP
-The
-\&\fI\fIpthread_cond_init()\fI\fR
-function may fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The implementation has detected an attempt
-to re-initialise the object referenced by
-\&\fIcond\fR,
-a previously initialised, but
-not yet destroyed, condition variable.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-is invalid.
-.PP
-The
-\&\fI\fIpthread_cond_destroy()\fI\fR
-function may fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The implementation has detected an attempt to destroy
-the object referenced by
-\&\fIcond\fR
-while it is referenced
-(for example, while being used in a
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR)
-by another thread.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIcond\fR
-is invalid.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_cond_signal()\fI\fR,
-\&\fI\fIpthread_cond_broadcast()\fI\fR,
-\&\fI\fIpthread_cond_wait()\fI\fR,
-\&\fI\fIpthread_cond_timedwait()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_cond_init,\fR \fBpthread_cond_destroy\fR \- initialise and destroy
-condition variables
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_cond_init(pthread_cond_t *\fIcond\fR,
-const pthread_condattr_t *\fIattr\fR);
-int pthread_cond_destroy(pthread_cond_t *\fIcond\fR);
-pthread_cond_t \fIcond\fR = \s-1PTHREAD_COND_INITIALIZER\s0;
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The function
-\&\fI\fIpthread_cond_init()\fI\fR
-initialises the condition variable referenced by
-\&\fIcond\fR
-with attributes referenced by
-\&\fIattr\fR.
-If
-\&\fIattr\fR
-is \s-1NULL\s0,
-the default condition variable attributes are used;
-the effect is the same as passing the address
-of a default condition variable attributes object.
-Upon successful initialisation,
-the state of the condition variable becomes initialised.
-.PP
-Attempting to initialise an already initialised
-condition variable
-results in undefined behaviour.
-.PP
-The function
-\&\fI\fIpthread_cond_destroy()\fI\fR
-destroys the given condition variable specified by
-\&\fIcond\fR;
-the object becomes, in effect, uninitialised.
-An implementation may cause
-\&\fI\fIpthread_cond_destroy()\fI\fR
-to set the object referenced by
-\&\fIcond\fR
-to an invalid value.
-A destroyed condition variable object
-can be re-initialised using
-\&\fI\fIpthread_cond_init()\fI\fR;
-the results of otherwise referencing the object after it has been destroyed
-are undefined.
-.PP
-It is safe to destroy an initialised condition variable
-upon which no threads are currently blocked.
-Attempting to destroy a condition variable
-upon which other threads are currently blocked
-results in undefined behaviour.
-.PP
-In cases where default condition variable attributes are appropriate,
-the macro \s-1PTHREAD_COND_INITIALIZER\s0
-can be used to initialise condition variables that are statically allocated.
-The effect is equivalent to dynamic initialisation by a call to
-\&\fI\fIpthread_cond_init()\fI\fR
-with parameter
-\&\fIattr\fR
-specified as \s-1NULL\s0, except that no error checks are performed.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_cond_init()\fI\fR
-and
-\&\fI\fIpthread_cond_destroy()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-The [\s-1EBUSY\s0] and [\s-1EINVAL\s0]
-error checks, if implemented,
-act as if they were performed immediately
-at the beginning of processing for the function
-and caused an error return
-prior to modifying the state of the condition variable specified by
-\&\fIcond\fR.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_cond_init()\fI\fR
-function will fail if:
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The system lacked the necessary resources (other
-than memory) to initialise another condition variable.
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the condition variable.
-.PP
-The
-\&\fI\fIpthread_cond_init()\fI\fR
-function may fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The implementation has detected an attempt
-to re-initialise the object referenced by
-\&\fIcond\fR,
-a previously initialised, but
-not yet destroyed, condition variable.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-is invalid.
-.PP
-The
-\&\fI\fIpthread_cond_destroy()\fI\fR
-function may fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The implementation has detected an attempt to destroy
-the object referenced by
-\&\fIcond\fR
-while it is referenced
-(for example, while being used in a
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR)
-by another thread.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIcond\fR
-is invalid.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_cond_signal()\fI\fR,
-\&\fI\fIpthread_cond_broadcast()\fI\fR,
-\&\fI\fIpthread_cond_wait()\fI\fR,
-\&\fI\fIpthread_cond_timedwait()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_cond_signal,\fR \fBpthread_cond_broadcast\fR \- signal or broadcast a
-condition
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_cond_signal(pthread_cond_t *\fIcond\fR);
-int pthread_cond_broadcast(pthread_cond_t *\fIcond\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-These two functions are used to unblock
-threads blocked on a condition variable.
-.PP
-The
-\&\fI\fIpthread_cond_signal()\fI\fR
-call unblocks at least one of the threads that are blocked on the
-specified condition variable
-\&\fIcond\fR
-(if any threads are blocked on
-\&\fIcond\fR).
-.PP
-The
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-call unblocks all threads currently blocked on the specified condition variable
-\&\fIcond\fR.
-.PP
-If more than one thread is blocked on a condition variable,
-the scheduling policy determines the order in which threads are unblocked.
-When each thread unblocked as a result of a
-\&\fI\fIpthread_cond_signal()\fI\fR
-or
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-returns from its call to
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR,
-the thread owns the mutex with which it called
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR.
-The \fIthread\fR\|(s) that are unblocked contend for the mutex
-according to the scheduling policy (if applicable),
-and as if each had called
-\&\fI\fIpthread_mutex_lock()\fI\fR.
-.PP
-The
-\&\fI\fIpthread_cond_signal()\fI\fR
-or
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-functions may be called by a thread whether or not it
-currently owns the mutex that threads calling
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-have associated with the condition variable during their waits;
-however, if predictable scheduling behaviour is required,
-then that mutex is locked by the thread calling
-\&\fI\fIpthread_cond_signal()\fI\fR
-or
-\&\fI\fIpthread_cond_broadcast()\fI\fR.
-.PP
-The
-\&\fI\fIpthread_cond_signal()\fI\fR
-and
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-functions have no effect if there are no threads
-currently blocked on
-\&\fIcond\fR.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_cond_signal()\fI\fR
-and
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_cond_signal()\fI\fR
-and
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value
-\&\fIcond\fR
-does not refer to an initialised condition variable.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI\fIpthread_cond_wait()\fI\fR,
-\&\fI\fIpthread_cond_timedwait()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_cond_wait,\fR \fBpthread_cond_timedwait\fR \- wait on a condition
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_cond_wait(pthread_cond_t *\fIcond\fR, pthread_mutex_t *\fImutex\fR);
-int pthread_cond_timedwait(pthread_cond_t *\fIcond\fR,
-pthread_mutex_t *\fImutex\fR, const struct timespec *\fIabstime\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_cond_wait()\fI\fR
-and
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-functions are used to block on a condition variable.
-They are called with
-\&\fImutex\fR
-locked by the calling thread or undefined behaviour will result.
-.PP
-These functions atomically release
-\&\fImutex\fR
-and cause the calling thread to block on the condition variable
-\&\fIcond\fR;
-atomically here means &quot;atomically with respect to access by another
-thread to the mutex and then the condition variable&quot;.
-That is, if another thread is able to acquire the mutex
-after the about-to-block thread has released it,
-then a subsequent call to
-\&\fI\fIpthread_cond_signal()\fI\fR
-or
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-in that thread behaves as if it were issued
-after the about-to-block thread has blocked.
-.PP
-Upon successful return, the mutex has been
-locked and is owned by the calling thread.
-.PP
-When using condition variables there is always a boolean predicate involving
-shared variables associated with each condition wait that is true if the thread
-should proceed.
-Spurious wakeups from the
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-functions may occur.
-Since the return from
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-does not imply anything about the value of this predicate,
-the predicate should be re-evaluated upon such return.
-.PP
-The effect of using more than one mutex for concurrent
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-operations on the same condition variable is
-undefined; that is, a condition variable becomes bound to a unique mutex
-when a thread
-waits on the condition variable,
-and this (dynamic) binding ends when the wait returns.
-.PP
-A condition wait (whether timed or not) is a cancellation point.
-When the cancelability enable state of a thread is set to
-\&\s-1PTHREAD_CANCEL_DEFERRED\s0,
-a side effect of acting upon a cancellation request
-while in a condition wait is that the mutex is (in effect) re-acquired
-before calling the first cancellation cleanup handler.
-The effect is as if the thread were unblocked,
-allowed to execute up to the point of returning from the
-call to
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR,
-but at that point
-notices the cancellation request and instead of returning to the caller
-of
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR,
-starts the thread cancellation activities, which includes calling
-cancellation cleanup handlers.
-.PP
-A thread that has been unblocked because it has been
-canceled while blocked in a call to
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-does not consume any condition signal that may be
-directed concurrently at the
-condition variable if there are other threads blocked on
-the condition variable.
-.PP
-The
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-function is the same as
-\&\fI\fIpthread_cond_wait()\fI\fR
-except that
-an error is returned
-if the absolute time specified by
-\&\fIabstime\fR
-passes (that is, system time equals or exceeds
-\&\fIabstime\fR)
-before the condition
-\&\fIcond\fR
-is signaled or broadcasted,
-or if the absolute time specified by
-\&\fIabstime\fR
-has already been passed at the time of the call.
-When such time-outs occur,
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-will nonetheless release
-and reacquire the mutex referenced by
-\&\fImutex\fR.
-The function
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-is also a cancellation point.
-.PP
-If a signal is delivered to a thread waiting for a condition variable,
-upon return from the signal handler
-the thread resumes waiting for the condition variable
-as if it was not interrupted,
-or it returns zero due to spurious wakeup.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Except in the case of [\s-1ETIMEDOUT\s0],
-all these error checks act as if they were performed immediately
-at the beginning of processing for the function
-and cause an error return,
-in effect, prior to modifying the state of the mutex specified by
-\&\fImutex\fR
-or the condition variable specified by
-\&\fIcond\fR.
-.PP
-Upon successful completion, a value of zero is returned.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-function will fail if:
-.Ip "[\s-1ETIMEDOUT\s0]" 4
-.IX Item "[ETIMEDOUT]"
-The time specified by
-\&\fIabstime\fR
-to
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-has passed.
-.PP
-The
-\&\fI\fIpthread_cond_wait()\fI\fR
-and
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIcond\fR,
-\&\fImutex\fR,
-or
-\&\fIabstime\fR
-is invalid.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-Different mutexes were supplied for concurrent
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-operations on the same condition variable.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The mutex was not owned by the current thread at the time of the call.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_cond_signal()\fI\fR,
-\&\fI\fIpthread_cond_broadcast()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_cond_wait,\fR \fBpthread_cond_timedwait\fR \- wait on a condition
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_cond_wait(pthread_cond_t *\fIcond\fR, pthread_mutex_t *\fImutex\fR);
-int pthread_cond_timedwait(pthread_cond_t *\fIcond\fR,
-pthread_mutex_t *\fImutex\fR, const struct timespec *\fIabstime\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_cond_wait()\fI\fR
-and
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-functions are used to block on a condition variable.
-They are called with
-\&\fImutex\fR
-locked by the calling thread or undefined behaviour will result.
-.PP
-These functions atomically release
-\&\fImutex\fR
-and cause the calling thread to block on the condition variable
-\&\fIcond\fR;
-atomically here means &quot;atomically with respect to access by another
-thread to the mutex and then the condition variable&quot;.
-That is, if another thread is able to acquire the mutex
-after the about-to-block thread has released it,
-then a subsequent call to
-\&\fI\fIpthread_cond_signal()\fI\fR
-or
-\&\fI\fIpthread_cond_broadcast()\fI\fR
-in that thread behaves as if it were issued
-after the about-to-block thread has blocked.
-.PP
-Upon successful return, the mutex has been
-locked and is owned by the calling thread.
-.PP
-When using condition variables there is always a boolean predicate involving
-shared variables associated with each condition wait that is true if the thread
-should proceed.
-Spurious wakeups from the
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-functions may occur.
-Since the return from
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-does not imply anything about the value of this predicate,
-the predicate should be re-evaluated upon such return.
-.PP
-The effect of using more than one mutex for concurrent
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-operations on the same condition variable is
-undefined; that is, a condition variable becomes bound to a unique mutex
-when a thread
-waits on the condition variable,
-and this (dynamic) binding ends when the wait returns.
-.PP
-A condition wait (whether timed or not) is a cancellation point.
-When the cancelability enable state of a thread is set to
-\&\s-1PTHREAD_CANCEL_DEFERRED\s0,
-a side effect of acting upon a cancellation request
-while in a condition wait is that the mutex is (in effect) re-acquired
-before calling the first cancellation cleanup handler.
-The effect is as if the thread were unblocked,
-allowed to execute up to the point of returning from the
-call to
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR,
-but at that point
-notices the cancellation request and instead of returning to the caller
-of
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR,
-starts the thread cancellation activities, which includes calling
-cancellation cleanup handlers.
-.PP
-A thread that has been unblocked because it has been
-canceled while blocked in a call to
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-does not consume any condition signal that may be
-directed concurrently at the
-condition variable if there are other threads blocked on
-the condition variable.
-.PP
-The
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-function is the same as
-\&\fI\fIpthread_cond_wait()\fI\fR
-except that
-an error is returned
-if the absolute time specified by
-\&\fIabstime\fR
-passes (that is, system time equals or exceeds
-\&\fIabstime\fR)
-before the condition
-\&\fIcond\fR
-is signaled or broadcasted,
-or if the absolute time specified by
-\&\fIabstime\fR
-has already been passed at the time of the call.
-When such time-outs occur,
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-will nonetheless release
-and reacquire the mutex referenced by
-\&\fImutex\fR.
-The function
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-is also a cancellation point.
-.PP
-If a signal is delivered to a thread waiting for a condition variable,
-upon return from the signal handler
-the thread resumes waiting for the condition variable
-as if it was not interrupted,
-or it returns zero due to spurious wakeup.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Except in the case of [\s-1ETIMEDOUT\s0],
-all these error checks act as if they were performed immediately
-at the beginning of processing for the function
-and cause an error return,
-in effect, prior to modifying the state of the mutex specified by
-\&\fImutex\fR
-or the condition variable specified by
-\&\fIcond\fR.
-.PP
-Upon successful completion, a value of zero is returned.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-function will fail if:
-.Ip "[\s-1ETIMEDOUT\s0]" 4
-.IX Item "[ETIMEDOUT]"
-The time specified by
-\&\fIabstime\fR
-to
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-has passed.
-.PP
-The
-\&\fI\fIpthread_cond_wait()\fI\fR
-and
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIcond\fR,
-\&\fImutex\fR,
-or
-\&\fIabstime\fR
-is invalid.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-Different mutexes were supplied for concurrent
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-operations on the same condition variable.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The mutex was not owned by the current thread at the time of the call.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_cond_signal()\fI\fR,
-\&\fI\fIpthread_cond_broadcast()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_condattr_init,\fR \fBpthread_condattr_destroy\fR
-\&\- initialise and destroy condition variable attributes object
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_condattr_init(pthread_condattr_t *\fIattr\fR);
-int pthread_condattr_destroy(pthread_condattr_t *\fIattr\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The function
-\&\fI\fIpthread_condattr_init()\fI\fR
-initialises a condition variable attributes object
-\&\fIattr\fR
-with the default value for all of the attributes
-defined by the implementation.
-.PP
-Attempting to initialise an already initialised
-condition variable attributes object
-results in undefined behaviour.
-.PP
-After a condition variable
-attributes object has been used to initialise one or more
-condition variables, any function affecting the attributes object (including
-destruction) does not affect any previously initialised condition variables.
-.PP
-The
-\&\fI\fIpthread_condattr_destroy()\fI\fR
-function destroys a condition variable attributes object;
-the object becomes, in effect, uninitialised.
-An implementation may cause
-\&\fI\fIpthread_condattr_destroy()\fI\fR
-to set the object referenced by
-\&\fIattr\fR
-to an invalid value.
-A destroyed condition variable attributes object
-can be re-initialised using
-\&\fI\fIpthread_condattr_init()\fI\fR;
-the results of otherwise referencing the object after it has been destroyed
-are undefined.
-.PP
-Additional attributes, their default values, and the names
-of the associated functions to get and set those attribute values are
-implementation-dependent.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_condattr_init()\fI\fR
-and
-\&\fI\fIpthread_condattr_destroy()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_condattr_init()\fI\fR
-function will fail if:
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the condition variable
-attributes object.
-.PP
-The
-\&\fI\fIpthread_condattr_destroy()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-is invalid.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_condattr_getpshared()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_condattr_getpshared,\fR \fBpthread_condattr_setpshared\fR
-\&\- get and set the process-shared condition variable attributes
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_condattr_getpshared(const pthread_condattr_t *\fIattr\fR,
-int *\fIpshared\fR);
-int pthread_condattr_setpshared(pthread_condattr_t *\fIattr\fR,
-int \fIpshared\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_condattr_getpshared()\fI\fR
-function obtains the value of the
-\&\fIprocess-shared\fR
-attribute from the attributes object referenced by
-\&\fIattr\fR.
-The
-\&\fI\fIpthread_condattr_setpshared()\fI\fR
-function is used to set the
-\&\fIprocess-shared\fR
-attribute in an initialised attributes object referenced by
-\&\fIattr\fR.
-.PP
-The
-\&\fIprocess-shared\fR
-attribute is set to \s-1PTHREAD_PROCESS_SHARED\s0
-to permit a condition variable
-to be operated upon by any thread that has access to the memory
-where the condition variable
-is allocated, even if the condition variable
-is allocated in memory that is shared by multiple processes.
-If the
-\&\fIprocess-shared\fR
-attribute is \s-1PTHREAD_PROCESS_PRIVATE\s0, the condition variable
-will only be operated upon by threads created
-within the same process as the
-thread that initialised the condition variable;
-if threads of differing processes
-attempt to operate on such a condition variable, the behaviour is
-undefined.  The default value of the attribute is
-\&\s-1PTHREAD_PROCESS_PRIVATE\s0.
-.PP
-Additional attributes, their default values, and the names
-of the associated functions to get and set those attribute values are
-implementation-dependent.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_condattr_setpshared()\fI\fR
-function returns zero.
-Otherwise, an error number is returned to indicate the error.
-.PP
-If successful, the
-\&\fI\fIpthread_condattr_getpshared()\fI\fR
-function returns zero
-and stores the value of the
-\&\fIprocess-shared\fR
-attribute of
-\&\fIattr\fR
-into the object referenced by the
-\&\fIpshared\fR
-parameter.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_condattr_getpshared()\fI\fR
-and
-\&\fI\fIpthread_condattr_setpshared()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-is invalid.
-.PP
-The
-\&\fI\fIpthread_condattr_setpshared()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The new value specified for the attribute
-is outside the range of legal values for that attribute.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_condattr_init()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_condattr_init,\fR \fBpthread_condattr_destroy\fR
-\&\- initialise and destroy condition variable attributes object
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_condattr_init(pthread_condattr_t *\fIattr\fR);
-int pthread_condattr_destroy(pthread_condattr_t *\fIattr\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The function
-\&\fI\fIpthread_condattr_init()\fI\fR
-initialises a condition variable attributes object
-\&\fIattr\fR
-with the default value for all of the attributes
-defined by the implementation.
-.PP
-Attempting to initialise an already initialised
-condition variable attributes object
-results in undefined behaviour.
-.PP
-After a condition variable
-attributes object has been used to initialise one or more
-condition variables, any function affecting the attributes object (including
-destruction) does not affect any previously initialised condition variables.
-.PP
-The
-\&\fI\fIpthread_condattr_destroy()\fI\fR
-function destroys a condition variable attributes object;
-the object becomes, in effect, uninitialised.
-An implementation may cause
-\&\fI\fIpthread_condattr_destroy()\fI\fR
-to set the object referenced by
-\&\fIattr\fR
-to an invalid value.
-A destroyed condition variable attributes object
-can be re-initialised using
-\&\fI\fIpthread_condattr_init()\fI\fR;
-the results of otherwise referencing the object after it has been destroyed
-are undefined.
-.PP
-Additional attributes, their default values, and the names
-of the associated functions to get and set those attribute values are
-implementation-dependent.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_condattr_init()\fI\fR
-and
-\&\fI\fIpthread_condattr_destroy()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_condattr_init()\fI\fR
-function will fail if:
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the condition variable
-attributes object.
-.PP
-The
-\&\fI\fIpthread_condattr_destroy()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-is invalid.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_condattr_getpshared()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_condattr_getpshared,\fR \fBpthread_condattr_setpshared\fR
-\&\- get and set the process-shared condition variable attributes
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_condattr_getpshared(const pthread_condattr_t *\fIattr\fR,
-int *\fIpshared\fR);
-int pthread_condattr_setpshared(pthread_condattr_t *\fIattr\fR,
-int \fIpshared\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_condattr_getpshared()\fI\fR
-function obtains the value of the
-\&\fIprocess-shared\fR
-attribute from the attributes object referenced by
-\&\fIattr\fR.
-The
-\&\fI\fIpthread_condattr_setpshared()\fI\fR
-function is used to set the
-\&\fIprocess-shared\fR
-attribute in an initialised attributes object referenced by
-\&\fIattr\fR.
-.PP
-The
-\&\fIprocess-shared\fR
-attribute is set to \s-1PTHREAD_PROCESS_SHARED\s0
-to permit a condition variable
-to be operated upon by any thread that has access to the memory
-where the condition variable
-is allocated, even if the condition variable
-is allocated in memory that is shared by multiple processes.
-If the
-\&\fIprocess-shared\fR
-attribute is \s-1PTHREAD_PROCESS_PRIVATE\s0, the condition variable
-will only be operated upon by threads created
-within the same process as the
-thread that initialised the condition variable;
-if threads of differing processes
-attempt to operate on such a condition variable, the behaviour is
-undefined.  The default value of the attribute is
-\&\s-1PTHREAD_PROCESS_PRIVATE\s0.
-.PP
-Additional attributes, their default values, and the names
-of the associated functions to get and set those attribute values are
-implementation-dependent.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_condattr_setpshared()\fI\fR
-function returns zero.
-Otherwise, an error number is returned to indicate the error.
-.PP
-If successful, the
-\&\fI\fIpthread_condattr_getpshared()\fI\fR
-function returns zero
-and stores the value of the
-\&\fIprocess-shared\fR
-attribute of
-\&\fIattr\fR
-into the object referenced by the
-\&\fIpshared\fR
-parameter.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_condattr_getpshared()\fI\fR
-and
-\&\fI\fIpthread_condattr_setpshared()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-is invalid.
-.PP
-The
-\&\fI\fIpthread_condattr_setpshared()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The new value specified for the attribute
-is outside the range of legal values for that attribute.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_condattr_init()\fI\fR,
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_create\fR \- thread creation
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_create(pthread_t *\fIthread\fR, const pthread_attr_t *\fIattr\fR,
-void *(*\fIstart_routine\fR)(void*), void *\fIarg\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_create()\fI\fR
-function is used to create a new thread, with attributes specified by
-\&\fIattr\fR,
-within a process.
-If
-\&\fIattr\fR
-is \s-1NULL\s0,
-the default attributes are used.
-If the attributes specified by
-\&\fIattr\fR
-are modified later, the thread's attributes are not affected.
-Upon successful completion,
-\&\fI\fIpthread_create()\fI\fR
-stores the \s-1ID\s0 of the created thread in the location referenced by
-\&\fIthread\fR.
-.PP
-The thread is created executing
-\&\fIstart_routine\fR
-with
-\&\fIarg\fR
-as its sole argument.
-If the
-\&\fIstart_routine\fR
-returns, the effect is as if there was an implicit call to
-\&\fI\fIpthread_exit()\fI\fR
-using the return value of
-\&\fIstart_routine\fR
-as the exit status.
-Note that the thread in which
-\&\fI\fImain()\fI\fR
-was originally invoked differs from this.
-When it returns from
-\&\fI\fImain()\fI\fR,
-the effect is as if there was an implicit call to
-\&\fI\fIexit()\fI\fR
-using the return value of
-\&\fI\fImain()\fI\fR
-as the exit status.
-.PP
-The signal state of the new thread is initialised as follows:
-.Ip "o" 4
-The signal mask is inherited from the creating thread.
-.Ip "o" 4
-The set of signals pending for the new thread is empty.
-.PP
-If
-\&\fI\fIpthread_create()\fI\fR
-fails, no new thread is created
-and the contents of the location referenced by
-\&\fIthread\fR
-are undefined.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_create()\fI\fR
-function returns zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_create()\fI\fR
-function will fail if:
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The system lacked the necessary resources to create another thread,
-or the system-imposed limit on the total number of threads
-in a process \s-1PTHREAD_THREADS_MAX\s0 would be exceeded.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-is invalid.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The caller does not have appropriate permission to set the required
-scheduling parameters or scheduling policy.
-.PP
-The
-\&\fI\fIpthread_create()\fI\fR
-function will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_exit()\fI\fR,
-\&\fI\fIpthread_join()\fI\fR,
-\&\fI\fIfork()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_detach\fR \- detach a thread
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_detach(pthread_t \fIthread\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_detach()\fI\fR
-function is used to indicate to the implementation that storage
-for the thread
-\&\fIthread\fR
-can be reclaimed when that thread terminates.
-If
-\&\fIthread\fR
-has not terminated,
-\&\fI\fIpthread_detach()\fI\fR
-will not cause it to terminate.
-The effect of multiple
-\&\fI\fIpthread_detach()\fI\fR
-calls on the same target thread is unspecified.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If the call succeeds,
-\&\fI\fIpthread_detach()\fI\fR
-returns 0.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_detach()\fI\fR
-function will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The implementation has detected that the value specified by
-\&\fIthread\fR
-does not refer to a joinable thread.
-.Ip "[\s-1ESRCH\s0]" 4
-.IX Item "[ESRCH]"
-No thread could be found corresponding to that specified
-by the given thread \s-1ID\s0.
-.PP
-The
-\&\fI\fIpthread_detach()\fI\fR
-function will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_join()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_equal\fR \- compare thread IDs
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_equal(pthread_t \fIt1\fR, pthread_t \fIt2\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-This function compares the thread IDs
-\&\fIt1\fR
-and
-\&\fIt2\fR.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-The
-\&\fI\fIpthread_equal()\fI\fR
-function returns a non-zero value if
-\&\fIt1\fR
-and
-\&\fIt2\fR
-are equal;
-otherwise, zero is returned.
-.PP
-If either
-\&\fIt1\fR
-or
-\&\fIt2\fR
-are not valid thread IDs, the behaviour is undefined.
-.SH "ERRORS"
-.IX Header "ERRORS"
-No errors are defined.
-.PP
-The
-\&\fI\fIpthread_equal()\fI\fR
-function will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_self()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_exit\fR \- thread termination
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-void pthread_exit(void *\fIvalue_ptr\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_exit()\fI\fR
-function terminates the calling thread and makes the value
-\&\fIvalue_ptr\fR
-available to any successful join with the terminating thread.
-Any cancellation cleanup handlers
-that have been pushed and not yet popped are popped in the reverse order
-that they were pushed and then executed.
-After all cancellation cleanup handlers have been executed,
-if the thread has any thread-specific data,
-appropriate destructor functions will be called in an unspecified order.
-Thread termination does not release any application visible process resources,
-including, but not limited to, mutexes and file descriptors,
-nor does it perform any process level cleanup actions,
-including, but not limited to, calling any
-\&\fI\fIatexit()\fI\fR
-routines that may exist.
-.PP
-An implicit call to
-\&\fI\fIpthread_exit()\fI\fR
-is made when a thread other than the thread in which
-\&\fI\fImain()\fI\fR
-was first invoked returns from the start routine
-that was used to create it.
-The function's return value serves as the thread's exit status.
-.PP
-The behaviour of
-\&\fI\fIpthread_exit()\fI\fR
-is undefined if called from a
-cancellation cleanup handler
-or destructor function
-that was invoked as a result of either an implicit or
-explicit call to
-\&\fI\fIpthread_exit()\fI\fR.
-.PP
-After a thread has terminated,
-the result of access to local (auto) variables of the thread is undefined.
-Thus, references to local variables of the exiting thread
-should not be used for the
-\&\fI\fIpthread_exit()\fI\fR
-\&\fIvalue_ptr\fR
-parameter value.
-.PP
-The process exits with an exit status of 0 after the
-last thread has been terminated.
-The behaviour is as if the implementation called
-\&\fI\fIexit()\fI\fR
-with a zero argument at thread termination time.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-The
-\&\fI\fIpthread_exit()\fI\fR
-function cannot return to its caller.
-.SH "ERRORS"
-.IX Header "ERRORS"
-No errors are defined.
-.PP
-The
-\&\fI\fIpthread_exit()\fI\fR
-function will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_join()\fI\fR,
-\&\fI\fIexit()\fI\fR,
-\&\fI\fI_exit()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_getconcurrency,\fR \fBpthread_setconcurrency\fR \-
-get or set level of concurrency
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_getconcurrency(void);
-int pthread_setconcurrency(int \fInew_level\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-Unbound threads in a process may or may not be required to be
-simultaneously active. By default, the threads
-implementation ensures that a sufficient number of threads are active
-so that the process can continue to make
-progress. While this conserves system resources, it may not produce
-the most effective level of concurrency.
-.PP
-The
-\&\fI\fIpthread_setconcurrency()\fI\fR
-function allows an application to inform
-the threads implementation of its desired concurrency level,
-\&\fInew_level\fR.
-The actual level of concurrency provided by the implementation as a
-result of this function call is unspecified.
-.PP
-If \fInew_level\fR is zero, it causes the implementation to maintain
-the concurrency level at its discretion as if
-\&\fI\fIpthread_setconcurrency()\fI\fR
-was never called.
-.PP
-The
-\&\fI\fIpthread_getconcurrency()\fI\fR
-function returns the
-value set by a previous call to the
-\&\fI\fIpthread_setconcurrency()\fI\fR
-function.  If the
-\&\fI\fIpthread_setconcurrency()\fI\fR
-function was not previously called,
-this function returns zero to indicate that the implementation
-is maintaining the concurrency level.
-.PP
-When an application calls
-\&\fI\fIpthread_setconcurrency()\fI\fR
-it is
-informing the implementation of its desired
-concurrency level. The implementation uses this as a hint,
-not a requirement.
-.PP
-If an implementation does not support multiplexing of user threads
-on top of several kernel scheduled entities,
-the
-\&\fI\fIpthread_setconcurrency()\fI\fR
-and
-\&\fI\fIpthread_getconcurrency()\fI\fR
-functions
-will be provided for source code
-compatibility but they will have no effect when called. To maintain
-the function semantics, the \fInew_level\fR
-parameter will be saved when
-\&\fI\fIpthread_setconcurrency()\fI\fR
-is called so
-that a subsequent call to
-\&\fI\fIpthread_getconcurrency()\fI\fR
-returns the same value.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_setconcurrency()\fI\fR
-function returns zero.  Otherwise, an error number is returned
-to indicate the error.
-.PP
-The
-\&\fI\fIpthread_getconcurrency()\fI\fR
-function always returns the concurrency level set by a previous call to
-\&\fI\fIpthread_setconcurrency()\fI\fR.
-If the
-\&\fI\fIpthread_setconcurrency()\fI\fR
-function has never been called,
-\&\fI\fIpthread_getconcurrency()\fI\fR
-returns zero.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_setconcurrency()\fI\fR
-function will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fInew_level\fR is negative.
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The value specific by \fInew_level\fR would cause a system resource
-to be exceeded.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-Use of these functions changes the state of the underlying
-concurrency upon which the application depends. Library
-developers are advised to not use the
-\&\fI\fIpthread_getconcurrency()\fI\fR
-and
-\&\fI\fIpthread_setconcurrency()\fI\fR
-functions since their
-use may conflict with an applications use of these functions.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_getschedparam,\fR \fBpthread_setschedparam\fR
-\&\- dynamic thread scheduling parameters access
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_getschedparam(pthread_t \fIthread\fR, int *\fIpolicy\fR,
-struct sched_param *\fIparam\fR);
-int pthread_setschedparam(pthread_t \fIthread\fR, int \fIpolicy\fR,
-const struct sched_param *\fIparam\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_getschedparam()\fI\fR
-and
-\&\fI\fIpthread_setschedparam()\fI\fR
-allow the scheduling policy and scheduling parameters of individual threads
-within a multi-threaded process to be retrieved and set.
-For \s-1SCHED_FIFO\s0 and \s-1SCHED_RR\s0,
-the only required member of the
-\&\fBsched_param\fR
-structure is the priority
-\&\fIsched_priority\fR.
-For \s-1SCHED_OTHER\s0,
-the affected scheduling parameters are implementation-dependent.
-.PP
-The
-\&\fI\fIpthread_getschedparam()\fI\fR
-function retrieves the scheduling policy and scheduling parameters
-for the thread whose thread \s-1ID\s0 is given by
-\&\fIthread\fR
-and stores those values in
-\&\fIpolicy\fR
-and
-\&\fIparam\fR,
-respectively.
-The priority value returned from
-\&\fI\fIpthread_getschedparam()\fI\fR
-is the value specified by the most recent
-\&\fI\fIpthread_setschedparam()\fI\fR
-or
-\&\fI\fIpthread_create()\fI\fR
-call affecting the target thread,
-and reflects any temporary adjustments to its priority
-as a result of any priority inheritance or ceiling functions.
-The
-\&\fI\fIpthread_setschedparam()\fI\fR
-function sets the scheduling policy
-and associated scheduling parameters for the thread whose
-thread \s-1ID\s0 is given by
-\&\fIthread\fR
-to the policy and associated parameters provided in
-\&\fIpolicy\fR
-and
-\&\fIparam\fR,
-respectively.
-.PP
-The
-\&\fIpolicy\fR
-parameter may have the value \s-1SCHED_OTHER\s0,
-that has implementation-dependent scheduling parameters,
-\&\s-1SCHED_FIFO\s0 or \s-1SCHED_RR\s0,
-that have the single scheduling parameter,
-\&\fIpriority.\fR
-.PP
-If the
-\&\fI\fIpthread_setschedparam()\fI\fR
-function fails, no scheduling parameters will be changed
-for the target thread.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_getschedparam()\fI\fR
-and
-\&\fI\fIpthread_setschedparam()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_getschedparam()\fI\fR
-and
-\&\fI\fIpthread_setschedparam()\fI\fR
-functions will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The option _POSIX_THREAD_PRIORITY_SCHEDULING is not defined and the
-implementation does not support the function.
-.PP
-The
-\&\fI\fIpthread_getschedparam()\fI\fR
-function may fail if:
-.Ip "[\s-1ESRCH\s0]" 4
-.IX Item "[ESRCH]"
-The value specified by
-\&\fIthread\fR
-does not refer to a existing thread.
-.PP
-The
-\&\fI\fIpthread_setschedparam()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIpolicy\fR
-or one of the scheduling parameters associated with
-the scheduling policy
-\&\fIpolicy\fR
-is invalid.
-.Ip "[\s-1ENOTSUP\s0]" 4
-.IX Item "[ENOTSUP]"
-An attempt was made to set the policy or scheduling parameters to
-an unsupported value.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The caller does not have the appropriate permission to set
-either the scheduling parameters or the scheduling policy of the
-specified thread.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The implementation does not allow the application to modify
-one of the parameters to the value specified.
-.Ip "[\s-1ESRCH\s0]" 4
-.IX Item "[ESRCH]"
-The value specified by
-\&\fIthread\fR
-does not refer to a existing thread.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIsched_setparam()\fI\fR,
-\&\fI\fIsched_getparam()\fI\fR,
-\&\fI\fIsched_setscheduler()\fI\fR,
-\&\fI\fIsched_getscheduler()\fI\fR,
-\&\fI<pthread.h\fR>,
-\&\fI<sched.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_setspecific,\fR \fBpthread_getspecific\fR \- thread-specific data management
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_setspecific(pthread_key_t \fIkey\fR, const void *\fIvalue\fR);
-void *pthread_getspecific(pthread_key_t \fIkey\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_setspecific()\fI\fR
-function associates a thread-specific
-\&\fIvalue\fR
-with a
-\&\fIkey\fR
-obtained via a previous call to
-\&\fI\fIpthread_key_create()\fI\fR.
-Different threads may bind different values to the same key.
-These values are typically pointers to blocks of dynamically allocated memory
-that have been reserved for use by the calling thread.
-.PP
-The
-\&\fI\fIpthread_getspecific()\fI\fR
-function returns the value currently bound to the specified
-\&\fIkey\fR
-on behalf of the calling thread.
-.PP
-The effect of calling
-\&\fI\fIpthread_setspecific()\fI\fR
-or
-\&\fI\fIpthread_getspecific()\fI\fR
-with a
-\&\fIkey\fR
-value not obtained from
-\&\fI\fIpthread_key_create()\fI\fR
-or after
-\&\fIkey\fR
-has been deleted with
-\&\fI\fIpthread_key_delete()\fI\fR
-is undefined.
-.PP
-Both
-\&\fI\fIpthread_setspecific()\fI\fR
-and
-\&\fI\fIpthread_getspecific()\fI\fR
-may be called from a thread-specific data destructor function.
-However, calling
-\&\fI\fIpthread_setspecific()\fI\fR
-from a destructor may result in lost storage or infinite loops.
-.PP
-Both functions may be implemented as macros.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-The function
-\&\fI\fIpthread_getspecific()\fI\fR
-returns the thread-specific data value
-associated with the given
-\&\fIkey\fR.
-If no thread-specific data value is associated with
-\&\fIkey\fR,
-then the value \s-1NULL\s0 is returned.
-.PP
-If successful, the
-\&\fI\fIpthread_setspecific()\fI\fR
-function returns zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_setspecific()\fI\fR
-function will fail if:
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to associate the value with the key.
-.PP
-The
-\&\fI\fIpthread_setspecific()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The key value is invalid.
-.PP
-No errors are returned from
-\&\fI\fIpthread_getspecific()\fI\fR.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_key_create()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_join\fR \- wait for thread termination
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_join(pthread_t \fIthread\fR, void **\fIvalue_ptr\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_join()\fI\fR
-function suspends execution of the calling thread until the target
-\&\fIthread\fR
-terminates, unless the target
-\&\fIthread\fR
-has already terminated.
-On return from a successful
-\&\fI\fIpthread_join()\fI\fR
-call with a non-NULL
-\&\fIvalue_ptr\fR
-argument, the value passed to
-\&\fI\fIpthread_exit()\fI\fR
-by the terminating thread is made available in the location referenced by
-\&\fIvalue_ptr\fR.
-When a
-\&\fI\fIpthread_join()\fI\fR
-returns successfully, the target thread has been terminated.
-The results of multiple simultaneous calls to
-\&\fI\fIpthread_join()\fI\fR
-specifying the same target thread are undefined.
-If the thread calling
-\&\fI\fIpthread_join()\fI\fR
-is canceled, then the target thread will not be detached.
-.PP
-It is unspecified whether a thread that has exited but remains unjoined
-counts against _POSIX_THREAD_THREADS_MAX.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_join()\fI\fR
-function returns zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_join()\fI\fR
-function will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The implementation has detected that the value specified by
-\&\fIthread\fR
-does not refer to a joinable thread.
-.Ip "[\s-1ESRCH\s0]" 4
-.IX Item "[ESRCH]"
-No thread could be found corresponding to that specified
-by the given thread \s-1ID\s0.
-.PP
-The
-\&\fI\fIpthread_join()\fI\fR
-function may fail if:
-.Ip "[\s-1EDEADLK\s0]" 4
-.IX Item "[EDEADLK]"
-A deadlock was detected or
-the value of
-\&\fIthread\fR
-specifies the calling thread.
-.PP
-The
-\&\fI\fIpthread_join()\fI\fR
-function will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIwait()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_key_create\fR \- thread-specific data key creation
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_key_create(pthread_key_t *\fIkey\fR, void (*\fIdestructor\fR)(void*));
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-This function creates a thread-specific data
-key visible to all threads in the process.
-Key values provided by
-\&\fI\fIpthread_key_create()\fI\fR
-are opaque objects used to locate thread-specific data.
-Although the same key value may be used by different threads,
-the values bound to the key by
-\&\fI\fIpthread_setspecific()\fI\fR
-are maintained on a per-thread basis and persist
-for the life of the calling thread.
-.PP
-Upon key creation,
-the value \s-1NULL\s0 is associated with the new key in all active threads.
-Upon thread creation,
-the value \s-1NULL\s0 is associated with all defined keys in the new thread.
-.PP
-An optional destructor function may be associated with
-each key value.
-At thread exit, if a key value has a non-NULL destructor pointer,
-and the thread has a non-NULL value associated with that key,
-the function pointed to is called with the current associated value
-as its sole argument.
-The order of destructor calls is unspecified
-if more than one destructor exists for a thread when it exits.
-.PP
-If, after all the destructors have been called for all non-NULL values
-with associated destructors,
-there are still some non-NULL values with associated destructors,
-then the process will be repeated.
-If, after at least \s-1PTHREAD_DESTRUCTOR_ITERATIONS\s0
-iterations of destructor calls for outstanding non-NULL values,
-there are still some non-NULL values with associated destructors,
-implementations may stop calling destructors,
-or they may continue calling destructors
-until no non-NULL values with associated destructors exist,
-even though this might result in an infinite loop.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_key_create()\fI\fR
-function stores the newly created key value at
-\&\fI*key\fR
-and returns zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_key_create()\fI\fR
-function will fail if:
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The system lacked the necessary resources to create another thread-specific
-data key, or the system-imposed limit on the total number of keys per process
-\&\s-1PTHREAD_KEYS_MAX\s0 has been exceeded.
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to create the key.
-.PP
-The
-\&\fI\fIpthread_key_create()\fI\fR
-function will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_getspecific()\fI\fR,
-\&\fI\fIpthread_setspecific()\fI\fR,
-\&\fI\fIpthread_key_delete()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_key_delete\fR \- thread-specific data key deletion
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_key_delete(pthread_key_t \fIkey\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-This function deletes a thread-specific data
-key previously returned by
-\&\fI\fIpthread_key_create()\fI\fR.
-The thread-specific data values associated with
-\&\fIkey\fR
-need not be \s-1NULL\s0 at the time
-\&\fI\fIpthread_key_delete()\fI\fR
-is called.
-It is the responsibility of the application
-to free any application storage
-or perform any cleanup actions for data structures
-related to the deleted key or associated thread-specific data
-in any threads;
-this cleanup can be done either before or after
-\&\fI\fIpthread_key_delete()\fI\fR
-is called.
-Any attempt to use
-\&\fIkey\fR
-following the call to
-\&\fI\fIpthread_key_delete()\fI\fR
-results in undefined behaviour.
-.PP
-The
-\&\fI\fIpthread_key_delete()\fI\fR
-function is callable from within destructor functions.
-No destructor functions will be invoked by
-\&\fI\fIpthread_key_delete()\fI\fR.
-Any destructor function that may have been associated with
-\&\fIkey\fR
-will no longer be called upon thread exit.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_key_delete()\fI\fR
-function returns zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_key_delete()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The
-\&\fIkey\fR
-value is invalid.
-.PP
-The
-\&\fI\fIpthread_key_delete()\fI\fR
-function will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_key_create()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_kill\fR \- send a signal to a thread
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <signal.h>
-.PP
-int pthread_kill(pthread_t \fIthread\fR, int \fIsig\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_kill()\fI\fR
-function is used to request that a signal be delivered to the specified thread.
-.PP
-As in
-\&\fI\fIkill()\fI\fR,
-if
-\&\fIsig\fR
-is zero, error checking is performed but no signal is actually sent.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion, the function returns a value of zero.
-Otherwise the function returns an error number.
-If the
-\&\fI\fIpthread_kill()\fI\fR
-function fails, no signal is sent.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_kill()\fI\fR
-function will fail if:
-.Ip "[\s-1ESRCH\s0]" 4
-.IX Item "[ESRCH]"
-No thread could be found corresponding to that specified
-by the given thread \s-1ID\s0.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value of the
-\&\fIsig\fR
-argument is an invalid or unsupported signal number.
-.PP
-The
-\&\fI\fIpthread_kill()\fI\fR
-function will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIkill()\fI\fR,
-\&\fI\fIpthread_self()\fI\fR,
-\&\fI\fIraise()\fI\fR,
-\&\fI<signal.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutex_init,\fR \fBpthread_mutex_destroy\fR \- initialise or destroy a mutex
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutex_init(pthread_mutex_t *\fImutex\fR,
-const pthread_mutexattr_t *\fIattr\fR);
-int pthread_mutex_destroy(pthread_mutex_t *\fImutex\fR);
-pthread_mutex_t \fImutex\fR = \s-1PTHREAD_MUTEX_INITIALIZER\s0;
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_mutex_init()\fI\fR
-function initialises the mutex referenced by
-\&\fImutex\fR
-with attributes specified
-by
-\&\fIattr\fR.
-If
-\&\fIattr\fR
-is \s-1NULL\s0,
-the default mutex attributes are used; the effect is the same as
-passing the address of a default mutex attributes object.
-Upon successful initialisation, the state of the mutex becomes
-initialised and unlocked.
-.PP
-Attempting to initialise an already initialised
-mutex results in
-undefined behaviour.
-.PP
-The
-\&\fI\fIpthread_mutex_destroy()\fI\fR
-function destroys the mutex object referenced by
-\&\fImutex\fR;
-the mutex object becomes, in effect, uninitialised.
-An implementation may cause
-\&\fI\fIpthread_mutex_destroy()\fI\fR
-to set the object referenced by
-\&\fImutex\fR
-to an invalid value.
-A destroyed mutex object
-can be re-initialised using
-\&\fI\fIpthread_mutex_init()\fI\fR;
-the results of otherwise referencing the object after it has been destroyed
-are undefined.
-.PP
-It is safe to destroy an initialised mutex that is unlocked.
-Attempting to destroy a locked mutex results in
-undefined behaviour.
-.PP
-In cases where default mutex attributes are appropriate,
-the macro \s-1PTHREAD_MUTEX_INITIALIZER\s0
-can be used to initialise mutexes that are statically allocated.
-The effect is equivalent to dynamic initialisation by a call to
-\&\fI\fIpthread_mutex_init()\fI\fR
-with parameter
-\&\fIattr\fR
-specified as \s-1NULL\s0,
-except that no error checks are performed.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_mutex_init()\fI\fR
-and
-\&\fI\fIpthread_mutex_destroy()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-The [\s-1EBUSY\s0] and [\s-1EINVAL\s0] error checks, if implemented,
-act as if they were performed immediately
-at the beginning of processing for the function
-and cause an error return
-prior to modifying the state of the mutex specified by
-\&\fImutex\fR.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutex_init()\fI\fR
-function will fail if:
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The system lacked the necessary resources (other than memory)
-to initialise another mutex.
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the mutex.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The caller does not have the privilege to perform the operation.
-.PP
-The
-\&\fI\fIpthread_mutex_init()\fI\fR
-function may fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The implementation has detected an attempt
-to re-initialise the object referenced by
-\&\fImutex\fR,
-a previously initialised, but
-not yet destroyed, mutex.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-is invalid.
-.PP
-The
-\&\fI\fIpthread_mutex_destroy()\fI\fR
-function may fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The implementation has detected an attempt to destroy
-the object referenced by
-\&\fImutex\fR
-while it is locked or referenced
-(for example, while being used in a
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR)
-by another thread.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fImutex\fR
-is invalid.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_mutex_getprioceiling()\fI\fR,
-\&\fI\fIpthread_mutex_lock()\fI\fR,
-\&\fI\fIpthread_mutex_unlock()\fI\fR,
-\&\fI\fIpthread_mutex_setprioceiling()\fI\fR,
-\&\fI\fIpthread_mutex_trylock()\fI\fR,
-\&\fI\fIpthread_mutexattr_getpshared()\fI\fR,
-\&\fI\fIpthread_mutexattr_setpshared()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutex_setprioceiling,\fR \fBpthread_mutex_getprioceiling\fR
-\&\- change the priority ceiling of a mutex
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutex_setprioceiling(pthread_mutex_t *\fImutex\fR, int \fIprioceiling\fR, int *\fIold_ceiling\fR);
-.PP
-int pthread_mutex_getprioceiling(const pthread_mutex_t *\fImutex\fR, int *\fIprioceiling\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_mutex_getprioceiling()\fI\fR
-function returns the current priority ceiling of the mutex.
-.PP
-The
-\&\fI\fIpthread_mutex_setprioceiling()\fI\fR
-function either locks the mutex if it is unlocked, or blocks until it can
-successfully lock the mutex, then it
-changes the mutex's priority ceiling and releases the mutex.
-When the change is successful, the previous value of the
-priority ceiling is returned in
-\&\fIold_ceiling\fR.
-The process of locking the mutex need not adhere
-to the priority protect protocol.
-.PP
-If the
-\&\fI\fIpthread_mutex_setprioceiling()\fI\fR
-function fails, the mutex priority ceiling is not changed.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_mutex_setprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutex_getprioceiling()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutex_getprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutex_setprioceiling()\fI\fR
-functions will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The option _POSIX_THREAD_PRIO_PROTECT is not defined and
-the implementation does not support the function.
-.PP
-The
-\&\fI\fIpthread_mutex_setprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutex_getprioceiling()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The priority requested by
-\&\fIprioceiling\fR
-is out of range.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fImutex\fR
-does not refer to a currently existing mutex.
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The implementation does not support the priority ceiling protocol for mutexes.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The caller does not have the privilege to perform the operation.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_mutex_lock()\fI\fR,
-\&\fI\fIpthread_mutex_unlock()\fI\fR,
-\&\fI\fIpthread_mutex_trylock()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutex_init,\fR \fBpthread_mutex_destroy\fR \- initialise or destroy a mutex
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutex_init(pthread_mutex_t *\fImutex\fR,
-const pthread_mutexattr_t *\fIattr\fR);
-int pthread_mutex_destroy(pthread_mutex_t *\fImutex\fR);
-pthread_mutex_t \fImutex\fR = \s-1PTHREAD_MUTEX_INITIALIZER\s0;
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_mutex_init()\fI\fR
-function initialises the mutex referenced by
-\&\fImutex\fR
-with attributes specified
-by
-\&\fIattr\fR.
-If
-\&\fIattr\fR
-is \s-1NULL\s0,
-the default mutex attributes are used; the effect is the same as
-passing the address of a default mutex attributes object.
-Upon successful initialisation, the state of the mutex becomes
-initialised and unlocked.
-.PP
-Attempting to initialise an already initialised
-mutex results in
-undefined behaviour.
-.PP
-The
-\&\fI\fIpthread_mutex_destroy()\fI\fR
-function destroys the mutex object referenced by
-\&\fImutex\fR;
-the mutex object becomes, in effect, uninitialised.
-An implementation may cause
-\&\fI\fIpthread_mutex_destroy()\fI\fR
-to set the object referenced by
-\&\fImutex\fR
-to an invalid value.
-A destroyed mutex object
-can be re-initialised using
-\&\fI\fIpthread_mutex_init()\fI\fR;
-the results of otherwise referencing the object after it has been destroyed
-are undefined.
-.PP
-It is safe to destroy an initialised mutex that is unlocked.
-Attempting to destroy a locked mutex results in
-undefined behaviour.
-.PP
-In cases where default mutex attributes are appropriate,
-the macro \s-1PTHREAD_MUTEX_INITIALIZER\s0
-can be used to initialise mutexes that are statically allocated.
-The effect is equivalent to dynamic initialisation by a call to
-\&\fI\fIpthread_mutex_init()\fI\fR
-with parameter
-\&\fIattr\fR
-specified as \s-1NULL\s0,
-except that no error checks are performed.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_mutex_init()\fI\fR
-and
-\&\fI\fIpthread_mutex_destroy()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-The [\s-1EBUSY\s0] and [\s-1EINVAL\s0] error checks, if implemented,
-act as if they were performed immediately
-at the beginning of processing for the function
-and cause an error return
-prior to modifying the state of the mutex specified by
-\&\fImutex\fR.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutex_init()\fI\fR
-function will fail if:
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The system lacked the necessary resources (other than memory)
-to initialise another mutex.
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the mutex.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The caller does not have the privilege to perform the operation.
-.PP
-The
-\&\fI\fIpthread_mutex_init()\fI\fR
-function may fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The implementation has detected an attempt
-to re-initialise the object referenced by
-\&\fImutex\fR,
-a previously initialised, but
-not yet destroyed, mutex.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-is invalid.
-.PP
-The
-\&\fI\fIpthread_mutex_destroy()\fI\fR
-function may fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The implementation has detected an attempt to destroy
-the object referenced by
-\&\fImutex\fR
-while it is locked or referenced
-(for example, while being used in a
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR)
-by another thread.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fImutex\fR
-is invalid.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_mutex_getprioceiling()\fI\fR,
-\&\fI\fIpthread_mutex_lock()\fI\fR,
-\&\fI\fIpthread_mutex_unlock()\fI\fR,
-\&\fI\fIpthread_mutex_setprioceiling()\fI\fR,
-\&\fI\fIpthread_mutex_trylock()\fI\fR,
-\&\fI\fIpthread_mutexattr_getpshared()\fI\fR,
-\&\fI\fIpthread_mutexattr_setpshared()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutex_lock,\fR \fBpthread_mutex_trylock,\fR \fBpthread_mutex_unlock\fR
-\&\- lock and unlock a mutex
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutex_lock(pthread_mutex_t *\fImutex\fR);
-int pthread_mutex_trylock(pthread_mutex_t *\fImutex\fR);
-int pthread_mutex_unlock(pthread_mutex_t *\fImutex\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The mutex object referenced by
-\&\fImutex\fR
-is locked by calling
-\&\fI\fIpthread_mutex_lock()\fI\fR.
-If the mutex is already locked,
-the calling thread blocks until the mutex becomes available.
-This operation returns with the mutex object referenced by
-\&\fImutex\fR
-in the locked state with the calling thread as its owner.
-.PP
-If the mutex type is \s-1PTHREAD_MUTEX_NORMAL\s0, deadlock detection is not
-provided. Attempting to
-relock the mutex causes deadlock. If a thread attempts to unlock a
-mutex that it has not locked or a mutex
-which is unlocked, undefined behaviour results.
-.PP
-If the mutex type is \s-1PTHREAD_MUTEX_ERRORCHECK\s0, then
-error checking is provided.
-If a thread attempts to relock a mutex that it has already
-locked, an error will be returned. If a thread
-attempts to unlock a mutex that it has not locked or a mutex which
-is unlocked, an error will be returned.
-.PP
-If the mutex type is \s-1PTHREAD_MUTEX_RECURSIVE\s0, then the mutex maintains
-the concept of a lock count.
-When a thread successfully acquires a mutex for the
-first time, the lock count is set
-to one. Every time a thread relocks this mutex, the lock count is
-incremented by one. Each time the
-thread unlocks the mutex, the lock count is decremented by one.
-When the lock count reaches zero, the
-mutex becomes available for other threads to acquire. If a thread
-attempts to unlock a mutex that it has
-not locked or a mutex which is unlocked, an error will be returned.
-.PP
-If the mutex type is \s-1PTHREAD_MUTEX_DEFAULT\s0, attempting to recursively
-lock the mutex results in
-undefined behaviour. Attempting to unlock the mutex if it was not
-locked by the calling thread results in
-undefined behaviour. Attempting to unlock the mutex if it is not
-locked results in undefined behaviour.
-.PP
-The function
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-is identical to
-\&\fI\fIpthread_mutex_lock()\fI\fR
-except that if the mutex object referenced by
-\&\fImutex\fR
-is currently locked (by any thread, including the
-current thread), the call returns immediately.
-.PP
-The
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-function releases the mutex object referenced by
-\&\fImutex\fR.
-The manner in which a mutex is released is dependent upon the mutex's
-type attribute.
-If there are threads blocked on the mutex object referenced by
-\&\fImutex\fR when
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-is called, resulting in the mutex
-becoming available, the scheduling policy is used to determine
-which thread shall acquire the mutex.
-(In the case of \s-1PTHREAD_MUTEX_RECURSIVE\s0 mutexes, the mutex becomes
-available when the count reaches zero and the calling thread no
-longer has any locks on this mutex).
-.PP
-If a signal is delivered to a thread waiting for a mutex,
-upon return from the signal handler the thread resumes waiting
-for the mutex as if it was not interrupted.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_mutex_lock()\fI\fR
-and
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.PP
-The function
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-returns zero if a lock on the mutex object referenced by
-\&\fImutex\fR
-is acquired.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutex_lock()\fI\fR
-and
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-functions will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The
-\&\fImutex\fR
-was created with the protocol attribute having the value
-\&\s-1PTHREAD_PRIO_PROTECT\s0
-and the calling thread's priority is higher
-than the mutex's current priority ceiling.
-.PP
-The
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-function will fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The
-\&\fImutex\fR
-could not be acquired because it was already locked.
-.PP
-The
-\&\fI\fIpthread_mutex_lock()\fI\fR,
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-and
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fImutex\fR
-does not refer to an initialised mutex object.
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The mutex could not be acquired because the maximum
-number of recursive locks for \fImutex\fR has been exceeded.
-.PP
-The
-\&\fI\fIpthread_mutex_lock()\fI\fR
-function may fail if:
-.Ip "[\s-1EDEADLK\s0]" 4
-.IX Item "[EDEADLK]"
-The current thread already owns the mutex.
-.PP
-The
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-function may fail if:
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The current thread does not own the mutex.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_mutex_destroy()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutex_setprioceiling,\fR \fBpthread_mutex_getprioceiling\fR
-\&\- change the priority ceiling of a mutex
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutex_setprioceiling(pthread_mutex_t *\fImutex\fR, int
-\&\fIprioceiling\fR, int *\fIold_ceiling\fR);
-.PP
-int pthread_mutex_getprioceiling(const pthread_mutex_t *\fImutex\fR,
-int *\fIprioceiling\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_mutex_getprioceiling()\fI\fR
-function returns the current priority ceiling of the mutex.
-.PP
-The
-\&\fI\fIpthread_mutex_setprioceiling()\fI\fR
-function either locks the mutex if it is unlocked, or blocks until it can
-successfully lock the mutex, then it
-changes the mutex's priority ceiling and releases the mutex.
-When the change is successful, the previous value of the
-priority ceiling is returned in
-\&\fIold_ceiling\fR.
-The process of locking the mutex need not adhere
-to the priority protect protocol.
-.PP
-If the
-\&\fI\fIpthread_mutex_setprioceiling()\fI\fR
-function fails, the mutex priority ceiling is not changed.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_mutex_setprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutex_getprioceiling()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutex_getprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutex_setprioceiling()\fI\fR
-functions will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The option _POSIX_THREAD_PRIO_PROTECT is not defined and
-the implementation does not support the function.
-.PP
-The
-\&\fI\fIpthread_mutex_setprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutex_getprioceiling()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The priority requested by
-\&\fIprioceiling\fR
-is out of range.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fImutex\fR
-does not refer to a currently existing mutex.
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The implementation does not support the priority ceiling protocol for mutexes.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The caller does not have the privilege to perform the operation.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_mutex_lock()\fI\fR,
-\&\fI\fIpthread_mutex_unlock()\fI\fR,
-\&\fI\fIpthread_mutex_trylock()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutex_lock,\fR \fBpthread_mutex_trylock,\fR \fBpthread_mutex_unlock\fR
-\&\- lock and unlock a mutex
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutex_lock(pthread_mutex_t *\fImutex\fR);
-int pthread_mutex_trylock(pthread_mutex_t *\fImutex\fR);
-int pthread_mutex_unlock(pthread_mutex_t *\fImutex\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The mutex object referenced by
-\&\fImutex\fR
-is locked by calling
-\&\fI\fIpthread_mutex_lock()\fI\fR.
-If the mutex is already locked,
-the calling thread blocks until the mutex becomes available.
-This operation returns with the mutex object referenced by
-\&\fImutex\fR
-in the locked state with the calling thread as its owner.
-.PP
-If the mutex type is \s-1PTHREAD_MUTEX_NORMAL\s0, deadlock detection is not
-provided. Attempting to
-relock the mutex causes deadlock. If a thread attempts to unlock a
-mutex that it has not locked or a mutex
-which is unlocked, undefined behaviour results.
-.PP
-If the mutex type is \s-1PTHREAD_MUTEX_ERRORCHECK\s0, then
-error checking is provided.
-If a thread attempts to relock a mutex that it has already
-locked, an error will be returned. If a thread
-attempts to unlock a mutex that it has not locked or a mutex which
-is unlocked, an error will be returned.
-.PP
-If the mutex type is \s-1PTHREAD_MUTEX_RECURSIVE\s0, then the mutex maintains
-the concept of a lock count.
-When a thread successfully acquires a mutex for the
-first time, the lock count is set
-to one. Every time a thread relocks this mutex, the lock count is
-incremented by one. Each time the
-thread unlocks the mutex, the lock count is decremented by one.
-When the lock count reaches zero, the
-mutex becomes available for other threads to acquire. If a thread
-attempts to unlock a mutex that it has
-not locked or a mutex which is unlocked, an error will be returned.
-.PP
-If the mutex type is \s-1PTHREAD_MUTEX_DEFAULT\s0, attempting to recursively
-lock the mutex results in
-undefined behaviour. Attempting to unlock the mutex if it was not
-locked by the calling thread results in
-undefined behaviour. Attempting to unlock the mutex if it is not
-locked results in undefined behaviour.
-.PP
-The function
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-is identical to
-\&\fI\fIpthread_mutex_lock()\fI\fR
-except that if the mutex object referenced by
-\&\fImutex\fR
-is currently locked (by any thread, including the
-current thread), the call returns immediately.
-.PP
-The
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-function releases the mutex object referenced by
-\&\fImutex\fR.
-The manner in which a mutex is released is dependent upon the mutex's
-type attribute.
-If there are threads blocked on the mutex object referenced by
-\&\fImutex\fR when
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-is called, resulting in the mutex
-becoming available, the scheduling policy is used to determine
-which thread shall acquire the mutex.
-(In the case of \s-1PTHREAD_MUTEX_RECURSIVE\s0 mutexes, the mutex becomes
-available when the count reaches zero and the calling thread no
-longer has any locks on this mutex).
-.PP
-If a signal is delivered to a thread waiting for a mutex,
-upon return from the signal handler the thread resumes waiting
-for the mutex as if it was not interrupted.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_mutex_lock()\fI\fR
-and
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.PP
-The function
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-returns zero if a lock on the mutex object referenced by
-\&\fImutex\fR
-is acquired.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutex_lock()\fI\fR
-and
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-functions will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The
-\&\fImutex\fR
-was created with the protocol attribute having the value
-\&\s-1PTHREAD_PRIO_PROTECT\s0
-and the calling thread's priority is higher
-than the mutex's current priority ceiling.
-.PP
-The
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-function will fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The
-\&\fImutex\fR
-could not be acquired because it was already locked.
-.PP
-The
-\&\fI\fIpthread_mutex_lock()\fI\fR,
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-and
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fImutex\fR
-does not refer to an initialised mutex object.
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The mutex could not be acquired because the maximum
-number of recursive locks for \fImutex\fR has been exceeded.
-.PP
-The
-\&\fI\fIpthread_mutex_lock()\fI\fR
-function may fail if:
-.Ip "[\s-1EDEADLK\s0]" 4
-.IX Item "[EDEADLK]"
-The current thread already owns the mutex.
-.PP
-The
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-function may fail if:
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The current thread does not own the mutex.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_mutex_destroy()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutex_lock,\fR \fBpthread_mutex_trylock,\fR \fBpthread_mutex_unlock\fR
-\&\- lock and unlock a mutex
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutex_lock(pthread_mutex_t *\fImutex\fR);
-int pthread_mutex_trylock(pthread_mutex_t *\fImutex\fR);
-int pthread_mutex_unlock(pthread_mutex_t *\fImutex\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The mutex object referenced by
-\&\fImutex\fR
-is locked by calling
-\&\fI\fIpthread_mutex_lock()\fI\fR.
-If the mutex is already locked,
-the calling thread blocks until the mutex becomes available.
-This operation returns with the mutex object referenced by
-\&\fImutex\fR
-in the locked state with the calling thread as its owner.
-.PP
-If the mutex type is \s-1PTHREAD_MUTEX_NORMAL\s0, deadlock detection is not
-provided. Attempting to
-relock the mutex causes deadlock. If a thread attempts to unlock a
-mutex that it has not locked or a mutex
-which is unlocked, undefined behaviour results.
-.PP
-If the mutex type is \s-1PTHREAD_MUTEX_ERRORCHECK\s0, then
-error checking is provided.
-If a thread attempts to relock a mutex that it has already
-locked, an error will be returned. If a thread
-attempts to unlock a mutex that it has not locked or a mutex which
-is unlocked, an error will be returned.
-.PP
-If the mutex type is \s-1PTHREAD_MUTEX_RECURSIVE\s0, then the mutex maintains
-the concept of a lock count.
-When a thread successfully acquires a mutex for the
-first time, the lock count is set
-to one. Every time a thread relocks this mutex, the lock count is
-incremented by one. Each time the
-thread unlocks the mutex, the lock count is decremented by one.
-When the lock count reaches zero, the
-mutex becomes available for other threads to acquire. If a thread
-attempts to unlock a mutex that it has
-not locked or a mutex which is unlocked, an error will be returned.
-.PP
-If the mutex type is \s-1PTHREAD_MUTEX_DEFAULT\s0, attempting to recursively
-lock the mutex results in
-undefined behaviour. Attempting to unlock the mutex if it was not
-locked by the calling thread results in
-undefined behaviour. Attempting to unlock the mutex if it is not
-locked results in undefined behaviour.
-.PP
-The function
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-is identical to
-\&\fI\fIpthread_mutex_lock()\fI\fR
-except that if the mutex object referenced by
-\&\fImutex\fR
-is currently locked (by any thread, including the
-current thread), the call returns immediately.
-.PP
-The
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-function releases the mutex object referenced by
-\&\fImutex\fR.
-The manner in which a mutex is released is dependent upon the mutex's
-type attribute.
-If there are threads blocked on the mutex object referenced by
-\&\fImutex\fR when
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-is called, resulting in the mutex
-becoming available, the scheduling policy is used to determine
-which thread shall acquire the mutex.
-(In the case of \s-1PTHREAD_MUTEX_RECURSIVE\s0 mutexes, the mutex becomes
-available when the count reaches zero and the calling thread no
-longer has any locks on this mutex).
-.PP
-If a signal is delivered to a thread waiting for a mutex,
-upon return from the signal handler the thread resumes waiting
-for the mutex as if it was not interrupted.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_mutex_lock()\fI\fR
-and
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.PP
-The function
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-returns zero if a lock on the mutex object referenced by
-\&\fImutex\fR
-is acquired.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutex_lock()\fI\fR
-and
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-functions will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The
-\&\fImutex\fR
-was created with the protocol attribute having the value
-\&\s-1PTHREAD_PRIO_PROTECT\s0
-and the calling thread's priority is higher
-than the mutex's current priority ceiling.
-.PP
-The
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-function will fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The
-\&\fImutex\fR
-could not be acquired because it was already locked.
-.PP
-The
-\&\fI\fIpthread_mutex_lock()\fI\fR,
-\&\fI\fIpthread_mutex_trylock()\fI\fR
-and
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fImutex\fR
-does not refer to an initialised mutex object.
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The mutex could not be acquired because the maximum
-number of recursive locks for \fImutex\fR has been exceeded.
-.PP
-The
-\&\fI\fIpthread_mutex_lock()\fI\fR
-function may fail if:
-.Ip "[\s-1EDEADLK\s0]" 4
-.IX Item "[EDEADLK]"
-The current thread already owns the mutex.
-.PP
-The
-\&\fI\fIpthread_mutex_unlock()\fI\fR
-function may fail if:
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The current thread does not own the mutex.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_mutex_destroy()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutexattr_init,\fR \fBpthread_mutexattr_destroy\fR
-\&\- initialise and destroy mutex attributes object
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutexattr_init(pthread_mutexattr_t *\fIattr\fR);
-int pthread_mutexattr_destroy(pthread_mutexattr_t *\fIattr\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The function
-\&\fI\fIpthread_mutexattr_init()\fI\fR
-initialises a mutex attributes object
-\&\fIattr\fR
-with the default value for all of the attributes
-defined by the implementation.
-.PP
-The effect of initialising an already initialised mutex
-attributes object is undefined.
-.PP
-After a mutex attributes object has been used
-to initialise one or more mutexes,
-any function affecting the attributes object (including destruction)
-does not affect any previously initialised mutexes.
-.PP
-The
-\&\fI\fIpthread_mutexattr_destroy()\fI\fR
-function destroys a mutex attributes object;
-the object becomes, in effect, uninitialised.
-An implementation may cause
-\&\fI\fIpthread_mutexattr_destroy()\fI\fR
-to set the object referenced by
-\&\fIattr\fR
-to an invalid value.
-A destroyed mutex attributes object
-can be re-initialised using
-\&\fI\fIpthread_mutexattr_init()\fI\fR;
-the results of otherwise referencing the object after it has been
-destroyed are undefined.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion,
-\&\fI\fIpthread_mutexattr_init()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_destroy()\fI\fR
-return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutexattr_init()\fI\fR
-function may fail if:
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the mutex attributes object.
-.PP
-The
-\&\fI\fIpthread_mutexattr_destroy()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-is invalid.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_mutexattr_init()\fI\fR,
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutexattr_setprioceiling,\fR \fBpthread_mutexattr_getprioceiling\fR
-\&\- set and get prioceiling attribute of mutex attribute object
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutexattr_setprioceiling(pthread_mutexattr_t *\fIattr\fR,
-int \fIprioceiling\fR);
-int pthread_mutexattr_getprioceiling(const pthread_mutexattr_t *\fIattr\fR,
-int *\fIprioceiling\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_mutexattr_setprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprioceiling()\fI\fR
-functions, respectively, set and get the priority ceiling attribute of
-a mutex attribute object pointed to by
-\&\fIattr\fR
-which was previously created by the function
-\&\fI\fIpthread_mutexattr_init()\fI\fR.
-.PP
-The
-\&\fIprioceiling\fR
-attribute contains the priority ceiling of initialised mutexes.
-The values of
-\&\fIprioceiling\fR
-will be within the maximum range of priorities defined by \s-1SCHED_FIFO\s0.
-.PP
-The
-\&\fIprioceiling\fR
-attribute defines the priority ceiling of initialised mutexes,
-which is the minimum priority level
-at which the critical section guarded by the mutex is executed.
-In order to avoid priority inversion,
-the priority ceiling of the mutex will be set to a priority
-higher than or equal to the highest priority of all the threads
-that may lock that mutex.
-The values of
-\&\fIprioceiling\fR
-will be within the maximum range of priorities
-defined under the \s-1SCHED_FIFO\s0 scheduling policy.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion, the
-\&\fI\fIpthread_mutexattr_setprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprioceiling()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutexattr_setprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprioceiling()\fI\fR
-functions will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The option _POSIX_THREAD_PRIO_PROTECT is not defined and the
-implementation does not support the function.
-.PP
-The
-\&\fI\fIpthread_mutexattr_setprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprioceiling()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-or
-\&\fIprioceiling\fR
-is invalid.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The caller does not have the privilege to perform the operation.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutexattr_setprotocol,\fR \fBpthread_mutexattr_getprotocol\fR
-\&\- set and get protocol attribute of mutex attribute object
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutexattr_setprotocol(pthread_mutexattr_t *\fIattr\fR,
-int \fIprotocol\fR);
-int pthread_mutexattr_getprotocol(const pthread_mutexattr_t *\fIattr\fR,
-int *\fIprotocol\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_mutexattr_setprotocol()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprotocol()\fI\fR
-functions, respectively, set and get the protocol attribute of a mutex
-attribute object pointed to by
-\&\fIattr\fR
-which was previously created by the function
-\&\fI\fIpthread_mutexattr_init()\fI\fR.
-.PP
-The
-\&\fIprotocol\fR
-attribute defines the protocol to be followed in utilising mutexes.
-The value of
-\&\fIprotocol\fR
-may be one of \s-1PTHREAD_PRIO_NONE\s0, \s-1PTHREAD_PRIO_INHERIT\s0 or
-\&\s-1PTHREAD_PRIO_PROTECT\s0, which are defined by the header
-\&\fI<pthread.h\fR>.
-.PP
-When a thread owns a mutex with the \s-1PTHREAD_PRIO_NONE\s0
-protocol attribute, its priority and scheduling are not affected
-by its mutex ownership.
-.PP
-When a thread is blocking higher priority threads because of owning one or
-more mutexes with the \s-1PTHREAD_PRIO_INHERIT\s0
-protocol attribute, it executes at the higher of its priority
-or the priority of the highest priority thread waiting on any of the mutexes
-owned by this thread and initialised with this protocol.
-.PP
-When a thread owns one or more mutexes initialised with the
-\&\s-1PTHREAD_PRIO_PROTECT\s0
-protocol, it executes at the higher of its priority or the highest
-of the priority ceilings of all the mutexes
-owned by this thread and initialised with this attribute,
-regardless of whether other threads are blocked on any of these
-mutexes or not.
-.PP
-While a thread is holding a mutex which has been initialised with the
-\&\s-1PRIO_INHERIT\s0 or \s-1PRIO_PROTECT\s0 protocol attributes,
-it will not be subject to being moved
-to the tail of the scheduling queue at its priority
-in the event that its original priority is changed,
-such as by a call to
-\&\fI\fIsched_setparam()\fI\fR.
-Likewise,
-when a thread unlocks a mutex that has been initialised with the
-\&\s-1PRIO_INHERIT\s0 or \s-1PRIO_PROTECT\s0 protocol attributes,
-it will not be subject to being moved
-to the tail of the scheduling queue at its priority
-in the event that its original priority is changed.
-.PP
-If a thread simultaneously owns several mutexes
-initialised with different protocols,
-it will execute at the highest of the priorities
-that it would have obtained by each of these protocols.
-.PP
-When a thread makes a call to
-\&\fI\fIpthread_mutex_lock()\fI\fR,
-if the symbol _POSIX_THREAD_PRIO_INHERIT
-is defined and the mutex was
-initialised with the protocol attribute having the value
-\&\s-1PTHREAD_PRIO_INHERIT\s0, when the calling thread is blocked
-because the mutex is owned by another thread,
-that owner thread will inherit the priority level
-of the calling thread as long as it continues to own the mutex.
-The implementation updates its execution priority
-to the maximum of its assigned priority and all its inherited priorities.
-Furthermore, if this owner thread itself becomes blocked on another mutex,
-the same priority inheritance effect will be propagated
-to this other owner thread, in a recursive manner.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion, the
-\&\fI\fIpthread_mutexattr_setprotocol()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprotocol()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutexattr_setprotocol()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprotocol()\fI\fR
-functions will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-Neither one of the options _POSIX_THREAD_PRIO_PROTECT and
-_POSIX_THREAD_PRIO_INHERIT is defined and the implementation does not
-support the function.
-.Ip "[\s-1ENOTSUP\s0]" 4
-.IX Item "[ENOTSUP]"
-The value specified by
-\&\fIprotocol\fR
-is an unsupported value.
-.PP
-The
-\&\fI\fIpthread_mutexattr_setprotocol()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprotocol()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-ro
-\&\fIprotocol\fR
-is invalid.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The caller does not have the privilege to perform the operation.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutexattr_getpshared,\fR \fBpthread_mutexattr_setpshared\fR
-\&\- set and get process-shared attribute
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutexattr_getpshared(const pthread_mutexattr_t *\fIattr\fR,
-int *\fIpshared\fR);
-int pthread_mutexattr_setpshared(pthread_mutexattr_t *\fIattr\fR,
-int \fIpshared\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_mutexattr_getpshared()\fI\fR
-function obtains the value of the
-\&\fIprocess-shared\fR
-attribute from the attributes object referenced by
-\&\fIattr\fR.
-The
-\&\fI\fIpthread_mutexattr_setpshared()\fI\fR
-function is used to set the
-\&\fIprocess-shared\fR
-attribute in an initialised attributes object referenced by
-\&\fIattr\fR.
-.PP
-The
-\&\fIprocess-shared\fR
-attribute is set to \s-1PTHREAD_PROCESS_SHARED\s0 to permit a mutex
-to be operated upon by any thread that has access to the memory
-where the mutex is allocated, even if the mutex
-is allocated in memory that is shared by multiple processes.
-If the
-\&\fIprocess-shared\fR
-attribute is \s-1PTHREAD_PROCESS_PRIVATE\s0, the mutex will only be operated upon
-by threads created within the same process as the thread
-that initialised the mutex;
-if threads of differing processes attempt to operate on such a mutex,
-the behaviour is undefined.
-The default value of the attribute is
-\&\s-1PTHREAD_PROCESS_PRIVATE\s0.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion,
-\&\fI\fIpthread_mutexattr_setpshared()\fI\fR
-returns zero.
-Otherwise, an error number is returned to indicate the error.
-.PP
-Upon successful completion,
-\&\fI\fIpthread_mutexattr_getpshared()\fI\fR
-returns zero and stores the value of the
-\&\fIprocess-shared\fR
-attribute of
-\&\fIattr\fR
-into the object referenced by the
-\&\fIpshared\fR
-parameter.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutexattr_getpshared()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_setpshared()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-is invalid.
-.PP
-The
-\&\fI\fIpthread_mutexattr_setpshared()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The new value specified for the attribute
-is outside the range of legal values for that attribute.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_mutexattr_init()\fI\fR,
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutexattr_gettype,\fR \fBpthread_mutexattr_settype\fR
-\&\- get or set a mutex type
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutexattr_gettype(const pthread_mutexattr_t \fI*attr\fR, int \fI*type\fR);
-int pthread_mutexattr_settype(pthread_mutexattr_t \fI*attr\fR, int \fItype\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_mutexattr_gettype()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_settype()\fI\fR
-functions respectively get and set the mutex \fItype\fR attribute.
-This attribute is set in the \fItype\fR parameter
-to these functions. The default value of the \fItype\fR
-attribute is \s-1PTHREAD_MUTEX_DEFAULT\s0.
-.PP
-The type of mutex is contained in the \fItype\fR attribute of the
-mutex attributes. Valid mutex types include:
-.Ip "\s-1PTHREAD_MUTEX_NORMAL\s0" 4
-.IX Item "PTHREAD_MUTEX_NORMAL"
-This type of mutex does not detect deadlock. A thread
-attempting to relock this mutex without first unlocking it
-will deadlock.  Attempting to unlock a
-mutex locked by a different thread results in undefined behaviour.
-Attempting to unlock an unlocked
-mutex results in undefined behaviour.
-.Ip "\s-1PTHREAD_MUTEX_ERRORCHECK\s0" 4
-.IX Item "PTHREAD_MUTEX_ERRORCHECK"
-This type of mutex provides error checking.  A thread
-attempting to relock this mutex without first unlocking it
-will return with an error.
-A thread attempting to unlock a mutex which another
-thread has locked will return with an error.
-A thread attempting to unlock an unlocked mutex will
-return with an error.
-.Ip "\s-1PTHREAD_MUTEX_RECURSIVE\s0" 4
-.IX Item "PTHREAD_MUTEX_RECURSIVE"
-A thread attempting to relock this mutex without first
-unlocking it will succeed in locking the mutex. The relocking
-deadlock which can occur with
-mutexes of type \s-1PTHREAD_MUTEX_NORMAL\s0 cannot occur with this type
-of mutex. Multiple
-locks of this mutex require the same number of unlocks to release
-the mutex before another thread
-can acquire the mutex.
-A thread attempting to unlock a mutex which another thread has
-locked will return with an error. A thread attempting to
-unlock an unlocked mutex will return with an error.
-.Ip "\s-1PTHREAD_MUTEX_DEFAULT\s0" 4
-.IX Item "PTHREAD_MUTEX_DEFAULT"
-Attempting to recursively lock a mutex of this type results in
-undefined behaviour. Attempting to unlock a mutex of this type which
-was not locked by the calling
-thread results in undefined behaviour. Attempting to unlock a mutex
-of this type which is not locked results in undefined behaviour.
-An implementation is allowed to map this mutex to one of the
-other mutex types.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_mutexattr_settype()\fI\fR
-function
-returns zero.  Otherwise, an error number is
-returned to indicate the error.
-.PP
-Upon successful completion, the
-\&\fI\fIpthread_mutexattr_gettype()\fI\fR
-function returns zero and stores the value of the
-\&\fItype\fR attribute of \fIattr\fR into the object referenced by the
-\&\fItype\fR
-parameter.  Otherwise an error is returned to indicate
-the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutexattr_gettype()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_settype()\fI\fR
-functions will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value \fItype\fR is invalid.
-.PP
-The
-\&\fI\fIpthread_mutexattr_gettype()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_settype()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIattr\fR is invalid.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-It is advised that an application should not use
-a \s-1PTHREAD_MUTEX_RECURSIVE\s0 mutex with condition variables
-because the implicit unlock performed for a
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-may not actually release the
-mutex (if it had been locked multiple times). If this happens,
-no other thread can satisfy the condition of the predicate.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_cond_wait()\fI\fR,
-\&\fI\fIpthread_cond_timedwait()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutexattr_init,\fR \fBpthread_mutexattr_destroy\fR
-\&\- initialise and destroy mutex attributes object
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutexattr_init(pthread_mutexattr_t *\fIattr\fR);
-int pthread_mutexattr_destroy(pthread_mutexattr_t *\fIattr\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The function
-\&\fI\fIpthread_mutexattr_init()\fI\fR
-initialises a mutex attributes object
-\&\fIattr\fR
-with the default value for all of the attributes
-defined by the implementation.
-.PP
-The effect of initialising an already initialised mutex
-attributes object is undefined.
-.PP
-After a mutex attributes object has been used
-to initialise one or more mutexes,
-any function affecting the attributes object (including destruction)
-does not affect any previously initialised mutexes.
-.PP
-The
-\&\fI\fIpthread_mutexattr_destroy()\fI\fR
-function destroys a mutex attributes object;
-the object becomes, in effect, uninitialised.
-An implementation may cause
-\&\fI\fIpthread_mutexattr_destroy()\fI\fR
-to set the object referenced by
-\&\fIattr\fR
-to an invalid value.
-A destroyed mutex attributes object
-can be re-initialised using
-\&\fI\fIpthread_mutexattr_init()\fI\fR;
-the results of otherwise referencing the object after it has been
-destroyed are undefined.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion,
-\&\fI\fIpthread_mutexattr_init()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_destroy()\fI\fR
-return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutexattr_init()\fI\fR
-function may fail if:
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the mutex attributes object.
-.PP
-The
-\&\fI\fIpthread_mutexattr_destroy()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-is invalid.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_mutexattr_init()\fI\fR,
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutexattr_setprioceiling,\fR \fBpthread_mutexattr_getprioceiling\fR
-\&\- set and get prioceiling attribute of mutex attribute object
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutexattr_setprioceiling(pthread_mutexattr_t *\fIattr\fR,
-int \fIprioceiling\fR);
-int pthread_mutexattr_getprioceiling(const pthread_mutexattr_t *\fIattr\fR,
-int *\fIprioceiling\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_mutexattr_setprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprioceiling()\fI\fR
-functions, respectively, set and get the priority ceiling attribute of
-a mutex attribute object pointed to by
-\&\fIattr\fR
-which was previously created by the function
-\&\fI\fIpthread_mutexattr_init()\fI\fR.
-.PP
-The
-\&\fIprioceiling\fR
-attribute contains the priority ceiling of initialised mutexes.
-The values of
-\&\fIprioceiling\fR
-will be within the maximum range of priorities defined by \s-1SCHED_FIFO\s0.
-.PP
-The
-\&\fIprioceiling\fR
-attribute defines the priority ceiling of initialised mutexes,
-which is the minimum priority level
-at which the critical section guarded by the mutex is executed.
-In order to avoid priority inversion,
-the priority ceiling of the mutex will be set to a priority
-higher than or equal to the highest priority of all the threads
-that may lock that mutex.
-The values of
-\&\fIprioceiling\fR
-will be within the maximum range of priorities
-defined under the \s-1SCHED_FIFO\s0 scheduling policy.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion, the
-\&\fI\fIpthread_mutexattr_setprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprioceiling()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutexattr_setprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprioceiling()\fI\fR
-functions will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The option _POSIX_THREAD_PRIO_PROTECT is not defined and the
-implementation does not support the function.
-.PP
-The
-\&\fI\fIpthread_mutexattr_setprioceiling()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprioceiling()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-or
-\&\fIprioceiling\fR
-is invalid.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The caller does not have the privilege to perform the operation.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutexattr_setprotocol,\fR \fBpthread_mutexattr_getprotocol\fR
-\&\- set and get protocol attribute of mutex attribute object
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutexattr_setprotocol(pthread_mutexattr_t *\fIattr\fR,
-int \fIprotocol\fR);
-int pthread_mutexattr_getprotocol(const pthread_mutexattr_t *\fIattr\fR,
-int *\fIprotocol\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_mutexattr_setprotocol()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprotocol()\fI\fR
-functions, respectively, set and get the protocol attribute of a mutex
-attribute object pointed to by
-\&\fIattr\fR
-which was previously created by the function
-\&\fI\fIpthread_mutexattr_init()\fI\fR.
-.PP
-The
-\&\fIprotocol\fR
-attribute defines the protocol to be followed in utilising mutexes.
-The value of
-\&\fIprotocol\fR
-may be one of \s-1PTHREAD_PRIO_NONE\s0, \s-1PTHREAD_PRIO_INHERIT\s0 or
-\&\s-1PTHREAD_PRIO_PROTECT\s0, which are defined by the header
-\&\fI<pthread.h\fR>.
-.PP
-When a thread owns a mutex with the \s-1PTHREAD_PRIO_NONE\s0
-protocol attribute, its priority and scheduling are not affected
-by its mutex ownership.
-.PP
-When a thread is blocking higher priority threads because of owning one or
-more mutexes with the \s-1PTHREAD_PRIO_INHERIT\s0
-protocol attribute, it executes at the higher of its priority
-or the priority of the highest priority thread waiting on any of the mutexes
-owned by this thread and initialised with this protocol.
-.PP
-When a thread owns one or more mutexes initialised with the
-\&\s-1PTHREAD_PRIO_PROTECT\s0
-protocol, it executes at the higher of its priority or the highest
-of the priority ceilings of all the mutexes
-owned by this thread and initialised with this attribute,
-regardless of whether other threads are blocked on any of these
-mutexes or not.
-.PP
-While a thread is holding a mutex which has been initialised with the
-\&\s-1PRIO_INHERIT\s0 or \s-1PRIO_PROTECT\s0 protocol attributes,
-it will not be subject to being moved
-to the tail of the scheduling queue at its priority
-in the event that its original priority is changed,
-such as by a call to
-\&\fI\fIsched_setparam()\fI\fR.
-Likewise,
-when a thread unlocks a mutex that has been initialised with the
-\&\s-1PRIO_INHERIT\s0 or \s-1PRIO_PROTECT\s0 protocol attributes,
-it will not be subject to being moved
-to the tail of the scheduling queue at its priority
-in the event that its original priority is changed.
-.PP
-If a thread simultaneously owns several mutexes
-initialised with different protocols,
-it will execute at the highest of the priorities
-that it would have obtained by each of these protocols.
-.PP
-When a thread makes a call to
-\&\fI\fIpthread_mutex_lock()\fI\fR,
-if the symbol _POSIX_THREAD_PRIO_INHERIT
-is defined and the mutex was
-initialised with the protocol attribute having the value
-\&\s-1PTHREAD_PRIO_INHERIT\s0, when the calling thread is blocked
-because the mutex is owned by another thread,
-that owner thread will inherit the priority level
-of the calling thread as long as it continues to own the mutex.
-The implementation updates its execution priority
-to the maximum of its assigned priority and all its inherited priorities.
-Furthermore, if this owner thread itself becomes blocked on another mutex,
-the same priority inheritance effect will be propagated
-to this other owner thread, in a recursive manner.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion, the
-\&\fI\fIpthread_mutexattr_setprotocol()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprotocol()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutexattr_setprotocol()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprotocol()\fI\fR
-functions will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-Neither one of the options _POSIX_THREAD_PRIO_PROTECT and
-_POSIX_THREAD_PRIO_INHERIT is defined and the implementation does not
-support the function.
-.Ip "[\s-1ENOTSUP\s0]" 4
-.IX Item "[ENOTSUP]"
-The value specified by
-\&\fIprotocol\fR
-is an unsupported value.
-.PP
-The
-\&\fI\fIpthread_mutexattr_setprotocol()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_getprotocol()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-ro
-\&\fIprotocol\fR
-is invalid.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The caller does not have the privilege to perform the operation.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutexattr_getpshared,\fR \fBpthread_mutexattr_setpshared\fR
-\&\- set and get process-shared attribute
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutexattr_getpshared(const pthread_mutexattr_t *\fIattr\fR,
-int *\fIpshared\fR);
-int pthread_mutexattr_setpshared(pthread_mutexattr_t *\fIattr\fR,
-int \fIpshared\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_mutexattr_getpshared()\fI\fR
-function obtains the value of the
-\&\fIprocess-shared\fR
-attribute from the attributes object referenced by
-\&\fIattr\fR.
-The
-\&\fI\fIpthread_mutexattr_setpshared()\fI\fR
-function is used to set the
-\&\fIprocess-shared\fR
-attribute in an initialised attributes object referenced by
-\&\fIattr\fR.
-.PP
-The
-\&\fIprocess-shared\fR
-attribute is set to \s-1PTHREAD_PROCESS_SHARED\s0 to permit a mutex
-to be operated upon by any thread that has access to the memory
-where the mutex is allocated, even if the mutex
-is allocated in memory that is shared by multiple processes.
-If the
-\&\fIprocess-shared\fR
-attribute is \s-1PTHREAD_PROCESS_PRIVATE\s0, the mutex will only be operated upon
-by threads created within the same process as the thread
-that initialised the mutex;
-if threads of differing processes attempt to operate on such a mutex,
-the behaviour is undefined.
-The default value of the attribute is
-\&\s-1PTHREAD_PROCESS_PRIVATE\s0.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion,
-\&\fI\fIpthread_mutexattr_setpshared()\fI\fR
-returns zero.
-Otherwise, an error number is returned to indicate the error.
-.PP
-Upon successful completion,
-\&\fI\fIpthread_mutexattr_getpshared()\fI\fR
-returns zero and stores the value of the
-\&\fIprocess-shared\fR
-attribute of
-\&\fIattr\fR
-into the object referenced by the
-\&\fIpshared\fR
-parameter.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutexattr_getpshared()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_setpshared()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIattr\fR
-is invalid.
-.PP
-The
-\&\fI\fIpthread_mutexattr_setpshared()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The new value specified for the attribute
-is outside the range of legal values for that attribute.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_mutex_init()\fI\fR,
-\&\fI\fIpthread_mutexattr_init()\fI\fR,
-\&\fI\fIpthread_cond_init()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_mutexattr_gettype,\fR \fBpthread_mutexattr_settype\fR
-\&\- get or set a mutex type
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_mutexattr_gettype(const pthread_mutexattr_t \fI*attr\fR, int \fI*type\fR);
-int pthread_mutexattr_settype(pthread_mutexattr_t \fI*attr\fR, int \fItype\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_mutexattr_gettype()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_settype()\fI\fR
-functions respectively get and set the mutex \fItype\fR attribute.
-This attribute is set in the \fItype\fR parameter
-to these functions. The default value of the \fItype\fR
-attribute is \s-1PTHREAD_MUTEX_DEFAULT\s0.
-.PP
-The type of mutex is contained in the \fItype\fR attribute of the
-mutex attributes. Valid mutex types include:
-.Ip "\s-1PTHREAD_MUTEX_NORMAL\s0" 4
-.IX Item "PTHREAD_MUTEX_NORMAL"
-This type of mutex does not detect deadlock. A thread
-attempting to relock this mutex without first unlocking it
-will deadlock.  Attempting to unlock a
-mutex locked by a different thread results in undefined behaviour.
-Attempting to unlock an unlocked
-mutex results in undefined behaviour.
-.Ip "\s-1PTHREAD_MUTEX_ERRORCHECK\s0" 4
-.IX Item "PTHREAD_MUTEX_ERRORCHECK"
-This type of mutex provides error checking.  A thread
-attempting to relock this mutex without first unlocking it
-will return with an error.
-A thread attempting to unlock a mutex which another
-thread has locked will return with an error.
-A thread attempting to unlock an unlocked mutex will
-return with an error.
-.Ip "\s-1PTHREAD_MUTEX_RECURSIVE\s0" 4
-.IX Item "PTHREAD_MUTEX_RECURSIVE"
-A thread attempting to relock this mutex without first
-unlocking it will succeed in locking the mutex. The relocking
-deadlock which can occur with
-mutexes of type \s-1PTHREAD_MUTEX_NORMAL\s0 cannot occur with this type
-of mutex. Multiple
-locks of this mutex require the same number of unlocks to release
-the mutex before another thread
-can acquire the mutex.
-A thread attempting to unlock a mutex which another thread has
-locked will return with an error. A thread attempting to
-unlock an unlocked mutex will return with an error.
-.Ip "\s-1PTHREAD_MUTEX_DEFAULT\s0" 4
-.IX Item "PTHREAD_MUTEX_DEFAULT"
-Attempting to recursively lock a mutex of this type results in
-undefined behaviour. Attempting to unlock a mutex of this type which
-was not locked by the calling
-thread results in undefined behaviour. Attempting to unlock a mutex
-of this type which is not locked results in undefined behaviour.
-An implementation is allowed to map this mutex to one of the
-other mutex types.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_mutexattr_settype()\fI\fR
-function
-returns zero.  Otherwise, an error number is
-returned to indicate the error.
-.PP
-Upon successful completion, the
-\&\fI\fIpthread_mutexattr_gettype()\fI\fR
-function returns zero and stores the value of the
-\&\fItype\fR attribute of \fIattr\fR into the object referenced by the
-\&\fItype\fR
-parameter.  Otherwise an error is returned to indicate
-the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_mutexattr_gettype()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_settype()\fI\fR
-functions will fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value \fItype\fR is invalid.
-.PP
-The
-\&\fI\fIpthread_mutexattr_gettype()\fI\fR
-and
-\&\fI\fIpthread_mutexattr_settype()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIattr\fR is invalid.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-It is advised that an application should not use
-a \s-1PTHREAD_MUTEX_RECURSIVE\s0 mutex with condition variables
-because the implicit unlock performed for a
-\&\fI\fIpthread_cond_wait()\fI\fR
-or
-\&\fI\fIpthread_cond_timedwait()\fI\fR
-may not actually release the
-mutex (if it had been locked multiple times). If this happens,
-no other thread can satisfy the condition of the predicate.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_cond_wait()\fI\fR,
-\&\fI\fIpthread_cond_timedwait()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_once\fR \- dynamic package initialisation
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_once(pthread_once_t *\fIonce_control\fR,
-void (*\fIinit_routine\fR)(void));
-pthread_once_t \fIonce_control\fR = \s-1PTHREAD_ONCE_INIT\s0;
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The first call to
-\&\fI\fIpthread_once()\fI\fR
-by any thread in a process, with a given
-\&\fIonce_control\fR,
-will call the
-\&\fI\fIinit_routine()\fI\fR
-with no arguments.
-Subsequent calls of
-\&\fI\fIpthread_once()\fI\fR
-with the same
-\&\fIonce_control\fR
-will not call the
-\&\fI\fIinit_routine()\fI\fR.
-On return from
-\&\fI\fIpthread_once()\fI\fR,
-it is guaranteed that
-\&\fI\fIinit_routine()\fI\fR
-has completed.
-The
-\&\fIonce_control\fR
-parameter is used to determine whether
-the associated initialisation routine has been called.
-.PP
-The function
-\&\fI\fIpthread_once()\fI\fR
-is not a cancellation point.
-However, if
-\&\fI\fIinit_routine()\fI\fR
-is a cancellation point and is canceled,
-the effect on
-\&\fIonce_control\fR
-is as if
-\&\fI\fIpthread_once()\fI\fR
-was never called.
-.PP
-The constant \s-1PTHREAD_ONCE_INIT\s0
-is defined by the header
-\&\fI<pthread.h\fR>.
-.PP
-The behaviour of
-\&\fI\fIpthread_once()\fI\fR
-is undefined if
-\&\fIonce_control\fR
-has automatic storage duration or is not initialised by
-\&\s-1PTHREAD_ONCE_INIT\s0.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-Upon successful completion,
-\&\fI\fIpthread_once()\fI\fR
-returns zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-No errors are defined.
-.PP
-The
-\&\fI\fIpthread_once()\fI\fR
-function will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread,h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_rwlock_init,\fR \fBpthread_rwlock_destroy\fR
-\&\- initialise or destroy a read-write lock object
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_rwlock_init(pthread_rwlock_t *rwlock,
-const pthread_rwlockattr_t \fI*attr\fR);
-int pthread_rwlock_destroy(pthread_rwlock_t \fI*rwlock\fR);
-pthread_rwlock_t \fIrwlock\fR=PTHREAD_RWLOCK_INITIALIZER;
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_rwlock_init()\fI\fR
-function initialises the read-write lock referenced by \fIrwlock\fR with
-the attributes referenced by \fIattr\fR.  If \fIattr\fR is \s-1NULL\s0, the
-default
-read-write lock attributes are used; the effect is the same as
-passing the address of a default read-write lock attributes object.
-Once initialised, the lock can be used any
-number of times without being re-initialised.
-Upon successful initialisation, the state of the read-write lock
-becomes initialised and unlocked.
-Results are undefined if
-\&\fI\fIpthread_rwlock_init()\fI\fR
-is called specifying an already initialised read-write lock.
-Results are undefined if a read-write lock is used without first being
-initialised.
-.PP
-If the
-\&\fI\fIpthread_rwlock_init()\fI\fR
-function fails, \fIrwlock\fR is not initialised and the contents of
-\&\fIrwlock\fR are undefined.
-.PP
-The
-\&\fI\fIpthread_rwlock_destroy()\fI\fR
-function destroys the read-write lock object referenced by \fIrwlock\fR
-and
-releases any resources used by the lock.
-The effect of subsequent use of the lock is undefined until the lock
-is re-initialised by another call to
-\&\fI\fIpthread_rwlock_init()\fI\fR.
-An implementation may cause
-\&\fI\fIpthread_rwlock_destroy()\fI\fR
-to set the object referenced by \fIrwlock\fR to an invalid value.
-Results are undefined if
-\&\fI\fIpthread_rwlock_destroy()\fI\fR
-is called when any thread holds \fIrwlock\fR.
-Attempting to destroy an uninitialised
-read-write lock results in undefined behaviour.
-A destroyed read-write lock object can be re-initialised using
-\&\fI\fIpthread_rwlock_init()\fI\fR;
-the results of otherwise referencing the read-write lock object after it
-has been destroyed are undefined.
-.PP
-In cases where default read-write lock attributes are appropriate, the
-macro \s-1PTHREAD_RWLOCK_INITIALIZER\s0 can be used to initialise read-write locks
-that are statically allocated.
-The effect is equivalent to dynamic initialisation by a call to
-\&\fI\fIpthread_rwlock_init()\fI\fR
-with the parameter \fIattr\fR specified as \s-1NULL\s0, except that no error
-checks are performed.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_rwlock_init()\fI\fR
-and
-\&\fI\fIpthread_rwlock_destroy()\fI\fR
-functions return zero.  Otherwise, an
-error number is returned to indicate the error.
-The [\s-1EBUSY\s0] and [\s-1EINVAL\s0] error checks, if implemented, will
-act as if they were performed immediately at the beginning of processing
-for the function and caused an error return
-prior to modifying the state of the read-write lock specified by
-\&\fIrwlock\fR.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_rwlock_init()\fI\fR
-function will fail if:
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The system lacked the necessary resources (other than memory)
-to initialise another read-write lock.
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the read-write lock.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The caller does not have the privilege to perform the operation.
-.PP
-The
-\&\fI\fIpthread_rwlock_init()\fI\fR
-function may fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The implementation has detected an attempt to re-initialise the
-object referenced by \fIrwlock\fR, a previously initialised but
-not yet destroyed read-write lock.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIattr\fR is invalid.
-.PP
-The
-\&\fI\fIpthread_rwlock_destroy()\fI\fR
-function may fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The implementation has detected an attempt to destroy the
-object referenced by \fIrwlock\fR while it is locked.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIattr\fR is invalid.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-Similar functions are being developed by \s-1IEEE\s0 \s-1PASC\s0.
-In keeping with its objective of ensuring that \s-1CAE\s0
-Specifications are fully aligned with formal standards, The Open Group
-intends to add any new interfaces adopted by an official \s-1IEEE\s0 standard
-in this area.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR,
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR,
-\&\fI\fIpthread_rwlockattr_init()\fI\fR,
-\&\fI\fIpthread_rwlock_unlock()\fI\fR.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_rwlock_init,\fR \fBpthread_rwlock_destroy\fR
-\&\- initialise or destroy a read-write lock object
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_rwlock_init(pthread_rwlock_t *rwlock,
-const pthread_rwlockattr_t \fI*attr\fR);
-int pthread_rwlock_destroy(pthread_rwlock_t \fI*rwlock\fR);
-pthread_rwlock_t \fIrwlock\fR=PTHREAD_RWLOCK_INITIALIZER;
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_rwlock_init()\fI\fR
-function initialises the read-write lock referenced by \fIrwlock\fR with
-the attributes referenced by \fIattr\fR.  If \fIattr\fR is \s-1NULL\s0, the
-default
-read-write lock attributes are used; the effect is the same as
-passing the address of a default read-write lock attributes object.
-Once initialised, the lock can be used any
-number of times without being re-initialised.
-Upon successful initialisation, the state of the read-write lock
-becomes initialised and unlocked.
-Results are undefined if
-\&\fI\fIpthread_rwlock_init()\fI\fR
-is called specifying an already initialised read-write lock.
-Results are undefined if a read-write lock is used without first being
-initialised.
-.PP
-If the
-\&\fI\fIpthread_rwlock_init()\fI\fR
-function fails, \fIrwlock\fR is not initialised and the contents of
-\&\fIrwlock\fR are undefined.
-.PP
-The
-\&\fI\fIpthread_rwlock_destroy()\fI\fR
-function destroys the read-write lock object referenced by \fIrwlock\fR
-and
-releases any resources used by the lock.
-The effect of subsequent use of the lock is undefined until the lock
-is re-initialised by another call to
-\&\fI\fIpthread_rwlock_init()\fI\fR.
-An implementation may cause
-\&\fI\fIpthread_rwlock_destroy()\fI\fR
-to set the object referenced by \fIrwlock\fR to an invalid value.
-Results are undefined if
-\&\fI\fIpthread_rwlock_destroy()\fI\fR
-is called when any thread holds \fIrwlock\fR.
-Attempting to destroy an uninitialised
-read-write lock results in undefined behaviour.
-A destroyed read-write lock object can be re-initialised using
-\&\fI\fIpthread_rwlock_init()\fI\fR;
-the results of otherwise referencing the read-write lock object after it
-has been destroyed are undefined.
-.PP
-In cases where default read-write lock attributes are appropriate, the
-macro \s-1PTHREAD_RWLOCK_INITIALIZER\s0 can be used to initialise read-write locks
-that are statically allocated.
-The effect is equivalent to dynamic initialisation by a call to
-\&\fI\fIpthread_rwlock_init()\fI\fR
-with the parameter \fIattr\fR specified as \s-1NULL\s0, except that no error
-checks are performed.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_rwlock_init()\fI\fR
-and
-\&\fI\fIpthread_rwlock_destroy()\fI\fR
-functions return zero.  Otherwise, an
-error number is returned to indicate the error.
-The [\s-1EBUSY\s0] and [\s-1EINVAL\s0] error checks, if implemented, will
-act as if they were performed immediately at the beginning of processing
-for the function and caused an error return
-prior to modifying the state of the read-write lock specified by
-\&\fIrwlock\fR.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_rwlock_init()\fI\fR
-function will fail if:
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The system lacked the necessary resources (other than memory)
-to initialise another read-write lock.
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the read-write lock.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The caller does not have the privilege to perform the operation.
-.PP
-The
-\&\fI\fIpthread_rwlock_init()\fI\fR
-function may fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The implementation has detected an attempt to re-initialise the
-object referenced by \fIrwlock\fR, a previously initialised but
-not yet destroyed read-write lock.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIattr\fR is invalid.
-.PP
-The
-\&\fI\fIpthread_rwlock_destroy()\fI\fR
-function may fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The implementation has detected an attempt to destroy the
-object referenced by \fIrwlock\fR while it is locked.
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIattr\fR is invalid.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-Similar functions are being developed by \s-1IEEE\s0 \s-1PASC\s0.
-In keeping with its objective of ensuring that \s-1CAE\s0
-Specifications are fully aligned with formal standards, The Open Group
-intends to add any new interfaces adopted by an official \s-1IEEE\s0 standard
-in this area.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR,
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR,
-\&\fI\fIpthread_rwlockattr_init()\fI\fR,
-\&\fI\fIpthread_rwlock_unlock()\fI\fR.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_rwlock_rdlock,\fR \fBpthread_rwlock_tryrdlock\fR
-\&\- lock a read-write lock object for reading
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_rwlock_rdlock(pthread_rwlock_t \fI*rwlock\fR);
-int pthread_rwlock_tryrdlock(pthread_rwlock_t \fI*rwlock\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR
-function applies a read lock to the read-write lock referenced by
-\&\fIrwlock\fR.
-The calling thread acquires the read lock if a writer does not
-hold the lock and there are no writers blocked
-on the lock.  It is unspecified whether the calling thread
-acquires the lock when a writer does not hold the lock
-and there are writers waiting for the lock.  If a writer holds
-the lock, the calling thread will not acquire the
-read lock.  If the read lock is not acquired, the calling
-thread blocks (that is, it does not return from the
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR
-call) until it can acquire the lock.
-Results are undefined if the calling thread holds
-a write lock on \fIrwlock\fR
-at the time the call is made.
-.PP
-Implementations are allowed to favour writers over readers
-to avoid writer starvation.
-.PP
-A thread may hold multiple concurrent read locks on \fIrwlock\fR
-(that is, successfully call the
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR
-function \fIn\fR times). If so, the thread
-must perform matching unlocks (that is, it must
-call the
-\&\fI\fIpthread_rwlock_unlock()\fI\fR
-function \fIn\fR times).
-.PP
-The function
-\&\fI\fIpthread_rwlock_tryrdlock()\fI\fR
-applies a read lock
-as in the
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR
-function
-with the exception that the function fails if any thread holds a
-write lock on \fIrwlock\fR or there are writers blocked
-on \fIrwlock\fR.
-.PP
-Results are undefined if any of these functions are called with
-an uninitialised read-write lock.
-.PP
-If a signal is delivered to a thread waiting for a read-write
-lock for reading, upon return from the signal handler
-the thread resumes waiting for the read-write lock for
-reading as if it was not interrupted.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR
-function returns zero.
-Otherwise, an error number is returned
-to indicate the error.
-.PP
-The function
-\&\fI\fIpthread_rwlock_tryrdlock()\fI\fR
-returns zero if the
-lock for reading on the read-write lock object
-referenced by \fIrwlock\fR is acquired.
-Otherwise an error number
-is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_rwlock_tryrdlock()\fI\fR
-function will fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The read-write lock could not be acquired for reading because a
-writer holds the
-lock or was blocked on it.
-.PP
-The
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR
-and
-\&\fI\fIpthread_rwlock_tryrdlock()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIrwlock\fR does not refer to an initialised
-read-write lock object.
-.Ip "[\s-1EDEADLK\s0]" 4
-.IX Item "[EDEADLK]"
-The current thread already owns the read-write lock for writing.
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The read lock could not be acquired because the maximum number of
-read locks
-for \fIrwlock\fR has been exceeded.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-Similar functions are being developed by \s-1IEEE\s0 \s-1PASC\s0.
-In keeping with its objective of ensuring that \s-1CAE\s0
-Specifications are fully aligned with formal standards, The Open Group
-intends to add any new interfaces adopted by an official \s-1IEEE\s0 standard
-in this area.
-.PP
-Realtime applications may encounter priority inversion when using
-read-write locks.
-The problem occurs when a high priority thread &quot;locks&quot; a read-write
-lock that is about to be &quot;unlocked&quot; by a low priority thread, but
-the low priority thread is preempted by a medium priority thread.
-This scenario leads to priority inversion; a high priority thread is
-blocked by lower priority threads for an unlimited period of time.
-During system design, realtime programmers must take into account the
-possibility of this kind of priority inversion.
-They can deal with it in a number of ways, such as by having critical
-sections that are guarded by read-write locks execute at a high
-priority, so that a thread cannot be preempted while executing in its
-critical section.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_rwlock_init()\fI\fR,
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR,
-\&\fI\fIpthread_rwlockattr_init()\fI\fR,
-\&\fI\fIpthread_rwlock_unlock()\fI\fR.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_rwlock_rdlock,\fR \fBpthread_rwlock_tryrdlock\fR
-\&\- lock a read-write lock object for reading
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_rwlock_rdlock(pthread_rwlock_t \fI*rwlock\fR);
-int pthread_rwlock_tryrdlock(pthread_rwlock_t \fI*rwlock\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR
-function applies a read lock to the read-write lock referenced by
-\&\fIrwlock\fR.
-The calling thread acquires the read lock if a writer does not
-hold the lock and there are no writers blocked
-on the lock.  It is unspecified whether the calling thread
-acquires the lock when a writer does not hold the lock
-and there are writers waiting for the lock.  If a writer holds
-the lock, the calling thread will not acquire the
-read lock.  If the read lock is not acquired, the calling
-thread blocks (that is, it does not return from the
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR
-call) until it can acquire the lock.
-Results are undefined if the calling thread holds
-a write lock on \fIrwlock\fR
-at the time the call is made.
-.PP
-Implementations are allowed to favour writers over readers
-to avoid writer starvation.
-.PP
-A thread may hold multiple concurrent read locks on \fIrwlock\fR
-(that is, successfully call the
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR
-function \fIn\fR times). If so, the thread
-must perform matching unlocks (that is, it must
-call the
-\&\fI\fIpthread_rwlock_unlock()\fI\fR
-function \fIn\fR times).
-.PP
-The function
-\&\fI\fIpthread_rwlock_tryrdlock()\fI\fR
-applies a read lock
-as in the
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR
-function
-with the exception that the function fails if any thread holds a
-write lock on \fIrwlock\fR or there are writers blocked
-on \fIrwlock\fR.
-.PP
-Results are undefined if any of these functions are called with
-an uninitialised read-write lock.
-.PP
-If a signal is delivered to a thread waiting for a read-write
-lock for reading, upon return from the signal handler
-the thread resumes waiting for the read-write lock for
-reading as if it was not interrupted.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR
-function returns zero.
-Otherwise, an error number is returned
-to indicate the error.
-.PP
-The function
-\&\fI\fIpthread_rwlock_tryrdlock()\fI\fR
-returns zero if the
-lock for reading on the read-write lock object
-referenced by \fIrwlock\fR is acquired.
-Otherwise an error number
-is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_rwlock_tryrdlock()\fI\fR
-function will fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The read-write lock could not be acquired for reading because a
-writer holds the
-lock or was blocked on it.
-.PP
-The
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR
-and
-\&\fI\fIpthread_rwlock_tryrdlock()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIrwlock\fR does not refer to an initialised
-read-write lock object.
-.Ip "[\s-1EDEADLK\s0]" 4
-.IX Item "[EDEADLK]"
-The current thread already owns the read-write lock for writing.
-.Ip "[\s-1EAGAIN\s0]" 4
-.IX Item "[EAGAIN]"
-The read lock could not be acquired because the maximum number of
-read locks
-for \fIrwlock\fR has been exceeded.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-Similar functions are being developed by \s-1IEEE\s0 \s-1PASC\s0.
-In keeping with its objective of ensuring that \s-1CAE\s0
-Specifications are fully aligned with formal standards, The Open Group
-intends to add any new interfaces adopted by an official \s-1IEEE\s0 standard
-in this area.
-.PP
-Realtime applications may encounter priority inversion when using
-read-write locks.
-The problem occurs when a high priority thread &quot;locks&quot; a read-write
-lock that is about to be &quot;unlocked&quot; by a low priority thread, but
-the low priority thread is preempted by a medium priority thread.
-This scenario leads to priority inversion; a high priority thread is
-blocked by lower priority threads for an unlimited period of time.
-During system design, realtime programmers must take into account the
-possibility of this kind of priority inversion.
-They can deal with it in a number of ways, such as by having critical
-sections that are guarded by read-write locks execute at a high
-priority, so that a thread cannot be preempted while executing in its
-critical section.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_rwlock_init()\fI\fR,
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR,
-\&\fI\fIpthread_rwlockattr_init()\fI\fR,
-\&\fI\fIpthread_rwlock_unlock()\fI\fR.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_rwlock_wrlock,\fR \fBpthread_rwlock_trywrlock\fR
-\&\- lock a read-write lock object for writing
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_rwlock_wrlock(pthread_rwlock_t \fI*rwlock\fR);
-int pthread_rwlock_trywrlock(pthread_rwlock_t \fI*rwlock\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR
-function applies a write lock to
-the read-write lock referenced by \fIrwlock\fR. The
-calling thread acquires the write lock if no other thread
-(reader or writer) holds the read-write lock \fIrwlock\fR.
-Otherwise, the thread blocks (that is, does not return from the
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR
-call) until it can
-acquire the lock. Results are undefined if the calling thread
-holds the read-write lock (whether a read or write
-lock) at the time the call is made.
-.PP
-Implementations are allowed to favour writers over
-readers to avoid writer starvation.
-.PP
-The function
-\&\fI\fIpthread_rwlock_trywrlock()\fI\fR
-applies a write lock
-like the
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR
-function, with the exception that the function fails if any
-thread currently holds \fIrwlock\fR (for reading or writing).
-.PP
-Results are undefined if any of these functions are called with
-an uninitialised read-write lock.
-.PP
-If a signal is delivered to a thread waiting for a read-write
-lock for writing, upon return from the signal handler
-the thread resumes waiting for the read-write lock for
-writing as if it was not interrupted.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR
-function returns zero.
-Otherwise, an error number is returned
-to indicate the error.
-.PP
-The function
-\&\fI\fIpthread_rwlock_trywrlock()\fI\fR
-returns zero if the
-lock for writing on the read-write lock object
-referenced by \fIrwlock\fR is acquired.
-Otherwise an error number is
-returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_rwlock_trywrlock()\fI\fR
-function will fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The read-write lock could not be acquired for writing because it
-was already locked for reading or writing.
-.PP
-The
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR
-and
-\&\fI\fIpthread_rwlock_trywrlock()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIrwlock\fR does not refer to an initialised
-read-write lock object.
-.Ip "[\s-1EDEADLK\s0]" 4
-.IX Item "[EDEADLK]"
-The current thread already owns the read-write lock for writing or
-reading.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-Similar functions are being developed by \s-1IEEE\s0 \s-1PASC\s0.
-In keeping with its objective of ensuring that \s-1CAE\s0
-Specifications are fully aligned with formal standards, The Open Group
-intends to add any new interfaces adopted by an official \s-1IEEE\s0 standard
-in this area.
-.PP
-Realtime applications may encounter priority inversion when using
-read-write locks.
-The problem occurs when a high priority thread &quot;locks&quot; a read-write
-lock that is about to be &quot;unlocked&quot; by a low priority thread, but
-the low priority thread is preempted by a medium priority thread.
-This scenario leads to priority inversion; a high priority thread is
-blocked by lower priority threads for an unlimited period of time.
-During system design, realtime programmers must take into account the
-possibility of this kind of priority inversion.
-They can deal with it in a number of ways, such as by having critical
-sections that are guarded by read-write locks execute at a high
-priority, so that a thread cannot be preempted while executing in its
-critical section.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_rwlock_init()\fI\fR,
-\&\fI\fIpthread_rwlock_unlock()\fI\fR,
-\&\fI\fIpthread_rwlockattr_init()\fI\fR,
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_rwlock_unlock\fR \- unlock a read-write lock object
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_rwlock_unlock(pthread_rwlock_t \fI*rwlock\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_rwlock_unlock()\fI\fR
-function is called to release a lock held on the read-write lock
-object referenced by \fIrwlock\fR.
-Results are undefined if the read-write lock \fIrwlock\fR is not
-held by the calling thread.
-.PP
-If this function is called to release a read lock from the
-read-write lock object and there are other read locks
-currently held on this read-write lock object, the read-write
-lock object remains in the read locked state.
-If this function releases the calling thread's last read lock on this
-read-write lock object, then the calling thread is no longer one of
-the owners of the object.
-If this function releases the last read lock for this read-write lock
-object, the read-write lock object will be put in the unlocked state
-with no owners.
-.PP
-If this function is called to release a write lock for this
-read-write lock object, the read-write lock object will
-be put in the unlocked state with no owners.
-.PP
-If the call to the
-\&\fI\fIpthread_rwlock_unlock()\fI\fR
-function results in
-the read-write lock object becoming unlocked
-and there are multiple threads waiting to acquire the read-write
-lock object for writing, the scheduling policy
-is used to determine which thread acquires the read-write
-lock object for writing. If there are multiple
-threads waiting to acquire the read-write lock object for reading,
-the scheduling policy is used to determine
-the order in which the waiting threads acquire the
-read-write lock object for reading.
-If there are multiple threads blocked on \fIrwlock\fR
-for both read locks and write locks, it is
-unspecified whether the readers acquire the lock first or whether
-a writer acquires the lock first.
-.PP
-Results are undefined if any of these functions are called with
-an uninitialised read-write lock.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_rwlock_unlock()\fI\fR
-function returns zero.
-Otherwise, an error number is returned
-to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_rwlock_unlock()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIrwlock\fR does not refer to an initialised
-read-write lock object.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The current thread does not own the read-write lock.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-Similar functions are being developed by \s-1IEEE\s0 \s-1PASC\s0.
-In keeping with its objective of ensuring that \s-1CAE\s0
-Specifications are fully aligned with formal standards, The Open Group
-intends to add any new interfaces adopted by an official \s-1IEEE\s0 standard
-in this area.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_rwlock_init()\fI\fR,
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR,
-\&\fI\fIpthread_rwlockattr_init()\fI\fR,
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_rwlock_wrlock,\fR \fBpthread_rwlock_trywrlock\fR
-\&\- lock a read-write lock object for writing
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_rwlock_wrlock(pthread_rwlock_t \fI*rwlock\fR);
-int pthread_rwlock_trywrlock(pthread_rwlock_t \fI*rwlock\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR
-function applies a write lock to
-the read-write lock referenced by \fIrwlock\fR. The
-calling thread acquires the write lock if no other thread
-(reader or writer) holds the read-write lock \fIrwlock\fR.
-Otherwise, the thread blocks (that is, does not return from the
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR
-call) until it can
-acquire the lock. Results are undefined if the calling thread
-holds the read-write lock (whether a read or write
-lock) at the time the call is made.
-.PP
-Implementations are allowed to favour writers over
-readers to avoid writer starvation.
-.PP
-The function
-\&\fI\fIpthread_rwlock_trywrlock()\fI\fR
-applies a write lock
-like the
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR
-function, with the exception that the function fails if any
-thread currently holds \fIrwlock\fR (for reading or writing).
-.PP
-Results are undefined if any of these functions are called with
-an uninitialised read-write lock.
-.PP
-If a signal is delivered to a thread waiting for a read-write
-lock for writing, upon return from the signal handler
-the thread resumes waiting for the read-write lock for
-writing as if it was not interrupted.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR
-function returns zero.
-Otherwise, an error number is returned
-to indicate the error.
-.PP
-The function
-\&\fI\fIpthread_rwlock_trywrlock()\fI\fR
-returns zero if the
-lock for writing on the read-write lock object
-referenced by \fIrwlock\fR is acquired.
-Otherwise an error number is
-returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_rwlock_trywrlock()\fI\fR
-function will fail if:
-.Ip "[\s-1EBUSY\s0]" 4
-.IX Item "[EBUSY]"
-The read-write lock could not be acquired for writing because it
-was already locked for reading or writing.
-.PP
-The
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR
-and
-\&\fI\fIpthread_rwlock_trywrlock()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIrwlock\fR does not refer to an initialised
-read-write lock object.
-.Ip "[\s-1EDEADLK\s0]" 4
-.IX Item "[EDEADLK]"
-The current thread already owns the read-write lock for writing or
-reading.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-Similar functions are being developed by \s-1IEEE\s0 \s-1PASC\s0.
-In keeping with its objective of ensuring that \s-1CAE\s0
-Specifications are fully aligned with formal standards, The Open Group
-intends to add any new interfaces adopted by an official \s-1IEEE\s0 standard
-in this area.
-.PP
-Realtime applications may encounter priority inversion when using
-read-write locks.
-The problem occurs when a high priority thread &quot;locks&quot; a read-write
-lock that is about to be &quot;unlocked&quot; by a low priority thread, but
-the low priority thread is preempted by a medium priority thread.
-This scenario leads to priority inversion; a high priority thread is
-blocked by lower priority threads for an unlimited period of time.
-During system design, realtime programmers must take into account the
-possibility of this kind of priority inversion.
-They can deal with it in a number of ways, such as by having critical
-sections that are guarded by read-write locks execute at a high
-priority, so that a thread cannot be preempted while executing in its
-critical section.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_rwlock_init()\fI\fR,
-\&\fI\fIpthread_rwlock_unlock()\fI\fR,
-\&\fI\fIpthread_rwlockattr_init()\fI\fR,
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_rwlockattr_init,\fR \fBpthread_rwlockattr_destroy\fR
-\&\- initialise and destroy read-write lock attributes object
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_rwlockattr_init(pthread_rwlockattr_t \fI*attr\fR);
-int pthread_rwlockattr_destroy(pthread_rwlockattr_t \fI*attr\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The function
-\&\fI\fIpthread_rwlockattr_init()\fI\fR
-initialises a read-write
-lock attributes object \fIattr\fR with the default
-value for all of the attributes defined by the implementation.
-.PP
-Results are undefined if
-\&\fI\fIpthread_rwlockattr_init()\fI\fR
-is called
-specifying an already initialised read-write lock
-attributes object.
-.PP
-After a read-write lock attributes object has been used to
-initialise one or more read-write locks, any function
-affecting the attributes object (including destruction) does not
-affect any previously initialised read-write locks.
-.PP
-The
-\&\fI\fIpthread_rwlockattr_destroy()\fI\fR
-function destroys a read-write
-lock attributes object. The effect of
-subsequent use of the object is undefined until the object is
-re-initialised by another call to
-\&\fI\fIpthread_rwlockattr_init()\fI\fR.
-An implementation may cause
-\&\fI\fIpthread_rwlockattr_destroy()\fI\fR
-to set the object
-referenced by attr to an invalid value.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_rwlockattr_init()\fI\fR
-and
-\&\fI\fIpthread_rwlockattr_destroy()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to
-indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_rwlockattr_init()\fI\fR
-function will fail if:
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the read-write
-lock attributes object.
-.PP
-The
-\&\fI\fIpthread_rwlockattr_destroy()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIattr\fR is invalid.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-Similar functions are being developed by \s-1IEEE\s0 \s-1PASC\s0.
-In keeping with its objective of ensuring that \s-1CAE\s0
-Specifications are fully aligned with formal standards, The Open Group
-intends to add any new interfaces adopted by an official \s-1IEEE\s0 standard
-in this area.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_rwlock_init()\fI\fR,
-\&\fI\fIpthread_rwlock_unlock()\fI\fR,
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR,
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR,
-\&\fI\fIpthread_rwlockattr_getpshared()\fI\fR.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_rwlockattr_getpshared,\fR \fBpthread_rwlockattr_setpshared\fR
-\&\- get and set process-shared attribute of read-write lock
-attributes object
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_rwlockattr_getpshared(const pthread_rwlockattr_t \fI*attr\fR,
-int \fI*pshared\fR);
-int pthread_rwlockattr_setpshared(pthread_rwlockattr_t \fI*attr\fR,
-int \fIpshared\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fIprocess-shared\fR
-attribute is set to \s-1PTHREAD_PROCESS_SHARED\s0 to
-permit a read-write lock to be operated upon by any thread that
-has access to the memory where the read-write lock is allocated,
-even if the read-write lock is allocated
-in memory that is shared by multiple processes.
-If the
-\&\fIprocess-shared\fR
-attribute is \s-1PTHREAD_PROCESS_PRIVATE\s0, the
-read-write lock will only be
-operated upon by threads created within the same process as the
-thread that initialised the read-write lock; if
-threads of differing processes attempt to operate on such a
-read-write lock, the behaviour is undefined. The
-default value of the
-\&\fIprocess-shared\fR
-attribute is \s-1PTHREAD_PROCESS_PRIVATE\s0.
-.PP
-The
-\&\fI\fIpthread_rwlockattr_getpshared()\fI\fR
-function obtains the value of the
-\&\fIprocess-shared\fR
-attribute from the initialised attributes object referenced by \fIattr\fR.
-The
-\&\fI\fIpthread_rwlockattr_setpshared()\fI\fR
-function is used to set the
-\&\fIprocess-shared\fR
-attribute in an initialised attributes object referenced by attr.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_rwlockattr_setpshared()\fI\fR
-function returns zero.
-Otherwise, an error number is returned to indicate the error.
-.PP
-Upon successful completion, the
-\&\fI\fIpthread_rwlockattr_getpshared()\fI\fR
-returns zero and stores the value of the
-\&\fIprocess-shared\fR
-attribute of \fIattr\fR into the object referenced by the
-\&\fIpshared\fR parameter. Otherwise an error number is
-returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_rwlockattr_getpshared()\fI\fR
-and
-\&\fI\fIpthread_rwlockattr_setpshared()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIattr\fR is invalid.
-.PP
-The
-\&\fI\fIpthread_rwlockattr_setpshared()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The new value specified for the attribute is outside the range
-of legal values for
-that attribute.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-Similar functions are being developed by \s-1IEEE\s0 \s-1PASC\s0.
-In keeping with its objective of ensuring that \s-1CAE\s0
-Specifications are fully aligned with formal standards, The Open Group
-intends to add any new interfaces adopted by an official \s-1IEEE\s0 standard
-in this area.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_rwlock_init()\fI\fR,
-\&\fI\fIpthread_rwlock_unlock()\fI\fR,
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR,
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR,
-\&\fI\fIpthread_rwlockattr_init()\fI\fR.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_rwlockattr_init,\fR \fBpthread_rwlockattr_destroy\fR
-\&\- initialise and destroy read-write lock attributes object
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_rwlockattr_init(pthread_rwlockattr_t \fI*attr\fR);
-int pthread_rwlockattr_destroy(pthread_rwlockattr_t \fI*attr\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The function
-\&\fI\fIpthread_rwlockattr_init()\fI\fR
-initialises a read-write
-lock attributes object \fIattr\fR with the default
-value for all of the attributes defined by the implementation.
-.PP
-Results are undefined if
-\&\fI\fIpthread_rwlockattr_init()\fI\fR
-is called
-specifying an already initialised read-write lock
-attributes object.
-.PP
-After a read-write lock attributes object has been used to
-initialise one or more read-write locks, any function
-affecting the attributes object (including destruction) does not
-affect any previously initialised read-write locks.
-.PP
-The
-\&\fI\fIpthread_rwlockattr_destroy()\fI\fR
-function destroys a read-write
-lock attributes object. The effect of
-subsequent use of the object is undefined until the object is
-re-initialised by another call to
-\&\fI\fIpthread_rwlockattr_init()\fI\fR.
-An implementation may cause
-\&\fI\fIpthread_rwlockattr_destroy()\fI\fR
-to set the object
-referenced by attr to an invalid value.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_rwlockattr_init()\fI\fR
-and
-\&\fI\fIpthread_rwlockattr_destroy()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to
-indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_rwlockattr_init()\fI\fR
-function will fail if:
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to initialise the read-write
-lock attributes object.
-.PP
-The
-\&\fI\fIpthread_rwlockattr_destroy()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIattr\fR is invalid.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-Similar functions are being developed by \s-1IEEE\s0 \s-1PASC\s0.
-In keeping with its objective of ensuring that \s-1CAE\s0
-Specifications are fully aligned with formal standards, The Open Group
-intends to add any new interfaces adopted by an official \s-1IEEE\s0 standard
-in this area.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_rwlock_init()\fI\fR,
-\&\fI\fIpthread_rwlock_unlock()\fI\fR,
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR,
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR,
-\&\fI\fIpthread_rwlockattr_getpshared()\fI\fR.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_rwlockattr_getpshared,\fR \fBpthread_rwlockattr_setpshared\fR
-\&\- get and set process-shared attribute of read-write lock
-attributes object
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_rwlockattr_getpshared(const pthread_rwlockattr_t \fI*attr\fR,
-int \fI*pshared\fR);
-int pthread_rwlockattr_setpshared(pthread_rwlockattr_t \fI*attr\fR,
-int \fIpshared\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fIprocess-shared\fR
-attribute is set to \s-1PTHREAD_PROCESS_SHARED\s0 to
-permit a read-write lock to be operated upon by any thread that
-has access to the memory where the read-write lock is allocated,
-even if the read-write lock is allocated
-in memory that is shared by multiple processes.
-If the
-\&\fIprocess-shared\fR
-attribute is \s-1PTHREAD_PROCESS_PRIVATE\s0, the
-read-write lock will only be
-operated upon by threads created within the same process as the
-thread that initialised the read-write lock; if
-threads of differing processes attempt to operate on such a
-read-write lock, the behaviour is undefined. The
-default value of the
-\&\fIprocess-shared\fR
-attribute is \s-1PTHREAD_PROCESS_PRIVATE\s0.
-.PP
-The
-\&\fI\fIpthread_rwlockattr_getpshared()\fI\fR
-function obtains the value of the
-\&\fIprocess-shared\fR
-attribute from the initialised attributes object referenced by \fIattr\fR.
-The
-\&\fI\fIpthread_rwlockattr_setpshared()\fI\fR
-function is used to set the
-\&\fIprocess-shared\fR
-attribute in an initialised attributes object referenced by attr.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_rwlockattr_setpshared()\fI\fR
-function returns zero.
-Otherwise, an error number is returned to indicate the error.
-.PP
-Upon successful completion, the
-\&\fI\fIpthread_rwlockattr_getpshared()\fI\fR
-returns zero and stores the value of the
-\&\fIprocess-shared\fR
-attribute of \fIattr\fR into the object referenced by the
-\&\fIpshared\fR parameter. Otherwise an error number is
-returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_rwlockattr_getpshared()\fI\fR
-and
-\&\fI\fIpthread_rwlockattr_setpshared()\fI\fR
-functions may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by \fIattr\fR is invalid.
-.PP
-The
-\&\fI\fIpthread_rwlockattr_setpshared()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The new value specified for the attribute is outside the range
-of legal values for
-that attribute.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-Similar functions are being developed by \s-1IEEE\s0 \s-1PASC\s0.
-In keeping with its objective of ensuring that \s-1CAE\s0
-Specifications are fully aligned with formal standards, The Open Group
-intends to add any new interfaces adopted by an official \s-1IEEE\s0 standard
-in this area.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI<pthread.h\fR>,
-\&\fI\fIpthread_rwlock_init()\fI\fR,
-\&\fI\fIpthread_rwlock_unlock()\fI\fR,
-\&\fI\fIpthread_rwlock_wrlock()\fI\fR,
-\&\fI\fIpthread_rwlock_rdlock()\fI\fR,
-\&\fI\fIpthread_rwlockattr_init()\fI\fR.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_self\fR \- get calling thread's \s-1ID\s0
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-pthread_t pthread_self(void);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_self()\fI\fR
-function returns the thread \s-1ID\s0 of the calling thread.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-See \s-1DESCRIPTION\s0 above.
-.SH "ERRORS"
-.IX Header "ERRORS"
-No errors are defined.
-.PP
-The
-\&\fI\fIpthread_self()\fI\fR
-function will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_create()\fI\fR,
-\&\fI\fIpthread_equal()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_setcancelstate,\fR \fBpthread_setcanceltype,\fR \fBpthread_testcancel\fR
-\&\- set cancelability state
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_setcancelstate(int \fIstate\fR, int *\fIoldstate\fR);
-int pthread_setcanceltype(int \fItype\fR, int *\fIoldtype\fR);
-void pthread_testcancel(void);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_setcancelstate()\fI\fR
-function atomically both sets the calling thread's cancelability
-state to the indicated
-\&\fIstate\fR
-and returns the previous cancelability state
-at the location referenced by \fIoldstate\fR.
-Legal values for
-\&\fIstate\fR
-are \s-1PTHREAD_CANCEL_ENABLE\s0 and \s-1PTHREAD_CANCEL_DISABLE\s0.
-.PP
-The
-\&\fI\fIpthread_setcanceltype()\fI\fR
-function atomically both sets the calling thread's cancelability
-type to the indicated
-\&\fItype\fR
-and returns the previous cancelability type
-at the location referenced by \fIoldtype\fR.
-Legal values for
-\&\fItype\fR
-are \s-1PTHREAD_CANCEL_DEFERRED\s0 and \s-1PTHREAD_CANCEL_ASYNCHRONOUS\s0.
-.PP
-The cancelability state and type of any newly
-created threads, including the thread in which
-\&\fI\fImain()\fI\fR
-was first invoked,
-are \s-1PTHREAD_CANCEL_ENABLE\s0 and \s-1PTHREAD_CANCEL_DEFERRED\s0
-respectively.
-.PP
-The
-\&\fI\fIpthread_testcancel()\fI\fR
-function creates a cancellation point in the calling thread.
-The
-\&\fI\fIpthread_testcancel()\fI\fR
-function has no effect if cancelability is disabled.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_setcancelstate()\fI\fR
-and
-\&\fI\fIpthread_setcanceltype()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_setcancelstate()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The specified state is not
-\&\s-1PTHREAD_CANCEL_ENABLE\s0 or \s-1PTHREAD_CANCEL_DISABLE\s0.
-.PP
-The
-\&\fI\fIpthread_setcanceltype()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The specified type is not \s-1PTHREAD_CANCEL_DEFERRED\s0
-or \s-1PTHREAD_CANCEL_ASYNCHRONOUS\s0.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_cancel()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_setcancelstate,\fR \fBpthread_setcanceltype,\fR \fBpthread_testcancel\fR
-\&\- set cancelability state
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_setcancelstate(int \fIstate\fR, int *\fIoldstate\fR);
-int pthread_setcanceltype(int \fItype\fR, int *\fIoldtype\fR);
-void pthread_testcancel(void);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_setcancelstate()\fI\fR
-function atomically both sets the calling thread's cancelability
-state to the indicated
-\&\fIstate\fR
-and returns the previous cancelability state
-at the location referenced by \fIoldstate\fR.
-Legal values for
-\&\fIstate\fR
-are \s-1PTHREAD_CANCEL_ENABLE\s0 and \s-1PTHREAD_CANCEL_DISABLE\s0.
-.PP
-The
-\&\fI\fIpthread_setcanceltype()\fI\fR
-function atomically both sets the calling thread's cancelability
-type to the indicated
-\&\fItype\fR
-and returns the previous cancelability type
-at the location referenced by \fIoldtype\fR.
-Legal values for
-\&\fItype\fR
-are \s-1PTHREAD_CANCEL_DEFERRED\s0 and \s-1PTHREAD_CANCEL_ASYNCHRONOUS\s0.
-.PP
-The cancelability state and type of any newly
-created threads, including the thread in which
-\&\fI\fImain()\fI\fR
-was first invoked,
-are \s-1PTHREAD_CANCEL_ENABLE\s0 and \s-1PTHREAD_CANCEL_DEFERRED\s0
-respectively.
-.PP
-The
-\&\fI\fIpthread_testcancel()\fI\fR
-function creates a cancellation point in the calling thread.
-The
-\&\fI\fIpthread_testcancel()\fI\fR
-function has no effect if cancelability is disabled.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_setcancelstate()\fI\fR
-and
-\&\fI\fIpthread_setcanceltype()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_setcancelstate()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The specified state is not
-\&\s-1PTHREAD_CANCEL_ENABLE\s0 or \s-1PTHREAD_CANCEL_DISABLE\s0.
-.PP
-The
-\&\fI\fIpthread_setcanceltype()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The specified type is not \s-1PTHREAD_CANCEL_DEFERRED\s0
-or \s-1PTHREAD_CANCEL_ASYNCHRONOUS\s0.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_cancel()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_setconcurrency\fR \- get or set level of concurrency
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_setconcurrency(int \fInew_level\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-Refer to
-\&\fI\fIpthread_getconcurrency()\fI\fR.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_getschedparam,\fR \fBpthread_setschedparam\fR
-\&\- dynamic thread scheduling parameters access
-(\fB\s-1REALTIME\s0 \s-1THREADS\s0\fR)
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_getschedparam(pthread_t \fIthread\fR, int *\fIpolicy\fR,
-struct sched_param *\fIparam\fR);
-int pthread_setschedparam(pthread_t \fIthread\fR, int \fIpolicy\fR,
-const struct sched_param *\fIparam\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_getschedparam()\fI\fR
-and
-\&\fI\fIpthread_setschedparam()\fI\fR
-allow the scheduling policy and scheduling parameters of individual threads
-within a multi-threaded process to be retrieved and set.
-For \s-1SCHED_FIFO\s0 and \s-1SCHED_RR\s0,
-the only required member of the
-\&\fBsched_param\fR
-structure is the priority
-\&\fIsched_priority\fR.
-For \s-1SCHED_OTHER\s0,
-the affected scheduling parameters are implementation-dependent.
-.PP
-The
-\&\fI\fIpthread_getschedparam()\fI\fR
-function retrieves the scheduling policy and scheduling parameters
-for the thread whose thread \s-1ID\s0 is given by
-\&\fIthread\fR
-and stores those values in
-\&\fIpolicy\fR
-and
-\&\fIparam\fR,
-respectively.
-The priority value returned from
-\&\fI\fIpthread_getschedparam()\fI\fR
-is the value specified by the most recent
-\&\fI\fIpthread_setschedparam()\fI\fR
-or
-\&\fI\fIpthread_create()\fI\fR
-call affecting the target thread,
-and reflects any temporary adjustments to its priority
-as a result of any priority inheritance or ceiling functions.
-The
-\&\fI\fIpthread_setschedparam()\fI\fR
-function sets the scheduling policy
-and associated scheduling parameters for the thread whose
-thread \s-1ID\s0 is given by
-\&\fIthread\fR
-to the policy and associated parameters provided in
-\&\fIpolicy\fR
-and
-\&\fIparam\fR,
-respectively.
-.PP
-The
-\&\fIpolicy\fR
-parameter may have the value \s-1SCHED_OTHER\s0,
-that has implementation-dependent scheduling parameters,
-\&\s-1SCHED_FIFO\s0 or \s-1SCHED_RR\s0,
-that have the single scheduling parameter,
-\&\fIpriority.\fR
-.PP
-If the
-\&\fI\fIpthread_setschedparam()\fI\fR
-function fails, no scheduling parameters will be changed
-for the target thread.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_getschedparam()\fI\fR
-and
-\&\fI\fIpthread_setschedparam()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_getschedparam()\fI\fR
-and
-\&\fI\fIpthread_setschedparam()\fI\fR
-functions will fail if:
-.Ip "[\s-1ENOSYS\s0]" 4
-.IX Item "[ENOSYS]"
-The option _POSIX_THREAD_PRIORITY_SCHEDULING is not defined and the
-implementation does not support the function.
-.PP
-The
-\&\fI\fIpthread_getschedparam()\fI\fR
-function may fail if:
-.Ip "[\s-1ESRCH\s0]" 4
-.IX Item "[ESRCH]"
-The value specified by
-\&\fIthread\fR
-does not refer to a existing thread.
-.PP
-The
-\&\fI\fIpthread_setschedparam()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The value specified by
-\&\fIpolicy\fR
-or one of the scheduling parameters associated with
-the scheduling policy
-\&\fIpolicy\fR
-is invalid.
-.Ip "[\s-1ENOTSUP\s0]" 4
-.IX Item "[ENOTSUP]"
-An attempt was made to set the policy or scheduling parameters to
-an unsupported value.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The caller does not have the appropriate permission to set
-either the scheduling parameters or the scheduling policy of the
-specified thread.
-.Ip "[\s-1EPERM\s0]" 4
-.IX Item "[EPERM]"
-The implementation does not allow the application to modify
-one of the parameters to the value specified.
-.Ip "[\s-1ESRCH\s0]" 4
-.IX Item "[ESRCH]"
-The value specified by
-\&\fIthread\fR
-does not refer to a existing thread.
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIsched_setparam()\fI\fR,
-\&\fI\fIsched_getparam()\fI\fR,
-\&\fI\fIsched_setscheduler()\fI\fR,
-\&\fI\fIsched_getscheduler()\fI\fR,
-\&\fI<pthread.h\fR>,
-\&\fI<sched.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_setspecific,\fR \fBpthread_getspecific\fR \- thread-specific data management
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_setspecific(pthread_key_t \fIkey\fR, const void *\fIvalue\fR);
-void *pthread_getspecific(pthread_key_t \fIkey\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_setspecific()\fI\fR
-function associates a thread-specific
-\&\fIvalue\fR
-with a
-\&\fIkey\fR
-obtained via a previous call to
-\&\fI\fIpthread_key_create()\fI\fR.
-Different threads may bind different values to the same key.
-These values are typically pointers to blocks of dynamically allocated memory
-that have been reserved for use by the calling thread.
-.PP
-The
-\&\fI\fIpthread_getspecific()\fI\fR
-function returns the value currently bound to the specified
-\&\fIkey\fR
-on behalf of the calling thread.
-.PP
-The effect of calling
-\&\fI\fIpthread_setspecific()\fI\fR
-or
-\&\fI\fIpthread_getspecific()\fI\fR
-with a
-\&\fIkey\fR
-value not obtained from
-\&\fI\fIpthread_key_create()\fI\fR
-or after
-\&\fIkey\fR
-has been deleted with
-\&\fI\fIpthread_key_delete()\fI\fR
-is undefined.
-.PP
-Both
-\&\fI\fIpthread_setspecific()\fI\fR
-and
-\&\fI\fIpthread_getspecific()\fI\fR
-may be called from a thread-specific data destructor function.
-However, calling
-\&\fI\fIpthread_setspecific()\fI\fR
-from a destructor may result in lost storage or infinite loops.
-.PP
-Both functions may be implemented as macros.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-The function
-\&\fI\fIpthread_getspecific()\fI\fR
-returns the thread-specific data value
-associated with the given
-\&\fIkey\fR.
-If no thread-specific data value is associated with
-\&\fIkey\fR,
-then the value \s-1NULL\s0 is returned.
-.PP
-If successful, the
-\&\fI\fIpthread_setspecific()\fI\fR
-function returns zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_setspecific()\fI\fR
-function will fail if:
-.Ip "[\s-1ENOMEM\s0]" 4
-.IX Item "[ENOMEM]"
-Insufficient memory exists to associate the value with the key.
-.PP
-The
-\&\fI\fIpthread_setspecific()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The key value is invalid.
-.PP
-No errors are returned from
-\&\fI\fIpthread_getspecific()\fI\fR.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_key_create()\fI\fR,
-\&\fI<pthread.h\fR>.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_sigmask\fR \- examine and change blocked signals
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <signal.h>
-.PP
-int pthread_sigmask(int \fIhow\fR, const sigset_t *\fIset\fR, sigset_t *\fIoset\fR);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-Refer to
-\&\fI\fIsigprocmask()\fI\fR.
-.SH "_\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|__\|_"
-.IX Header "______________________________________________________________________"
-.SH "NAME"
-\&\fBpthread_setcancelstate,\fR \fBpthread_setcanceltype,\fR \fBpthread_testcancel\fR
-\&\- set cancelability state
-.SH "SYNOPSIS"
-.IX Header "SYNOPSIS"
-#include <pthread.h>
-.PP
-int pthread_setcancelstate(int \fIstate\fR, int *\fIoldstate\fR);
-int pthread_setcanceltype(int \fItype\fR, int *\fIoldtype\fR);
-void pthread_testcancel(void);
-.SH "DESCRIPTION"
-.IX Header "DESCRIPTION"
-The
-\&\fI\fIpthread_setcancelstate()\fI\fR
-function atomically both sets the calling thread's cancelability
-state to the indicated
-\&\fIstate\fR
-and returns the previous cancelability state
-at the location referenced by \fIoldstate\fR.
-Legal values for
-\&\fIstate\fR
-are \s-1PTHREAD_CANCEL_ENABLE\s0 and \s-1PTHREAD_CANCEL_DISABLE\s0.
-.PP
-The
-\&\fI\fIpthread_setcanceltype()\fI\fR
-function atomically both sets the calling thread's cancelability
-type to the indicated
-\&\fItype\fR
-and returns the previous cancelability type
-at the location referenced by \fIoldtype\fR.
-Legal values for
-\&\fItype\fR
-are \s-1PTHREAD_CANCEL_DEFERRED\s0 and \s-1PTHREAD_CANCEL_ASYNCHRONOUS\s0.
-.PP
-The cancelability state and type of any newly
-created threads, including the thread in which
-\&\fI\fImain()\fI\fR
-was first invoked,
-are \s-1PTHREAD_CANCEL_ENABLE\s0 and \s-1PTHREAD_CANCEL_DEFERRED\s0
-respectively.
-.PP
-The
-\&\fI\fIpthread_testcancel()\fI\fR
-function creates a cancellation point in the calling thread.
-The
-\&\fI\fIpthread_testcancel()\fI\fR
-function has no effect if cancelability is disabled.
-.SH "RETURN VALUE"
-.IX Header "RETURN VALUE"
-If successful, the
-\&\fI\fIpthread_setcancelstate()\fI\fR
-and
-\&\fI\fIpthread_setcanceltype()\fI\fR
-functions return zero.
-Otherwise, an error number is returned to indicate the error.
-.SH "ERRORS"
-.IX Header "ERRORS"
-The
-\&\fI\fIpthread_setcancelstate()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The specified state is not
-\&\s-1PTHREAD_CANCEL_ENABLE\s0 or \s-1PTHREAD_CANCEL_DISABLE\s0.
-.PP
-The
-\&\fI\fIpthread_setcanceltype()\fI\fR
-function may fail if:
-.Ip "[\s-1EINVAL\s0]" 4
-.IX Item "[EINVAL]"
-The specified type is not \s-1PTHREAD_CANCEL_DEFERRED\s0
-or \s-1PTHREAD_CANCEL_ASYNCHRONOUS\s0.
-.PP
-These functions will not return an error code of [\s-1EINTR\s0].
-.SH "EXAMPLES"
-.IX Header "EXAMPLES"
-None.
-.SH "APPLICATION USAGE"
-.IX Header "APPLICATION USAGE"
-None.
-.SH "FUTURE DIRECTIONS"
-.IX Header "FUTURE DIRECTIONS"
-None.
-.SH "SEE ALSO"
-.IX Header "SEE ALSO"
-\&\fI\fIpthread_cancel()\fI\fR,
-\&\fI<pthread.h\fR>.
Index: ossp-pkg/pth/shtool
RCS File: /v/ossp/cvs/ossp-pkg/pth/Attic/shtool,v
co -q -kk -p'1.52' '/v/ossp/cvs/ossp-pkg/pth/Attic/shtool,v' | diff -u /dev/null - -L'ossp-pkg/pth/shtool' 2>/dev/null
--- ossp-pkg/pth/shtool
+++ -	2024-05-14 08:38:00.905328214 +0200
@@ -0,0 +1,1548 @@
+#!/bin/sh
+##
+##  GNU shtool -- The GNU Portable Shell Tool
+##  Copyright (c) 1994-2001 Ralf S. Engelschall <rse@engelschall.com>
+##
+##  See http://www.gnu.org/software/shtool/ for more information.
+##  See ftp://ftp.gnu.org/gnu/shtool/ for latest version.
+##
+##  Version:  1.5.4 (14-Jun-2001)
+##  Contents: 7/17 available modules
+##
+
+##
+##  This program is free software; you can redistribute it and/or modify
+##  it under the terms of the GNU General Public License as published by
+##  the Free Software Foundation; either version 2 of the License, or
+##  (at your option) any later version.
+##
+##  This program is distributed in the hope that it will be useful,
+##  but WITHOUT ANY WARRANTY; without even the implied warranty of
+##  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+##  General Public License for more details.
+##
+##  You should have received a copy of the GNU General Public License
+##  along with this program; if not, write to the Free Software
+##  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
+##  USA, or contact Ralf S. Engelschall <rse@engelschall.com>.
+##
+##  NOTICE: Given that you include this file verbatim into your own
+##  source tree, you are justified in saying that it remains separate
+##  from your package, and that this way you are simply just using GNU
+##  shtool. So, in this situation, there is no requirement that your
+##  package itself is licensed under the GNU General Public License in
+##  order to take advantage of GNU shtool.
+##
+
+##
+##  Usage: shtool [<options>] [<cmd-name> [<cmd-options>] [<cmd-args>]]
+##
+##  Available commands:
+##    echo       Print string with optional construct expansion
+##    install    Install a program, script or datafile
+##    mkdir      Make one or more directories
+##    fixperm    Fix file permissions inside a source tree
+##    tarball    Roll distribution tarballs
+##    scpp       Sharing C Pre-Processor
+##    version    Maintain a version information file
+##
+##  Not available commands (because module was not built-in):
+##    mdate      Pretty-print modification time of a file or dir
+##    table      Pretty-print a field-separated list as a table
+##    prop       Display progress with a running propeller
+##    move       Move files with simultaneous substitution
+##    mkln       Make link with calculation of relative paths
+##    mkshadow   Make a shadow tree through symbolic links
+##    guessos    Simple operating system guesser
+##    arx        Extended archive command
+##    slo        Separate linker options by library class
+##    path       Deal with program paths
+##
+
+if [ $# -eq 0 ]; then
+    echo "$0:Error: invalid command line" 1>&2
+    echo "$0:Hint:  run \`$0 -h' for usage" 1>&2
+    exit 1
+fi
+if [ ".$1" = ".-h" -o ".$1" = ".--help" ]; then
+    echo "This is GNU shtool, version 1.5.4 (14-Jun-2001)"
+    echo "Copyright (c) 1994-2001 Ralf S. Engelschall <rse@engelschall.com>"
+    echo "Report bugs to <bug-shtool@gnu.org>"
+    echo ''
+    echo "Usage: shtool [<options>] [<cmd-name> [<cmd-options>] [<cmd-args>]]"
+    echo ''
+    echo 'Available global <options>:'
+    echo '  -v, --version   display shtool version information'
+    echo '  -h, --help      display shtool usage help page (this one)'
+    echo '  -d, --debug     display shell trace information'
+    echo '  -r, --recreate  recreate this shtool script via shtoolize'
+    echo ''
+    echo 'Available <cmd-name> [<cmd-options>] [<cmd-args>]:'
+    echo '  echo     [-n] [-e] [<str> ...]'
+    echo '  install  [-v] [-t] [-c] [-C] [-s] [-m<mode>] [-o<owner>] [-g<group>]'
+    echo '           [-e<sed-cmd>] <file> [<file> ...] <path>'
+    echo '  mkdir    [-t] [-f] [-p] [-m<mode>] <dir> [<dir> ...]'
+    echo '  fixperm  [-v] [-t] <path> [<path> ...]'
+    echo '  tarball  [-t] [-v] [-o<tarball>] [-c<prog>] [-d<dir>] [-u<user>]'
+    echo '           [-g<group>] [-e<pattern>] <path> [<path> ...]'
+    echo '  scpp     [-v] [-p] [-f<filter>] [-o<ofile>] [-t<tfile>] [-M<mark>]'
+    echo '           [-D<dname>] [-C<cname>] <file> [<file> ...]'
+    echo '  version  [-l<lang>] [-n<name>] [-p<prefix>] [-s<version>] [-e]'
+    echo '           [-i<knob>] [-d<type>] <file>'
+    echo ''
+    echo 'Not available <cmd-name> (because module was not built-in):'
+    echo '  mdate    [-n] [-z] [-s] [-d] [-f<str>] [-o<spec>] <path>'
+    echo '  table    [-F<sep>] [-w<width>] [-c<cols>] [-s<strip>] <str><sep><str>...'
+    echo '  prop     [-p<str>]'
+    echo '  move     [-v] [-t] [-e] [-p] <src-file> <dst-file>'
+    echo '  mkln     [-t] [-f] [-s] <src-path> [<src-path> ...] <dst-path>'
+    echo '  mkshadow [-v] [-t] [-a] <src-dir> <dst-dir>'
+    echo '  guessos  '
+    echo '  arx      [-t] [-C<cmd>] <op> <archive> [<file> ...]'
+    echo '  slo      [-p<str>] -- -L<dir> -l<lib> [-L<dir> -l<lib> ...]'
+    echo '  path     [-s] [-r] [-d] [-b] [-m] [-p<path>] <str> [<str> ...]'
+    echo ''
+    exit 0
+fi
+if [ ".$1" = ".-v" -o ".$1" = ."--version" ]; then
+    echo "GNU shtool 1.5.4 (14-Jun-2001)"
+    exit 0
+fi
+if [ ".$1" = ".-r" -o ".$1" = ."--recreate" ]; then
+    shtoolize -oshtool echo install mkdir fixperm tarball scpp version
+    exit 0
+fi
+if [ ".$1" = ".-d" -o ".$1" = ."--debug" ]; then
+    shift
+    set -x
+fi
+name=`echo "$0" | sed -e 's;.*/\([^/]*\)$;\1;' -e 's;-sh$;;' -e 's;\.sh$;;'`
+case "$name" in
+    echo|install|mkdir|fixperm|tarball|scpp|version )
+        #   implicit tool command selection
+        tool="$name"
+        ;;
+    * )
+        #   explicit tool command selection
+        tool="$1"
+        shift
+        ;;
+esac
+arg_spec=""
+opt_spec=""
+gen_tmpfile=no
+
+##
+##  DISPATCH INTO SCRIPT PROLOG
+##
+
+case $tool in
+    echo )
+        str_tool="echo"
+        str_usage="[-n] [-e] [<str> ...]"
+        arg_spec="0+"
+        opt_spec="n.e."
+        opt_n=no
+        opt_e=no
+        ;;
+    install )
+        str_tool="install"
+        str_usage="[-v] [-t] [-c] [-C] [-s] [-m<mode>] [-o<owner>] [-g<group>] [-e<sed-cmd>] <file> [<file> ...] <path>"
+        arg_spec="2+"
+        opt_spec="v.t.c.C.s.m:o:g:e+"
+        opt_v=no
+        opt_t=no
+        opt_c=no
+        opt_C=no
+        opt_s=no
+        opt_m="0755"
+        opt_o=""
+        opt_g=""
+        opt_e=""
+        ;;
+    mkdir )
+        str_tool="mkdir"
+        str_usage="[-t] [-f] [-p] [-m<mode>] <dir> [<dir> ...]"
+        arg_spec="1+"
+        opt_spec="t.f.p.m:"
+        opt_t=no
+        opt_f=no
+        opt_p=no
+        opt_m=""
+        ;;
+    fixperm )
+        str_tool="fixperm"
+        str_usage="[-v] [-t] <path> [<path> ...]"
+        arg_spec="1+"
+        opt_spec="v.t."
+        opt_v=no
+        opt_t=no
+        ;;
+    tarball )
+        str_tool="tarball"
+        str_usage="[-t] [-v] [-o<tarball>] [-c<prog>] [-d<dir>] [-u<user>] [-g<group>] [-e<pattern>] <path> [<path> ...]"
+        gen_tmpfile=yes
+        arg_spec="1+"
+        opt_spec="t.v.o:c:d:u:g:e:"
+        opt_t=no
+        opt_v=no
+        opt_o=""
+        opt_c=""
+        opt_d=""
+        opt_u=""
+        opt_g=""
+        opt_e="CVS,\\.cvsignore,\\.[oa]\$"
+        ;;
+    scpp )
+        str_tool="scpp"
+        str_usage="[-v] [-p] [-f<filter>] [-o<ofile>] [-t<tfile>] [-M<mark>] [-D<dname>] [-C<cname>] <file> [<file> ...]"
+        gen_tmpfile=yes
+        arg_spec="1+"
+        opt_spec="v.p.f+o:t:M:D:C:"
+        opt_v=no
+        opt_p=no
+        opt_f=""
+        opt_o="lib.h"
+        opt_t="lib.h.in"
+        opt_M="%%MARK%%"
+        opt_D="cpp"
+        opt_C="intern"
+        ;;
+    version )
+        str_tool="version"
+        str_usage="[-l<lang>] [-n<name>] [-p<prefix>] [-s<version>] [-e] [-i<knob>] [-d<type>] <file>"
+        arg_spec="1="
+        opt_spec="l:n:p:s:i:e.d:"
+        opt_l="txt"
+        opt_n="unknown"
+        opt_p=""
+        opt_s=""
+        opt_e="no"
+        opt_i=""
+        opt_d="short"
+        ;;
+    -* )
+        echo "$0:Error: unknown option \`$tool'" 2>&1
+        echo "$0:Hint:  run \`$0 -h' for usage" 2>&1
+        exit 1
+        ;;
+    * )
+        echo "$0:Error: unknown command \`$tool'" 2>&1
+        echo "$0:Hint:  run \`$0 -h' for usage" 2>&1
+        exit 1
+        ;;
+esac
+
+##
+##  COMMON UTILITY CODE
+##
+
+#   determine name of tool
+if [ ".$tool" != . ]; then
+    #   used inside shtool script
+    toolcmd="$0 $tool"
+    toolcmdhelp="shtool $tool"
+    msgprefix="shtool:$tool"
+else
+    #   used as standalone script
+    toolcmd="$0"
+    toolcmdhelp="sh $0"
+    msgprefix="$str_tool"
+fi
+
+#   parse argument specification string
+eval `echo $arg_spec |\
+      sed -e 's/^\([0-9]*\)\([+=]\)/arg_NUMS=\1; arg_MODE=\2/'`
+
+#   parse option specification string
+eval `echo h.$opt_spec |\
+      sed -e 's/\([a-zA-Z0-9]\)\([.:+]\)/opt_MODE_\1=\2;/g'`
+
+#   interate over argument line
+opt_PREV=''
+while [ $# -gt 0 ]; do
+    #   special option stops processing
+    if [ ".$1" = ".--" ]; then
+        shift
+        break
+    fi
+
+    #   determine option and argument
+    opt_ARG_OK=no
+    if [ ".$opt_PREV" != . ]; then
+        #   merge previous seen option with argument
+        opt_OPT="$opt_PREV"
+        opt_ARG="$1"
+        opt_ARG_OK=yes
+        opt_PREV=''
+    else
+        #   split argument into option and argument
+        case "$1" in
+            -[a-zA-Z0-9]*)
+                eval `echo "x$1" |\
+                      sed -e 's/^x-\([a-zA-Z0-9]\)/opt_OPT="\1";/' \
+                          -e 's/";\(.*\)$/"; opt_ARG="\1"/'`
+                ;;
+            -[a-zA-Z0-9])
+                opt_OPT=`echo "x$1" | cut -c3-`
+                opt_ARG=''
+                ;;
+            *)
+                break
+                ;;
+        esac
+    fi
+
+    #   eat up option
+    shift
+
+    #   determine whether option needs an argument
+    eval "opt_MODE=\$opt_MODE_${opt_OPT}"
+    if [ ".$opt_ARG" = . -a ".$opt_ARG_OK" != .yes ]; then
+        if [ ".$opt_MODE" = ".:" -o ".$opt_MODE" = ".+" ]; then
+            opt_PREV="$opt_OPT"
+            continue
+        fi
+    fi
+
+    #   process option
+    case $opt_MODE in
+        '.' )
+            #   boolean option
+            eval "opt_${opt_OPT}=yes"
+            ;;
+        ':' )
+            #   option with argument (multiple occurances override)
+            eval "opt_${opt_OPT}=\"\$opt_ARG\""
+            ;;
+        '+' )
+            #   option with argument (multiple occurances append)
+            eval "opt_${opt_OPT}=\"\$opt_${opt_OPT} \$opt_ARG\""
+            ;;
+        * )
+            echo "$msgprefix:Error: unknown option: \`-$opt_OPT'" 1>&2
+            echo "$msgprefix:Hint:  run \`$toolcmdhelp -h' or \`man shtool' for details" 1>&2
+            exit 1
+            ;;
+    esac
+done
+if [ ".$opt_PREV" != . ]; then
+    echo "$msgprefix:Error: missing argument to option \`-$opt_PREV'" 1>&2
+    echo "$msgprefix:Hint:  run \`$toolcmdhelp -h' or \`man shtool' for details" 1>&2
+    exit 1
+fi
+
+#   process help option
+if [ ".$opt_h" = .yes ]; then
+    echo "Usage: $toolcmdhelp $str_usage"
+    exit 0
+fi
+
+#   complain about incorrect number of arguments
+case $arg_MODE in
+    '=' )
+        if [ $# -ne $arg_NUMS ]; then
+            echo "$msgprefix:Error: invalid number of arguments (exactly $arg_NUMS expected)" 1>&2
+            echo "$msgprefix:Hint:  run \`$toolcmd -h' or \`man shtool' for details" 1>&2
+            exit 1
+        fi
+        ;;
+    '+' )
+        if [ $# -lt $arg_NUMS ]; then
+            echo "$msgprefix:Error: invalid number of arguments (at least $arg_NUMS expected)" 1>&2
+            echo "$msgprefix:Hint:  run \`$toolcmd -h' or \`man shtool' for details" 1>&2
+            exit 1
+        fi
+        ;;
+esac
+
+#   establish a temporary file on request
+if [ ".$gen_tmpfile" = .yes ]; then
+    if [ ".$TMPDIR" != . ]; then
+        tmpdir="$TMPDIR"
+    elif [ ".$TEMPDIR" != . ]; then
+        tmpdir="$TEMPDIR"
+    else
+        tmpdir="/tmp"
+    fi
+    tmpfile="$tmpdir/.shtool.$$"
+    rm -f $tmpfile >/dev/null 2>&1
+    touch $tmpfile
+    chmod 600 $tmpfile
+fi
+
+##
+##  DISPATCH INTO SCRIPT BODY
+##
+
+case $tool in
+
+echo )
+    ##
+    ##  echo -- Print string with optional construct expansion
+    ##  Copyright (c) 1998-2001 Ralf S. Engelschall <rse@engelschall.com>
+    ##  Originally written for WML as buildinfo
+    ##
+    
+    text="$*"
+    
+    #   check for broken escape sequence expansion
+    seo=''
+    bytes=`echo '\1' | wc -c | awk '{ printf("%s", $1); }'`
+    if [ ".$bytes" != .3 ]; then
+        bytes=`echo -E '\1' | wc -c | awk '{ printf("%s", $1); }'`
+        if [ ".$bytes" = .3 ]; then
+            seo='-E'
+        fi
+    fi
+    
+    #   check for existing -n option (to suppress newline)
+    minusn=''
+    bytes=`echo -n 123 2>/dev/null | wc -c | awk '{ printf("%s", $1); }'`
+    if [ ".$bytes" = .3 ]; then
+        minusn='-n'
+    fi
+    
+    #   determine terminal bold sequence
+    term_bold=''
+    term_norm=''
+    if [ ".$opt_e" = .yes -a ".`echo $text | egrep '%[Bb]'`" != . ]; then
+        case $TERM in
+            #   for the most important terminal types we directly know the sequences
+            xterm|xterm*|vt220|vt220*)
+                term_bold=`awk 'BEGIN { printf("%c%c%c%c", 27, 91, 49, 109); }' </dev/null 2>/dev/null`
+                term_norm=`awk 'BEGIN { printf("%c%c%c", 27, 91, 109); }' </dev/null 2>/dev/null`
+                ;;
+            vt100|vt100*)
+                term_bold=`awk 'BEGIN { printf("%c%c%c%c%c%c", 27, 91, 49, 109, 0, 0); }' </dev/null 2>/dev/null`
+                term_norm=`awk 'BEGIN { printf("%c%c%c%c%c", 27, 91, 109, 0, 0); }' </dev/null 2>/dev/null`
+                ;;
+            #   for all others, we try to use a possibly existing `tput' or `tcout' utility
+            * )
+                paths=`echo $PATH | sed -e 's/:/ /g'`
+                for tool in tput tcout; do
+                    for dir in $paths; do
+                        if [ -r "$dir/$tool" ]; then
+                            for seq in bold md smso; do # 'smso' is last
+                                bold="`$dir/$tool $seq 2>/dev/null`"
+                                if [ ".$bold" != . ]; then
+                                    term_bold="$bold"
+                                    break
+                                fi
+                            done
+                            if [ ".$term_bold" != . ]; then
+                                for seq in sgr0 me rmso reset; do # 'reset' is last
+                                    norm="`$dir/$tool $seq 2>/dev/null`"
+                                    if [ ".$norm" != . ]; then
+                                        term_norm="$norm"
+                                        break
+                                    fi
+                                done
+                            fi
+                            break
+                        fi
+                    done
+                    if [ ".$term_bold" != . -a ".$term_norm" != . ]; then
+                        break;
+                    fi
+                done
+                ;;
+        esac
+        if [ ".$term_bold" = . -o ".$term_norm" = . ]; then
+            echo "$msgprefix:Warning: unable to determine terminal sequence for bold mode" 1>&2
+        fi
+    fi
+    
+    #   determine user name
+    username=''
+    if [ ".$opt_e" = .yes -a ".`echo $text | egrep '%[uUgG]'`" != . ]; then
+        username="$LOGNAME"
+        if [ ".$username" = . ]; then
+            username="$USER"
+            if [ ".$username" = . ]; then
+                username="`(whoami) 2>/dev/null |\
+                           awk '{ printf("%s", $1); }'`"
+                if [ ".$username" = . ]; then
+                    username="`(who am i) 2>/dev/null |\
+                               awk '{ printf("%s", $1); }'`"
+                    if [ ".$username" = . ]; then
+                        username='unknown'
+                    fi
+                fi
+            fi
+        fi
+    fi
+    
+    #   determine user id
+    userid=''
+    if [ ".$opt_e" = .yes -a ".`echo $text | egrep '%U'`" != . ]; then
+        userid="`(id -u) 2>/dev/null`"
+        if [ ".$userid" = . ]; then
+            str="`(id) 2>/dev/null`"
+            if [ ".`echo $str | grep '^uid[ 	]*=[ 	]*[0-9]*('`" != . ]; then
+                userid=`echo $str | sed -e 's/^uid[ 	]*=[ 	]*//' -e 's/(.*//'`
+            fi
+            if [ ".$userid" = . ]; then
+                userid=`egrep "^${username}:" /etc/passwd 2>/dev/null | \
+                        sed -e 's/[^:]*:[^:]*://' -e 's/:.*$//'`
+                if [ ".$userid" = . ]; then
+                    userid=`(ypcat passwd) 2>/dev/null |
+                            egrep "^${username}:" | \
+                            sed -e 's/[^:]*:[^:]*://' -e 's/:.*$//'`
+                    if [ ".$userid" = . ]; then
+                        userid='?'
+                    fi
+                fi
+            fi
+        fi
+    fi
+    
+    #   determine (primary) group id
+    groupid=''
+    if [ ".$opt_e" = .yes -a ".`echo $text | egrep '%[gG]'`" != . ]; then
+        groupid=`egrep "^${username}:" /etc/passwd 2>/dev/null | \
+                 sed -e 's/[^:]*:[^:]*:[^:]*://' -e 's/:.*$//'`
+        if [ ".$groupid" = . ]; then
+            groupid=`(ypcat passwd) 2>/dev/null | egrep "^${username}:" | \
+                     sed -e 's/[^:]*:[^:]*:[^:]*://' -e 's/:.*$//'`
+            if [ ".$groupid" = . ]; then
+                groupid='?'
+            fi
+        fi
+    fi
+    
+    #   determine (primary) group name
+    groupname=''
+    if [ ".$opt_e" = .yes -a ".`echo $text | egrep '%g'`" != . ]; then
+        groupname=`egrep "^[^:]*:[^:]*:${groupid}:" /etc/group 2>/dev/null | \
+                   sed -e 's/:.*$//'`
+        if [ ".$groupname" = . ]; then
+            groupname=`(ypcat group) 2>/dev/null | \
+                       egrep "^[^:]*:[^:]*:${groupid}:" | \
+                       sed -e 's/:.*$//'`
+            if [ ".$groupname" = . ]; then
+                groupname='?'
+            fi
+        fi
+    fi
+    
+    #   determine host and domain name
+    hostname=''
+    domainname=''
+    if [ ".$opt_e" = .yes -a ".`echo $text | egrep '%h'`" != . ]; then
+        hostname="`(uname -n) 2>/dev/null |\
+                   awk '{ printf("%s", $1); }'`"
+        if [ ".$hostname" = . ]; then
+            hostname="`(hostname) 2>/dev/null |\
+                       awk '{ printf("%s", $1); }'`"
+            if [ ".$hostname" = . ]; then
+                hostname='unknown'
+            fi
+        fi
+        case $hostname in
+            *.* )
+                domainname=".`echo $hostname | cut -d. -f2-`"
+                hostname="`echo $hostname | cut -d. -f1`"
+                ;;
+        esac
+    fi
+    if [ ".$opt_e" = .yes -a ".`echo $text | egrep '%d'`" != . ]; then
+        if [ ".$domainname" = . ]; then
+            if [ -f /etc/resolv.conf ]; then
+                domainname="`egrep '^[ 	]*domain' /etc/resolv.conf | head -1 |\
+                             sed -e 's/.*domain//' \
+                                 -e 's/^[ 	]*//' -e 's/^ *//' -e 's/^	*//' \
+                                 -e 's/^\.//' -e 's/^/./' |\
+                             awk '{ printf("%s", $1); }'`"
+                if [ ".$domainname" = . ]; then
+                    domainname="`egrep '^[ 	]*search' /etc/resolv.conf | head -1 |\
+                                 sed -e 's/.*search//' \
+                                     -e 's/^[ 	]*//' -e 's/^ *//' -e 's/^	*//' \
+                                     -e 's/ .*//' -e 's/	.*//' \
+                                     -e 's/^\.//' -e 's/^/./' |\
+                                 awk '{ printf("%s", $1); }'`"
+                fi
+            fi
+        fi
+    fi
+    
+    #   determine current time
+    time_day=''
+    time_month=''
+    time_year=''
+    time_monthname=''
+    if [ ".$opt_e" = .yes -a ".`echo $text | egrep '%[DMYm]'`" != . ]; then
+        time_day=`date '+%d'`
+        time_month=`date '+%m'`
+        time_year=`date '+%Y' 2>/dev/null`
+        if [ ".$time_year" = . ]; then
+            time_year=`date '+%y'`
+            case $time_year in
+                [5-9][0-9]) time_year="19$time_year" ;;
+                [0-4][0-9]) time_year="20$time_year" ;;
+            esac
+        fi
+        case $time_month in
+            1|01) time_monthname='Jan' ;;
+            2|02) time_monthname='Feb' ;;
+            3|03) time_monthname='Mar' ;;
+            4|04) time_monthname='Apr' ;;
+            5|05) time_monthname='May' ;;
+            6|06) time_monthname='Jun' ;;
+            7|07) time_monthname='Jul' ;;
+            8|08) time_monthname='Aug' ;;
+            9|09) time_monthname='Sep' ;;
+              10) time_monthname='Oct' ;;
+              11) time_monthname='Nov' ;;
+              12) time_monthname='Dec' ;;
+        esac
+    fi
+    
+    #   expand special ``%x'' constructs
+    if [ ".$opt_e" = .yes ]; then
+        text=`echo $seo "$text" |\
+              sed -e "s/%B/${term_bold}/g" \
+                  -e "s/%b/${term_norm}/g" \
+                  -e "s/%u/${username}/g" \
+                  -e "s/%U/${userid}/g" \
+                  -e "s/%g/${groupname}/g" \
+                  -e "s/%G/${groupid}/g" \
+                  -e "s/%h/${hostname}/g" \
+                  -e "s/%d/${domainname}/g" \
+                  -e "s/%D/${time_day}/g" \
+                  -e "s/%M/${time_month}/g" \
+                  -e "s/%Y/${time_year}/g" \
+                  -e "s/%m/${time_monthname}/g" 2>/dev/null`
+    fi
+    
+    #   create output
+    if [ .$opt_n = .no ]; then
+        echo $seo "$text"
+    else
+        #   the harder part: echo -n is best, because
+        #   awk may complain about some \xx sequences.
+        if [ ".$minusn" != . ]; then
+            echo $seo $minusn "$text"
+        else
+            echo dummy | awk '{ printf("%s", TEXT); }' TEXT="$text"
+        fi
+    fi
+    ;;
+
+install )
+    ##
+    ##  install -- Install a program, script or datafile
+    ##  Copyright (c) 1997-2001 Ralf S. Engelschall <rse@engelschall.com>
+    ##  Originally written for shtool
+    ##
+    
+    #   determine source(s) and destination
+    argc=$#
+    srcs=""
+    while [ $# -gt 1 ]; do
+        srcs="$srcs $1"
+        shift
+    done
+    dstpath="$1"
+    
+    #   type check for destination
+    dstisdir=0
+    if [ -d $dstpath ]; then
+        dstpath=`echo "$dstpath" | sed -e 's:/$::'`
+        dstisdir=1
+    fi
+    
+    #   consistency check for destination
+    if [ $argc -gt 2 -a $dstisdir = 0 ]; then
+        echo "$msgprefix:Error: multiple sources require destination to be directory" 1>&2
+        exit 1
+    fi
+    
+    #   iterate over all source(s)
+    for src in $srcs; do
+        dst=$dstpath
+    
+        #   if destination is a directory, append the input filename
+        if [ $dstisdir = 1 ]; then
+            dstfile=`echo "$src" | sed -e 's;.*/\([^/]*\)$;\1;'`
+            dst="$dst/$dstfile"
+        fi
+    
+        #   check for correct arguments
+        if [ ".$src" = ".$dst" ]; then
+            echo "$msgprefix:Warning: source and destination are the same - skipped" 1>&2
+            continue
+        fi
+        if [ -d "$src" ]; then
+            echo "$msgprefix:Warning: source \`$src' is a directory - skipped" 1>&2
+            continue
+        fi
+    
+        #   make a temp file name in the destination directory
+        dsttmp=`echo $dst |\
+                sed -e 's;[^/]*$;;' -e 's;\(.\)/$;\1;' -e 's;^$;.;' \
+                    -e "s;\$;/#INST@$$#;"`
+    
+        #   verbosity
+        if [ ".$opt_v" = .yes ]; then
+            echo "$src -> $dst" 1>&2
+        fi
+    
+        #   copy or move the file name to the temp name
+        #   (because we might be not allowed to change the source)
+        if [ ".$opt_C" = .yes ]; then
+            opt_c=yes
+        fi
+        if [ ".$opt_c" = .yes ]; then
+            if [ ".$opt_t" = .yes ]; then
+                echo "cp $src $dsttmp" 1>&2
+            fi
+            cp $src $dsttmp || exit $?
+        else
+            if [ ".$opt_t" = .yes ]; then
+                echo "mv $src $dsttmp" 1>&2
+            fi
+            mv $src $dsttmp || exit $?
+        fi
+    
+        #   adjust the target file
+        if [ ".$opt_e" != . ]; then
+            sed='sed'
+            for e in $opt_e; do
+                sed="$sed -e '$e'"
+            done
+            cp $dsttmp $dsttmp.old
+            eval "$sed <$dsttmp.old >$dsttmp" || exit $?
+            rm -f $dsttmp.old
+        fi
+        if [ ".$opt_s" = .yes ]; then
+            if [ ".$opt_t" = .yes ]; then
+                echo "strip $dsttmp" 1>&2
+            fi
+            strip $dsttmp || exit $?
+        fi
+        if [ ".$opt_o" != . ]; then
+            if [ ".$opt_t" = .yes ]; then
+                echo "chown $opt_o $dsttmp" 1>&2
+            fi
+            chown $opt_o $dsttmp || exit $?
+        fi
+        if [ ".$opt_g" != . ]; then
+            if [ ".$opt_t" = .yes ]; then
+                echo "chgrp $opt_g $dsttmp" 1>&2
+            fi
+            chgrp $opt_g $dsttmp || exit $?
+        fi
+        if [ ".$opt_m" != ".-" ]; then
+            if [ ".$opt_t" = .yes ]; then
+                echo "chmod $opt_m $dsttmp" 1>&2
+            fi
+            chmod $opt_m $dsttmp || exit $?
+        fi
+    
+        #   determine whether to do a quick install
+        #   (has to be done _after_ the strip was already done)
+        quick=no
+        if [ ".$opt_C" = .yes ]; then
+            if [ -r $dst ]; then
+                if cmp -s $src $dst; then
+                    quick=yes
+                fi
+            fi
+        fi
+    
+        #   finally, install the file to the real destination
+        if [ $quick = yes ]; then
+            if [ ".$opt_t" = .yes ]; then
+                echo "rm -f $dsttmp" 1>&2
+            fi
+            rm -f $dsttmp
+        else
+            if [ ".$opt_t" = .yes ]; then
+                echo "rm -f $dst && mv $dsttmp $dst" 1>&2
+            fi
+            rm -f $dst && mv $dsttmp $dst
+        fi
+    done
+    ;;
+
+mkdir )
+    ##
+    ##  mkdir -- Make one or more directories
+    ##  Copyright (c) 1996-2001 Ralf S. Engelschall <rse@engelschall.com>
+    ##  Originally written for public domain by Noah Friedman <friedman@prep.ai.mit.edu>
+    ##  Cleaned up and enhanced for shtool
+    ##
+    
+    errstatus=0
+    for p in ${1+"$@"}; do
+        #   if the directory already exists...
+        if [ -d "$p" ]; then
+            if [ ".$opt_f" = .no -a ".$opt_p" = .no ]; then
+                echo "$msgprefix:Error: directory already exists: $p" 1>&2
+                errstatus=1
+                break
+            else
+                continue
+            fi
+        fi
+        #   if the directory has to be created...
+        if [ ".$opt_p" = .no ]; then
+            if [ ".$opt_t" = .yes ]; then
+                echo "mkdir $p" 1>&2
+            fi
+            mkdir $p || errstatus=$?
+            if [ ".$opt_m" != . ]; then
+                if [ ".$opt_t" = .yes ]; then
+                    echo "chmod $opt_m $p" 1>&2
+                fi
+                chmod $opt_m $p || errstatus=$?
+            fi
+        else
+            #   the smart situation
+            set fnord `echo ":$p" |\
+                       sed -e 's/^:\//%/' \
+                           -e 's/^://' \
+                           -e 's/\// /g' \
+                           -e 's/^%/\//'`
+            shift
+            pathcomp=''
+            for d in ${1+"$@"}; do
+                pathcomp="$pathcomp$d"
+                case "$pathcomp" in
+                    -* ) pathcomp="./$pathcomp" ;;
+                esac
+                if [ ! -d "$pathcomp" ]; then
+                    if [ ".$opt_t" = .yes ]; then
+                        echo "mkdir $pathcomp" 1>&2
+                    fi
+                    mkdir $pathcomp || errstatus=$?
+                    if [ ".$opt_m" != . ]; then
+                        if [ ".$opt_t" = .yes ]; then
+                            echo "chmod $opt_m $pathcomp" 1>&2
+                        fi
+                        chmod $opt_m $pathcomp || errstatus=$?
+                    fi
+                fi
+                pathcomp="$pathcomp/"
+            done
+        fi
+    done
+    exit $errstatus
+    ;;
+
+fixperm )
+    ##
+    ##  fixperm -- Fix file permissions inside a source tree
+    ##  Copyright (c) 1996-2001 Ralf S. Engelschall <rse@engelschall.com>
+    ##  Originally written for ePerl
+    ##
+    
+    paths="$*"
+    
+    #   check whether the test command supports the -x option
+    if [ -x /bin/sh ] 2>/dev/null; then
+        minusx="-x"
+    else
+        minusx="-r"
+    fi
+    
+    #   iterate over paths
+    for p in $paths; do
+        for file in `find $p -depth -print`; do
+            if [ -f $file ]; then
+                if [ $minusx $file ]; then
+                    if [ ".$opt_v" = .yes ]; then
+                        echo "-rwxrwxr-x $file" 2>&1
+                    fi
+                    if [ ".$opt_t" = .yes ]; then
+                        echo "chmod 775 $file" 2>&1
+                    fi
+                    chmod 775 $file
+                else
+                    if [ ".$opt_v" = .yes ]; then
+                        echo "-rw-rw-r-- $file" 2>&1
+                    fi
+                    if [ ".$opt_t" = .yes ]; then
+                        echo "chmod 664 $file" 2>&1
+                    fi
+                    chmod 664 $file
+                fi
+                continue
+            fi
+            if [ -d $file ]; then
+                if [ ".$opt_v" = .yes ]; then
+                    echo "drwxrwxr-x $file" 2>&1
+                fi
+                if [ ".$opt_t" = .yes ]; then
+                    echo "chmod 775 $file" 2>&1
+                fi
+                chmod 775 $file
+                continue
+            fi
+            if [ ".$opt_v" = .yes ]; then
+                echo "?????????? $file" 2>&1
+            fi
+        done
+    done
+    ;;
+
+tarball )
+    ##
+    ##  tarball -- Roll distribution tarballs
+    ##  Copyright (c) 1999-2001 Ralf S. Engelschall <rse@engelschall.com>
+    ##  Originally written for shtool
+    ##
+    
+    srcs="$*"
+    
+    #   check whether the test command supports the -x option
+    if [ -x /bin/sh ] 2>/dev/null; then
+        minusx="-x"
+    else
+        minusx="-r"
+    fi
+    
+    #   find the tools
+    paths="`echo $PATH |\
+            sed -e 's%/*:%:%g' -e 's%/*$%%' \
+                -e 's/^:/.:/' -e 's/::/:.:/g' -e 's/:$/:./' \
+                -e 's/:/ /g'`"
+    for spec in find:gfind,find tar:gtar,tar tardy:tardy,tarcust; do
+        prg=`echo $spec | sed -e 's/:.*$//'`
+        tools=`echo $spec | sed -e 's/^.*://'`
+        eval "prg_${prg}=''"
+        #   iterate over tools
+        for tool in `echo $tools | sed -e 's/,/ /g'`; do
+            #   iterate over paths
+            for path in $paths; do
+                if [ $minusx "$path/$tool" -a ! -d "$path/$tool" ]; then
+                    eval "prg_${prg}=\"$path/$tool\""
+                    break
+                fi
+            done
+            eval "val=\$prg_${prg}"
+            if [ ".$val" != . ]; then
+                break
+            fi
+        done
+    done
+    
+    #   expand source paths
+    exclude=''
+    for pat in `echo $opt_e | sed 's/,/ /g'`; do
+        exclude="$exclude | grep -v '$pat'"
+    done
+    if [ ".$opt_t" = .yes ]; then
+        echo "cp /dev/null $tmpfile.lst" 1>&2
+    fi
+    cp /dev/null $tmpfile.lst
+    for src in $srcs; do
+        if [ -d $src ]; then
+            if [ ".$opt_t" = .yes ]; then
+                echo "(cd $src && $prg_find . -type f -depth -print) | sed -e 's:^\\.\$::' -e 's:^\\./::' | cat $exclude >>$tmpfile.lst" 1>&2
+            fi
+            (cd $src && $prg_find . -type f -depth -print) |\
+            sed -e 's:^\.$::' -e 's:^\./::' | eval cat $exclude >>$tmpfile.lst
+        else
+            if [ ".$opt_t" = .yes ]; then
+                echo "echo $src >>$tmpfile.lst" 1>&2
+            fi
+            echo $src >>$tmpfile.lst
+        fi
+    done
+    sort <$tmpfile.lst >$tmpfile.lst.n
+    mv $tmpfile.lst.n $tmpfile.lst
+    if [ ".$opt_v" = .yes ]; then
+        cat $tmpfile.lst | sed -e 's/^/  /' 1>&2
+    fi
+    
+    #   determine tarball file and directory name
+    if [ ".$opt_o" != . ]; then
+        tarfile="$opt_o"
+        if [ ".$opt_d" != . ]; then
+            tarname="$opt_d"
+        else
+            tarname=`echo $tarfile | sed -e 's/\.tar.*$//' -e 's;.*/\([^/]*\)$;\1;'`
+        fi
+    else
+        if [ ".$opt_d" != . ]; then
+            tarname="$opt_d"
+        elif [ -d "$from" ]; then
+            tarname=`echo $from | sed -e 's;.*/\([^/]*\)$;\1;'`
+        else
+            tarname="out"
+        fi
+        tarfile="$tarname.tar"
+    fi
+    
+    #   roll the tarball
+    compress=''
+    if [ ".$opt_c" != . ]; then
+        compress="| $opt_c"
+    fi
+    if [ ".$prg_tardy" != . ]; then
+        #   the elegant hackers way
+        tardy_opt="--prefix=$tarname"
+        tardy_opt="$tardy_opt --user_number=0 --group_number=0" # security!
+        if [ ".$opt_u" != . ]; then
+            tardy_opt="$tardy_opt --user_name=$opt_u"
+        fi
+        if [ ".$opt_g" != . ]; then
+            tardy_opt="$tardy_opt --group_name=$opt_g"
+        fi
+        if [ ".$opt_t" = .yes ]; then
+            echo "cat $tmpfile.lst | xargs $prg_tar cf - | $prg_tardy $tardy_opt | cat $compress >$tmpfile.out" 1>&2
+        fi
+        cat $tmpfile.lst |\
+        xargs $prg_tar cf - |\
+        $prg_tardy $tardy_opt |\
+        eval cat $compress >$tmpfile.out
+        if [ ".$opt_t" = .yes ]; then
+            echo "cp $tmpfile.out $tarfile" 1>&2
+        fi
+        cp $tmpfile.out $tarfile
+    else
+        #  the portable standard way
+        if [ ".$opt_t" = .yes ]; then
+            echo "mkdir $tmpdir/$tarname" 1>&2
+        fi
+        mkdir $tmpdir/$tarname || exit 1
+        if [ ".$opt_t" = .yes ]; then
+            echo "cat $tmpfile.lst | xargs $prg_tar cf - | (cd $tmpdir/$tarname && $prg_tar xf -)" 1>&2
+        fi
+        cat $tmpfile.lst |\
+        xargs $prg_tar cf - |\
+        (cd $tmpdir/$tarname && $prg_tar xf -)
+        if [ ".$opt_u" != . ]; then
+            if [ ".$opt_t" = .yes ]; then
+                echo "chown -R $opt_u $tmpdir/$tarname >/dev/null 2>&1" 2>&1
+            fi
+            chown -R $opt_u $tmpdir/$tarname >/dev/null 2>&1 ||\
+            echo "$msgprefix:Warning: cannot set user name \`$opt_u' (would require root priviledges)"
+        fi
+        if [ ".$opt_g" != . ]; then
+            if [ ".$opt_t" = .yes ]; then
+                echo "chgrp -R $opt_g $tmpdir/$tarname >/dev/null 2>&1" 2>&1
+            fi
+            chgrp -R $opt_g $tmpdir/$tarname >/dev/null 2>&1 ||\
+            echo "$msgprefix:Warning: cannot set group name \`$opt_g' (would require root priviledges)"
+        fi
+        if [ ".$opt_t" = .yes ]; then
+            echo "(cd $tmpdir && $prg_find $tarname -type f -depth -print | sort | xargs $prg_tar cf -) | cat $compress >$tmpfile.out" 1>&2
+        fi
+        (cd $tmpdir && $prg_find $tarname -type f -depth -print | sort | xargs $prg_tar cf -) |\
+        eval cat $compress >$tmpfile.out
+        if [ ".$opt_t" = .yes ]; then
+            echo "cp $tmpfile.out $tarfile" 1>&2
+        fi
+        cp $tmpfile.out $tarfile
+        if [ ".$opt_t" = .yes ]; then
+            echo "rm -rf $tmpdir/$tarname" 1>&2
+        fi
+        rm -rf $tmpdir/$tarname
+    fi
+    
+    #   cleanup
+    if [ ".$opt_t" = .yes ]; then
+        echo "rm -f $tmpfile.lst $tmpfile.out" 1>&2
+    fi
+    rm -f $tmpfile.lst $tmpfile.out
+    ;;
+
+scpp )
+    ##
+    ##  scpp -- Sharing C Pre-Processor
+    ##  Copyright (c) 1999-2001 Ralf S. Engelschall <rse@engelschall.com>
+    ##  Originally written for GNU Pth
+    ##
+    
+    srcs="$*"
+    output="${opt_o}.n"
+    
+    #   find a reasonable Awk
+    awk=''
+    paths=`echo $PATH |\
+           sed -e 's%/*:%:%g' -e 's%/$%%' \
+               -e 's/^:/.:/' -e 's/::/:.:/g' -e 's/:$/:./' \
+               -e 's/:/ /g'`
+    for name in gawk nawk awk; do
+        for path in $paths; do
+            if [ -r "$path/$name" ]; then
+                awk="$path/$name"
+                break
+            fi
+        done
+        if [ ".$awk" != . ]; then
+            break
+        fi
+    done
+    if [ ".$awk" = . ]; then
+        echo "$msgprefix:Error: cannot find a reasonable Awk" 1>&2
+        exit 1
+    fi
+    
+    #   parse source file(s)
+    if [ ".$opt_v" = .yes ]; then
+        echo "Parsing:" | $awk '{ printf("%s", $0); }' 1>&2
+    fi
+    for src in $srcs; do
+        if [ ".$opt_v" = .yes ]; then
+            echo $src | $awk '{ printf(" %s", $0); }' 1>&2
+        fi
+        if [ ".$opt_f" = . ]; then
+            inputcmd="cat $src"
+        else
+            inputcmd="sed $opt_f $src"
+        fi
+        $inputcmd |\
+        $awk '
+           BEGIN {
+               ln    = 0;
+               fln   = 0;
+               level = 0;
+               mode  = "";
+               store = "";
+           }
+           {
+               ln++;
+           }
+           /^#if.*/ {
+               level++;
+           }
+           /^#if [a-zA-Z_][a-zA-Z0-9_]* *$/ {
+               if ($2 == define) {
+                   mode = "D";
+                   printf("D:#line %d \"%s\"\n", ln, src);
+                   next;
+               }
+           }
+           /^#endif.*/ {
+               level--;
+               if (mode == "D" && level == 0) {
+                   mode = "";
+                   next;
+               }
+           }
+           /^[a-zA-Z_][a-zA-Z0-9_].*;.*/ {
+               if ($1 == class) {
+                   printf("V:#line %d \"%s\"\n", ln, src);
+                   printf("V:%s\n", $0);
+                   printf("J:%s\n", $0);
+                   next;
+               }
+           }
+           /^[a-zA-Z_][a-zA-Z0-9_].*=.*/ {
+               if ($1 == class) {
+                   printf("V:#line %d \"%s\"\n", ln, src);
+                   printf("V:%s\n", $0);
+                   printf("J:%s\n", $0);
+                   next;
+               }
+           }
+           /^[a-zA-Z_][a-zA-Z0-9_]*/ {
+               if ($1 == class) {
+                   fln = ln;
+                   store = $0;
+                   mode = "F";
+                   next;
+               }
+           }
+           /^\{ *$/ {
+               if (mode == "F") {
+                   printf("F:#line %d \"%s\"\n", fln, src);
+                   printf("F:%s;\n", store);
+                   printf("I:%s;\n", store);
+                   store = "";
+                   mode = "";
+                   next;
+               }
+           }
+           {
+               if (mode == "D")
+                   printf("D:%s\n", $0);
+               else if (mode == "F")
+                   store = store " " $0;
+           }
+        ' "src=$src" "define=$opt_D" "class=$opt_C" >>$tmpfile
+    done
+    if [ ".$opt_v" = .yes ]; then
+        echo "" 1>&2
+    fi
+    
+    #   start generating output header
+    echo "/* $opt_o -- autogenerated from $opt_t, DO NOT EDIT! */" >$output
+    echo "#line 1 \"$opt_t\"" >>$output
+    sed <$opt_t -e "1,/^${opt_M} *\$/p" -e 'd' |\
+    sed -e "/^${opt_M} *\$/d" >>$output
+    
+    #   merge in the define blocks
+    grep '^D:' $tmpfile | sed -e 's/^D://' >>$output
+    
+    #   generate standard prolog
+    echo "#line 1 \"_ON_THE_FLY_\"" >>$output
+    echo "" >>$output
+    echo "/* make sure the scpp source extensions are skipped */" >>$output
+    echo "#define $opt_D 0" >>$output
+    echo "#define $opt_C /**/" >>$output
+    
+    #   generate namespace hiding for variables
+    echo "" >>$output
+    echo "/* move intern variables to hidden namespace */" >>$output
+    grep '^J:' $tmpfile | sed >>$output \
+        -e 's/^J://' \
+        -e 's/  */ /g' \
+        -e 's/^[^=;]*[ *]\([a-zA-Z0-9_]*\)\[\];.*$/#define \1 __\1/' \
+        -e 's/^[^=;]*[ *]\([a-zA-Z0-9_]*\)\[\] =.*$/#define \1 __\1/' \
+        -e 's/^[^=;]*[ *]\([a-zA-Z0-9_]*\);.*$/#define \1 __\1/' \
+        -e 's/^[^=;]*[ *]\([a-zA-Z0-9_]*\) =.*$/#define \1 __\1/'
+    
+    #   generate namespace hiding for functions
+    echo "" >>$output
+    echo "/* move intern functions to hidden namespace */" >>$output
+    grep '^I:' $tmpfile | sed >>$output \
+        -e 's/^I://' \
+        -e 's/\([ (]\) */\1/g' \
+        -e 's/ *\([),]\)/\1/g' \
+        -e 's/^[^(]*[ *]\([a-zA-Z0-9_]*\)(.*$/#define \1 __\1/'
+    
+    #   generate prototypes for variables
+    echo "" >>$output
+    echo "/* prototypes for intern variables */" >>$output
+    grep '^V:' $tmpfile | sed >>$output \
+        -e 's/^V://' \
+        -e 's/  */ /g' \
+        -e 's/^\([^=;]*[ *][a-zA-Z0-9_]*\[\]\);.*$/\1;/' \
+        -e 's/^\([^=;]*[ *][a-zA-Z0-9_]*\[\]\) =.*$/\1;/' \
+        -e 's/^\([^=;]*[ *][a-zA-Z0-9_]*\);.*$/\1;/' \
+        -e 's/^\([^=;]*[ *][a-zA-Z0-9_]*\) =.*$/\1;/' \
+        -e 's/ ;/;/g' \
+        -e "s/^$opt_C /extern /"
+    
+    #   generate prototypes for functions
+    echo "" >>$output
+    echo "/* prototypes for intern functions */" >>$output
+    grep '^F:' $tmpfile | sed >>$output \
+        -e 's/^F://' \
+        -e 's/\([ (]\) */\1/g' \
+        -e 's/ *\([),]\)/\1/g' \
+        -e 's/\([* ]\)[a-zA-Z0-9_]*,/\1,/g' \
+        -e 's/\([* ]\)[a-zA-Z0-9_]*);/\1);/g' \
+        -e 's/(\*[a-zA-Z0-9_]*)(/(*)(/g' \
+        -e 's/\([ (]\) */\1/g' \
+        -e 's/ *\([),]\)/\1/g' \
+        -e "s/^$opt_C /extern /"
+    
+    #   finish generating output header
+    n=`(echo ''; sed <$opt_t -e "1,/^${opt_M} *\$/p" -e 'd') |\
+       wc -l | sed -e 's;^ *\([0-9]*\) *$;\1;'`
+    echo "#line $n \"$opt_t\"" >>$output
+    sed <$opt_t -e "/^${opt_M} *\$/,\$p" -e 'd' |\
+    sed -e "/^${opt_M} *\$/d" >>$output
+    
+    #   create final output file
+    if [ -f $opt_o ]; then
+        if [ ".$opt_p" = .yes ]; then
+            grep -v '^#line' $opt_o  >$tmpfile.o
+            grep -v '^#line' $output >$tmpfile.n
+            out_old="$tmpfile.o"
+            out_new="$tmpfile.n"
+        else
+            out_old="$opt_o"
+            out_new="$output"
+        fi
+        if cmp -s $out_old $out_new; then
+            :
+        else
+            cp $output $opt_o
+        fi
+    else
+        cp $output $opt_o
+    fi
+    rm -f $output
+    rm -f $tmpfile $tmpfile.* >/dev/null 2>&1
+    ;;
+
+version )
+    ##
+    ##  version -- Maintain a version information file
+    ##  Copyright (c) 1994-2001 Ralf S. Engelschall <rse@engelschall.com>
+    ##  Originally written for ePerl, rewritten from scratch for shtool
+    ##
+    
+    file="$1"
+    
+    #   determine prefix and name
+    name="$opt_n"
+    prefix="$opt_p"
+    
+    #   determine current version
+    triple="$opt_s"
+    if [ ".$triple" != . ]; then
+        #   use given triple
+        if [ ".`echo $triple | grep '[0-9]*.[0-9]*[sabp.][0-9]*'`" = . ]; then
+            echo "$msgprefix:Error: invalid argument to option \`-s': \`$opt_s'" 1>&2
+            exit 1
+        fi
+        eval `echo $triple |\
+              sed -e 's%\([0-9]*\)\.\([0-9]*\)\([sabp.]\)\([0-9]*\).*%\
+              ver="\1";rev="\2";typ="\3";lev="\4"%'`
+        tim=calc
+    elif [ -r $file ]; then
+        #   determine triple from given file
+        eval `grep 'Version [0-9]*.[0-9]*[sabp.][0-9]* ([0-9]*-[a-zA-Z]*-[0-9]*)' $file |\
+              head -1 | sed -e 's%.*Version \([0-9]*\)\.\([0-9]*\)\([sabp.]\)\([0-9]*\) (\([0-9]*-[a-zA-Z]*-[0-9]*\)).*%\
+              ver="\1";rev="\2";typ="\3";lev="\4";tim="\5"%'`
+    else
+        #   intialise to first version
+        ver=0
+        rev=1
+        typ=.
+        lev=0
+        tim=calc
+    fi
+    
+    #   determine new version in batch
+    if [ ".$opt_i" != . ]; then
+        case $opt_i in
+            v ) ver=`expr $ver + 1`
+                rev=0
+                lev=0
+                ;;
+            r ) rev=`expr $rev + 1`
+                lev=0
+                ;;
+            l ) lev=`expr $lev + 1`
+                ;;
+            * ) echo "$msgprefix:Error: invalid argument to option \`-i': \`$opt_i'" 1>&2
+                exit 1
+                ;;
+        esac
+        tim=calc
+    fi
+    
+    #   determine new version interactively
+    if [ ".$opt_e" = .yes ]; then
+        echo "old version: ${ver}.${rev}${typ}${lev}"
+        while [ 1 ]; do
+            echo dummy | awk '{ printf("new version: "); }'
+            read triple
+            case $triple in
+                [0-9]*.[0-9]*[sabp.][0-9]* )
+                    ;;
+                * ) echo "$msgprefix:Error: invalid version string entered: \`$triple'" 1>&2
+                    continue
+                    ;;
+            esac
+            break
+        done
+        eval `echo $triple |\
+              sed -e 's%^\([0-9]*\)\.\([0-9]*\)\([sabp.]\)\([0-9]*\)$%\
+              ver="\1";rev="\2";typ="\3";lev="\4"%'`
+        tim=calc
+    fi
+    
+    #   determine hexadecimal and libtool value of version
+    case $typ in
+        a     ) typnum=0;  levnum=$lev ;;
+        b     ) typnum=1;  levnum=$lev ;;
+        p | . ) typnum=2;  levnum=$lev ;;
+        s     ) typnum=15; levnum=255  ;; # snapshots are special
+    esac
+    hex=`echo "$ver:$rev:$typnum:$levnum" |\
+         awk -F: '{ printf("0x%x%02x%1x%02x", $1, $2, $3, $4); }' |\
+         tr 'abcdef' 'ABCDEF'`
+    ltv=`echo "$ver:$rev:$typnum:$levnum" |\
+         awk -F: '{ printf("%d:%d", $1*10 + $2, $3*10 + $4); }'`
+    
+    #   determine date
+    if [ ".$tim" = .calc ]; then
+        day=`date '+%d'`
+        month=`date '+%m'`
+        year=`date '+%Y' 2>/dev/null`
+        if [ ".$time_year" = . ]; then
+            year=`date '+%y'`
+            case $year in
+                [5-9][0-9]) year="19$year" ;;
+                [0-4][0-9]) year="20$year" ;;
+            esac
+        fi
+        case $month in
+            1|01) month='Jan' ;;
+            2|02) month='Feb' ;;
+            3|03) month='Mar' ;;
+            4|04) month='Apr' ;;
+            5|05) month='May' ;;
+            6|06) month='Jun' ;;
+            7|07) month='Jul' ;;
+            8|08) month='Aug' ;;
+            9|09) month='Sep' ;;
+              10) month='Oct' ;;
+              11) month='Nov' ;;
+              12) month='Dec' ;;
+        esac
+        tim="${day}-${month}-${year}"
+    fi
+    
+    #   perform result actions
+    mode=show
+    if [ ".$opt_i" != . ]; then
+        mode=edit
+    elif [ ".$opt_e" = .yes ]; then
+        mode=edit
+    elif [ ".$opt_s" != . ]; then
+        mode=edit
+    fi
+    if [ ".$mode" = .show ]; then
+        #   just display the current version
+        case $opt_d in
+            short )
+                echo "${ver}.${rev}${typ}${lev}"
+                ;;
+            long )
+                echo "${ver}.${rev}${typ}${lev} ($tim)"
+                ;;
+            libtool )
+                echo "${ltv}"
+                ;;
+            hex )
+                echo "${hex}"
+                ;;
+            * ) echo "$msgprefix:Error: invalid argument to option \`-d': \`$opt_d'" 1>&2
+                exit 1
+                ;;
+        esac
+    else
+        #   update the version file
+    
+        #   pre-generate various strings
+        triple="${ver}.${rev}${typ}${lev}"
+        vHex="$hex"
+        vShort="${triple}"
+        vLong="${triple} (${tim})"
+        vTeX="This is ${name}, Version ${triple} (${tim})"
+        vGNU="${name} ${triple} (${tim})"
+        vWeb="${name}/${triple}"
+        vSCCS="@(#)${name} ${triple} (${tim})"
+        vRCS="\$Id${name} ${triple} (${tim}) \$"
+    
+        #   determine string out of filename
+        #   (do NOT try to optimize this in any way because of portability)
+        filestr=`echo $file |\
+                 tr 'abcdefghijklmnopqrstuvwxyz./%+' \
+                    'ABCDEFGHIJKLMNOPQRSTUVWXYZ____' | sed -e 's/-/_/g'`
+    
+        #   generate uppercase prefix
+        prefixupper=`echo $prefix |\
+                     tr 'abcdefghijklmnopqrstuvwxyz' 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'`
+    
+        #   create the version file according the the selected language
+        echo "new version: ${vLong}"
+    
+        cp /dev/null $file
+        case $opt_l in
+            txt )
+                echo >>$file ""
+                echo >>$file "  ${file} -- Version Information for ${name} (syntax: Text)"
+                echo >>$file "  [automatically generated and maintained by GNU shtool]"
+                echo >>$file ""
+                echo >>$file "  $vTeX"
+                echo >>$file ""
+                ;;
+            c )
+                echo >>$file "/*"
+                echo >>$file "**  ${file} -- Version Information for ${name} (syntax: C/C++)"
+                echo >>$file "**  [automatically generated and maintained by GNU shtool]"
+                echo >>$file "*/"
+                echo >>$file ""
+                echo >>$file "#ifdef _${filestr}_AS_HEADER_"
+                echo >>$file ""
+                echo >>$file "#ifndef _${filestr}_"
+                echo >>$file "#define _${filestr}_"
+                echo >>$file ""
+                echo >>$file "#define ${prefixupper}VERSION ${vHex}"
+                echo >>$file ""
+                echo >>$file "typedef struct {"
+                echo >>$file "    const int   v_hex;"
+                echo >>$file "    const char *v_short;"
+                echo >>$file "    const char *v_long;"
+                echo >>$file "    const char *v_tex;"
+                echo >>$file "    const char *v_gnu;"
+                echo >>$file "    const char *v_web;"
+                echo >>$file "    const char *v_sccs;"
+                echo >>$file "    const char *v_rcs;"
+                echo >>$file "} ${prefix}version_t;"
+                echo >>$file ""
+                echo >>$file "extern ${prefix}version_t ${prefix}version;"
+                echo >>$file ""
+                echo >>$file "#endif /* _${filestr}_ */"
+                echo >>$file ""
+                echo >>$file "#else /* _${filestr}_AS_HEADER_ */"
+                echo >>$file ""
+                echo >>$file "#define _${filestr}_AS_HEADER_"
+                echo >>$file "#include \"${file}\""
+                echo >>$file "#undef  _${filestr}_AS_HEADER_"
+                echo >>$file ""
+                echo >>$file "${prefix}version_t ${prefix}version = {"
+                echo >>$file "    ${vHex},"
+                echo >>$file "    \"${vShort}\","
+                echo >>$file "    \"${vLong}\","
+                echo >>$file "    \"${vTeX}\","
+                echo >>$file "    \"${vGNU}\","
+                echo >>$file "    \"${vWeb}\","
+                echo >>$file "    \"${vSCCS}\","
+                echo >>$file "    \"${vRCS}\""
+                echo >>$file "};"
+                echo >>$file ""
+                echo >>$file "#endif /* _${filestr}_AS_HEADER_ */"
+                echo >>$file ""
+                ;;
+            perl )
+                echo >>$file "##"
+                echo >>$file "##  ${file} -- Version Information for ${name} (syntax: Perl)"
+                echo >>$file "##  [automatically generated and maintained by GNU shtool]"
+                echo >>$file "##"
+                echo >>$file ""
+                echo >>$file "my \$${prefix}version = {"
+                echo >>$file "    'v_hex'   => ${vHex},"
+                echo >>$file "    'v_short' => \"${vShort}\","
+                echo >>$file "    'v_long'  => \"${vLong}\","
+                echo >>$file "    'v_tex'   => \"${vTeX}\","
+                echo >>$file "    'v_gnu'   => \"${vGNU}\","
+                echo >>$file "    'v_web'   => \"${vWeb}\","
+                echo >>$file "    'v_sccs'  => \"${vSCCS}\","
+                echo >>$file "    'v_rcs'   => \"\\${vRCS}/\""
+                echo >>$file "};"
+                echo >>$file ""
+                echo >>$file "1;"
+                echo >>$file ""
+                ;;
+            python )
+                echo >>$file "##"
+                echo >>$file "##  ${file} -- Version Information for ${name} (syntax: Python)"
+                echo >>$file "##  [automatically generated and maintained by GNU shtool]"
+                echo >>$file "##"
+                echo >>$file ""
+                echo >>$file "class ${prefix}version:"
+                echo >>$file "    v_hex       = ${vHex}"
+                echo >>$file "    v_short     = \"${vShort}\""
+                echo >>$file "    v_long      = \"${vLong}\""
+                echo >>$file "    v_tex       = \"${vTeX}\""
+                echo >>$file "    v_gnu       = \"${vGNU}\""
+                echo >>$file "    v_web       = \"${vWeb}\""
+                echo >>$file "    v_sccs      = \"${vSCCS}\""
+                echo >>$file "    v_rcs       = \"${vRCS}\""
+                echo >>$file ""
+                ;;
+            * ) echo "$msgprefix:Error: invalid argument to option \`-l': \`$opt_l'" 1>&2
+                exit 1
+                ;;
+        esac
+    fi
+    ;;
+
+esac
+
+exit 0
+
+##EOF##