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