ports/151931: [NEW PORT] www/mod_backtrace: Collects backtraces when a child process crashes

[Frank Wall]

>Number:         151931
>Category:       ports
>Synopsis:       [NEW PORT] www/mod_backtrace: Collects backtraces when a child process crashes
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-ports-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Nov 04 12:50:03 UTC 2010
>Closed-Date:
>Last-Modified:
>Originator:     Frank Wall
>Release:        FreeBSD 7.1-RELEASE-p11 amd64
>Organization:
>Environment:
System: FreeBSD 7.1-RELEASE-p11 FreeBSD 7.1-RELEASE-p11 #0: Fri Feb 26 19:22:31 UTC 2010
>Description:
mod_backtrace is an experimental module for Apache httpd 2.x which
collects backtraces when a child process crashes.  Currently it is
implemented only on Linux and FreeBSD, but other platforms could be
supported in the future.

Requirements: Apache httpd >= 2.0.49 must be built with the 
--enable-exception-hook configure option and mod_so enabled.

Activating mod_backtrace:

  1. Load it like any other DSO:
	LoadModule backtrace_module modules/mod_backtrace.so

  2. Enable exception hooks for modules like mod_backtrace:
	EnableExceptionHook On

  3. Choose where backtrace information should be written.
     If you want backtraces from crashes to be reported some place other
     than the error log, use the BacktraceLog directive to specify a
     fully-qualified filename for the log to which backtraces will be
     written.  Note that the web server user id (e.g., "nobody") must
     be able to create or append to this log file, as the log file is

WWW: http://people.apache.org/~trawick/exception_hook.html

Generated with FreeBSD Port Tools 0.99
>How-To-Repeat:
>Fix:

--- ap22-mod_backtrace-1.0.shar begins here ---
# This is a shell archive.  Save it in a file, remove anything before
# this line, and then unpack it by entering "sh file".  Note, it may
# create directories; files and directories will be owned by you and
# have default permissions.
#
# This archive contains:
#
#	mod_backtrace
#	mod_backtrace/Makefile
#	mod_backtrace/distinfo
#	mod_backtrace/pkg-descr
#
echo c - mod_backtrace
mkdir -p mod_backtrace > /dev/null 2>&1
echo x - mod_backtrace/Makefile
sed 's/^X//' >mod_backtrace/Makefile << '2eae82758c703cbac6e9e2c8c6f2c712'
X# New ports collection makefile for:   	mod_backtrace
X# Date created:        			Thu Nov  4 10:08:27 CET 2010
X# Whom:                			Frank Wall <fw at moov.de>
X#
X# $FreeBSD$
X#
X
XPORTNAME=	mod_backtrace
XPORTVERSION=	1.0
XCATEGORIES=	www
XMASTER_SITES=	http://people.apache.org/~trawick/ \
X		http://dl.moov.de/freebsd/${PORTNAME}/
XDISTNAME=	${PORTNAME}.c
XEXTRACT_SUFX=	# none
XEXTRACT_ONLY=	# empty
X
XMAINTAINER=	fw at moov.de
XCOMMENT=	Collects backtraces when a child process crashes
X
XLIB_DEPENDS=	execinfo.1:${PORTSDIR}/devel/libexecinfo
X
XMAKE_JOBS_SAFE=	yes
X
XUSE_APACHE=	20+
XAP_FAST_BUILD=	YES
XAP_GENPLIST=	YES
XAP_EXTRAS+=	-lexecinfo
XAP_LIB+=	${LOCALBASE}/lib
XSHORTMODNAME=	backtrace
X
XWRKSRC=		${WRKDIR}
X
Xdo-extract:
X	${MKDIR} ${WRKSRC}
X	${CP} ${DISTDIR}/${PORTNAME}.c ${WRKSRC}
X
Xpre-build:
X	@${ECHO_MSG} "*********************** PLEASE NOTE! ***********************"
X	@${ECHO_MSG} "Apache httpd must be built with the --enable-exception-hook"
X	@${ECHO_MSG} "configure option and mod_so enabled."
X	@${ECHO_MSG} "*********************** PLEASE NOTE! ***********************"
X
X.include <bsd.port.mk>
2eae82758c703cbac6e9e2c8c6f2c712
echo x - mod_backtrace/distinfo
sed 's/^X//' >mod_backtrace/distinfo << 'b53438360c9373173a1a1b4e7477379e'
XSHA256 (mod_backtrace.c) = 56fd08206e5b5a2b6258dc2b48e0466010640ddac12dcc153e65c455f294e900
XSIZE (mod_backtrace.c) = 5965
b53438360c9373173a1a1b4e7477379e
echo x - mod_backtrace/pkg-descr
sed 's/^X//' >mod_backtrace/pkg-descr << '976aa361066ce0e7262298a23cdfcbb4'
Xmod_backtrace is an experimental module for Apache httpd 2.x which
Xcollects backtraces when a child process crashes.  Currently it is
Ximplemented only on Linux and FreeBSD, but other platforms could be
Xsupported in the future.
X
XRequirements: Apache httpd >= 2.0.49 must be built with the 
X--enable-exception-hook configure option and mod_so enabled.
X
XActivating mod_backtrace:
X
X  1. Load it like any other DSO:
X	LoadModule backtrace_module modules/mod_backtrace.so
X
X  2. Enable exception hooks for modules like mod_backtrace:
X	EnableExceptionHook On
X
X  3. Choose where backtrace information should be written.
X     If you want backtraces from crashes to be reported some place other
X     than the error log, use the BacktraceLog directive to specify a
X     fully-qualified filename for the log to which backtraces will be
X     written.  Note that the web server user id (e.g., "nobody") must
X     be able to create or append to this log file, as the log file is
X
XWWW: http://people.apache.org/~trawick/exception_hook.html
976aa361066ce0e7262298a23cdfcbb4
exit
--- ap22-mod_backtrace-1.0.shar ends here ---

>Release-Note:
>Audit-Trail:
>Unformatted: