calc.el (calc-mode-map): Bind O to 'calc-missing-key'.
[emacs.git] / src / .gdbinit
blobb959baae8f3f86681273665c149ed00500371041
1 # Copyright (C) 1992, 1993, 1994, 1995, 1996, 1997, 1998, 2000, 2001,
2 #   2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
3 #   Free Software Foundation, Inc.
5 # This file is part of GNU Emacs.
7 # GNU Emacs is free software; you can redistribute it and/or modify
8 # it under the terms of the GNU General Public License as published by
9 # the Free Software Foundation; either version 3, or (at your option)
10 # any later version.
12 # GNU Emacs is distributed in the hope that it will be useful,
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 # GNU General Public License for more details.
17 # You should have received a copy of the GNU General Public License
18 # along with GNU Emacs; see the file COPYING.  If not, write to the
19 # Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
20 # Boston, MA 02110-1301, USA.
22 # Force loading of symbols, enough to give us gdb_valbits etc.
23 set main
25 # Find lwlib source files too.
26 dir ../lwlib
27 #dir /gd/gnu/lesstif-0.89.9/lib/Xm
29 # Don't enter GDB when user types C-g to quit.
30 # This has one unfortunate effect: you can't type C-c
31 # at the GDB to stop Emacs, when using X.
32 # However, C-z works just as well in that case.
33 handle 2 noprint pass
35 # Make it work like SIGINT normally does.
36 handle SIGTSTP nopass
38 # Pass on user signals
39 handle SIGUSR1 noprint pass
40 handle SIGUSR2 noprint pass
42 # Don't pass SIGALRM to Emacs.  This makes problems when
43 # debugging.
44 handle SIGALRM ignore
46 # $valmask and $tagmask are mask values set up by the xreload macro below.
48 # Use $bugfix so that the value isn't a constant.
49 # Using a constant runs into GDB bugs sometimes.
50 define xgetptr
51   set $bugfix = $arg0
52   set $ptr = (gdb_use_union ? $bugfix.u.val : $bugfix & $valmask) | gdb_data_seg_bits
53 end
55 define xgetint
56   set $bugfix = $arg0
57   set $int = gdb_use_union ? $bugfix.s.val : (gdb_use_lsb ? $bugfix : $bugfix << gdb_gctypebits) >> gdb_gctypebits
58 end
60 define xgettype
61   set $bugfix = $arg0
62   set $type = gdb_use_union ? $bugfix.s.type : (enum Lisp_Type) (gdb_use_lsb ? $bugfix & $tagmask : $bugfix >> gdb_valbits)
63 end
65 # Set up something to print out s-expressions.
66 # We save and restore print_output_debug_flag to prevent the w32 port
67 # from calling OutputDebugString, which causes GDB to display each
68 # character twice (yuk!).
69 define pr
70   set $output_debug = print_output_debug_flag
71   set print_output_debug_flag = 0
72   set debug_print ($)
73   set print_output_debug_flag = $output_debug
74 end
75 document pr
76 Print the emacs s-expression which is $.
77 Works only when an inferior emacs is executing.
78 end
80 # Print out s-expressions
81 define pp
82   set $tmp = $arg0
83   set $output_debug = print_output_debug_flag
84   set print_output_debug_flag = 0
85   set safe_debug_print ($tmp)
86   set print_output_debug_flag = $output_debug
87 end
88 document pp
89 Print the argument as an emacs s-expression
90 Works only when an inferior emacs is executing.
91 end
93 # Print out s-expressions from tool bar
94 define pp1
95   set $tmp = $arg0
96   set $output_debug = print_output_debug_flag
97   set print_output_debug_flag = 0
98   set safe_debug_print ($tmp)
99   set print_output_debug_flag = $output_debug
101 document pp1
102 Print the argument as an emacs s-expression.
103 Works only when an inferior emacs is executing.
104 For use on tool bar when debugging in Emacs
105 where the variable name would not otherwise
106 be recorded in the GUD buffer.
109 # Print value of lisp variable
110 define pv
111   set $tmp = "$arg0"
112   set $output_debug = print_output_debug_flag
113   set print_output_debug_flag = 0
114   set safe_debug_print ( find_symbol_value (intern ($tmp)))
115   set print_output_debug_flag = $output_debug
117 document pv
118 Print the value of the lisp variable given as argument.
119 Works only when an inferior emacs is executing.
122 # Print value of lisp variable
123 define pv1
124   set $tmp = "$arg0"
125   set $output_debug = print_output_debug_flag
126   set print_output_debug_flag = 0
127   set safe_debug_print (find_symbol_value (intern ($tmp)))
128   set print_output_debug_flag = $output_debug
130 document pv1
131 Print the value of the lisp variable given as argument.
132 Works only when an inferior emacs is executing.
133 For use when debugging in Emacs where the variable
134 name would not otherwise be recorded in the GUD buffer.
137 # Print out current buffer point and boundaries
138 define ppt
139   set $b = current_buffer
140   set $t = $b->text
141   printf "BUF PT: %d", $b->pt
142   if ($b->pt != $b->pt_byte)
143     printf "[%d]", $b->pt_byte
144   end
145   printf " of 1..%d", $t->z
146   if ($t->z != $t->z_byte)
147     printf "[%d]", $t->z_byte
148   end
149   if ($b->begv != 1 || $b->zv != $t->z)
150     printf " NARROW=%d..%d", $b->begv, $b->zv
151     if ($b->begv != $b->begv_byte || $b->zv != $b->zv_byte)
152       printf " [%d..%d]", $b->begv_byte, $b->zv_byte
153     end
154   end
155   printf " GAP: %d", $t->gpt
156   if ($t->gpt != $t->gpt_byte)
157     printf "[%d]", $t->gpt_byte
158   end
159   printf " SZ=%d\n", $t->gap_size
161 document ppt
162 Print current buffer's point and boundaries.
163 Prints values of point, beg, end, narrow, and gap for current buffer.
166 define pitmethod
167   set $itmethod = $arg0
168   # output $itmethod
169   if ($itmethod == 0)
170     printf "GET_FROM_BUFFER"
171   end
172   if ($itmethod == 1)
173     printf "GET_FROM_DISPLAY_VECTOR"
174   end
175   if ($itmethod == 2)
176     printf "GET_FROM_STRING"
177   end
178   if ($itmethod == 3)
179     printf "GET_FROM_C_STRING"
180   end
181   if ($itmethod == 4)
182     printf "GET_FROM_IMAGE"
183   end
184   if ($itmethod == 5)
185     printf "GET_FROM_STRETCH"
186   end
187   if ($itmethod < 0 || $itmethod > 5)
188     output $itmethod
189   end
191 document pitmethod
192 Pretty print it->method given as first arg
195 # Print out iterator given as first arg
196 define pitx
197   set $it = $arg0
198   printf "cur=%d", $it->current.pos.charpos
199   if ($it->current.pos.charpos != $it->current.pos.bytepos)
200     printf "[%d]", $it->current.pos.bytepos
201   end
202   printf " pos=%d", $it->position.charpos
203   if ($it->position.charpos != $it->position.bytepos)
204     printf "[%d]", $it->position.bytepos
205   end
206   printf " start=%d", $it->start.pos.charpos
207   if ($it->start.pos.charpos != $it->start.pos.bytepos)
208     printf "[%d]", $it->start.pos.bytepos
209   end
210   printf " end=%d", $it->end_charpos
211   printf " stop=%d", $it->stop_charpos
212   printf " face=%d", $it->face_id
213   if ($it->multibyte_p)
214     printf " MB"
215   end
216   if ($it->header_line_p)
217     printf " HL"
218   end
219   if ($it->n_overlay_strings > 0)
220     printf " nov=%d", $it->n_overlay_strings
221   end
222   if ($it->sp != 0)
223     printf " sp=%d", $it->sp
224   end
225   # IT_CHARACTER
226   if ($it->what == 0)
227     if ($it->len == 1 && $it->c >= ' ' && it->c < 255)
228       printf " ch='%c'", $it->c
229     else
230       printf " ch=[%d,%d]", $it->c, $it->len
231     end
232   else
233     printf " "
234     # output $it->what
235     if ($it->what == 0)
236       printf "IT_CHARACTER"
237     end
238     if ($it->what == 1)
239       printf "IT_COMPOSITION"
240     end
241     if ($it->what == 2)
242       printf "IT_IMAGE"
243     end
244     if ($it->what == 3)
245       printf "IT_STRETCH"
246     end
247     if ($it->what == 4)
248       printf "IT_EOB"
249     end
250     if ($it->what == 5)
251       printf "IT_TRUNCATION"
252     end
253     if ($it->what == 6)
254       printf "IT_CONTINUATION"
255     end
256     if ($it->what < 0 || $it->what > 6)
257       output $it->what
258     end
259   end
260   if ($it->method != 0)
261     # !GET_FROM_BUFFER
262     printf " next="
263     pitmethod $it->method
264     if ($it->method == 2)
265       # GET_FROM_STRING
266       printf "[%d]", $it->current.string_pos.charpos
267     end
268     if ($it->method == 4)
269       # GET_FROM_IMAGE
270       printf "[%d]", $it->image_id
271     end
272   end
273   printf "\n"
274   if ($it->bidi_p)
275     printf "BIDI: base_stop=%d prev_stop=%d level=%d\n", $it->base_level_stop, $it->prev_stop, $it->bidi_it.resolved_level
276   end
277   if ($it->region_beg_charpos >= 0)
278     printf "reg=%d-%d ", $it->region_beg_charpos, $it->region_end_charpos
279   end
280   printf "vpos=%d hpos=%d", $it->vpos, $it->hpos,
281   printf " y=%d lvy=%d", $it->current_y, $it->last_visible_y
282   printf " x=%d vx=%d-%d", $it->current_x, $it->first_visible_x, $it->last_visible_x
283   printf " w=%d", $it->pixel_width
284   printf " a+d=%d+%d=%d", $it->ascent, $it->descent, $it->ascent+$it->descent
285   printf " max=%d+%d=%d", $it->max_ascent, $it->max_descent, $it->max_ascent+$it->max_descent
286   printf "\n"
287   set $i = 0
288   while ($i < $it->sp && $i < 4)
289     set $e = $it->stack[$i]
290     printf "stack[%d]: ", $i
291     pitmethod $e->method
292     printf "[%d]", $e->position.charpos
293     printf "\n"
294     set $i = $i + 1
295   end
297 document pitx
298 Pretty print a display iterator.
299 Take one arg, an iterator object or pointer.
302 define pit
303   pitx it
305 document pit
306 Pretty print the display iterator it.
309 define prowx
310   set $row = $arg0
311   printf "y=%d x=%d pwid=%d", $row->y, $row->x, $row->pixel_width
312   printf " a+d=%d+%d=%d", $row->ascent, $row->height-$row->ascent, $row->height
313   printf " phys=%d+%d=%d", $row->phys_ascent, $row->phys_height-$row->phys_ascent, $row->phys_height
314   printf " vis=%d", $row->visible_height
315   printf "  L=%d T=%d R=%d", $row->used[0], $row->used[1], $row->used[2]
316   printf "\n"
317   printf "start=%d end=%d", $row->start.pos.charpos, $row->end.pos.charpos
318   if ($row->enabled_p)
319     printf " ENA"
320   end
321   if ($row->displays_text_p)
322     printf " DISP"
323   end
324   if ($row->mode_line_p)
325     printf " MODEL"
326   end
327   if ($row->continued_p)
328     printf " CONT"
329   end
330   if ($row-> truncated_on_left_p)
331     printf " TRUNC:L"
332   end
333   if ($row-> truncated_on_right_p)
334     printf " TRUNC:R"
335   end
336   if ($row->starts_in_middle_of_char_p)
337     printf " STARTMID"
338   end
339   if ($row->ends_in_middle_of_char_p)
340     printf " ENDMID"
341   end
342   if ($row->ends_in_newline_from_string_p)
343     printf " ENDNLFS"
344   end
345   if ($row->ends_at_zv_p)
346     printf " ENDZV"
347   end
348   if ($row->overlapped_p)
349     printf " OLAPD"
350   end
351   if ($row->overlapping_p)
352     printf " OLAPNG"
353   end
354   printf "\n"
356 document prowx
357 Pretty print information about glyph_row.
358 Takes one argument, a row object or pointer.
361 define prow
362   prowx row
364 document prow
365 Pretty print information about glyph_row in row.
369 define pcursorx
370   set $cp = $arg0
371   printf "y=%d x=%d vpos=%d hpos=%d", $cp->y, $cp->x, $cp->vpos, $cp->hpos
373 document pcursorx
374 Pretty print a window cursor.
377 define pcursor
378   printf "output: "
379   pcursorx output_cursor
380   printf "\n"
382 document pcursor
383 Pretty print the output_cursor.
386 define pwinx
387   set $w = $arg0
388   xgetint $w->sequence_number
389   if ($w->mini_p != Qnil)
390     printf "Mini "
391   end
392   printf "Window %d ", $int
393   xgetptr $w->buffer
394   set $tem = (struct buffer *) $ptr
395   xgetptr $tem->name
396   printf "%s", ((struct Lisp_String *) $ptr)->data
397   printf "\n"
398   xgetptr $w->start
399   set $tem = (struct Lisp_Marker *) $ptr
400   printf "start=%d end:", $tem->charpos
401   if ($w->window_end_valid != Qnil)
402     xgetint $w->window_end_pos
403     printf "pos=%d", $int
404     xgetint $w->window_end_vpos
405     printf " vpos=%d", $int
406   else
407     printf "invalid"
408   end
409   printf " vscroll=%d", $w->vscroll
410   if ($w->force_start != Qnil)
411     printf " FORCE_START"
412   end
413   if ($w->must_be_updated_p)
414     printf " MUST_UPD"
415   end
416   printf "\n"
417   printf "cursor: "
418   pcursorx $w->cursor
419   printf "  phys: "
420   pcursorx $w->phys_cursor
421   if ($w->phys_cursor_on_p)
422     printf " ON"
423   else
424     printf " OFF"
425   end
426   printf " blk="
427   if ($w->last_cursor_off_p != $w->cursor_off_p)
428     if ($w->last_cursor_off_p)
429       printf "ON->"
430     else
431       printf "OFF->"
432     end
433   end
434   if ($w->cursor_off_p)
435     printf "ON"
436   else
437     printf "OFF"
438   end
439   printf "\n"
441 document pwinx
442 Pretty print a window structure.
443 Takes one argument, a pointer to a window structure.
446 define pwin
447   pwinx w
449 document pwin
450 Pretty print window structure w.
453 define pbiditype
454   if ($arg0 == 0)
455     printf "UNDEF"
456   end
457   if ($arg0 == 1)
458     printf "L"
459   end
460   if ($arg0 == 2)
461     printf "R"
462   end
463   if ($arg0 == 3)
464     printf "EN"
465   end
466   if ($arg0 == 4)
467     printf "AN"
468   end
469   if ($arg0 == 5)
470     printf "BN"
471   end
472   if ($arg0 == 6)
473     printf "B"
474   end
475   if ($arg0 < 0 || $arg0 > 6)
476     printf "%d??", $arg0
477   end
479 document pbiditype
480 Print textual description of bidi type given as first argument.
483 define pgx
484   set $g = $arg0
485   # CHAR_GLYPH
486   if ($g->type == 0)
487     if ($g->u.ch >= ' ' && $g->u.ch < 127)
488       printf "CHAR[%c]", $g->u.ch
489     else
490       printf "CHAR[0x%x]", $g->u.ch
491     end
492   end
493   # COMPOSITE_GLYPH
494   if ($g->type == 1)
495     printf "COMP[%d (%d..%d)]", $g->u.cmp.id, $g->u.cmp.from, $g->u.cmp.to
496   end
497   # IMAGE_GLYPH
498   if ($g->type == 2)
499     printf "IMAGE[%d]", $g->u.img_id
500   end
501   # STRETCH_GLYPH
502   if ($g->type == 3)
503     printf "STRETCH[%d+%d]", $g->u.stretch.height, $g->u.stretch.ascent
504   end
505   xgettype ($g->object)
506   if ($type == Lisp_String)
507     printf " str=%x[%d]", $g->object, $g->charpos
508   else
509     printf " pos=%d", $g->charpos
510   end
511   # For characters, print their resolved level and bidi type
512   if ($g->type == 0)
513     printf " blev=%d,btyp=", $g->resolved_level
514     pbiditype $g->bidi_type
515   end
516   printf " w=%d a+d=%d+%d", $g->pixel_width, $g->ascent, $g->descent
517   # If not DEFAULT_FACE_ID
518   if ($g->face_id != 0)
519     printf " face=%d", $g->face_id
520   end
521   if ($g->voffset)
522     printf " vof=%d", $g->voffset
523   end
524   if ($g->multibyte_p)
525     printf " MB"
526   end
527   if ($g->padding_p)
528     printf " PAD"
529   end
530   if ($g->glyph_not_available_p)
531     printf " N/A"
532   end
533   if ($g->overlaps_vertically_p)
534     printf " OVL"
535   end
536   if ($g->left_box_line_p)
537     printf " ["
538   end
539   if ($g->right_box_line_p)
540     printf " ]"
541   end
542   if ($g->slice.x || $g->slice.y || $g->slice.width || $g->slice.height)
543     printf " slice=%d,%d,%d,%d" ,$g->slice.x, $g->slice.y, $g->slice.width, $g->slice.height
544   end
545   printf "\n"
547 document pgx
548 Pretty print a glyph structure.
549 Takes one argument, a pointer to a glyph structure.
552 define pg
553   set $pgidx = 0
554   pgx glyph
556 document pg
557 Pretty print glyph structure glyph.
560 define pgi
561   set $pgidx = $arg0
562   pgx (&glyph[$pgidx])
564 document pgi
565 Pretty print glyph structure glyph[I].
566 Takes one argument, a integer I.
569 define pgn
570   set $pgidx = $pgidx + 1
571   pgx (&glyph[$pgidx])
573 document pgn
574 Pretty print next glyph structure.
577 define pgrowx
578   set $row = $arg0
579   set $area = 0
580   set $xofs = $row->x
581   while ($area < 3)
582     set $used = $row->used[$area]
583     if ($used > 0)
584       set $gl0 = $row->glyphs[$area]
585       set $pgidx = 0
586       printf "%s: %d glyphs\n", ($area == 0 ? "LEFT" : $area == 2 ? "RIGHT" : "TEXT"), $used
587       while ($pgidx < $used)
588         printf "%3d %4d: ", $pgidx, $xofs
589         pgx $gl0[$pgidx]
590         set $xofs = $xofs + $gl0[$pgidx]->pixel_width
591         set $pgidx = $pgidx + 1
592       end
593     end
594     set $area = $area + 1
595   end
597 document pgrowx
598 Pretty print all glyphs in a row structure.
599 Takes one argument, a pointer to a row structure.
602 define pgrow
603   pgrowx row
605 document pgrow
606 Pretty print all glyphs in row structure row.
609 define pgrowit
610   pgrowx it->glyph_row
612 document pgrowit
613 Pretty print all glyphs in it->glyph_row.
616 define prowlims
617   printf "start=%d,end=%d,reversed=%d,cont=%d,at_zv=%d\n", $arg0->start.pos.charpos, $arg0->end.pos.charpos, $arg0->reversed_p, $arg0->continued_p, $arg0->ends_at_zv_p
619 document prowlims
620 Print important attributes of a glyph_row structure.
621 Takes one argument, a pointer to a glyph_row structure.
624 define pmtxrows
625   set $mtx = $arg0
626   set $gl = $mtx->rows
627   set $glend = $mtx->rows + $mtx->nrows
628   while ($gl < $glend)
629     prowlims $gl
630     set $gl = $gl + 1
631   end
633 document pmtxrows
634 Print data about glyph rows in a glyph matrix.
635 Takes one argument, a pointer to a glyph_matrix structure.
638 define xtype
639   xgettype $
640   output $type
641   echo \n
642   if $type == Lisp_Misc
643     xmisctype
644   else
645     if $type == Lisp_Vectorlike
646       xvectype
647     end
648   end
650 document xtype
651 Print the type of $, assuming it is an Emacs Lisp value.
652 If the first type printed is Lisp_Vector or Lisp_Misc,
653 a second line gives the more precise type.
656 define xvectype
657   xgetptr $
658   set $size = ((struct Lisp_Vector *) $ptr)->size
659   output ($size & PVEC_FLAG) ? (enum pvec_type) ($size & PVEC_TYPE_MASK) : $size & ~gdb_array_mark_flag
660   echo \n
662 document xvectype
663 Print the size or vector subtype of $.
664 This command assumes that $ is a vector or pseudovector.
667 define xmisctype
668   xgetptr $
669   output (enum Lisp_Misc_Type) (((struct Lisp_Free *) $ptr)->type)
670   echo \n
672 document xmisctype
673 Assume that $ is some misc type and print its specific type.
676 define xint
677   xgetint $
678   print $int
680 document xint
681 Print $ as an Emacs Lisp integer.  This gets the sign right.
684 define xptr
685   xgetptr $
686   print (void *) $ptr
688 document xptr
689 Print the pointer portion of an Emacs Lisp value in $.
692 define xmarker
693   xgetptr $
694   print (struct Lisp_Marker *) $ptr
696 document xmarker
697 Print $ as a marker pointer.
698 This command assumes that $ is an Emacs Lisp marker value.
701 define xoverlay
702   xgetptr $
703   print (struct Lisp_Overlay *) $ptr
705 document xoverlay
706 Print $ as a overlay pointer.
707 This command assumes that $ is an Emacs Lisp overlay value.
710 define xmiscfree
711   xgetptr $
712   print (struct Lisp_Free *) $ptr
714 document xmiscfree
715 Print $ as a misc free-cell pointer.
716 This command assumes that $ is an Emacs Lisp Misc value.
719 define xintfwd
720   xgetptr $
721   print (struct Lisp_Intfwd *) $ptr
723 document xintfwd
724 Print $ as an integer forwarding pointer.
725 This command assumes that $ is an Emacs Lisp Misc value.
728 define xboolfwd
729   xgetptr $
730   print (struct Lisp_Boolfwd *) $ptr
732 document xboolfwd
733 Print $ as a boolean forwarding pointer.
734 This command assumes that $ is an Emacs Lisp Misc value.
737 define xobjfwd
738   xgetptr $
739   print (struct Lisp_Objfwd *) $ptr
741 document xobjfwd
742 Print $ as an object forwarding pointer.
743 This command assumes that $ is an Emacs Lisp Misc value.
746 define xbufobjfwd
747   xgetptr $
748   print (struct Lisp_Buffer_Objfwd *) $ptr
750 document xbufobjfwd
751 Print $ as a buffer-local object forwarding pointer.
752 This command assumes that $ is an Emacs Lisp Misc value.
755 define xkbobjfwd
756   xgetptr $
757   print (struct Lisp_Kboard_Objfwd *) $ptr
759 document xkbobjfwd
760 Print $ as a kboard-local object forwarding pointer.
761 This command assumes that $ is an Emacs Lisp Misc value.
764 define xbuflocal
765   xgetptr $
766   print (struct Lisp_Buffer_Local_Value *) $ptr
768 document xbuflocal
769 Print $ as a buffer-local-value pointer.
770 This command assumes that $ is an Emacs Lisp Misc value.
773 define xsymbol
774   set $sym = $
775   xgetptr $sym
776   print (struct Lisp_Symbol *) $ptr
777   xprintsym $sym
778   echo \n
780 document xsymbol
781 Print the name and address of the symbol $.
782 This command assumes that $ is an Emacs Lisp symbol value.
785 define xstring
786   xgetptr $
787   print (struct Lisp_String *) $ptr
788   xprintstr $
789   echo \n
791 document xstring
792 Print the contents and address of the string $.
793 This command assumes that $ is an Emacs Lisp string value.
796 define xvector
797   xgetptr $
798   print (struct Lisp_Vector *) $ptr
799   output ($->size > 50) ? 0 : ($->contents[0])@($->size & ~gdb_array_mark_flag)
800 echo \n
802 document xvector
803 Print the contents and address of the vector $.
804 This command assumes that $ is an Emacs Lisp vector value.
807 define xprocess
808   xgetptr $
809   print (struct Lisp_Process *) $ptr
810   output *$
811   echo \n
813 document xprocess
814 Print the address of the struct Lisp_process to which $ points.
815 This command assumes that $ is a Lisp_Object.
818 define xframe
819   xgetptr $
820   print (struct frame *) $ptr
821   xgetptr $->name
822   set $ptr = (struct Lisp_String *) $ptr
823   xprintstr $ptr
824   echo \n
826 document xframe
827 Print $ as a frame pointer.
828 This command assumes $ is an Emacs Lisp frame value.
831 define xcompiled
832   xgetptr $
833   print (struct Lisp_Vector *) $ptr
834   output ($->contents[0])@($->size & 0xff)
836 document xcompiled
837 Print $ as a compiled function pointer.
838 This command assumes that $ is an Emacs Lisp compiled value.
841 define xwindow
842   xgetptr $
843   print (struct window *) $ptr
844   set $window = (struct window *) $ptr
845   xgetint $window->total_cols
846   set $width=$int
847   xgetint $window->total_lines
848   set $height=$int
849   xgetint $window->left_col
850   set $left=$int
851   xgetint $window->top_line
852   set $top=$int
853   printf "%dx%d+%d+%d\n", $width, $height, $left, $top
855 document xwindow
856 Print $ as a window pointer, assuming it is an Emacs Lisp window value.
857 Print the window's position as "WIDTHxHEIGHT+LEFT+TOP".
860 define xwinconfig
861   xgetptr $
862   print (struct save_window_data *) $ptr
864 document xwinconfig
865 Print $ as a window configuration pointer.
866 This command assumes that $ is an Emacs Lisp window configuration value.
869 define xsubr
870   xgetptr $
871   print (struct Lisp_Subr *) $ptr
872   output *$
873   echo \n
875 document xsubr
876 Print the address of the subr which the Lisp_Object $ points to.
879 define xchartable
880   xgetptr $
881   print (struct Lisp_Char_Table *) $ptr
882   printf "Purpose: "
883   xprintsym $->purpose
884   printf "  %d extra slots", ($->size & 0x1ff) - 68
885   echo \n
887 document xchartable
888 Print the address of the char-table $, and its purpose.
889 This command assumes that $ is an Emacs Lisp char-table value.
892 define xboolvector
893   xgetptr $
894   print (struct Lisp_Bool_Vector *) $ptr
895   output ($->size > 256) ? 0 : ($->data[0])@((($->size & ~gdb_array_mark_flag) + 7)/ 8)
896   echo \n
898 document xboolvector
899 Print the contents and address of the bool-vector $.
900 This command assumes that $ is an Emacs Lisp bool-vector value.
903 define xbuffer
904   xgetptr $
905   print (struct buffer *) $ptr
906   xgetptr $->name
907   output ((struct Lisp_String *) $ptr)->data
908   echo \n
910 document xbuffer
911 Set $ as a buffer pointer and the name of the buffer.
912 This command assumes $ is an Emacs Lisp buffer value.
915 define xhashtable
916   xgetptr $
917   print (struct Lisp_Hash_Table *) $ptr
919 document xhashtable
920 Set $ as a hash table pointer.
921 This command assumes that $ is an Emacs Lisp hash table value.
924 define xcons
925   xgetptr $
926   print (struct Lisp_Cons *) $ptr
927   output/x *$
928   echo \n
930 document xcons
931 Print the contents of $ as an Emacs Lisp cons.
934 define nextcons
935   p $.u.cdr
936   xcons
938 document nextcons
939 Print the contents of the next cell in a list.
940 This command assumes that the last thing you printed was a cons cell contents
941 (type struct Lisp_Cons) or a pointer to one.
943 define xcar
944   xgetptr $
945   xgettype $
946   print/x ($type == Lisp_Cons ? ((struct Lisp_Cons *) $ptr)->car : 0)
948 document xcar
949 Assume that $ is an Emacs Lisp pair and print its car.
952 define xcdr
953   xgetptr $
954   xgettype $
955   print/x ($type == Lisp_Cons ? ((struct Lisp_Cons *) $ptr)->u.cdr : 0)
957 document xcdr
958 Assume that $ is an Emacs Lisp pair and print its cdr.
961 define xlist
962   xgetptr $
963   set $cons = (struct Lisp_Cons *) $ptr
964   xgetptr Qnil
965   set $nil = $ptr
966   set $i = 0
967   while $cons != $nil && $i < 10
968     p/x $cons->car
969     xpr
970     xgetptr $cons->u.cdr
971     set $cons = (struct Lisp_Cons *) $ptr
972     set $i = $i + 1
973     printf "---\n"
974   end
975   if $cons == $nil
976     printf "nil\n"
977   else
978     printf "...\n"
979     p $ptr
980   end
982 document xlist
983 Print $ assuming it is a list.
986 define xfloat
987   xgetptr $
988   print ((struct Lisp_Float *) $ptr)->u.data
990 document xfloat
991 Print $ assuming it is a lisp floating-point number.
994 define xscrollbar
995   xgetptr $
996   print (struct scrollbar *) $ptr
997 output *$
998 echo \n
1000 document xscrollbar
1001 Print $ as a scrollbar pointer.
1004 define xpr
1005   xtype
1006   if $type == Lisp_Int
1007     xint
1008   end
1009   if $type == Lisp_Symbol
1010     xsymbol
1011   end
1012   if $type == Lisp_String
1013     xstring
1014   end
1015   if $type == Lisp_Cons
1016     xcons
1017   end
1018   if $type == Lisp_Float
1019     xfloat
1020   end
1021   if $type == Lisp_Misc
1022     set $misc = (enum Lisp_Misc_Type) (((struct Lisp_Free *) $ptr)->type)
1023     if $misc == Lisp_Misc_Free
1024       xmiscfree
1025     end
1026     if $misc == Lisp_Misc_Boolfwd
1027       xboolfwd
1028     end
1029     if $misc == Lisp_Misc_Marker
1030       xmarker
1031     end
1032     if $misc == Lisp_Misc_Intfwd
1033       xintfwd
1034     end
1035     if $misc == Lisp_Misc_Boolfwd
1036       xboolfwd
1037     end
1038     if $misc == Lisp_Misc_Objfwd
1039       xobjfwd
1040     end
1041     if $misc == Lisp_Misc_Buffer_Objfwd
1042       xbufobjfwd
1043     end
1044     if $misc == Lisp_Misc_Buffer_Local_Value
1045       xbuflocal
1046     end
1047 #    if $misc == Lisp_Misc_Some_Buffer_Local_Value
1048 #      xvalue
1049 #    end
1050     if $misc == Lisp_Misc_Overlay
1051       xoverlay
1052     end
1053     if $misc == Lisp_Misc_Kboard_Objfwd
1054       xkbobjfwd
1055     end
1056 #    if $misc == Lisp_Misc_Save_Value
1057 #      xsavevalue
1058 #    end
1059   end
1060   if $type == Lisp_Vectorlike
1061     set $size = ((struct Lisp_Vector *) $ptr)->size
1062     if ($size & PVEC_FLAG)
1063       set $vec = (enum pvec_type) ($size & PVEC_TYPE_MASK)
1064       if $vec == PVEC_NORMAL_VECTOR
1065         xvector
1066       end
1067       if $vec == PVEC_PROCESS
1068         xprocess
1069       end
1070       if $vec == PVEC_FRAME
1071         xframe
1072       end
1073       if $vec == PVEC_COMPILED
1074         xcompiled
1075       end
1076       if $vec == PVEC_WINDOW
1077         xwindow
1078       end
1079       if $vec == PVEC_WINDOW_CONFIGURATION
1080         xwinconfig
1081       end
1082       if $vec == PVEC_SUBR
1083         xsubr
1084       end
1085       if $vec == PVEC_CHAR_TABLE
1086         xchartable
1087       end
1088       if $vec == PVEC_BOOL_VECTOR
1089         xboolvector
1090       end
1091       if $vec == PVEC_BUFFER
1092         xbuffer
1093       end
1094       if $vec == PVEC_HASH_TABLE
1095         xhashtable
1096       end
1097     else
1098       xvector
1099     end
1100   end
1102 document xpr
1103 Print $ as a lisp object of any type.
1106 define xprintstr
1107   set $data = (char *) $arg0->data
1108   output ($arg0->size > 1000) ? 0 : ($data[0])@($arg0->size_byte < 0 ? $arg0->size & ~gdb_array_mark_flag : $arg0->size_byte)
1111 define xprintsym
1112   xgetptr $arg0
1113   set $sym = (struct Lisp_Symbol *) $ptr
1114   xgetptr $sym->xname
1115   set $sym_name = (struct Lisp_String *) $ptr
1116   xprintstr $sym_name
1118 document xprintsym
1119   Print argument as a symbol.
1122 define xcoding
1123   set $tmp = (struct Lisp_Hash_Table *) ((Vcoding_system_hash_table & $valmask) | gdb_data_seg_bits)
1124   set $tmp = (struct Lisp_Vector *) (($tmp->key_and_value & $valmask) | gdb_data_seg_bits)
1125   set $name = $tmp->contents[$arg0 * 2]
1126   print $name
1127   pr
1128   print $tmp->contents[$arg0 * 2 + 1]
1129   pr
1131 document xcoding
1132   Print the name and attributes of coding system that has ID (argument).
1135 define xcharset
1136   set $tmp = (struct Lisp_Hash_Table *) ((Vcharset_hash_table & $valmask) | gdb_data_seg_bits)
1137   set $tmp = (struct Lisp_Vector *) (($tmp->key_and_value & $valmask) | gdb_data_seg_bits)
1138   p $tmp->contents[charset_table[$arg0].hash_index * 2]
1139   pr
1141 document xcharset
1142   Print the name of charset that has ID (argument).
1145 define xfontset
1146   xgetptr $
1147   set $tbl = (struct Lisp_Char_Table *) $ptr
1148   print $tbl
1149   xgetint $tbl->extras[0]
1150   printf " ID:%d", $int
1151   xgettype $tbl->extras[1]
1152   xgetptr $tbl->extras[1]
1153   if $type == Lisp_String
1154     set $ptr = (struct Lisp_String *) $ptr
1155     printf " Name:"
1156     xprintstr $ptr
1157   else
1158     xgetptr $tbl->extras[2]
1159     set $ptr = (struct Lisp_Char_Table *) $ptr
1160     xgetptr $ptr->extras[1]
1161     set $ptr = (struct Lisp_String *) $ptr
1162     printf " Realized from:"
1163     xprintstr $ptr
1164   end
1165   echo \n
1168 define xfont
1169   xgetptr $
1170   set $size = (((struct Lisp_Vector *) $ptr)->size & 0x1FF)
1171   if $size == FONT_SPEC_MAX
1172     print (struct font_spec *) $ptr
1173   else
1174     if $size == FONT_ENTITY_MAX
1175       print (struct font_entity *) $ptr
1176     else
1177       print (struct font *) $ptr
1178     end
1179   end
1181 document xfont
1182 Print $ assuming it is a list font (font-spec, font-entity, or font-object).
1185 define xbacktrace
1186   set $bt = backtrace_list
1187   while $bt
1188     xgettype (*$bt->function)
1189     if $type == Lisp_Symbol
1190       xprintsym (*$bt->function)
1191       printf " (0x%x)\n", $bt->args
1192     else
1193       printf "0x%x ", *$bt->function
1194       if $type == Lisp_Vectorlike
1195         xgetptr (*$bt->function)
1196         set $size = ((struct Lisp_Vector *) $ptr)->size
1197         output ($size & PVEC_FLAG) ? (enum pvec_type) ($size & PVEC_TYPE_MASK) : $size & ~gdb_array_mark_flag
1198       else
1199         printf "Lisp type %d", $type
1200       end
1201       echo \n
1202     end
1203     set $bt = $bt->next
1204   end
1206 document xbacktrace
1207   Print a backtrace of Lisp function calls from backtrace_list.
1208   Set a breakpoint at Fsignal and call this to see from where
1209   an error was signaled.
1212 define which
1213   set debug_print (which_symbols ($arg0))
1215 document which
1216   Print symbols which references a given lisp object
1217   either as its symbol value or symbol function.
1220 define xbytecode
1221   set $bt = byte_stack_list
1222   while $bt
1223     xgettype ($bt->byte_string)
1224     printf "0x%x => ", $bt->byte_string
1225     which $bt->byte_string
1226     set $bt = $bt->next
1227   end
1229 document xbytecode
1230   Print a backtrace of the byte code stack.
1233 # Show Lisp backtrace after normal backtrace.
1234 define hookpost-backtrace
1235   set $bt = backtrace_list
1236   if $bt
1237     echo \n
1238     echo Lisp Backtrace:\n
1239     xbacktrace
1240   end
1243 define xreload
1244   set $tagmask = (((long)1 << gdb_gctypebits) - 1)
1245   set $valmask = gdb_use_lsb ? ~($tagmask) : ((long)1 << gdb_valbits) - 1
1247 document xreload
1248   When starting Emacs a second time in the same gdb session under
1249   FreeBSD 2.2.5, gdb 4.13, $valmask have lost
1250   their values.  (The same happens on current (2000) versions of GNU/Linux
1251   with gdb 5.0.)
1252   This function reloads them.
1254 xreload
1256 # Flush display (X only)
1257 define ff
1258   set x_flush (0)
1260 document ff
1261 Flush pending X window display updates to screen.
1262 Works only when an inferior emacs is executing.
1266 define hook-run
1267   xreload
1270 # Call xreload if a new Emacs executable is loaded.
1271 define hookpost-run
1272   xreload
1275 set print pretty on
1276 set print sevenbit-strings
1278 show environment DISPLAY
1279 show environment TERM
1281 # People get bothered when they see messages about non-existent functions...
1282 xgetptr Vsystem_type
1283 # $ptr is NULL in temacs
1284 if ($ptr != 0)
1285   set $tem = (struct Lisp_Symbol *) $ptr
1286   xgetptr $tem->xname
1287   set $tem = (struct Lisp_String *) $ptr
1288   set $tem = (char *) $tem->data
1290   # Don't let abort actually run, as it will make stdio stop working and
1291   # therefore the `pr' command above as well.
1292   if $tem[0] == 'w' && $tem[1] == 'i' && $tem[2] == 'n' && $tem[3] == 'd'
1293     # The windows-nt build replaces abort with its own function.
1294     break w32_abort
1295   else
1296     break abort
1297   end
1300 # x_error_quitter is defined only on X.  But window-system is set up
1301 # only at run time, during Emacs startup, so we need to defer setting
1302 # the breakpoint.  init_sys_modes is the first function called on
1303 # every platform after init_display, where window-system is set.
1304 tbreak init_sys_modes
1305 commands
1306   silent
1307   xgetptr Vinitial_window_system
1308   set $tem = (struct Lisp_Symbol *) $ptr
1309   xgetptr $tem->xname
1310   set $tem = (struct Lisp_String *) $ptr
1311   set $tem = (char *) $tem->data
1312   # If we are running in synchronous mode, we want a chance to look
1313   # around before Emacs exits.  Perhaps we should put the break
1314   # somewhere else instead...
1315   if $tem[0] == 'x' && $tem[1] == '\0'
1316     break x_error_quitter
1317   end
1318   continue
1320 # arch-tag: 12f34321-7bfa-4240-b77a-3cd3a1696dfe