improved portability and fix for large number of threads

Author: d99kris

Makefile.in

@@ -1,7 +1,7 @@
-# Makefile.in generated by automake 1.14.1 from Makefile.am.
+# Makefile.in generated by automake 1.15 from Makefile.am.
 # @configure_input@
 
-# Copyright (C) 1994-2013 Free Software Foundation, Inc.
+# Copyright (C) 1994-2014 Free Software Foundation, Inc.
 
 # This Makefile.in is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -14,7 +14,17 @@
 
 @SET_MAKE@
 VPATH = @srcdir@
-am__is_gnu_make = test -n '$(MAKEFILE_LIST)' && test -n '$(MAKELEVEL)'
+am__is_gnu_make = { \
+  if test -z '$(MAKELEVEL)'; then \
+    false; \
+  elif test -n '$(MAKE_HOST)'; then \
+    true; \
+  elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \
+    true; \
+  else \
+    false; \
+  fi; \
+}
 am__make_running_with_option = \
   case $${target_option-} in \
       ?) ;; \
@@ -78,16 +88,15 @@ POST_UNINSTALL = :
 build_triplet = @build@
 host_triplet = @host@
 subdir = .
-DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \
-	$(top_srcdir)/configure $(am__configure_deps) ar-lib compile \
-	config.guess config.sub depcomp install-sh missing ltmain.sh
 ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
 am__aclocal_m4_deps = $(top_srcdir)/m4/libtool.m4 \
 	$(top_srcdir)/m4/ltoptions.m4 $(top_srcdir)/m4/ltsugar.m4 \
 	$(top_srcdir)/m4/ltversion.m4 $(top_srcdir)/m4/lt~obsolete.m4 \
 	$(top_srcdir)/configure.ac
 am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
 	$(ACLOCAL_M4)
+DIST_COMMON = $(srcdir)/Makefile.am $(top_srcdir)/configure \
+	$(am__configure_deps) $(am__DIST_COMMON)
 am__CONFIG_DISTCLEAN_FILES = config.status config.cache config.log \
  configure.lineno config.status.lineno
 mkinstalldirs = $(install_sh) -d
@@ -149,6 +158,8 @@ ETAGS = etags
 CTAGS = ctags
 CSCOPE = cscope
 DIST_SUBDIRS = $(SUBDIRS)
+am__DIST_COMMON = $(srcdir)/Makefile.in ar-lib compile config.guess \
+	config.sub depcomp install-sh ltmain.sh missing
 DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
 distdir = $(PACKAGE)-$(VERSION)
 top_distdir = $(distdir)
@@ -204,10 +215,6 @@ CCDEPMODE = @CCDEPMODE@
 CFLAGS = @CFLAGS@
 CPP = @CPP@
 CPPFLAGS = @CPPFLAGS@
-CXX = @CXX@
-CXXCPP = @CXXCPP@
-CXXDEPMODE = @CXXDEPMODE@
-CXXFLAGS = @CXXFLAGS@
 CYGPATH_W = @CYGPATH_W@
 DEFS = @DEFS@
 DEPDIR = @DEPDIR@
@@ -263,7 +270,6 @@ abs_top_builddir = @abs_top_builddir@
 abs_top_srcdir = @abs_top_srcdir@
 ac_ct_AR = @ac_ct_AR@
 ac_ct_CC = @ac_ct_CC@
-ac_ct_CXX = @ac_ct_CXX@
 ac_ct_DUMPBIN = @ac_ct_DUMPBIN@
 am__include = @am__include@
 am__leading_dot = @am__leading_dot@
@@ -302,6 +308,7 @@ pdfdir = @pdfdir@
 prefix = @prefix@
 program_transform_name = @program_transform_name@
 psdir = @psdir@
+runstatedir = @runstatedir@
 sbindir = @sbindir@
 sharedstatedir = @sharedstatedir@
 srcdir = @srcdir@
@@ -333,7 +340,6 @@ $(srcdir)/Makefile.in:  $(srcdir)/Makefile.am  $(am__configure_deps)
 	echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign Makefile'; \
 	$(am__cd) $(top_srcdir) && \
 	  $(AUTOMAKE) --foreign Makefile
-.PRECIOUS: Makefile
 Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
 	@case '$?' in \
 	  *config.status*) \
