gdb/
[platform/upstream/binutils.git] / gdb / jit.c
1 /* Handle JIT code generation in the inferior for GDB, the GNU Debugger.
2
3    Copyright (C) 2009-2012 Free Software Foundation, Inc.
4
5    This file is part of GDB.
6
7    This program 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 of the License, or
10    (at your option) any later version.
11
12    This program 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.
16
17    You should have received a copy of the GNU General Public License
18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
19
20 #include "defs.h"
21
22 #include "jit.h"
23 #include "jit-reader.h"
24 #include "block.h"
25 #include "breakpoint.h"
26 #include "command.h"
27 #include "dictionary.h"
28 #include "frame-unwind.h"
29 #include "gdbcmd.h"
30 #include "gdbcore.h"
31 #include "inferior.h"
32 #include "observer.h"
33 #include "objfiles.h"
34 #include "regcache.h"
35 #include "symfile.h"
36 #include "symtab.h"
37 #include "target.h"
38 #include "gdb-dlfcn.h"
39 #include "gdb_stat.h"
40 #include "exceptions.h"
41
42 static const char *jit_reader_dir = NULL;
43
44 static const struct objfile_data *jit_objfile_data;
45
46 static const char *const jit_break_name = "__jit_debug_register_code";
47
48 static const char *const jit_descriptor_name = "__jit_debug_descriptor";
49
50 static const struct inferior_data *jit_inferior_data = NULL;
51
52 static void jit_inferior_init (struct gdbarch *gdbarch);
53
54 /* An unwinder is registered for every gdbarch.  This key is used to
55    remember if the unwinder has been registered for a particular
56    gdbarch.  */
57
58 static struct gdbarch_data *jit_gdbarch_data;
59
60 /* Non-zero if we want to see trace of jit level stuff.  */
61
62 static int jit_debug = 0;
63
64 static void
65 show_jit_debug (struct ui_file *file, int from_tty,
66                 struct cmd_list_element *c, const char *value)
67 {
68   fprintf_filtered (file, _("JIT debugging is %s.\n"), value);
69 }
70
71 struct target_buffer
72 {
73   CORE_ADDR base;
74   ULONGEST size;
75 };
76
77 /* Openning the file is a no-op.  */
78
79 static void *
80 mem_bfd_iovec_open (struct bfd *abfd, void *open_closure)
81 {
82   return open_closure;
83 }
84
85 /* Closing the file is just freeing the base/size pair on our side.  */
86
87 static int
88 mem_bfd_iovec_close (struct bfd *abfd, void *stream)
89 {
90   xfree (stream);
91   return 1;
92 }
93
94 /* For reading the file, we just need to pass through to target_read_memory and
95    fix up the arguments and return values.  */
96
97 static file_ptr
98 mem_bfd_iovec_pread (struct bfd *abfd, void *stream, void *buf,
99                      file_ptr nbytes, file_ptr offset)
100 {
101   int err;
102   struct target_buffer *buffer = (struct target_buffer *) stream;
103
104   /* If this read will read all of the file, limit it to just the rest.  */
105   if (offset + nbytes > buffer->size)
106     nbytes = buffer->size - offset;
107
108   /* If there are no more bytes left, we've reached EOF.  */
109   if (nbytes == 0)
110     return 0;
111
112   err = target_read_memory (buffer->base + offset, (gdb_byte *) buf, nbytes);
113   if (err)
114     return -1;
115
116   return nbytes;
117 }
118
119 /* For statting the file, we only support the st_size attribute.  */
120
121 static int
122 mem_bfd_iovec_stat (struct bfd *abfd, void *stream, struct stat *sb)
123 {
124   struct target_buffer *buffer = (struct target_buffer*) stream;
125
126   sb->st_size = buffer->size;
127   return 0;
128 }
129
130 /* Open a BFD from the target's memory.  */
131
132 static struct bfd *
133 bfd_open_from_target_memory (CORE_ADDR addr, ULONGEST size, char *target)
134 {
135   const char *filename = xstrdup ("<in-memory>");
136   struct target_buffer *buffer = xmalloc (sizeof (struct target_buffer));
137
138   buffer->base = addr;
139   buffer->size = size;
140   return bfd_openr_iovec (filename, target,
141                           mem_bfd_iovec_open,
142                           buffer,
143                           mem_bfd_iovec_pread,
144                           mem_bfd_iovec_close,
145                           mem_bfd_iovec_stat);
146 }
147
148 /* One reader that has been loaded successfully, and can potentially be used to
149    parse debug info.  */
150
151 static struct jit_reader
152 {
153   struct gdb_reader_funcs *functions;
154   void *handle;
155 } *loaded_jit_reader = NULL;
156
157 typedef struct gdb_reader_funcs * (reader_init_fn_type) (void);
158 static const char *reader_init_fn_sym = "gdb_init_reader";
159
160 /* Try to load FILE_NAME as a JIT debug info reader.  */
161
162 static struct jit_reader *
163 jit_reader_load (const char *file_name)
164 {
165   void *so;
166   reader_init_fn_type *init_fn;
167   struct jit_reader *new_reader = NULL;
168   struct gdb_reader_funcs *funcs = NULL;
169   struct cleanup *old_cleanups;
170
171   if (jit_debug)
172     fprintf_unfiltered (gdb_stdlog, _("Opening shared object %s.\n"),
173                         file_name);
174   so = gdb_dlopen (file_name);
175   old_cleanups = make_cleanup_dlclose (so);
176
177   init_fn = gdb_dlsym (so, reader_init_fn_sym);
178   if (!init_fn)
179     error (_("Could not locate initialization function: %s."),
180           reader_init_fn_sym);
181
182   if (gdb_dlsym (so, "plugin_is_GPL_compatible") == NULL)
183     error (_("Reader not GPL compatible."));
184
185   funcs = init_fn ();
186   if (funcs->reader_version != GDB_READER_INTERFACE_VERSION)
187     error (_("Reader version does not match GDB version."));
188
189   new_reader = XZALLOC (struct jit_reader);
190   new_reader->functions = funcs;
191   new_reader->handle = so;
192
193   discard_cleanups (old_cleanups);
194   return new_reader;
195 }
196
197 /* Provides the jit-reader-load command.  */
198
199 static void
200 jit_reader_load_command (char *args, int from_tty)
201 {
202   char *so_name;
203   struct cleanup *prev_cleanup;
204
205   if (args == NULL)
206     error (_("No reader name provided."));
207
208   if (loaded_jit_reader != NULL)
209     error (_("JIT reader already loaded.  Run jit-reader-unload first."));
210
211   so_name = xstrprintf ("%s/%s", jit_reader_dir, args);
212   prev_cleanup = make_cleanup (xfree, so_name);
213
214   loaded_jit_reader = jit_reader_load (so_name);
215   do_cleanups (prev_cleanup);
216 }
217
218 /* Provides the jit-reader-unload command.  */
219
220 static void
221 jit_reader_unload_command (char *args, int from_tty)
222 {
223   if (!loaded_jit_reader)
224     error (_("No JIT reader loaded."));
225
226   loaded_jit_reader->functions->destroy (loaded_jit_reader->functions);
227
228   gdb_dlclose (loaded_jit_reader->handle);
229   xfree (loaded_jit_reader);
230   loaded_jit_reader = NULL;
231 }
232
233 /* Per-inferior structure recording which objfile has the JIT
234    symbols.  */
235
236 struct jit_inferior_data
237 {
238   /* The objfile.  This is NULL if no objfile holds the JIT
239      symbols.  */
240
241   struct objfile *objfile;
242 };
243
244 /* Per-objfile structure recording the addresses in the inferior.  */
245
246 struct jit_objfile_data
247 {
248   /* Symbol for __jit_debug_register_code.  */
249   struct minimal_symbol *register_code;
250
251   /* Symbol for __jit_debug_descriptor.  */
252   struct minimal_symbol *descriptor;
253
254   /* Address of struct jit_code_entry in this objfile.  */
255   CORE_ADDR addr;
256 };
257
258 /* Fetch the jit_objfile_data associated with OBJF.  If no data exists
259    yet, make a new structure and attach it.  */
260
261 static struct jit_objfile_data *
262 get_jit_objfile_data (struct objfile *objf)
263 {
264   struct jit_objfile_data *objf_data;
265
266   objf_data = objfile_data (objf, jit_objfile_data);
267   if (objf_data == NULL)
268     {
269       objf_data = XZALLOC (struct jit_objfile_data);
270       set_objfile_data (objf, jit_objfile_data, objf_data);
271     }
272
273   return objf_data;
274 }
275
276 /* Remember OBJFILE has been created for struct jit_code_entry located
277    at inferior address ENTRY.  */
278
279 static void
280 add_objfile_entry (struct objfile *objfile, CORE_ADDR entry)
281 {
282   struct jit_objfile_data *objf_data;
283
284   objf_data = get_jit_objfile_data (objfile);
285   objf_data->addr = entry;
286 }
287
288 /* Return jit_inferior_data for current inferior.  Allocate if not already
289    present.  */
290
291 static struct jit_inferior_data *
292 get_jit_inferior_data (void)
293 {
294   struct inferior *inf;
295   struct jit_inferior_data *inf_data;
296
297   inf = current_inferior ();
298   inf_data = inferior_data (inf, jit_inferior_data);
299   if (inf_data == NULL)
300     {
301       inf_data = XZALLOC (struct jit_inferior_data);
302       set_inferior_data (inf, jit_inferior_data, inf_data);
303     }
304
305   return inf_data;
306 }
307
308 static void
309 jit_inferior_data_cleanup (struct inferior *inf, void *arg)
310 {
311   xfree (arg);
312 }
313
314 /* Helper function for reading the global JIT descriptor from remote
315    memory.  Returns 1 if all went well, 0 otherwise.  */
316
317 static int
318 jit_read_descriptor (struct gdbarch *gdbarch,
319                      struct jit_descriptor *descriptor,
320                      struct jit_inferior_data *inf_data)
321 {
322   int err;
323   struct type *ptr_type;
324   int ptr_size;
325   int desc_size;
326   gdb_byte *desc_buf;
327   enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
328   struct jit_objfile_data *objf_data;
329
330   if (inf_data->objfile == NULL)
331     return 0;
332   objf_data = get_jit_objfile_data (inf_data->objfile);
333   if (objf_data->descriptor == NULL)
334     return 0;
335
336   if (jit_debug)
337     fprintf_unfiltered (gdb_stdlog,
338                         "jit_read_descriptor, descriptor_addr = %s\n",
339                         paddress (gdbarch, SYMBOL_VALUE_ADDRESS (objf_data->descriptor)));
340
341   /* Figure out how big the descriptor is on the remote and how to read it.  */
342   ptr_type = builtin_type (gdbarch)->builtin_data_ptr;
343   ptr_size = TYPE_LENGTH (ptr_type);
344   desc_size = 8 + 2 * ptr_size;  /* Two 32-bit ints and two pointers.  */
345   desc_buf = alloca (desc_size);
346
347   /* Read the descriptor.  */
348   err = target_read_memory (SYMBOL_VALUE_ADDRESS (objf_data->descriptor),
349                             desc_buf, desc_size);
350   if (err)
351     {
352       printf_unfiltered (_("Unable to read JIT descriptor from "
353                            "remote memory\n"));
354       return 0;
355     }
356
357   /* Fix the endianness to match the host.  */
358   descriptor->version = extract_unsigned_integer (&desc_buf[0], 4, byte_order);
359   descriptor->action_flag =
360       extract_unsigned_integer (&desc_buf[4], 4, byte_order);
361   descriptor->relevant_entry = extract_typed_address (&desc_buf[8], ptr_type);
362   descriptor->first_entry =
363       extract_typed_address (&desc_buf[8 + ptr_size], ptr_type);
364
365   return 1;
366 }
367
368 /* Helper function for reading a JITed code entry from remote memory.  */
369
370 static void
371 jit_read_code_entry (struct gdbarch *gdbarch,
372                      CORE_ADDR code_addr, struct jit_code_entry *code_entry)
373 {
374   int err, off;
375   struct type *ptr_type;
376   int ptr_size;
377   int entry_size;
378   int align_bytes;
379   gdb_byte *entry_buf;
380   enum bfd_endian byte_order = gdbarch_byte_order (gdbarch);
381
382   /* Figure out how big the entry is on the remote and how to read it.  */
383   ptr_type = builtin_type (gdbarch)->builtin_data_ptr;
384   ptr_size = TYPE_LENGTH (ptr_type);
385
386   /* Figure out where the longlong value will be.  */
387   align_bytes = gdbarch_long_long_align_bit (gdbarch) / 8;
388   off = 3 * ptr_size;
389   off = (off + (align_bytes - 1)) & ~(align_bytes - 1);
390
391   entry_size = off + 8;  /* Three pointers and one 64-bit int.  */
392   entry_buf = alloca (entry_size);
393
394   /* Read the entry.  */
395   err = target_read_memory (code_addr, entry_buf, entry_size);
396   if (err)
397     error (_("Unable to read JIT code entry from remote memory!"));
398
399   /* Fix the endianness to match the host.  */
400   ptr_type = builtin_type (gdbarch)->builtin_data_ptr;
401   code_entry->next_entry = extract_typed_address (&entry_buf[0], ptr_type);
402   code_entry->prev_entry =
403       extract_typed_address (&entry_buf[ptr_size], ptr_type);
404   code_entry->symfile_addr =
405       extract_typed_address (&entry_buf[2 * ptr_size], ptr_type);
406   code_entry->symfile_size =
407       extract_unsigned_integer (&entry_buf[off], 8, byte_order);
408 }
409
410 /* Proxy object for building a block.  */
411
412 struct gdb_block
413 {
414   /* gdb_blocks are linked into a tree structure.  Next points to the
415      next node at the same depth as this block and parent to the
416      parent gdb_block.  */
417   struct gdb_block *next, *parent;
418
419   /* Points to the "real" block that is being built out of this
420      instance.  This block will be added to a blockvector, which will
421      then be added to a symtab.  */
422   struct block *real_block;
423
424   /* The first and last code address corresponding to this block.  */
425   CORE_ADDR begin, end;
426
427   /* The name of this block (if any).  If this is non-NULL, the
428      FUNCTION symbol symbol is set to this value.  */
429   const char *name;
430 };
431
432 /* Proxy object for building a symtab.  */
433
434 struct gdb_symtab
435 {
436   /* The list of blocks in this symtab.  These will eventually be
437      converted to real blocks.  */
438   struct gdb_block *blocks;
439
440   /* The number of blocks inserted.  */
441   int nblocks;
442
443   /* A mapping between line numbers to PC.  */
444   struct linetable *linetable;
445
446   /* The source file for this symtab.  */
447   const char *file_name;
448   struct gdb_symtab *next;
449 };
450
451 /* Proxy object for building an object.  */
452
453 struct gdb_object
454 {
455   struct gdb_symtab *symtabs;
456 };
457
458 /* The type of the `private' data passed around by the callback
459    functions.  */
460
461 typedef CORE_ADDR jit_dbg_reader_data;
462
463 /* The reader calls into this function to read data off the targets
464    address space.  */
465
466 static enum gdb_status
467 jit_target_read_impl (GDB_CORE_ADDR target_mem, void *gdb_buf, int len)
468 {
469   int result = target_read_memory ((CORE_ADDR) target_mem, gdb_buf, len);
470   if (result == 0)
471     return GDB_SUCCESS;
472   else
473     return GDB_FAIL;
474 }
475
476 /* The reader calls into this function to create a new gdb_object
477    which it can then pass around to the other callbacks.  Right now,
478    all that is required is allocating the memory.  */
479
480 static struct gdb_object *
481 jit_object_open_impl (struct gdb_symbol_callbacks *cb)
482 {
483   /* CB is not required right now, but sometime in the future we might
484      need a handle to it, and we'd like to do that without breaking
485      the ABI.  */
486   return XZALLOC (struct gdb_object);
487 }
488
489 /* Readers call into this function to open a new gdb_symtab, which,
490    again, is passed around to other callbacks.  */
491
492 static struct gdb_symtab *
493 jit_symtab_open_impl (struct gdb_symbol_callbacks *cb,
494                       struct gdb_object *object,
495                       const char *file_name)
496 {
497   struct gdb_symtab *ret;
498
499   /* CB stays unused.  See comment in jit_object_open_impl.  */
500
501   ret = XZALLOC (struct gdb_symtab);
502   ret->file_name = file_name ? xstrdup (file_name) : xstrdup ("");
503   ret->next = object->symtabs;
504   object->symtabs = ret;
505   return ret;
506 }
507
508 /* Returns true if the block corresponding to old should be placed
509    before the block corresponding to new in the final blockvector.  */
510
511 static int
512 compare_block (const struct gdb_block *const old,
513                const struct gdb_block *const new)
514 {
515   if (old == NULL)
516     return 1;
517   if (old->begin < new->begin)
518     return 1;
519   else if (old->begin == new->begin)
520     {
521       if (old->end > new->end)
522         return 1;
523       else
524         return 0;
525     }
526   else
527     return 0;
528 }
529
530 /* Called by readers to open a new gdb_block.  This function also
531    inserts the new gdb_block in the correct place in the corresponding
532    gdb_symtab.  */
533
534 static struct gdb_block *
535 jit_block_open_impl (struct gdb_symbol_callbacks *cb,
536                      struct gdb_symtab *symtab, struct gdb_block *parent,
537                      GDB_CORE_ADDR begin, GDB_CORE_ADDR end, const char *name)
538 {
539   struct gdb_block *block = XZALLOC (struct gdb_block);
540
541   block->next = symtab->blocks;
542   block->begin = (CORE_ADDR) begin;
543   block->end = (CORE_ADDR) end;
544   block->name = name ? xstrdup (name) : NULL;
545   block->parent = parent;
546
547   /* Ensure that the blocks are inserted in the correct (reverse of
548      the order expected by blockvector).  */
549   if (compare_block (symtab->blocks, block))
550     {
551       symtab->blocks = block;
552     }
553   else
554     {
555       struct gdb_block *i = symtab->blocks;
556
557       for (;; i = i->next)
558         {
559           /* Guaranteed to terminate, since compare_block (NULL, _)
560              returns 1.  */
561           if (compare_block (i->next, block))
562             {
563               block->next = i->next;
564               i->next = block;
565               break;
566             }
567         }
568     }
569   symtab->nblocks++;
570
571   return block;
572 }
573
574 /* Readers call this to add a line mapping (from PC to line number) to
575    a gdb_symtab.  */
576
577 static void
578 jit_symtab_line_mapping_add_impl (struct gdb_symbol_callbacks *cb,
579                                   struct gdb_symtab *stab, int nlines,
580                                   struct gdb_line_mapping *map)
581 {
582   int i;
583
584   if (nlines < 1)
585     return;
586
587   stab->linetable = xmalloc (sizeof (struct linetable)
588                              + (nlines - 1) * sizeof (struct linetable_entry));
589   stab->linetable->nitems = nlines;
590   for (i = 0; i < nlines; i++)
591     {
592       stab->linetable->item[i].pc = (CORE_ADDR) map[i].pc;
593       stab->linetable->item[i].line = map[i].line;
594     }
595 }
596
597 /* Called by readers to close a gdb_symtab.  Does not need to do
598    anything as of now.  */
599
600 static void
601 jit_symtab_close_impl (struct gdb_symbol_callbacks *cb,
602                        struct gdb_symtab *stab)
603 {
604   /* Right now nothing needs to be done here.  We may need to do some
605      cleanup here in the future (again, without breaking the plugin
606      ABI).  */
607 }
608
609 /* Transform STAB to a proper symtab, and add it it OBJFILE.  */
610
611 static void
612 finalize_symtab (struct gdb_symtab *stab, struct objfile *objfile)
613 {
614   struct symtab *symtab;
615   struct gdb_block *gdb_block_iter, *gdb_block_iter_tmp;
616   struct block *block_iter;
617   int actual_nblocks, i, blockvector_size;
618   CORE_ADDR begin, end;
619
620   actual_nblocks = FIRST_LOCAL_BLOCK + stab->nblocks;
621
622   symtab = allocate_symtab (stab->file_name, objfile);
623   /* JIT compilers compile in memory.  */
624   symtab->dirname = NULL;
625
626   /* Copy over the linetable entry if one was provided.  */
627   if (stab->linetable)
628     {
629       int size = ((stab->linetable->nitems - 1)
630                   * sizeof (struct linetable_entry)
631                   + sizeof (struct linetable));
632       LINETABLE (symtab) = obstack_alloc (&objfile->objfile_obstack, size);
633       memcpy (LINETABLE (symtab), stab->linetable, size);
634     }
635   else
636     {
637       LINETABLE (symtab) = NULL;
638     }
639
640   blockvector_size = (sizeof (struct blockvector)
641                       + (actual_nblocks - 1) * sizeof (struct block *));
642   symtab->blockvector = obstack_alloc (&objfile->objfile_obstack,
643                                        blockvector_size);
644
645   /* (begin, end) will contain the PC range this entire blockvector
646      spans.  */
647   symtab->primary = 1;
648   BLOCKVECTOR_MAP (symtab->blockvector) = NULL;
649   begin = stab->blocks->begin;
650   end = stab->blocks->end;
651   BLOCKVECTOR_NBLOCKS (symtab->blockvector) = actual_nblocks;
652
653   /* First run over all the gdb_block objects, creating a real block
654      object for each.  Simultaneously, keep setting the real_block
655      fields.  */
656   for (i = (actual_nblocks - 1), gdb_block_iter = stab->blocks;
657        i >= FIRST_LOCAL_BLOCK;
658        i--, gdb_block_iter = gdb_block_iter->next)
659     {
660       struct block *new_block = allocate_block (&objfile->objfile_obstack);
661       struct symbol *block_name = obstack_alloc (&objfile->objfile_obstack,
662                                                  sizeof (struct symbol));
663
664       BLOCK_DICT (new_block) = dict_create_linear (&objfile->objfile_obstack,
665                                                    NULL);
666       /* The address range.  */
667       BLOCK_START (new_block) = (CORE_ADDR) gdb_block_iter->begin;
668       BLOCK_END (new_block) = (CORE_ADDR) gdb_block_iter->end;
669
670       /* The name.  */
671       memset (block_name, 0, sizeof (struct symbol));
672       SYMBOL_DOMAIN (block_name) = VAR_DOMAIN;
673       SYMBOL_CLASS (block_name) = LOC_BLOCK;
674       SYMBOL_SYMTAB (block_name) = symtab;
675       SYMBOL_BLOCK_VALUE (block_name) = new_block;
676
677       block_name->ginfo.name = obsavestring (gdb_block_iter->name,
678                                              strlen (gdb_block_iter->name),
679                                              &objfile->objfile_obstack);
680
681       BLOCK_FUNCTION (new_block) = block_name;
682
683       BLOCKVECTOR_BLOCK (symtab->blockvector, i) = new_block;
684       if (begin > BLOCK_START (new_block))
685         begin = BLOCK_START (new_block);
686       if (end < BLOCK_END (new_block))
687         end = BLOCK_END (new_block);
688
689       gdb_block_iter->real_block = new_block;
690     }
691
692   /* Now add the special blocks.  */
693   block_iter = NULL;
694   for (i = 0; i < FIRST_LOCAL_BLOCK; i++)
695     {
696       struct block *new_block;
697
698       new_block = (i == GLOBAL_BLOCK
699                    ? allocate_global_block (&objfile->objfile_obstack)
700                    : allocate_block (&objfile->objfile_obstack));
701       BLOCK_DICT (new_block) = dict_create_linear (&objfile->objfile_obstack,
702                                                    NULL);
703       BLOCK_SUPERBLOCK (new_block) = block_iter;
704       block_iter = new_block;
705
706       BLOCK_START (new_block) = (CORE_ADDR) begin;
707       BLOCK_END (new_block) = (CORE_ADDR) end;
708
709       BLOCKVECTOR_BLOCK (symtab->blockvector, i) = new_block;
710
711       if (i == GLOBAL_BLOCK)
712         set_block_symtab (new_block, symtab);
713     }
714
715   /* Fill up the superblock fields for the real blocks, using the
716      real_block fields populated earlier.  */
717   for (gdb_block_iter = stab->blocks;
718        gdb_block_iter;
719        gdb_block_iter = gdb_block_iter->next)
720     {
721       if (gdb_block_iter->parent != NULL)
722         BLOCK_SUPERBLOCK (gdb_block_iter->real_block) =
723           gdb_block_iter->parent->real_block;
724     }
725
726   /* Free memory.  */
727   gdb_block_iter = stab->blocks;
728
729   for (gdb_block_iter = stab->blocks, gdb_block_iter_tmp = gdb_block_iter->next;
730        gdb_block_iter;
731        gdb_block_iter = gdb_block_iter_tmp)
732     {
733       xfree ((void *) gdb_block_iter->name);
734       xfree (gdb_block_iter);
735     }
736   xfree (stab->linetable);
737   xfree ((char *) stab->file_name);
738   xfree (stab);
739 }
740
741 /* Called when closing a gdb_objfile.  Converts OBJ to a proper
742    objfile.  */
743
744 static void
745 jit_object_close_impl (struct gdb_symbol_callbacks *cb,
746                        struct gdb_object *obj)
747 {
748   struct gdb_symtab *i, *j;
749   struct objfile *objfile;
750   jit_dbg_reader_data *priv_data;
751
752   priv_data = cb->priv_data;
753
754   objfile = allocate_objfile (NULL, 0);
755   objfile->gdbarch = target_gdbarch;
756
757   terminate_minimal_symbol_table (objfile);
758
759   xfree (objfile->name);
760   objfile->name = xstrdup ("<< JIT compiled code >>");
761
762   j = NULL;
763   for (i = obj->symtabs; i; i = j)
764     {
765       j = i->next;
766       finalize_symtab (i, objfile);
767     }
768   add_objfile_entry (objfile, *priv_data);
769   xfree (obj);
770 }
771
772 /* Try to read CODE_ENTRY using the loaded jit reader (if any).
773    ENTRY_ADDR is the address of the struct jit_code_entry in the
774    inferior address space.  */
775
776 static int
777 jit_reader_try_read_symtab (struct jit_code_entry *code_entry,
778                             CORE_ADDR entry_addr)
779 {
780   void *gdb_mem;
781   int status;
782   jit_dbg_reader_data priv_data;
783   struct gdb_reader_funcs *funcs;
784   volatile struct gdb_exception e;
785   struct gdb_symbol_callbacks callbacks =
786     {
787       jit_object_open_impl,
788       jit_symtab_open_impl,
789       jit_block_open_impl,
790       jit_symtab_close_impl,
791       jit_object_close_impl,
792
793       jit_symtab_line_mapping_add_impl,
794       jit_target_read_impl,
795
796       &priv_data
797     };
798
799   priv_data = entry_addr;
800
801   if (!loaded_jit_reader)
802     return 0;
803
804   gdb_mem = xmalloc (code_entry->symfile_size);
805
806   status = 1;
807   TRY_CATCH (e, RETURN_MASK_ALL)
808     if (target_read_memory (code_entry->symfile_addr, gdb_mem,
809                             code_entry->symfile_size))
810       status = 0;
811   if (e.reason < 0)
812     status = 0;
813
814   if (status)
815     {
816       funcs = loaded_jit_reader->functions;
817       if (funcs->read (funcs, &callbacks, gdb_mem, code_entry->symfile_size)
818           != GDB_SUCCESS)
819         status = 0;
820     }
821
822   xfree (gdb_mem);
823   if (jit_debug && status == 0)
824     fprintf_unfiltered (gdb_stdlog,
825                         "Could not read symtab using the loaded JIT reader.\n");
826   return status;
827 }
828
829 /* Try to read CODE_ENTRY using BFD.  ENTRY_ADDR is the address of the
830    struct jit_code_entry in the inferior address space.  */
831
832 static void
833 jit_bfd_try_read_symtab (struct jit_code_entry *code_entry,
834                          CORE_ADDR entry_addr,
835                          struct gdbarch *gdbarch)
836 {
837   bfd *nbfd;
838   struct section_addr_info *sai;
839   struct bfd_section *sec;
840   struct objfile *objfile;
841   struct cleanup *old_cleanups;
842   int i;
843   const struct bfd_arch_info *b;
844
845   if (jit_debug)
846     fprintf_unfiltered (gdb_stdlog,
847                         "jit_register_code, symfile_addr = %s, "
848                         "symfile_size = %s\n",
849                         paddress (gdbarch, code_entry->symfile_addr),
850                         pulongest (code_entry->symfile_size));
851
852   nbfd = bfd_open_from_target_memory (code_entry->symfile_addr,
853                                       code_entry->symfile_size, gnutarget);
854   if (nbfd == NULL)
855     {
856       puts_unfiltered (_("Error opening JITed symbol file, ignoring it.\n"));
857       return;
858     }
859
860   /* Check the format.  NOTE: This initializes important data that GDB uses!
861      We would segfault later without this line.  */
862   if (!bfd_check_format (nbfd, bfd_object))
863     {
864       printf_unfiltered (_("\
865 JITed symbol file is not an object file, ignoring it.\n"));
866       bfd_close (nbfd);
867       return;
868     }
869
870   /* Check bfd arch.  */
871   b = gdbarch_bfd_arch_info (gdbarch);
872   if (b->compatible (b, bfd_get_arch_info (nbfd)) != b)
873     warning (_("JITed object file architecture %s is not compatible "
874                "with target architecture %s."), bfd_get_arch_info
875              (nbfd)->printable_name, b->printable_name);
876
877   /* Read the section address information out of the symbol file.  Since the
878      file is generated by the JIT at runtime, it should all of the absolute
879      addresses that we care about.  */
880   sai = alloc_section_addr_info (bfd_count_sections (nbfd));
881   old_cleanups = make_cleanup_free_section_addr_info (sai);
882   i = 0;
883   for (sec = nbfd->sections; sec != NULL; sec = sec->next)
884     if ((bfd_get_section_flags (nbfd, sec) & (SEC_ALLOC|SEC_LOAD)) != 0)
885       {
886         /* We assume that these virtual addresses are absolute, and do not
887            treat them as offsets.  */
888         sai->other[i].addr = bfd_get_section_vma (nbfd, sec);
889         sai->other[i].name = xstrdup (bfd_get_section_name (nbfd, sec));
890         sai->other[i].sectindex = sec->index;
891         ++i;
892       }
893
894   /* This call takes ownership of NBFD.  It does not take ownership of SAI.  */
895   objfile = symbol_file_add_from_bfd (nbfd, 0, sai, OBJF_SHARED, NULL);
896
897   do_cleanups (old_cleanups);
898   add_objfile_entry (objfile, entry_addr);
899 }
900
901 /* This function registers code associated with a JIT code entry.  It uses the
902    pointer and size pair in the entry to read the symbol file from the remote
903    and then calls symbol_file_add_from_local_memory to add it as though it were
904    a symbol file added by the user.  */
905
906 static void
907 jit_register_code (struct gdbarch *gdbarch,
908                    CORE_ADDR entry_addr, struct jit_code_entry *code_entry)
909 {
910   int i, success;
911   const struct bfd_arch_info *b;
912   struct jit_inferior_data *inf_data = get_jit_inferior_data ();
913
914   if (jit_debug)
915     fprintf_unfiltered (gdb_stdlog,
916                         "jit_register_code, symfile_addr = %s, "
917                         "symfile_size = %s\n",
918                         paddress (gdbarch, code_entry->symfile_addr),
919                         pulongest (code_entry->symfile_size));
920
921   success = jit_reader_try_read_symtab (code_entry, entry_addr);
922
923   if (!success)
924     jit_bfd_try_read_symtab (code_entry, entry_addr, gdbarch);
925 }
926
927 /* This function unregisters JITed code and frees the corresponding
928    objfile.  */
929
930 static void
931 jit_unregister_code (struct objfile *objfile)
932 {
933   free_objfile (objfile);
934 }
935
936 /* Look up the objfile with this code entry address.  */
937
938 static struct objfile *
939 jit_find_objf_with_entry_addr (CORE_ADDR entry_addr)
940 {
941   struct objfile *objf;
942
943   ALL_OBJFILES (objf)
944     {
945       struct jit_objfile_data *objf_data;
946
947       objf_data = objfile_data (objf, jit_objfile_data);
948       if (objf_data != NULL && objf_data->addr == entry_addr)
949         return objf;
950     }
951   return NULL;
952 }
953
954 /* (Re-)Initialize the jit breakpoint if necessary.
955    Return 0 on success.  */
956
957 static int
958 jit_breakpoint_re_set_internal (struct gdbarch *gdbarch,
959                                 struct jit_inferior_data *inf_data)
960 {
961   struct minimal_symbol *reg_symbol, *desc_symbol;
962   struct objfile *objf;
963   struct jit_objfile_data *objf_data;
964
965   if (inf_data->objfile != NULL)
966     return 0;
967
968   /* Lookup the registration symbol.  If it is missing, then we assume
969      we are not attached to a JIT.  */
970   reg_symbol = lookup_minimal_symbol_and_objfile (jit_break_name, &objf);
971   if (reg_symbol == NULL || SYMBOL_VALUE_ADDRESS (reg_symbol) == 0)
972     return 1;
973
974   desc_symbol = lookup_minimal_symbol (jit_descriptor_name, NULL, objf);
975   if (desc_symbol == NULL || SYMBOL_VALUE_ADDRESS (desc_symbol) == 0)
976     return 1;
977
978   objf_data = get_jit_objfile_data (objf);
979   objf_data->register_code = reg_symbol;
980   objf_data->descriptor = desc_symbol;
981
982   inf_data->objfile = objf;
983
984   jit_inferior_init (gdbarch);
985
986   if (jit_debug)
987     fprintf_unfiltered (gdb_stdlog,
988                         "jit_breakpoint_re_set_internal, "
989                         "breakpoint_addr = %s\n",
990                         paddress (gdbarch, SYMBOL_VALUE_ADDRESS (reg_symbol)));
991
992   /* Put a breakpoint in the registration symbol.  */
993   create_jit_event_breakpoint (gdbarch, SYMBOL_VALUE_ADDRESS (reg_symbol));
994
995   return 0;
996 }
997
998 /* The private data passed around in the frame unwind callback
999    functions.  */
1000
1001 struct jit_unwind_private
1002 {
1003   /* Cached register values.  See jit_frame_sniffer to see how this
1004      works.  */
1005   struct gdb_reg_value **registers;
1006
1007   /* The frame being unwound.  */
1008   struct frame_info *this_frame;
1009 };
1010
1011 /* Sets the value of a particular register in this frame.  */
1012
1013 static void
1014 jit_unwind_reg_set_impl (struct gdb_unwind_callbacks *cb, int dwarf_regnum,
1015                          struct gdb_reg_value *value)
1016 {
1017   struct jit_unwind_private *priv;
1018   int gdb_reg;
1019
1020   priv = cb->priv_data;
1021
1022   gdb_reg = gdbarch_dwarf2_reg_to_regnum (get_frame_arch (priv->this_frame),
1023                                           dwarf_regnum);
1024   if (gdb_reg == -1)
1025     {
1026       if (jit_debug)
1027         fprintf_unfiltered (gdb_stdlog,
1028                             _("Could not recognize DWARF regnum %d"),
1029                             dwarf_regnum);
1030       return;
1031     }
1032
1033   gdb_assert (priv->registers);
1034   priv->registers[gdb_reg] = value;
1035 }
1036
1037 static void
1038 reg_value_free_impl (struct gdb_reg_value *value)
1039 {
1040   xfree (value);
1041 }
1042
1043 /* Get the value of register REGNUM in the previous frame.  */
1044
1045 static struct gdb_reg_value *
1046 jit_unwind_reg_get_impl (struct gdb_unwind_callbacks *cb, int regnum)
1047 {
1048   struct jit_unwind_private *priv;
1049   struct gdb_reg_value *value;
1050   int gdb_reg, size;
1051   struct gdbarch *frame_arch;
1052
1053   priv = cb->priv_data;
1054   frame_arch = get_frame_arch (priv->this_frame);
1055
1056   gdb_reg = gdbarch_dwarf2_reg_to_regnum (frame_arch, regnum);
1057   size = register_size (frame_arch, gdb_reg);
1058   value = xmalloc (sizeof (struct gdb_reg_value) + size - 1);
1059   value->defined = frame_register_read (priv->this_frame, gdb_reg,
1060                                         value->value);
1061   value->size = size;
1062   value->free = reg_value_free_impl;
1063   return value;
1064 }
1065
1066 /* gdb_reg_value has a free function, which must be called on each
1067    saved register value.  */
1068
1069 static void
1070 jit_dealloc_cache (struct frame_info *this_frame, void *cache)
1071 {
1072   struct jit_unwind_private *priv_data = cache;
1073   struct gdbarch *frame_arch;
1074   int i;
1075
1076   gdb_assert (priv_data->registers);
1077   frame_arch = get_frame_arch (priv_data->this_frame);
1078
1079   for (i = 0; i < gdbarch_num_regs (frame_arch); i++)
1080     if (priv_data->registers[i] && priv_data->registers[i]->free)
1081       priv_data->registers[i]->free (priv_data->registers[i]);
1082
1083   xfree (priv_data->registers);
1084   xfree (priv_data);
1085 }
1086
1087 /* The frame sniffer for the pseudo unwinder.
1088
1089    While this is nominally a frame sniffer, in the case where the JIT
1090    reader actually recognizes the frame, it does a lot more work -- it
1091    unwinds the frame and saves the corresponding register values in
1092    the cache.  jit_frame_prev_register simply returns the saved
1093    register values.  */
1094
1095 static int
1096 jit_frame_sniffer (const struct frame_unwind *self,
1097                    struct frame_info *this_frame, void **cache)
1098 {
1099   struct jit_inferior_data *inf_data;
1100   struct jit_unwind_private *priv_data;
1101   struct gdb_unwind_callbacks callbacks;
1102   struct gdb_reader_funcs *funcs;
1103
1104   inf_data = get_jit_inferior_data ();
1105
1106   callbacks.reg_get = jit_unwind_reg_get_impl;
1107   callbacks.reg_set = jit_unwind_reg_set_impl;
1108   callbacks.target_read = jit_target_read_impl;
1109
1110   if (loaded_jit_reader == NULL)
1111     return 0;
1112
1113   funcs = loaded_jit_reader->functions;
1114
1115   gdb_assert (!*cache);
1116
1117   *cache = XZALLOC (struct jit_unwind_private);
1118   priv_data = *cache;
1119   priv_data->registers =
1120     XCALLOC (gdbarch_num_regs (get_frame_arch (this_frame)),
1121              struct gdb_reg_value *);
1122   priv_data->this_frame = this_frame;
1123
1124   callbacks.priv_data = priv_data;
1125
1126   /* Try to coax the provided unwinder to unwind the stack */
1127   if (funcs->unwind (funcs, &callbacks) == GDB_SUCCESS)
1128     {
1129       if (jit_debug)
1130         fprintf_unfiltered (gdb_stdlog, _("Successfully unwound frame using "
1131                                           "JIT reader.\n"));
1132       return 1;
1133     }
1134   if (jit_debug)
1135     fprintf_unfiltered (gdb_stdlog, _("Could not unwind frame using "
1136                                       "JIT reader.\n"));
1137
1138   jit_dealloc_cache (this_frame, *cache);
1139   *cache = NULL;
1140
1141   return 0;
1142 }
1143
1144
1145 /* The frame_id function for the pseudo unwinder.  Relays the call to
1146    the loaded plugin.  */
1147
1148 static void
1149 jit_frame_this_id (struct frame_info *this_frame, void **cache,
1150                    struct frame_id *this_id)
1151 {
1152   struct jit_unwind_private private;
1153   struct gdb_frame_id frame_id;
1154   struct gdb_reader_funcs *funcs;
1155   struct gdb_unwind_callbacks callbacks;
1156
1157   private.registers = NULL;
1158   private.this_frame = this_frame;
1159
1160   /* We don't expect the frame_id function to set any registers, so we
1161      set reg_set to NULL.  */
1162   callbacks.reg_get = jit_unwind_reg_get_impl;
1163   callbacks.reg_set = NULL;
1164   callbacks.target_read = jit_target_read_impl;
1165   callbacks.priv_data = &private;
1166
1167   gdb_assert (loaded_jit_reader);
1168   funcs = loaded_jit_reader->functions;
1169
1170   frame_id = funcs->get_frame_id (funcs, &callbacks);
1171   *this_id = frame_id_build (frame_id.stack_address, frame_id.code_address);
1172 }
1173
1174 /* Pseudo unwinder function.  Reads the previously fetched value for
1175    the register from the cache.  */
1176
1177 static struct value *
1178 jit_frame_prev_register (struct frame_info *this_frame, void **cache, int reg)
1179 {
1180   struct jit_unwind_private *priv = *cache;
1181   struct gdb_reg_value *value;
1182
1183   if (priv == NULL)
1184     return frame_unwind_got_optimized (this_frame, reg);
1185
1186   gdb_assert (priv->registers);
1187   value = priv->registers[reg];
1188   if (value && value->defined)
1189     return frame_unwind_got_bytes (this_frame, reg, value->value);
1190   else
1191     return frame_unwind_got_optimized (this_frame, reg);
1192 }
1193
1194 /* Relay everything back to the unwinder registered by the JIT debug
1195    info reader.*/
1196
1197 static const struct frame_unwind jit_frame_unwind =
1198 {
1199   NORMAL_FRAME,
1200   default_frame_unwind_stop_reason,
1201   jit_frame_this_id,
1202   jit_frame_prev_register,
1203   NULL,
1204   jit_frame_sniffer,
1205   jit_dealloc_cache
1206 };
1207
1208
1209 /* This is the information that is stored at jit_gdbarch_data for each
1210    architecture.  */
1211
1212 struct jit_gdbarch_data_type
1213 {
1214   /* Has the (pseudo) unwinder been prepended? */
1215   int unwinder_registered;
1216 };
1217
1218 /* Check GDBARCH and prepend the pseudo JIT unwinder if needed.  */
1219
1220 static void
1221 jit_prepend_unwinder (struct gdbarch *gdbarch)
1222 {
1223   struct jit_gdbarch_data_type *data;
1224
1225   data = gdbarch_data (gdbarch, jit_gdbarch_data);
1226   if (!data->unwinder_registered)
1227     {
1228       frame_unwind_prepend_unwinder (gdbarch, &jit_frame_unwind);
1229       data->unwinder_registered = 1;
1230     }
1231 }
1232
1233 /* Register any already created translations.  */
1234
1235 static void
1236 jit_inferior_init (struct gdbarch *gdbarch)
1237 {
1238   struct jit_descriptor descriptor;
1239   struct jit_code_entry cur_entry;
1240   struct jit_inferior_data *inf_data;
1241   CORE_ADDR cur_entry_addr;
1242
1243   if (jit_debug)
1244     fprintf_unfiltered (gdb_stdlog, "jit_inferior_init\n");
1245
1246   jit_prepend_unwinder (gdbarch);
1247
1248   inf_data = get_jit_inferior_data ();
1249   if (jit_breakpoint_re_set_internal (gdbarch, inf_data) != 0)
1250     return;
1251
1252   /* Read the descriptor so we can check the version number and load
1253      any already JITed functions.  */
1254   if (!jit_read_descriptor (gdbarch, &descriptor, inf_data))
1255     return;
1256
1257   /* Check that the version number agrees with that we support.  */
1258   if (descriptor.version != 1)
1259     {
1260       printf_unfiltered (_("Unsupported JIT protocol version %ld "
1261                            "in descriptor (expected 1)\n"),
1262                          (long) descriptor.version);
1263       return;
1264     }
1265
1266   /* If we've attached to a running program, we need to check the descriptor
1267      to register any functions that were already generated.  */
1268   for (cur_entry_addr = descriptor.first_entry;
1269        cur_entry_addr != 0;
1270        cur_entry_addr = cur_entry.next_entry)
1271     {
1272       jit_read_code_entry (gdbarch, cur_entry_addr, &cur_entry);
1273
1274       /* This hook may be called many times during setup, so make sure we don't
1275          add the same symbol file twice.  */
1276       if (jit_find_objf_with_entry_addr (cur_entry_addr) != NULL)
1277         continue;
1278
1279       jit_register_code (gdbarch, cur_entry_addr, &cur_entry);
1280     }
1281 }
1282
1283 /* Exported routine to call when an inferior has been created.  */
1284
1285 void
1286 jit_inferior_created_hook (void)
1287 {
1288   jit_inferior_init (target_gdbarch);
1289 }
1290
1291 /* Exported routine to call to re-set the jit breakpoints,
1292    e.g. when a program is rerun.  */
1293
1294 void
1295 jit_breakpoint_re_set (void)
1296 {
1297   jit_breakpoint_re_set_internal (target_gdbarch,
1298                                   get_jit_inferior_data ());
1299 }
1300
1301 /* This function cleans up any code entries left over when the
1302    inferior exits.  We get left over code when the inferior exits
1303    without unregistering its code, for example when it crashes.  */
1304
1305 static void
1306 jit_inferior_exit_hook (struct inferior *inf)
1307 {
1308   struct objfile *objf;
1309   struct objfile *temp;
1310
1311   ALL_OBJFILES_SAFE (objf, temp)
1312     {
1313       struct jit_objfile_data *objf_data = objfile_data (objf,
1314                                                          jit_objfile_data);
1315
1316       if (objf_data != NULL && objf_data->addr != 0)
1317         jit_unregister_code (objf);
1318     }
1319 }
1320
1321 void
1322 jit_event_handler (struct gdbarch *gdbarch)
1323 {
1324   struct jit_descriptor descriptor;
1325   struct jit_code_entry code_entry;
1326   CORE_ADDR entry_addr;
1327   struct objfile *objf;
1328
1329   /* Read the descriptor from remote memory.  */
1330   if (!jit_read_descriptor (gdbarch, &descriptor, get_jit_inferior_data ()))
1331     return;
1332   entry_addr = descriptor.relevant_entry;
1333
1334   /* Do the corresponding action.  */
1335   switch (descriptor.action_flag)
1336     {
1337     case JIT_NOACTION:
1338       break;
1339     case JIT_REGISTER:
1340       jit_read_code_entry (gdbarch, entry_addr, &code_entry);
1341       jit_register_code (gdbarch, entry_addr, &code_entry);
1342       break;
1343     case JIT_UNREGISTER:
1344       objf = jit_find_objf_with_entry_addr (entry_addr);
1345       if (objf == NULL)
1346         printf_unfiltered (_("Unable to find JITed code "
1347                              "entry at address: %s\n"),
1348                            paddress (gdbarch, entry_addr));
1349       else
1350         jit_unregister_code (objf);
1351
1352       break;
1353     default:
1354       error (_("Unknown action_flag value in JIT descriptor!"));
1355       break;
1356     }
1357 }
1358
1359 /* Called to free the data allocated to the jit_inferior_data slot.  */
1360
1361 static void
1362 free_objfile_data (struct objfile *objfile, void *data)
1363 {
1364   struct jit_objfile_data *objf_data = data;
1365
1366   if (objf_data->register_code != NULL)
1367     {
1368       struct jit_inferior_data *inf_data = get_jit_inferior_data ();
1369
1370       if (inf_data->objfile == objfile)
1371         inf_data->objfile = NULL;
1372     }
1373
1374   xfree (data);
1375 }
1376
1377 /* Initialize the jit_gdbarch_data slot with an instance of struct
1378    jit_gdbarch_data_type */
1379
1380 static void *
1381 jit_gdbarch_data_init (struct obstack *obstack)
1382 {
1383   struct jit_gdbarch_data_type *data;
1384
1385   data = obstack_alloc (obstack, sizeof (struct jit_gdbarch_data_type));
1386   data->unwinder_registered = 0;
1387   return data;
1388 }
1389
1390 /* Provide a prototype to silence -Wmissing-prototypes.  */
1391
1392 extern void _initialize_jit (void);
1393
1394 void
1395 _initialize_jit (void)
1396 {
1397   jit_reader_dir = relocate_gdb_directory (JIT_READER_DIR,
1398                                            JIT_READER_DIR_RELOCATABLE);
1399   add_setshow_zinteger_cmd ("jit", class_maintenance, &jit_debug,
1400                             _("Set JIT debugging."),
1401                             _("Show JIT debugging."),
1402                             _("When non-zero, JIT debugging is enabled."),
1403                             NULL,
1404                             show_jit_debug,
1405                             &setdebuglist, &showdebuglist);
1406
1407   observer_attach_inferior_exit (jit_inferior_exit_hook);
1408   jit_objfile_data =
1409     register_objfile_data_with_cleanup (NULL, free_objfile_data);
1410   jit_inferior_data =
1411     register_inferior_data_with_cleanup (jit_inferior_data_cleanup);
1412   jit_gdbarch_data = gdbarch_data_register_pre_init (jit_gdbarch_data_init);
1413   if (is_dl_available ())
1414     {
1415       add_com ("jit-reader-load", no_class, jit_reader_load_command, _("\
1416 Load FILE as debug info reader and unwinder for JIT compiled code.\n\
1417 Usage: jit-reader-load FILE\n\
1418 Try to load file FILE as a debug info reader (and unwinder) for\n\
1419 JIT compiled code.  The file is loaded from " JIT_READER_DIR ",\n\
1420 relocated relative to the GDB executable if required."));
1421       add_com ("jit-reader-unload", no_class, jit_reader_unload_command, _("\
1422 Unload the currently loaded JIT debug info reader.\n\
1423 Usage: jit-reader-unload FILE\n\n\
1424 Do \"help jit-reader-load\" for info on loading debug info readers."));
1425     }
1426 }