blob: 0c0e46a624cf02c498a7eb824a3080eada421821 [file] [log] [blame]
#!/bin/bash
## -----------------------------------------------------------------------
## Intent: An example script showing how to source common libraries
## and produce a stack trace on script error/exit
## -----------------------------------------------------------------------
declare -g fatal=1 # assign to view stack trace
echo "$0: ENTER"
echo "$0: Source library shell includes"
declare -g pgmdir="${0%/*}" # dirname($script)
declare -a common_args=()
common_args+=('--common-args-begin--')
# common_args+=('--traputils')
# common_args+=('--stacktrace')
# common_args+=('--tempdir')
source "${pgmdir}/common.sh" "${common_args[@]}"
echo "$0: define foo(), bar() & tans()"
function foo()
{
echo "${FUNCNAME}: hello - stack_frame[1]"
bar
}
function bar()
{
echo "${FUNCNAME}: hello - stack_frame[2]"
tans
}
function tans()
{
declare -g fatal
echo "${FUNCNAME}: early exit for stacktrace"
[[ $fatal -eq 1 ]] && exit 1
return
}
echo "$0: calling foo() for a stack trace"
foo
echo "$0: ENTER"
## -----------------------------------------------------------------------
# % ./example.sh
# ./example.sh: ENTER
# ./example.sh: Source library shell includes
# ./example.sh: define foo(), bar() & tans()
# ./example.sh: calling foo() for a stack trace
# foo: hello - stack_frame[1]
# bar: hello - stack_frame[2]
# tans: early exit for stacktrace
#
# OFFENDER: ./example.sh:1
# ERROR: 'exit 1' exited with status 1
# Call tree:
# 1: ./example.sh:25 tans(...)
# 2: ./example.sh:19 bar(...)
# 3: ./example.sh:37 foo(...)
# Exiting with status 1
# [EOF]