@@ -549,15 +555,15 @@ dist-xz: distdir
 	$(am__post_remove_distdir)
 
 dist-tarZ: distdir
-	@echo WARNING: "Support for shar distribution archives is" \
-	               "deprecated." >&2
+	@echo WARNING: "Support for distribution archives compressed with" \
+		       "legacy program 'compress' is deprecated." >&2
 	@echo WARNING: "It will be removed altogether in Automake 2.0" >&2
 	tardir=$(distdir) && $(am__tar) | compress -c >$(distdir).tar.Z
 	$(am__post_remove_distdir)
 
 dist-shar: distdir
-	@echo WARNING: "Support for distribution archives compressed with" \
-		       "legacy program 'compress' is deprecated." >&2
+	@echo WARNING: "Support for shar distribution archives is" \
+	               "deprecated." >&2
 	@echo WARNING: "It will be removed altogether in Automake 2.0" >&2
 	shar $(distdir) | GZIP=$(GZIP_ENV) gzip -c >$(distdir).shar.gz
 	$(am__post_remove_distdir)
@@ -593,17 +599,17 @@ distcheck: dist
 	esac
 	chmod -R a-w $(distdir)
 	chmod u+w $(distdir)
-	mkdir $(distdir)/_build $(distdir)/_inst
+	mkdir $(distdir)/_build $(distdir)/_build/sub $(distdir)/_inst
 	chmod a-w $(distdir)
 	test -d $(distdir)/_build || exit 0; \
 	dc_install_base=`$(am__cd) $(distdir)/_inst && pwd | sed -e 's,^[^:\\/]:[\\/],/,'` \
 	  && dc_destdir="$${TMPDIR-/tmp}/am-dc-$$$$/" \
 	  && am__cwd=`pwd` \
-	  && $(am__cd) $(distdir)/_build \
-	  && ../configure \
+	  && $(am__cd) $(distdir)/_build/sub \
+	  && ../../configure \
 	    $(AM_DISTCHECK_CONFIGURE_FLAGS) \
 	    $(DISTCHECK_CONFIGURE_FLAGS) \
-	    --srcdir=.. --prefix="$$dc_install_base" \
+	    --srcdir=../.. --prefix="$$dc_install_base" \
 	  && $(MAKE) $(AM_MAKEFLAGS) \
 	  && $(MAKE) $(AM_MAKEFLAGS) dvi \
 	  && $(MAKE) $(AM_MAKEFLAGS) check \
@@ -779,6 +785,8 @@ uninstall-am:
 	mostlyclean mostlyclean-generic mostlyclean-libtool pdf pdf-am \
 	ps ps-am tags tags-am uninstall uninstall-am
 
+.PRECIOUS: Makefile
+
 
 # Tell versions [3.59,3.63) of GNU make to not export all variables.
 # Otherwise a system limit (for SysV at least) may be exceeded.

README.md

@@ -9,19 +9,16 @@ resource-constrained environments, such as embedded Linux systems.
 
 Supported Platforms
 ===================
-libstackusage should work on most Linux systems with glibc present. It has
-however only been tested on:
-Ubuntu 14.04 LTS / Intel x64
+libstackusage is primarily developed and tested on Linux, but basic
+functionality should work in OS X as well. Current version has been tested on:
+- OS X El Capitan 10.11
+- Ubuntu 16.04 LTS
 
 Installation
 ============
-Download the source code package:
+Download the source code:
 
-    wget https://github.com/d99kris/libstackusage/archive/master.zip
-
-Extract package and go to extracted directory:
-
-    unzip master.zip && cd libstackusage-master
+    git clone https://github.com/d99kris/libstackusage && cd libstackusage
 
 Configure and build:
 
@@ -33,65 +30,86 @@ Optionally install in system:
 
 Usage
 =====
+
+Linux
+-----
+
 General usage syntax:
 
     [SU_STDERR=1] [SU_SYSLOG=1] LD_PRELOAD="/path/to/libstackusage.so" <application>
 
 Example using libstackusage (without system install) with gedit and logging
-output at process stop to stderr:
+output to stderr:
 
     SU_STDERR=1 LD_PRELOAD="./src/.libs/libstackusage.so" gedit
 
 Example using libstackusage (system installed) with ls and logging
