# Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 2000, 2001# Free Software Foundation, Inc.## This file is part of GNU Emacs.## GNU Emacs is free software; you can redistribute it and/or modify# it under the terms of the GNU General Public License as published by# the Free Software Foundation; either version 2, or (at your option)# any later version.## GNU Emacs is distributed in the hope that it will be useful,# but WITHOUT ANY WARRANTY; without even the implied warranty of# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the# GNU General Public License for more details.## You should have received a copy of the GNU General Public License# along with GNU Emacs; see the file COPYING. If not, write to the# Free Software Foundation, Inc., 59 Temple Place - Suite 330,# Boston, MA 02111-1307, USA.# Force loading of symbols, enough to give us gdb_valbits etc.set main# Find lwlib source files too.dir ../lwlib#dir /gd/gnu/lesstif-0.89.9/lib/Xm# Don't enter GDB when user types C-g to quit.# This has one unfortunate effect: you can't type C-c# at the GDB to stop Emacs, when using X.# However, C-z works just as well in that case.handle 2 noprint pass# Don't pass SIGALRM to Emacs. This makes problems when# debugging.handle SIGALRM ignore# Set up a mask to use.# This should be EMACS_INT, but in some cases that is a macro.# long ought to work in all cases right now.set $valmask = ((long)1 << gdb_valbits) - 1set $nonvalbits = gdb_emacs_intbits - gdb_valbits# Set up something to print out s-expressions.define prset debug_print ($)enddocument prPrint the emacs s-expression which is $.Works only when an inferior emacs is executing.enddefine xtypeoutput (enum Lisp_Type) (($ >> gdb_valbits) & 0x7)echo \noutput ((($ >> gdb_valbits) & 0x7) == Lisp_Misc ? (enum Lisp_Misc_Type) (((struct Lisp_Free *) (($ & $valmask) | gdb_data_seg_bits))->type) : (($ >> gdb_valbits) & 0x7) == Lisp_Vectorlike ? ($size = ((struct Lisp_Vector *) (($ & $valmask) | gdb_data_seg_bits))->size, (enum pvec_type) (($size & PVEC_FLAG) ? $size & PVEC_TYPE_MASK : 0)) : 0)echo \nenddocument xtypePrint the type of $, assuming it is an Emacs Lisp value.If the first type printed is Lisp_Vector or Lisp_Misc,the second line gives the more precise type.Otherwise the second line doesn't mean anything.enddefine xvectypeset $size = ((struct Lisp_Vector *) (($ & $valmask) | gdb_data_seg_bits))->sizeoutput (enum pvec_type) (($size & PVEC_FLAG) ? $size & PVEC_TYPE_MASK : 0)echo \nenddocument xvectypePrint the vector subtype of $, assuming it is a vector or pseudovector.enddefine xmisctypeoutput (enum Lisp_Misc_Type) (((struct Lisp_Free *) (($ & $valmask) | gdb_data_seg_bits))->type)echo \nenddocument xmisctypePrint the specific type of $, assuming it is some misc type.enddefine xintprint (($ & $valmask) << $nonvalbits) >> $nonvalbitsenddocument xintPrint $, assuming it is an Emacs Lisp integer. This gets the sign right.enddefine xptrprint (void *) (($ & $valmask) | gdb_data_seg_bits)enddocument xptrPrint the pointer portion of $, assuming it is an Emacs Lisp value.enddefine xmarkerprint (struct Lisp_Marker *) (($ & $valmask) | gdb_data_seg_bits)enddocument xmarkerPrint $ as a marker pointer, assuming it is an Emacs Lisp marker value.enddefine xoverlayprint (struct Lisp_Overlay *) (($ & $valmask) | gdb_data_seg_bits)enddocument xoverlayPrint $ as a overlay pointer, assuming it is an Emacs Lisp overlay value.enddefine xmiscfreeprint (struct Lisp_Free *) (($ & $valmask) | gdb_data_seg_bits)enddocument xmiscfreePrint $ as a misc free-cell pointer, assuming it is an Emacs Lisp Misc value.enddefine xintfwdprint (struct Lisp_Intfwd *) (($ & $valmask) | gdb_data_seg_bits)enddocument xintfwdPrint $ as an integer forwarding pointer, assuming it is an Emacs Lisp Misc value.enddefine xboolfwdprint (struct Lisp_Boolfwd *) (($ & $valmask) | gdb_data_seg_bits)enddocument xboolfwdPrint $ as a boolean forwarding pointer, assuming it is an Emacs Lisp Misc value.enddefine xobjfwdprint (struct Lisp_Objfwd *) (($ & $valmask) | gdb_data_seg_bits)enddocument xobjfwdPrint $ as an object forwarding pointer, assuming it is an Emacs Lisp Misc value.enddefine xbufobjfwdprint (struct Lisp_Buffer_Objfwd *) (($ & $valmask) | gdb_data_seg_bits)enddocument xbufobjfwdPrint $ as a buffer-local object forwarding pointer, assuming it is an Emacs Lisp Misc value.enddefine xkbobjfwdprint (struct Lisp_Kboard_Objfwd *) (($ & $valmask) | gdb_data_seg_bits)enddocument xkbobjfwdPrint $ as a kboard-local object forwarding pointer, assuming it is an Emacs Lisp Misc value.enddefine xbuflocalprint (struct Lisp_Buffer_Local_Value *) (($ & $valmask) | gdb_data_seg_bits)enddocument xbuflocalPrint $ as a buffer-local-value pointer, assuming it is an Emacs Lisp Misc value.enddefine xsymbolprint (struct Lisp_Symbol *) ((((int) $) & $valmask) | gdb_data_seg_bits)xprintsym $enddocument xsymbolPrint the name and address of the symbol $.This command assumes that $ is an Emacs Lisp symbol value.enddefine xstringprint (struct Lisp_String *) (($ & $valmask) | gdb_data_seg_bits)output ($->size > 1000) ? 0 : ($->data[0])@($->size_byte < 0 ? $->size : $->size_byte)echo \nenddocument xstringPrint the contents and address of the string $.This command assumes that $ is an Emacs Lisp string value.enddefine xvectorprint (struct Lisp_Vector *) (($ & $valmask) | gdb_data_seg_bits)output ($->size > 50) ? 0 : ($->contents[0])@($->size)echo \nenddocument xvectorPrint the contents and address of the vector $.This command assumes that $ is an Emacs Lisp vector value.enddefine xprocessprint (struct Lisp_Process *) (($ & $valmask) | gdb_data_seg_bits)output *$echo \nenddocument xprocessPrint the address of the struct Lisp_process which the Lisp_Object $ points to.enddefine xframeprint (struct frame *) (($ & $valmask) | gdb_data_seg_bits)enddocument xframePrint $ as a frame pointer, assuming it is an Emacs Lisp frame value.enddefine xcompiledprint (struct Lisp_Vector *) (($ & $valmask) | gdb_data_seg_bits)output ($->contents[0])@($->size & 0xff)enddocument xcompiledPrint $ as a compiled function pointer, assuming it is an Emacs Lisp compiled value.enddefine xwindowprint (struct window *) (($ & $valmask) | gdb_data_seg_bits)printf "%dx%d+%d+%d\n", $->width, $->height, $->left, $->topenddocument xwindowPrint $ as a window pointer, assuming it is an Emacs Lisp window value.Print the window's position as "WIDTHxHEIGHT+LEFT+TOP".enddefine xwinconfigprint (struct save_window_data *) (($ & $valmask) | gdb_data_seg_bits)enddocument xwinconfigPrint $ as a window configuration pointer, assuming it is an Emacs Lisp window configuration value.enddefine xsubrprint (struct Lisp_Subr *) (($ & $valmask) | gdb_data_seg_bits)output *$echo \nenddocument xsubrPrint the address of the subr which the Lisp_Object $ points to.enddefine xchartableprint (struct Lisp_Char_Table *) (($ & $valmask) | gdb_data_seg_bits)printf "Purpose: "output (char*)&((struct Lisp_Symbol *) ((((int) $->purpose) & $valmask) | gdb_data_seg_bits))->name->dataprintf " %d extra slots", ($->size & 0x1ff) - 388echo \nenddocument xchartablePrint the address of the char-table $, and its purpose.This command assumes that $ is an Emacs Lisp char-table value.enddefine xboolvectorprint (struct Lisp_Bool_Vector *) (($ & $valmask) | gdb_data_seg_bits)output ($->size > 256) ? 0 : ($->data[0])@(($->size + 7)/ 8)echo \nenddocument xboolvectorPrint the contents and address of the bool-vector $.This command assumes that $ is an Emacs Lisp bool-vector value.enddefine xbufferprint (struct buffer *) (($ & $valmask) | gdb_data_seg_bits)output ((struct Lisp_String *) ((($->name) & $valmask) | gdb_data_seg_bits))->dataecho \nenddocument xbufferSet $ as a buffer pointer, assuming it is an Emacs Lisp buffer value.Print the name of the buffer.enddefine xhashtableprint (struct Lisp_Hash_Table *) (($ & $valmask) | gdb_data_seg_bits)enddocument xhashtableSet $ as a hash table pointer, assuming it is an Emacs Lisp hash table value.enddefine xconsprint (struct Lisp_Cons *) (($ & $valmask) | gdb_data_seg_bits)output/x *$echo \nenddocument xconsPrint the contents of $, assuming it is an Emacs Lisp cons.enddefine nextconsp $.cdrxconsenddocument nextconsPrint the contents of the next cell in a list.This assumes that the last thing you printed was a cons cell contents(type struct Lisp_Cons) or a pointer to one.enddefine xcarprint/x ((($ >> gdb_valbits) & 0xf) == Lisp_Cons ? ((struct Lisp_Cons *) (($ & $valmask) | gdb_data_seg_bits))->car : 0)enddocument xcarPrint the car of $, assuming it is an Emacs Lisp pair.enddefine xcdrprint/x ((($ >> gdb_valbits) & 0xf) == Lisp_Cons ? ((struct Lisp_Cons *) (($ & $valmask) | gdb_data_seg_bits))->cdr : 0)enddocument xcdrPrint the cdr of $, assuming it is an Emacs Lisp pair.enddefine xfloatprint ((struct Lisp_Float *) (($ & $valmask) | gdb_data_seg_bits))->dataenddocument xfloatPrint $ assuming it is a lisp floating-point number.enddefine xscrollbarprint (struct scrollbar *) (($ & $valmask) | gdb_data_seg_bits)output *$echo \nenddocument xscrollbarPrint $ as a scrollbar pointer.enddefine xprintsym set $sym = (struct Lisp_Symbol *) ((((int) $arg0) & $valmask) | gdb_data_seg_bits) set $sym_name = ((struct Lisp_String *)(($sym->xname & $valmask) | gdb_data_seg_bits)) output ($sym_name->data[0])@($sym_name->size_byte < 0 ? $sym_name->size : $sym_name->size_byte) echo \nenddocument xprintsym Print argument as a symbol.enddefine xbacktrace set $bt = backtrace_list while $bt set $type = (enum Lisp_Type) ((*$bt->function >> gdb_valbits) & 0x7) if $type == Lisp_Symbol xprintsym *$bt->function else printf "0x%x ", *$bt->function if $type == Lisp_Vectorlike set $size = ((struct Lisp_Vector *) ((*$bt->function & $valmask) | gdb_data_seg_bits))->size output (enum pvec_type) (($size & PVEC_FLAG) ? $size & PVEC_TYPE_MASK : 0) else printf "Lisp type %d", $type end echo \n end set $bt = $bt->next endenddocument xbacktrace Print a backtrace of Lisp function calls from backtrace_list. Set a breakpoint at Fsignal and call this to see from where an error was signaled.enddefine xreload set $valmask = ((long)1 << gdb_valbits) - 1 set $nonvalbits = gdb_emacs_intbits - gdb_valbitsenddocument xreload When starting Emacs a second time in the same gdb session under FreeBSD 2.2.5, gdb 4.13, $valmask and $nonvalbits have lost their values. (The same happens on current (2000) versions of GNU/Linux with gdb 5.0.) This function reloads them.enddefine hook-run xreloadend# Call xreload if a new Emacs executable is loaded.define hookpost-run xreloadendset print pretty onset print sevenbit-stringsshow environment DISPLAYshow environment TERMset args -geometry 80x40+0+0# Don't let abort actually run, as it will make# stdio stop working and therefore the `pr' command above as well.break abort# If we are running in synchronous mode, we want a chance to look around# before Emacs exits. Perhaps we should put the break somewhere else# instead...break x_error_quitter# arch-tag: 12f34321-7bfa-4240-b77a-3cd3a1696dfe