tools/debugscripts/kgdb

   1 #!/bin/sh -
   2 #
   3 # Copyright 2004 John-Mark Gurney
   4 # All rights reserved.
   5 #
   6 # Redistribution and use in source and binary forms, with or without
   7 # modification, are permitted provided that the following conditions
   8 # are met:
   9 # 1. Redistributions of source code must retain the above copyright
  10 #    notice, this list of conditions and the following disclaimer.
  11 # 2. Redistributions in binary form must reproduce the above copyright
  12 #    notice, this list of conditions and the following disclaimer in the
  13 #    documentation and/or other materials provided with the distribution.
  14 #
  15 # THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  16 # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  17 # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  18 # ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  19 # FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  20 # DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  21 # OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  22 # HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  23 # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  24 # OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  25 # SUCH DAMAGE.
  26 #
  27 # $FreeBSD$
  28
  29 crashpath="/var/crash"
  30 kld_debpy="kld_deb.py"
  31
  32 if [ x"$1" = x"-?" -o x"$1" = x"-h" ]; then
  33         echo "Usage: $0 <corenum> [ <gdbcmdfile> [ <modulepaths> ] ]"
  34         echo ""
  35         echo "Path for crash dumps: $crashpath"
  36         exit 1
  37 fi
  38
  39 if [ x"$1" = x"" ]; then
  40         echo "Need core number."
  41         exit 1
  42 fi
  43 corenum="$1"
  44 shift
  45
  46 cmd_file=""
  47 if [ x"$2" != x"" ]; then
  48         cmd_file="-x $2"
  49         shift
  50 fi
  51
  52 core="$crashpath/vmcore.$corenum"
  53 info="$crashpath/info.$corenum"
  54
  55 #Get the kernel source compile dir from the info file
  56 kernsrc="`awk 'i == 1 { split($0, a, ":"); print a[2]; i = 0 } $1 == "Versionstring:" { i = 1 }' < "$info"`"
  57
  58 tmpfile="/tmp/kgdb.asf.$$"
  59 # -mapped (broken?)
  60 # -x command_file
  61 echo "Kernel Source:    $kernsrc"
  62 echo "Getting KLD information and locations..."
  63 python $kld_debpy "$kernsrc" "$core" $@ > "$tmpfile" &&
  64 echo "Please run the following command to load module symbols:"
  65 echo "source $tmpfile"
  66 (cd "$kernsrc"; kgdb "$kernsrc/kernel.debug" "$core")
  67 rm "$tmpfile"