-output at process stop to syslog:
+output to syslog:
 
     SU_SYSLOG=1 LD_PRELOAD="/usr/lib/libstackusage.so" ls
 
-Example using libstackusage (without system install) with suctest application
-logging output at process stop to stderr and syslog:
+Example using libstackusage (without system install) with sutest01 application
+logging output to stderr and syslog:
+
+    SU_STDERR=1 SU_SYSLOG=1 LD_PRELOAD="./src/.libs/libstackusage.so" ./test/sutest01
+
+OS X
+----
+
+General usage syntax:
+
+    [SU_STDERR=1] [SU_SYSLOG=1] DYLD_INSERT_LIBRARIES="/path/to/libstackusage.1.dylib" DYLD_FORCE_FLAT_NAMESPACE=1 <application>
+
+Example using libstackusage (without system install) with sutest01 application
+logging output to stderr and syslog:
+
+    SU_STDERR=1 SU_SYSLOG=1 DYLD_INSERT_LIBRARIES="./src/.libs/libstackusage.1.dylib" DYLD_FORCE_FLAT_NAMESPACE=1 ./test/sutest01
 
-    SU_STDERR=1 SU_SYSLOG=1 LD_PRELOAD="./src/.libs/libstackusage.so" ./test/suctest
- 
 Output
 ======
 Example output:
 
-    $ SU_STDERR=1 LD_PRELOAD="./src/.libs/libstackusage.so" ./test/suctest
-    libstackusage   pid tid  requested     actual    maxuse  max%    dur  funcP
-    libstackusage  3830   0    8388608    8384512     34584     0      0  (nil)
-    libstackusage  3830   1      16384      16384     11496    70      0  0x4009d0
-    libstackusage  3830   2      16384      16384     13560    82      0  0x4009d0
-    libstackusage  3830   3      32768      32768     28552    87      0  0x4009d0
+    $ SU_STDERR=1 LD_PRELOAD="./src/.libs/libstackusage.so" ./test/sutest01
+    libstackusage log start -------------------------------------------------
+      pid  id    tid  requested     actual     maxuse  max%    dur  funcP
+    23930   0  23930    8388608    8384512       4144     0      0  (nil)
+    23930   1  23931      16384      16384       9336    56      0  0x4009b0
+    23930   2  23932      20480      20480      13528    66      0  0x4009b0
+    23930   3  23933      24576      24576      16728    68      0  0x4009b0
+    23930   4  23934      32768      32768      24920    76      0  0x4009b0
+    23930   5  23935      49152      49152      41304    84      0  0x4009b0
+    libstackusage log end ---------------------------------------------------
 
 Description of columns:
 
     pid         process id
-    tid         thread id (0 = main thread, 1 = first child thread, etc..)
+    id          id (0 = main thread, 1 = first child thread, etc..)
+    tid         thread id / tid (only supported on Linux, others show '0')
     requested   requested stack size in bytes
-    actual      actual available stack size in bytes (excl. any stack guard)
+    actual      actual stack size in bytes (excl. any stack guard)
     maxuse      maximum stack usage in bytes
     max%        maximum use of requested stack size in percentage
     dur         thread duration in seconds
     funcP       (nil) for main, pointer to start_routine for child threads
 
 The function that funcP points to can be determined for example using addr2line:
 
-    $ addr2line -f -e ./test/suctest 0x4009d0
+    $ addr2line -f -e ./test/sutest01 0x4009b0
     thread_start
-    ./test/suctest.c:76
+    ./test/sutest01.c:101
 
 Design Notes
 ============
 libstackusage intercepts calls to pthread_create and fills the thread
 stack with a dummy data pattern. It also registers a callback routine to be
 called upon thread termination. For main thread stack it utilizes
-__constructor__ and __destructor__ routines.
+constructor and destructor routines.
 
 Limitations
 ===========
 Logging to stderr upon process termination may not work for all applications.
 Certain applications, like coreutils ls, etc, are closing stdout/stderr before
-library __destructor__ is called. For such applications it is recommended to
+library destructor is called. For such applications it is recommended to
 use syslog logging.
 
 License
@@ -100,5 +118,5 @@ libstackusage is distributed under BSD 3-Clause license. See LICENSE file.
 
 Keywords
 ========
-pthreads, linux, threads, stack usage, stack utilization.
+linux, os x, pthreads, stack usage, stack utilization, threads.