Use class to manage BFD reference counts
[external/binutils.git] / gdb / corelow.c
1 /* Core dump and executable file functions below target vector, for GDB.
2
3    Copyright (C) 1986-2017 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 #include "arch-utils.h"
22 #include <signal.h>
23 #include <fcntl.h>
24 #ifdef HAVE_SYS_FILE_H
25 #include <sys/file.h>           /* needed for F_OK and friends */
26 #endif
27 #include "frame.h"              /* required by inferior.h */
28 #include "inferior.h"
29 #include "infrun.h"
30 #include "symtab.h"
31 #include "command.h"
32 #include "bfd.h"
33 #include "target.h"
34 #include "gdbcore.h"
35 #include "gdbthread.h"
36 #include "regcache.h"
37 #include "regset.h"
38 #include "symfile.h"
39 #include "exec.h"
40 #include "readline/readline.h"
41 #include "solib.h"
42 #include "filenames.h"
43 #include "progspace.h"
44 #include "objfiles.h"
45 #include "gdb_bfd.h"
46 #include "completer.h"
47 #include "filestuff.h"
48
49 #ifndef O_LARGEFILE
50 #define O_LARGEFILE 0
51 #endif
52
53 /* List of all available core_fns.  On gdb startup, each core file
54    register reader calls deprecated_add_core_fns() to register
55    information on each core format it is prepared to read.  */
56
57 static struct core_fns *core_file_fns = NULL;
58
59 /* The core_fns for a core file handler that is prepared to read the
60    core file currently open on core_bfd.  */
61
62 static struct core_fns *core_vec = NULL;
63
64 /* FIXME: kettenis/20031023: Eventually this variable should
65    disappear.  */
66
67 static struct gdbarch *core_gdbarch = NULL;
68
69 /* Per-core data.  Currently, only the section table.  Note that these
70    target sections are *not* mapped in the current address spaces' set
71    of target sections --- those should come only from pure executable
72    or shared library bfds.  The core bfd sections are an
73    implementation detail of the core target, just like ptrace is for
74    unix child targets.  */
75 static struct target_section_table *core_data;
76
77 static void core_files_info (struct target_ops *);
78
79 static struct core_fns *sniff_core_bfd (bfd *);
80
81 static int gdb_check_format (bfd *);
82
83 static void core_close (struct target_ops *self);
84
85 static void core_close_cleanup (void *ignore);
86
87 static void add_to_thread_list (bfd *, asection *, void *);
88
89 static void init_core_ops (void);
90
91 void _initialize_corelow (void);
92
93 static struct target_ops core_ops;
94
95 /* An arbitrary identifier for the core inferior.  */
96 #define CORELOW_PID 1
97
98 /* Link a new core_fns into the global core_file_fns list.  Called on
99    gdb startup by the _initialize routine in each core file register
100    reader, to register information about each format the reader is
101    prepared to handle.  */
102
103 void
104 deprecated_add_core_fns (struct core_fns *cf)
105 {
106   cf->next = core_file_fns;
107   core_file_fns = cf;
108 }
109
110 /* The default function that core file handlers can use to examine a
111    core file BFD and decide whether or not to accept the job of
112    reading the core file.  */
113
114 int
115 default_core_sniffer (struct core_fns *our_fns, bfd *abfd)
116 {
117   int result;
118
119   result = (bfd_get_flavour (abfd) == our_fns -> core_flavour);
120   return (result);
121 }
122
123 /* Walk through the list of core functions to find a set that can
124    handle the core file open on ABFD.  Returns pointer to set that is
125    selected.  */
126
127 static struct core_fns *
128 sniff_core_bfd (bfd *abfd)
129 {
130   struct core_fns *cf;
131   struct core_fns *yummy = NULL;
132   int matches = 0;;
133
134   /* Don't sniff if we have support for register sets in
135      CORE_GDBARCH.  */
136   if (core_gdbarch && gdbarch_iterate_over_regset_sections_p (core_gdbarch))
137     return NULL;
138
139   for (cf = core_file_fns; cf != NULL; cf = cf->next)
140     {
141       if (cf->core_sniffer (cf, abfd))
142         {
143           yummy = cf;
144           matches++;
145         }
146     }
147   if (matches > 1)
148     {
149       warning (_("\"%s\": ambiguous core format, %d handlers match"),
150                bfd_get_filename (abfd), matches);
151     }
152   else if (matches == 0)
153     error (_("\"%s\": no core file handler recognizes format"),
154            bfd_get_filename (abfd));
155
156   return (yummy);
157 }
158
159 /* The default is to reject every core file format we see.  Either
160    BFD has to recognize it, or we have to provide a function in the
161    core file handler that recognizes it.  */
162
163 int
164 default_check_format (bfd *abfd)
165 {
166   return (0);
167 }
168
169 /* Attempt to recognize core file formats that BFD rejects.  */
170
171 static int
172 gdb_check_format (bfd *abfd)
173 {
174   struct core_fns *cf;
175
176   for (cf = core_file_fns; cf != NULL; cf = cf->next)
177     {
178       if (cf->check_format (abfd))
179         {
180           return (1);
181         }
182     }
183   return (0);
184 }
185
186 /* Discard all vestiges of any previous core file and mark data and
187    stack spaces as empty.  */
188
189 static void
190 core_close (struct target_ops *self)
191 {
192   if (core_bfd)
193     {
194       int pid = ptid_get_pid (inferior_ptid);
195       inferior_ptid = null_ptid;    /* Avoid confusion from thread
196                                        stuff.  */
197       if (pid != 0)
198         exit_inferior_silent (pid);
199
200       /* Clear out solib state while the bfd is still open.  See
201          comments in clear_solib in solib.c.  */
202       clear_solib ();
203
204       if (core_data)
205         {
206           xfree (core_data->sections);
207           xfree (core_data);
208           core_data = NULL;
209         }
210
211       gdb_bfd_unref (core_bfd);
212       core_bfd = NULL;
213     }
214   core_vec = NULL;
215   core_gdbarch = NULL;
216 }
217
218 static void
219 core_close_cleanup (void *ignore)
220 {
221   core_close (NULL);
222 }
223
224 /* Look for sections whose names start with `.reg/' so that we can
225    extract the list of threads in a core file.  */
226
227 static void
228 add_to_thread_list (bfd *abfd, asection *asect, void *reg_sect_arg)
229 {
230   ptid_t ptid;
231   int core_tid;
232   int pid, lwpid;
233   asection *reg_sect = (asection *) reg_sect_arg;
234   int fake_pid_p = 0;
235   struct inferior *inf;
236
237   if (!startswith (bfd_section_name (abfd, asect), ".reg/"))
238     return;
239
240   core_tid = atoi (bfd_section_name (abfd, asect) + 5);
241
242   pid = bfd_core_file_pid (core_bfd);
243   if (pid == 0)
244     {
245       fake_pid_p = 1;
246       pid = CORELOW_PID;
247     }
248
249   lwpid = core_tid;
250
251   inf = current_inferior ();
252   if (inf->pid == 0)
253     {
254       inferior_appeared (inf, pid);
255       inf->fake_pid_p = fake_pid_p;
256     }
257
258   ptid = ptid_build (pid, lwpid, 0);
259
260   add_thread (ptid);
261
262 /* Warning, Will Robinson, looking at BFD private data! */
263
264   if (reg_sect != NULL
265       && asect->filepos == reg_sect->filepos)   /* Did we find .reg?  */
266     inferior_ptid = ptid;                       /* Yes, make it current.  */
267 }
268
269 /* This routine opens and sets up the core file bfd.  */
270
271 static void
272 core_open (const char *arg, int from_tty)
273 {
274   const char *p;
275   int siggy;
276   struct cleanup *old_chain;
277   char *temp;
278   int scratch_chan;
279   int flags;
280   char *filename;
281
282   target_preopen (from_tty);
283   if (!arg)
284     {
285       if (core_bfd)
286         error (_("No core file specified.  (Use `detach' "
287                  "to stop debugging a core file.)"));
288       else
289         error (_("No core file specified."));
290     }
291
292   filename = tilde_expand (arg);
293   if (!IS_ABSOLUTE_PATH (filename))
294     {
295       temp = concat (current_directory, "/",
296                      filename, (char *) NULL);
297       xfree (filename);
298       filename = temp;
299     }
300
301   old_chain = make_cleanup (xfree, filename);
302
303   flags = O_BINARY | O_LARGEFILE;
304   if (write_files)
305     flags |= O_RDWR;
306   else
307     flags |= O_RDONLY;
308   scratch_chan = gdb_open_cloexec (filename, flags, 0);
309   if (scratch_chan < 0)
310     perror_with_name (filename);
311
312   gdb_bfd_ref_ptr temp_bfd (gdb_bfd_fopen (filename, gnutarget,
313                                            write_files ? FOPEN_RUB : FOPEN_RB,
314                                            scratch_chan));
315   if (temp_bfd == NULL)
316     perror_with_name (filename);
317
318   if (!bfd_check_format (temp_bfd.get (), bfd_core)
319       && !gdb_check_format (temp_bfd.get ()))
320     {
321       /* Do it after the err msg */
322       /* FIXME: should be checking for errors from bfd_close (for one
323          thing, on error it does not free all the storage associated
324          with the bfd).  */
325       error (_("\"%s\" is not a core dump: %s"),
326              filename, bfd_errmsg (bfd_get_error ()));
327     }
328
329   /* Looks semi-reasonable.  Toss the old core file and work on the
330      new.  */
331
332   do_cleanups (old_chain);
333   unpush_target (&core_ops);
334   core_bfd = temp_bfd.release ();
335   old_chain = make_cleanup (core_close_cleanup, 0 /*ignore*/);
336
337   core_gdbarch = gdbarch_from_bfd (core_bfd);
338
339   /* Find a suitable core file handler to munch on core_bfd */
340   core_vec = sniff_core_bfd (core_bfd);
341
342   validate_files ();
343
344   core_data = XCNEW (struct target_section_table);
345
346   /* Find the data section */
347   if (build_section_table (core_bfd,
348                            &core_data->sections,
349                            &core_data->sections_end))
350     error (_("\"%s\": Can't find sections: %s"),
351            bfd_get_filename (core_bfd), bfd_errmsg (bfd_get_error ()));
352
353   /* If we have no exec file, try to set the architecture from the
354      core file.  We don't do this unconditionally since an exec file
355      typically contains more information that helps us determine the
356      architecture than a core file.  */
357   if (!exec_bfd)
358     set_gdbarch_from_file (core_bfd);
359
360   push_target (&core_ops);
361   discard_cleanups (old_chain);
362
363   /* Do this before acknowledging the inferior, so if
364      post_create_inferior throws (can happen easilly if you're loading
365      a core file with the wrong exec), we aren't left with threads
366      from the previous inferior.  */
367   init_thread_list ();
368
369   inferior_ptid = null_ptid;
370
371   /* Need to flush the register cache (and the frame cache) from a
372      previous debug session.  If inferior_ptid ends up the same as the
373      last debug session --- e.g., b foo; run; gcore core1; step; gcore
374      core2; core core1; core core2 --- then there's potential for
375      get_current_regcache to return the cached regcache of the
376      previous session, and the frame cache being stale.  */
377   registers_changed ();
378
379   /* Build up thread list from BFD sections, and possibly set the
380      current thread to the .reg/NN section matching the .reg
381      section.  */
382   bfd_map_over_sections (core_bfd, add_to_thread_list,
383                          bfd_get_section_by_name (core_bfd, ".reg"));
384
385   if (ptid_equal (inferior_ptid, null_ptid))
386     {
387       /* Either we found no .reg/NN section, and hence we have a
388          non-threaded core (single-threaded, from gdb's perspective),
389          or for some reason add_to_thread_list couldn't determine
390          which was the "main" thread.  The latter case shouldn't
391          usually happen, but we're dealing with input here, which can
392          always be broken in different ways.  */
393       struct thread_info *thread = first_thread_of_process (-1);
394
395       if (thread == NULL)
396         {
397           inferior_appeared (current_inferior (), CORELOW_PID);
398           inferior_ptid = pid_to_ptid (CORELOW_PID);
399           add_thread_silent (inferior_ptid);
400         }
401       else
402         switch_to_thread (thread->ptid);
403     }
404
405   post_create_inferior (&core_ops, from_tty);
406
407   /* Now go through the target stack looking for threads since there
408      may be a thread_stratum target loaded on top of target core by
409      now.  The layer above should claim threads found in the BFD
410      sections.  */
411   TRY
412     {
413       target_update_thread_list ();
414     }
415
416   CATCH (except, RETURN_MASK_ERROR)
417     {
418       exception_print (gdb_stderr, except);
419     }
420   END_CATCH
421
422   p = bfd_core_file_failing_command (core_bfd);
423   if (p)
424     printf_filtered (_("Core was generated by `%s'.\n"), p);
425
426   /* Clearing any previous state of convenience variables.  */
427   clear_exit_convenience_vars ();
428
429   siggy = bfd_core_file_failing_signal (core_bfd);
430   if (siggy > 0)
431     {
432       /* If we don't have a CORE_GDBARCH to work with, assume a native
433          core (map gdb_signal from host signals).  If we do have
434          CORE_GDBARCH to work with, but no gdb_signal_from_target
435          implementation for that gdbarch, as a fallback measure,
436          assume the host signal mapping.  It'll be correct for native
437          cores, but most likely incorrect for cross-cores.  */
438       enum gdb_signal sig = (core_gdbarch != NULL
439                              && gdbarch_gdb_signal_from_target_p (core_gdbarch)
440                              ? gdbarch_gdb_signal_from_target (core_gdbarch,
441                                                                siggy)
442                              : gdb_signal_from_host (siggy));
443
444       printf_filtered (_("Program terminated with signal %s, %s.\n"),
445                        gdb_signal_to_name (sig), gdb_signal_to_string (sig));
446
447       /* Set the value of the internal variable $_exitsignal,
448          which holds the signal uncaught by the inferior.  */
449       set_internalvar_integer (lookup_internalvar ("_exitsignal"),
450                                siggy);
451     }
452
453   /* Fetch all registers from core file.  */
454   target_fetch_registers (get_current_regcache (), -1);
455
456   /* Now, set up the frame cache, and print the top of stack.  */
457   reinit_frame_cache ();
458   print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC, 1);
459
460   /* Current thread should be NUM 1 but the user does not know that.
461      If a program is single threaded gdb in general does not mention
462      anything about threads.  That is why the test is >= 2.  */
463   if (thread_count () >= 2)
464     {
465       TRY
466         {
467           thread_command (NULL, from_tty);
468         }
469       CATCH (except, RETURN_MASK_ERROR)
470         {
471           exception_print (gdb_stderr, except);
472         }
473       END_CATCH
474     }
475 }
476
477 static void
478 core_detach (struct target_ops *ops, const char *args, int from_tty)
479 {
480   if (args)
481     error (_("Too many arguments"));
482   unpush_target (ops);
483   reinit_frame_cache ();
484   if (from_tty)
485     printf_filtered (_("No core file now.\n"));
486 }
487
488 /* Try to retrieve registers from a section in core_bfd, and supply
489    them to core_vec->core_read_registers, as the register set numbered
490    WHICH.
491
492    If inferior_ptid's lwp member is zero, do the single-threaded
493    thing: look for a section named NAME.  If inferior_ptid's lwp
494    member is non-zero, do the multi-threaded thing: look for a section
495    named "NAME/LWP", where LWP is the shortest ASCII decimal
496    representation of inferior_ptid's lwp member.
497
498    HUMAN_NAME is a human-readable name for the kind of registers the
499    NAME section contains, for use in error messages.
500
501    If REQUIRED is non-zero, print an error if the core file doesn't
502    have a section by the appropriate name.  Otherwise, just do
503    nothing.  */
504
505 static void
506 get_core_register_section (struct regcache *regcache,
507                            const struct regset *regset,
508                            const char *name,
509                            int min_size,
510                            int which,
511                            const char *human_name,
512                            int required)
513 {
514   static char *section_name = NULL;
515   struct bfd_section *section;
516   bfd_size_type size;
517   char *contents;
518
519   xfree (section_name);
520
521   if (ptid_get_lwp (inferior_ptid))
522     section_name = xstrprintf ("%s/%ld", name,
523                                ptid_get_lwp (inferior_ptid));
524   else
525     section_name = xstrdup (name);
526
527   section = bfd_get_section_by_name (core_bfd, section_name);
528   if (! section)
529     {
530       if (required)
531         warning (_("Couldn't find %s registers in core file."),
532                  human_name);
533       return;
534     }
535
536   size = bfd_section_size (core_bfd, section);
537   if (size < min_size)
538     {
539       warning (_("Section `%s' in core file too small."), section_name);
540       return;
541     }
542   if (size != min_size && !(regset->flags & REGSET_VARIABLE_SIZE))
543     {
544       warning (_("Unexpected size of section `%s' in core file."),
545                section_name);
546     }
547
548   contents = (char *) alloca (size);
549   if (! bfd_get_section_contents (core_bfd, section, contents,
550                                   (file_ptr) 0, size))
551     {
552       warning (_("Couldn't read %s registers from `%s' section in core file."),
553                human_name, name);
554       return;
555     }
556
557   if (regset != NULL)
558     {
559       regset->supply_regset (regset, regcache, -1, contents, size);
560       return;
561     }
562
563   gdb_assert (core_vec);
564   core_vec->core_read_registers (regcache, contents, size, which,
565                                  ((CORE_ADDR)
566                                   bfd_section_vma (core_bfd, section)));
567 }
568
569 /* Callback for get_core_registers that handles a single core file
570    register note section. */
571
572 static void
573 get_core_registers_cb (const char *sect_name, int size,
574                        const struct regset *regset,
575                        const char *human_name, void *cb_data)
576 {
577   struct regcache *regcache = (struct regcache *) cb_data;
578   int required = 0;
579
580   if (strcmp (sect_name, ".reg") == 0)
581     {
582       required = 1;
583       if (human_name == NULL)
584         human_name = "general-purpose";
585     }
586   else if (strcmp (sect_name, ".reg2") == 0)
587     {
588       if (human_name == NULL)
589         human_name = "floating-point";
590     }
591
592   /* The 'which' parameter is only used when no regset is provided.
593      Thus we just set it to -1. */
594   get_core_register_section (regcache, regset, sect_name,
595                              size, -1, human_name, required);
596 }
597
598 /* Get the registers out of a core file.  This is the machine-
599    independent part.  Fetch_core_registers is the machine-dependent
600    part, typically implemented in the xm-file for each
601    architecture.  */
602
603 /* We just get all the registers, so we don't use regno.  */
604
605 static void
606 get_core_registers (struct target_ops *ops,
607                     struct regcache *regcache, int regno)
608 {
609   int i;
610   struct gdbarch *gdbarch;
611
612   if (!(core_gdbarch && gdbarch_iterate_over_regset_sections_p (core_gdbarch))
613       && (core_vec == NULL || core_vec->core_read_registers == NULL))
614     {
615       fprintf_filtered (gdb_stderr,
616                      "Can't fetch registers from this type of core file\n");
617       return;
618     }
619
620   gdbarch = get_regcache_arch (regcache);
621   if (gdbarch_iterate_over_regset_sections_p (gdbarch))
622     gdbarch_iterate_over_regset_sections (gdbarch,
623                                           get_core_registers_cb,
624                                           (void *) regcache, NULL);
625   else
626     {
627       get_core_register_section (regcache, NULL,
628                                  ".reg", 0, 0, "general-purpose", 1);
629       get_core_register_section (regcache, NULL,
630                                  ".reg2", 0, 2, "floating-point", 0);
631     }
632
633   /* Mark all registers not found in the core as unavailable.  */
634   for (i = 0; i < gdbarch_num_regs (get_regcache_arch (regcache)); i++)
635     if (regcache_register_status (regcache, i) == REG_UNKNOWN)
636       regcache_raw_supply (regcache, i, NULL);
637 }
638
639 static void
640 core_files_info (struct target_ops *t)
641 {
642   print_section_info (core_data, core_bfd);
643 }
644 \f
645 struct spuid_list
646 {
647   gdb_byte *buf;
648   ULONGEST offset;
649   LONGEST len;
650   ULONGEST pos;
651   ULONGEST written;
652 };
653
654 static void
655 add_to_spuid_list (bfd *abfd, asection *asect, void *list_p)
656 {
657   struct spuid_list *list = (struct spuid_list *) list_p;
658   enum bfd_endian byte_order
659     = bfd_big_endian (abfd) ? BFD_ENDIAN_BIG : BFD_ENDIAN_LITTLE;
660   int fd, pos = 0;
661
662   sscanf (bfd_section_name (abfd, asect), "SPU/%d/regs%n", &fd, &pos);
663   if (pos == 0)
664     return;
665
666   if (list->pos >= list->offset && list->pos + 4 <= list->offset + list->len)
667     {
668       store_unsigned_integer (list->buf + list->pos - list->offset,
669                               4, byte_order, fd);
670       list->written += 4;
671     }
672   list->pos += 4;
673 }
674
675 /* Read siginfo data from the core, if possible.  Returns -1 on
676    failure.  Otherwise, returns the number of bytes read.  ABFD is the
677    core file's BFD; READBUF, OFFSET, and LEN are all as specified by
678    the to_xfer_partial interface.  */
679
680 static LONGEST
681 get_core_siginfo (bfd *abfd, gdb_byte *readbuf, ULONGEST offset, ULONGEST len)
682 {
683   asection *section;
684   char *section_name;
685   const char *name = ".note.linuxcore.siginfo";
686
687   if (ptid_get_lwp (inferior_ptid))
688     section_name = xstrprintf ("%s/%ld", name,
689                                ptid_get_lwp (inferior_ptid));
690   else
691     section_name = xstrdup (name);
692
693   section = bfd_get_section_by_name (abfd, section_name);
694   xfree (section_name);
695   if (section == NULL)
696     return -1;
697
698   if (!bfd_get_section_contents (abfd, section, readbuf, offset, len))
699     return -1;
700
701   return len;
702 }
703
704 static enum target_xfer_status
705 core_xfer_partial (struct target_ops *ops, enum target_object object,
706                    const char *annex, gdb_byte *readbuf,
707                    const gdb_byte *writebuf, ULONGEST offset,
708                    ULONGEST len, ULONGEST *xfered_len)
709 {
710   switch (object)
711     {
712     case TARGET_OBJECT_MEMORY:
713       return section_table_xfer_memory_partial (readbuf, writebuf,
714                                                 offset, len, xfered_len,
715                                                 core_data->sections,
716                                                 core_data->sections_end,
717                                                 NULL);
718
719     case TARGET_OBJECT_AUXV:
720       if (readbuf)
721         {
722           /* When the aux vector is stored in core file, BFD
723              represents this with a fake section called ".auxv".  */
724
725           struct bfd_section *section;
726           bfd_size_type size;
727
728           section = bfd_get_section_by_name (core_bfd, ".auxv");
729           if (section == NULL)
730             return TARGET_XFER_E_IO;
731
732           size = bfd_section_size (core_bfd, section);
733           if (offset >= size)
734             return TARGET_XFER_EOF;
735           size -= offset;
736           if (size > len)
737             size = len;
738
739           if (size == 0)
740             return TARGET_XFER_EOF;
741           if (!bfd_get_section_contents (core_bfd, section, readbuf,
742                                          (file_ptr) offset, size))
743             {
744               warning (_("Couldn't read NT_AUXV note in core file."));
745               return TARGET_XFER_E_IO;
746             }
747
748           *xfered_len = (ULONGEST) size;
749           return TARGET_XFER_OK;
750         }
751       return TARGET_XFER_E_IO;
752
753     case TARGET_OBJECT_WCOOKIE:
754       if (readbuf)
755         {
756           /* When the StackGhost cookie is stored in core file, BFD
757              represents this with a fake section called
758              ".wcookie".  */
759
760           struct bfd_section *section;
761           bfd_size_type size;
762
763           section = bfd_get_section_by_name (core_bfd, ".wcookie");
764           if (section == NULL)
765             return TARGET_XFER_E_IO;
766
767           size = bfd_section_size (core_bfd, section);
768           if (offset >= size)
769             return TARGET_XFER_EOF;
770           size -= offset;
771           if (size > len)
772             size = len;
773
774           if (size == 0)
775             return TARGET_XFER_EOF;
776           if (!bfd_get_section_contents (core_bfd, section, readbuf,
777                                          (file_ptr) offset, size))
778             {
779               warning (_("Couldn't read StackGhost cookie in core file."));
780               return TARGET_XFER_E_IO;
781             }
782
783           *xfered_len = (ULONGEST) size;
784           return TARGET_XFER_OK;
785
786         }
787       return TARGET_XFER_E_IO;
788
789     case TARGET_OBJECT_LIBRARIES:
790       if (core_gdbarch
791           && gdbarch_core_xfer_shared_libraries_p (core_gdbarch))
792         {
793           if (writebuf)
794             return TARGET_XFER_E_IO;
795           else
796             {
797               *xfered_len = gdbarch_core_xfer_shared_libraries (core_gdbarch,
798                                                                 readbuf,
799                                                                 offset, len);
800
801               if (*xfered_len == 0)
802                 return TARGET_XFER_EOF;
803               else
804                 return TARGET_XFER_OK;
805             }
806         }
807       /* FALL THROUGH */
808
809     case TARGET_OBJECT_LIBRARIES_AIX:
810       if (core_gdbarch
811           && gdbarch_core_xfer_shared_libraries_aix_p (core_gdbarch))
812         {
813           if (writebuf)
814             return TARGET_XFER_E_IO;
815           else
816             {
817               *xfered_len
818                 = gdbarch_core_xfer_shared_libraries_aix (core_gdbarch,
819                                                           readbuf, offset,
820                                                           len);
821
822               if (*xfered_len == 0)
823                 return TARGET_XFER_EOF;
824               else
825                 return TARGET_XFER_OK;
826             }
827         }
828       /* FALL THROUGH */
829
830     case TARGET_OBJECT_SPU:
831       if (readbuf && annex)
832         {
833           /* When the SPU contexts are stored in a core file, BFD
834              represents this with a fake section called
835              "SPU/<annex>".  */
836
837           struct bfd_section *section;
838           bfd_size_type size;
839           char sectionstr[100];
840
841           xsnprintf (sectionstr, sizeof sectionstr, "SPU/%s", annex);
842
843           section = bfd_get_section_by_name (core_bfd, sectionstr);
844           if (section == NULL)
845             return TARGET_XFER_E_IO;
846
847           size = bfd_section_size (core_bfd, section);
848           if (offset >= size)
849             return TARGET_XFER_EOF;
850           size -= offset;
851           if (size > len)
852             size = len;
853
854           if (size == 0)
855             return TARGET_XFER_EOF;
856           if (!bfd_get_section_contents (core_bfd, section, readbuf,
857                                          (file_ptr) offset, size))
858             {
859               warning (_("Couldn't read SPU section in core file."));
860               return TARGET_XFER_E_IO;
861             }
862
863           *xfered_len = (ULONGEST) size;
864           return TARGET_XFER_OK;
865         }
866       else if (readbuf)
867         {
868           /* NULL annex requests list of all present spuids.  */
869           struct spuid_list list;
870
871           list.buf = readbuf;
872           list.offset = offset;
873           list.len = len;
874           list.pos = 0;
875           list.written = 0;
876           bfd_map_over_sections (core_bfd, add_to_spuid_list, &list);
877
878           if (list.written == 0)
879             return TARGET_XFER_EOF;
880           else
881             {
882               *xfered_len = (ULONGEST) list.written;
883               return TARGET_XFER_OK;
884             }
885         }
886       return TARGET_XFER_E_IO;
887
888     case TARGET_OBJECT_SIGNAL_INFO:
889       if (readbuf)
890         {
891           LONGEST l = get_core_siginfo (core_bfd, readbuf, offset, len);
892
893           if (l > 0)
894             {
895               *xfered_len = len;
896               return TARGET_XFER_OK;
897             }
898         }
899       return TARGET_XFER_E_IO;
900
901     default:
902       return ops->beneath->to_xfer_partial (ops->beneath, object,
903                                             annex, readbuf,
904                                             writebuf, offset, len,
905                                             xfered_len);
906     }
907 }
908
909 \f
910 /* If mourn is being called in all the right places, this could be say
911    `gdb internal error' (since generic_mourn calls
912    breakpoint_init_inferior).  */
913
914 static int
915 ignore (struct target_ops *ops, struct gdbarch *gdbarch,
916         struct bp_target_info *bp_tgt)
917 {
918   return 0;
919 }
920
921 /* Implement the to_remove_breakpoint method.  */
922
923 static int
924 core_remove_breakpoint (struct target_ops *ops, struct gdbarch *gdbarch,
925                         struct bp_target_info *bp_tgt,
926                         enum remove_bp_reason reason)
927 {
928   return 0;
929 }
930
931
932 /* Okay, let's be honest: threads gleaned from a core file aren't
933    exactly lively, are they?  On the other hand, if we don't claim
934    that each & every one is alive, then we don't get any of them
935    to appear in an "info thread" command, which is quite a useful
936    behaviour.
937  */
938 static int
939 core_thread_alive (struct target_ops *ops, ptid_t ptid)
940 {
941   return 1;
942 }
943
944 /* Ask the current architecture what it knows about this core file.
945    That will be used, in turn, to pick a better architecture.  This
946    wrapper could be avoided if targets got a chance to specialize
947    core_ops.  */
948
949 static const struct target_desc *
950 core_read_description (struct target_ops *target)
951 {
952   if (core_gdbarch && gdbarch_core_read_description_p (core_gdbarch))
953     {
954       const struct target_desc *result;
955
956       result = gdbarch_core_read_description (core_gdbarch, 
957                                               target, core_bfd);
958       if (result != NULL)
959         return result;
960     }
961
962   return target->beneath->to_read_description (target->beneath);
963 }
964
965 static char *
966 core_pid_to_str (struct target_ops *ops, ptid_t ptid)
967 {
968   static char buf[64];
969   struct inferior *inf;
970   int pid;
971
972   /* The preferred way is to have a gdbarch/OS specific
973      implementation.  */
974   if (core_gdbarch
975       && gdbarch_core_pid_to_str_p (core_gdbarch))
976     return gdbarch_core_pid_to_str (core_gdbarch, ptid);
977
978   /* Otherwise, if we don't have one, we'll just fallback to
979      "process", with normal_pid_to_str.  */
980
981   /* Try the LWPID field first.  */
982   pid = ptid_get_lwp (ptid);
983   if (pid != 0)
984     return normal_pid_to_str (pid_to_ptid (pid));
985
986   /* Otherwise, this isn't a "threaded" core -- use the PID field, but
987      only if it isn't a fake PID.  */
988   inf = find_inferior_ptid (ptid);
989   if (inf != NULL && !inf->fake_pid_p)
990     return normal_pid_to_str (ptid);
991
992   /* No luck.  We simply don't have a valid PID to print.  */
993   xsnprintf (buf, sizeof buf, "<main task>");
994   return buf;
995 }
996
997 static const char *
998 core_thread_name (struct target_ops *self, struct thread_info *thr)
999 {
1000   if (core_gdbarch
1001       && gdbarch_core_thread_name_p (core_gdbarch))
1002     return gdbarch_core_thread_name (core_gdbarch, thr);
1003   return NULL;
1004 }
1005
1006 static int
1007 core_has_memory (struct target_ops *ops)
1008 {
1009   return (core_bfd != NULL);
1010 }
1011
1012 static int
1013 core_has_stack (struct target_ops *ops)
1014 {
1015   return (core_bfd != NULL);
1016 }
1017
1018 static int
1019 core_has_registers (struct target_ops *ops)
1020 {
1021   return (core_bfd != NULL);
1022 }
1023
1024 /* Implement the to_info_proc method.  */
1025
1026 static void
1027 core_info_proc (struct target_ops *ops, const char *args,
1028                 enum info_proc_what request)
1029 {
1030   struct gdbarch *gdbarch = get_current_arch ();
1031
1032   /* Since this is the core file target, call the 'core_info_proc'
1033      method on gdbarch, not 'info_proc'.  */
1034   if (gdbarch_core_info_proc_p (gdbarch))
1035     gdbarch_core_info_proc (gdbarch, args, request);
1036 }
1037
1038 /* Fill in core_ops with its defined operations and properties.  */
1039
1040 static void
1041 init_core_ops (void)
1042 {
1043   core_ops.to_shortname = "core";
1044   core_ops.to_longname = "Local core dump file";
1045   core_ops.to_doc =
1046     "Use a core file as a target.  Specify the filename of the core file.";
1047   core_ops.to_open = core_open;
1048   core_ops.to_close = core_close;
1049   core_ops.to_detach = core_detach;
1050   core_ops.to_fetch_registers = get_core_registers;
1051   core_ops.to_xfer_partial = core_xfer_partial;
1052   core_ops.to_files_info = core_files_info;
1053   core_ops.to_insert_breakpoint = ignore;
1054   core_ops.to_remove_breakpoint = core_remove_breakpoint;
1055   core_ops.to_thread_alive = core_thread_alive;
1056   core_ops.to_read_description = core_read_description;
1057   core_ops.to_pid_to_str = core_pid_to_str;
1058   core_ops.to_thread_name = core_thread_name;
1059   core_ops.to_stratum = process_stratum;
1060   core_ops.to_has_memory = core_has_memory;
1061   core_ops.to_has_stack = core_has_stack;
1062   core_ops.to_has_registers = core_has_registers;
1063   core_ops.to_info_proc = core_info_proc;
1064   core_ops.to_magic = OPS_MAGIC;
1065
1066   if (core_target)
1067     internal_error (__FILE__, __LINE__, 
1068                     _("init_core_ops: core target already exists (\"%s\")."),
1069                     core_target->to_longname);
1070   core_target = &core_ops;
1071 }
1072
1073 void
1074 _initialize_corelow (void)
1075 {
1076   init_core_ops ();
1077
1078   add_target_with_completer (&core_ops, filename_completer);
1079 }