File apache2-debugging-modules.spec of Package apache2-debugging-modules

Overview Repositories Revisions Requests Users Attributes Meta

File apache2-debugging-modules.spec of Package apache2-debugging-modules (Revision 097e5c2525060bdf0d4c0bccdc24bed4)

Currently displaying revision 097e5c2525060bdf0d4c0bccdc24bed4 , Show latest

#
# spec file for package apache2-debugging-modules
#
# Copyright (c) 2014 SUSE LINUX Products GmbH, Nuernberg, Germany.
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
# upon. The license for this file, and modifications and additions to the
# file, is the same license as for the pristine package itself (unless the
# license for the pristine package is not an Open Source License, in which
# case the license is the MIT License). An "Open Source License" is a
# license that conforms to the Open Source Definition (Version 1.9)
# published by the Open Source Initiative.

# Please submit bugfixes or comments via http://bugs.opensuse.org/
#

%define wku_name    wku_bt
%define wku_version 2.01

Name:           apache2-debugging-modules
Version:        2.4
Release:        0
License:        Apache-2.0
Summary:        A bunch of modules useful for debugging
Group:          Productivity/Networking/Web/Servers
Source0:        https://emptyhammock.com/downloads/%{wku_name}-%{wku_version}.zip
Source1:        http://apache.webthing.com/mod_diagnostics/mod_diagnostics.c
Source2:        http://people.apache.org/~trawick/mod_backdoor.c
Source3:        http://people.apache.org/~trawick/mod_backdoor.txt
Source4:        wku.conf
BuildRequires:  apache-rpm-macros
BuildRequires:  apache2-devel
BuildRequires:  apache2-prefork
BuildRequires:  apache2-worker
BuildRequires:  curl
BuildRequires:  unzip
Requires:       %{apache_mmn}
Requires:       %{apache_suse_maintenance_mmn}
Requires:       apache2
#
BuildRoot:      %{_tmppath}/%{name}-%{version}-build

%description
This package contains
        mod_crash
	mod_backtrace
	mod_whatkilledus
	mod_backdoor
	mod_diagnostic_filter

To enable any of the modules, use a2enmod, e.g.
"a2enmod whatkilledus"
See the source files in %{_docdir}/apache2-debugging-modules
for usage info.

Other useful debugging modules, NOT included here, but worth mentioning, are:
mod_bucketeer (ships with apache2 package)
mod_dumpio    (ships with apache2 package)
mod_coredumper (needs CoreDumper library)

%prep
%setup -c -T -q -a0
cp -p %{SOURCE1} %{SOURCE2} %{SOURCE3} .
sed -i "s:$^.*ap_my_generation.*$$:    int ap_my_generation = 0;\n    ap_mpm_query(AP_MPMQ_GENERATION, \&ap_my_generation);\n\1:" mod_backdoor.c

%build
export CFLAGS="-O0 -Wall"
cd %{wku_name}-%{wku_version}
  BITS=%{__isa_bits} make clean all APXS=%{apache_apxs} [LIBUNWIND=yes]
cd ..
%{apache_apxs} -c mod_diagnostics.c
for mpm in prefork worker; do
  %{apache_apxs}-$mpm -c mod_backdoor.c; mv .libs/mod_backdoor.so .libs/mod_backdoor-$mpm.so
  %{apache_apxs}-$mpm -c mod_backdoor.c
done

%install
cd %{wku_name}-%{wku_version}
mkdir -p %{buildroot}%{apache_libexecdir}
cp -p .libs/mod_backtrace.so %{buildroot}%{apache_libexecdir}
cp -p .libs/mod_crash.so %{buildroot}%{apache_libexecdir}
cp -p .libs/mod_whatkilledus.so %{buildroot}%{apache_libexecdir}
mkdir -p %{buildroot}%{_docdir}/%{name}/%{wku_name}
cp -p CHANGES.txt LICENSE.txt NOTICE.txt README.txt %{buildroot}%{_docdir}/%{name}/%{wku_name}
cd ..
cp -p .libs/mod_diagnostics.so %{buildroot}%{apache_libexecdir}/mod_diagnostic_filter.so
for mpm in prefork worker; do
  mkdir -p %{buildroot}%{apache_libexecdir}-$mpm
  cp -p .libs/mod_backdoor-$mpm.so %{buildroot}%{apache_libexecdir}-$mpm/mod_backdoor.so
