3 # Copyright (C) 2003-2019 Free Software Foundation, Inc.
5 # This program is free software; you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; either version 3 of the License, or
8 # (at your option) any later version.
10 # This program is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 # GNU General Public License for more details.
15 # You should have received a copy of the GNU General Public License
16 # along with this program. If not, see <http://www.gnu.org/licenses/>.
19 # Script to generate a core file of a running program.
20 # It starts up gdb, attaches to the given PID and invokes the gcore command.
23 # Need to check for -o option, but set default basename to "core".
26 # When the -a option is present, this may hold additional commands
27 # to ensure gdb dumps all mappings (OS dependent).
30 while getopts :ao: opt; do
35 dump_all_cmds=("-ex" "set use-coredump-filter off")
36 dump_all_cmds+=("-ex" "set dump-excluded-mappings on")
44 echo "usage: @GCORE_TRANSFORM_NAME@ [-a] [-o prefix] pid1 [pid2...pidN]"
54 echo "usage: @GCORE_TRANSFORM_NAME@ [-a] [-o prefix] pid1 [pid2...pidN]"
58 # Attempt to fetch the absolute path to the gcore script that was
60 binary_path=`dirname "$0"`
62 if test "x$binary_path" = x. ; then
63 # We got "." back as a path. This means the user executed
64 # the gcore script locally (i.e. ./gcore) or called the
65 # script via a shell interpreter (i.e. sh gcore).
66 binary_basename=`basename "$0"`
68 # If the gcore script was called like "sh gcore" and the script
69 # lives in the current directory, "which" will not give us "gcore".
70 # So first we check if the script is in the current directory
71 # before using the output of "which".
72 if test -f "$binary_basename" ; then
73 # We have a local gcore script in ".". This covers the case of
74 # doing "./gcore" or "sh gcore".
77 # The gcore script was not found in ".", which means the script
78 # was called from somewhere else in $PATH by "sh gcore".
79 # Extract the correct path now.
80 binary_path_from_env=`which "$0"`
81 binary_path=`dirname "$binary_path_from_env"`
85 # Check if the GDB binary is in the expected path. If not, just
86 # quit with a message.
87 if [ ! -f "$binary_path/@GDB_TRANSFORM_NAME@" ]; then
88 echo "gcore: GDB binary (${binary_path}/@GDB_TRANSFORM_NAME@) not found"
92 # Initialise return code.
98 # `</dev/null' to avoid touching interactive terminal if it is
99 # available but not accessible as GDB would get stopped on SIGTTIN.
100 "$binary_path/@GDB_TRANSFORM_NAME@" </dev/null \
101 --nx --batch --readnever \
102 -ex "set pagination off" -ex "set height 0" -ex "set width 0" \
103 "${dump_all_cmds[@]}" \
104 -ex "attach $pid" -ex "gcore $prefix.$pid" -ex detach -ex quit
106 if [ -r "$prefix.$pid" ] ; then
109 echo "@GCORE_TRANSFORM_NAME@: failed to create $prefix.$pid"