Add gdb wrapper for easier core dumps analysis

Closes #25

Author: gerhard

jobs/rabbitmq-server/spec

@@ -286,6 +286,7 @@ templates:
   bin/stop: bin/stop
 
   bin/rabbitmq_management_http_ok: bin/rabbitmq_management_http_ok
+  bin/analyse_core_dump: bin/analyse_core_dump
 
   bin/_add_user: bin/_add_user
   bin/_add_external_plugins: bin/_add_external_plugins

jobs/rabbitmq-server/templates/bin/analyse_core_dump

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+
+set -e
+
+# shellcheck source=/dev/null
+. /var/vcap/jobs/rabbitmq-server/env
+
+ERLANG_CORE_DUMP="${1:?first argument must be a valid Erlang Core Dump}"
+
+ERTS_EMULATOR="$ERLANG_HOME"/src/erts/emulator
+GDB_MACROS="$ERLANG_HOME"/src/erts/etc/unix/etp-commands.in
+
+shell_expanded_beam_path() {
+  echo "${ERLANG_HOME:?must be set}"/lib/erlang/erts-*/bin/beam.smp
+}
+
+gdb "$(shell_expanded_beam_path)" \
+  -directory="$ERTS_EMULATOR" -command="$GDB_MACROS" -core="$ERLANG_CORE_DUMP"

jobs/rabbitmq-server/templates/env.erb

@@ -72,9 +72,10 @@ export LC_ALL=en_US.UTF-8
 
 export ERL_INETRC=/var/vcap/jobs/rabbitmq-server/erl_inetrc
 export ERLANG_COOKIE="<%= p("erlang.cookie") %>"
+export ERLANG_HOME=/var/vcap/jobs/rabbitmq-server/packages/erlang-<%= p("erlang.version") %>
 
 # erl(1) / erlc(1) require $HOME to be set
 # Default to the system user that runs rabbitmq-server
 [ -n "$HOME" ] || export HOME=/home/"$RABBITMQ_SERVICE_USER"
 
-export PATH="$RABBITMQ_SERVER_PACKAGE/sbin:/var/vcap/jobs/rabbitmq-server/packages/erlang-<%= p("erlang.version") %>/bin:/var/vcap/jobs/rabbitmq-server/bin:/var/vcap/jobs/rabbitmq-server/packages/rabbitmq-support-tools/scripts:$PATH"
+export PATH="$RABBITMQ_SERVER_PACKAGE/sbin:$ERLANG_HOME/bin:/var/vcap/jobs/rabbitmq-server/bin:/var/vcap/jobs/rabbitmq-server/packages/rabbitmq-support-tools/scripts:$PATH"