done
mkdir -p %{buildroot}%{apache_sysconfdir}/conf.d/
install -m 644 %{SOURCE4} %{buildroot}%{apache_sysconfdir}/conf.d/

%check
exit_code=0
mkdir -p %{apache_test_module_dir}
#
# mod_backtrace and mod_whatkilledus configuration
#
cat << EOF > %{apache_test_module_dir}/wku-test.conf
# see https://emptyhammock.com/projects/httpd/diag/
EnableExceptionHook On
# mod_backtrace provide %B, see the documentation
ErrorLogFormat "[%t] [%l] [pid\ %P] [client\ %a] %M backtrace: [%{//}B]"
<Location /backtrace>
SetHandler backtrace-handler
</Location>
# mod_crash provides test crash of one of the child
<Location /crash>
SetHandler crash-handler
</Location>
WKUObscureInRequest hdr:Authorization hdr:Cookie hdr:Proxy-Authorization user password query unparsed-line
# * httpd MUST NOT be started by systemctl
# * this file must be writeable by user:group under which apache servers running on
#   (wwwrun:www for SUSE at time of writing) 
WKULogfile %{apache_test_module_dir}/wku_log
EOF
#
# mod_backdoor configuration
# 
cat << EOF > %{apache_test_module_dir}/backdoor-test.conf
BackdoorAddress 127.0.0.1:65535
EOF
set +x
#
# run test apache instance
#
echo -n '' > %{apache_test_module_dir}/error_log
echo -n '' > %{apache_test_module_dir}/wku_log
%apache_test_module_start_apache -m backtrace:crash:whatkilledus:diagnostic_filter:backdoor -i wku-test.conf:backdoor-test.conf
# currently testing: mod_backtrace together with mod_whatkillus and mod_crash
#
# perform test crash trough mod_crash (|| true as the child dies, curl returns 18)
curl -s http://127.0.0.1:%{__test_port}/crash -o %{apache_test_module_dir}/mod_crash.txt || true
%apache_test_module_curl -d /backtrace -o %{apache_test_module_dir}/mod_backtrace.txt
echo '[1] mod_crash output'
grep 'Crashing in process'  %{apache_test_module_dir}/mod_crash.txt || exit_code=1
grep 'about to crash'       %{apache_test_module_dir}/error_log     || exit_code=1
echo '[2] mod_backtrace output in error_log'
grep 'backtrace.*ap_run_handler' %{apache_test_module_dir}/error_log || exit_code=2
echo '[3] mod_backtrace output in /backtrace'
grep 'mod_backtrace: DIAG_BTFIELDS_FUNCTION' %{apache_test_module_dir}/mod_backtrace.txt || exit_code=3
grep 'ap_run_handler'                        %{apache_test_module_dir}/mod_backtrace.txt || exit_code=3
echo '[4] test mod_whatkilledus output in wku_log'
grep 'Crash at'          %{apache_test_module_dir}/wku_log || exit_code=4
grep 'Fatal signal: 11'  %{apache_test_module_dir}/wku_log || exit_code=4
grep '__libc_start_main' %{apache_test_module_dir}/wku_log || exit_code=4
grep 'Request line'      %{apache_test_module_dir}/wku_log || exit_code=4
if [ $exit_code -eq 0 ]; then
  echo 'SUCCESS'
else
  echo 'FAILED, error_log:'
  cat %{apache_test_module_dir}/error_log
fi
#
# stop test apache instance
#
%apache_test_module_stop_apache
set -x
exit $exit_code

%files
%defattr(-,root,root)
%dir %{apache_libexecdir}
%doc %{_docdir}/%{name}
%doc %{_docdir}/%{name}/%{wku_name}
%{apache_libexecdir}/*.so
%dir %{apache_libexecdir}-prefork
%dir %{apache_libexecdir}-worker
%{apache_libexecdir}-*/*.so
%dir %{apache_sysconfdir}/conf.d/
%{apache_sysconfdir}/conf.d/wku.conf

%changelog

Places

File apache2-debugging-modules.spec of Package apache2-debugging-modules (Revision 097e5c2525060bdf0d4c0bccdc24bed4)

Places