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