Use unique_xmalloc_ptr in c_type_print_base
[deliverable/binutils-gdb.git] / gdb / infcall.c
CommitLineData
04714b91
AC
1/* Perform an inferior function call, for GDB, the GNU debugger.
2
61baf725 3 Copyright (C) 1986-2017 Free Software Foundation, Inc.
04714b91
AC
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
a9762ec7 9 the Free Software Foundation; either version 3 of the License, or
04714b91
AC
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
a9762ec7 18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
04714b91
AC
19
20#include "defs.h"
0700e23e 21#include "infcall.h"
04714b91 22#include "breakpoint.h"
573cda03 23#include "tracepoint.h"
04714b91
AC
24#include "target.h"
25#include "regcache.h"
26#include "inferior.h"
45741a9c 27#include "infrun.h"
04714b91
AC
28#include "block.h"
29#include "gdbcore.h"
30#include "language.h"
9ab9195f 31#include "objfiles.h"
04714b91
AC
32#include "gdbcmd.h"
33#include "command.h"
96860204 34#include "dummy-frame.h"
a93c0eb6 35#include "ada-lang.h"
347bddb7 36#include "gdbthread.h"
beb460e8 37#include "event-top.h"
162078c8 38#include "observer.h"
0b333c5e
PA
39#include "top.h"
40#include "interps.h"
388a7084 41#include "thread-fsm.h"
b89667eb
DE
42
43/* If we can't find a function's name from its address,
44 we print this instead. */
45#define RAW_FUNCTION_ADDRESS_FORMAT "at 0x%s"
46#define RAW_FUNCTION_ADDRESS_SIZE (sizeof (RAW_FUNCTION_ADDRESS_FORMAT) \
47 + 2 * sizeof (CORE_ADDR))
04714b91
AC
48
49/* NOTE: cagney/2003-04-16: What's the future of this code?
50
51 GDB needs an asynchronous expression evaluator, that means an
52 asynchronous inferior function call implementation, and that in
53 turn means restructuring the code so that it is event driven. */
54
55/* How you should pass arguments to a function depends on whether it
56 was defined in K&R style or prototype style. If you define a
57 function using the K&R syntax that takes a `float' argument, then
58 callers must pass that argument as a `double'. If you define the
59 function using the prototype syntax, then you must pass the
60 argument as a `float', with no promotion.
61
62 Unfortunately, on certain older platforms, the debug info doesn't
63 indicate reliably how each function was defined. A function type's
a9ff5f12
UW
64 TYPE_PROTOTYPED flag may be clear, even if the function was defined
65 in prototype style. When calling a function whose TYPE_PROTOTYPED
66 flag is clear, GDB consults this flag to decide what to do.
04714b91
AC
67
68 For modern targets, it is proper to assume that, if the prototype
69 flag is clear, that can be trusted: `float' arguments should be
70 promoted to `double'. For some older targets, if the prototype
71 flag is clear, that doesn't tell us anything. The default is to
72 trust the debug information; the user can override this behavior
73 with "set coerce-float-to-double 0". */
74
75static int coerce_float_to_double_p = 1;
920d2a44
AC
76static void
77show_coerce_float_to_double_p (struct ui_file *file, int from_tty,
78 struct cmd_list_element *c, const char *value)
79{
3e43a32a
MS
80 fprintf_filtered (file,
81 _("Coercion of floats to doubles "
82 "when calling functions is %s.\n"),
920d2a44
AC
83 value);
84}
04714b91
AC
85
86/* This boolean tells what gdb should do if a signal is received while
87 in a function called from gdb (call dummy). If set, gdb unwinds
88 the stack and restore the context to what as it was before the
89 call.
90
1777feb0 91 The default is to stop in the frame where the signal was received. */
04714b91 92
ef61f180 93static int unwind_on_signal_p = 0;
920d2a44
AC
94static void
95show_unwind_on_signal_p (struct ui_file *file, int from_tty,
96 struct cmd_list_element *c, const char *value)
97{
3e43a32a
MS
98 fprintf_filtered (file,
99 _("Unwinding of stack if a signal is "
100 "received while in a call dummy is %s.\n"),
920d2a44
AC
101 value);
102}
103
7cd1089b
PM
104/* This boolean tells what gdb should do if a std::terminate call is
105 made while in a function called from gdb (call dummy).
106 As the confines of a single dummy stack prohibit out-of-frame
107 handlers from handling a raised exception, and as out-of-frame
108 handlers are common in C++, this can lead to no handler being found
109 by the unwinder, and a std::terminate call. This is a false positive.
110 If set, gdb unwinds the stack and restores the context to what it
111 was before the call.
112
113 The default is to unwind the frame if a std::terminate call is
114 made. */
115
116static int unwind_on_terminating_exception_p = 1;
117
118static void
119show_unwind_on_terminating_exception_p (struct ui_file *file, int from_tty,
120 struct cmd_list_element *c,
121 const char *value)
122
123{
3e43a32a
MS
124 fprintf_filtered (file,
125 _("Unwind stack if a C++ exception is "
126 "unhandled while in a call dummy is %s.\n"),
7cd1089b
PM
127 value);
128}
04714b91
AC
129
130/* Perform the standard coercions that are specified
a93c0eb6 131 for arguments to be passed to C or Ada functions.
04714b91
AC
132
133 If PARAM_TYPE is non-NULL, it is the expected parameter type.
a93c0eb6
JB
134 IS_PROTOTYPED is non-zero if the function declaration is prototyped.
135 SP is the stack pointer were additional data can be pushed (updating
136 its value as needed). */
04714b91
AC
137
138static struct value *
7788af6d
UW
139value_arg_coerce (struct gdbarch *gdbarch, struct value *arg,
140 struct type *param_type, int is_prototyped, CORE_ADDR *sp)
04714b91 141{
7788af6d 142 const struct builtin_type *builtin = builtin_type (gdbarch);
df407dfe 143 struct type *arg_type = check_typedef (value_type (arg));
52f0bd74 144 struct type *type
04714b91
AC
145 = param_type ? check_typedef (param_type) : arg_type;
146
a93c0eb6
JB
147 /* Perform any Ada-specific coercion first. */
148 if (current_language->la_language == language_ada)
40bc484c 149 arg = ada_convert_actual (arg, type);
a93c0eb6 150
63092375
DJ
151 /* Force the value to the target if we will need its address. At
152 this point, we could allocate arguments on the stack instead of
153 calling malloc if we knew that their addresses would not be
154 saved by the called function. */
155 arg = value_coerce_to_target (arg);
156
04714b91
AC
157 switch (TYPE_CODE (type))
158 {
159 case TYPE_CODE_REF:
aa006118 160 case TYPE_CODE_RVALUE_REF:
fb933624
DJ
161 {
162 struct value *new_value;
163
aa006118 164 if (TYPE_IS_REFERENCE (arg_type))
b1af9e97 165 return value_cast_pointers (type, arg, 0);
fb933624
DJ
166
167 /* Cast the value to the reference's target type, and then
168 convert it back to a reference. This will issue an error
169 if the value was not previously in memory - in some cases
170 we should clearly be allowing this, but how? */
171 new_value = value_cast (TYPE_TARGET_TYPE (type), arg);
a65cfae5 172 new_value = value_ref (new_value, TYPE_CODE (type));
fb933624
DJ
173 return new_value;
174 }
04714b91
AC
175 case TYPE_CODE_INT:
176 case TYPE_CODE_CHAR:
177 case TYPE_CODE_BOOL:
178 case TYPE_CODE_ENUM:
179 /* If we don't have a prototype, coerce to integer type if necessary. */
180 if (!is_prototyped)
181 {
7788af6d
UW
182 if (TYPE_LENGTH (type) < TYPE_LENGTH (builtin->builtin_int))
183 type = builtin->builtin_int;
04714b91
AC
184 }
185 /* Currently all target ABIs require at least the width of an integer
186 type for an argument. We may have to conditionalize the following
187 type coercion for future targets. */
7788af6d
UW
188 if (TYPE_LENGTH (type) < TYPE_LENGTH (builtin->builtin_int))
189 type = builtin->builtin_int;
04714b91
AC
190 break;
191 case TYPE_CODE_FLT:
192 if (!is_prototyped && coerce_float_to_double_p)
193 {
7788af6d
UW
194 if (TYPE_LENGTH (type) < TYPE_LENGTH (builtin->builtin_double))
195 type = builtin->builtin_double;
196 else if (TYPE_LENGTH (type) > TYPE_LENGTH (builtin->builtin_double))
197 type = builtin->builtin_long_double;
04714b91
AC
198 }
199 break;
200 case TYPE_CODE_FUNC:
201 type = lookup_pointer_type (type);
202 break;
203 case TYPE_CODE_ARRAY:
204 /* Arrays are coerced to pointers to their first element, unless
205 they are vectors, in which case we want to leave them alone,
206 because they are passed by value. */
207 if (current_language->c_style_arrays)
208 if (!TYPE_VECTOR (type))
209 type = lookup_pointer_type (TYPE_TARGET_TYPE (type));
210 break;
211 case TYPE_CODE_UNDEF:
212 case TYPE_CODE_PTR:
213 case TYPE_CODE_STRUCT:
214 case TYPE_CODE_UNION:
215 case TYPE_CODE_VOID:
216 case TYPE_CODE_SET:
217 case TYPE_CODE_RANGE:
218 case TYPE_CODE_STRING:
04714b91 219 case TYPE_CODE_ERROR:
0d5de010
DJ
220 case TYPE_CODE_MEMBERPTR:
221 case TYPE_CODE_METHODPTR:
04714b91
AC
222 case TYPE_CODE_METHOD:
223 case TYPE_CODE_COMPLEX:
224 default:
225 break;
226 }
227
228 return value_cast (type, arg);
229}
230
07be84bf
JK
231/* Return the return type of a function with its first instruction exactly at
232 the PC address. Return NULL otherwise. */
233
234static struct type *
235find_function_return_type (CORE_ADDR pc)
236{
237 struct symbol *sym = find_pc_function (pc);
238
239 if (sym != NULL && BLOCK_START (SYMBOL_BLOCK_VALUE (sym)) == pc
240 && SYMBOL_TYPE (sym) != NULL)
241 return TYPE_TARGET_TYPE (SYMBOL_TYPE (sym));
242
243 return NULL;
244}
245
04714b91
AC
246/* Determine a function's address and its return type from its value.
247 Calls error() if the function is not valid for calling. */
248
a9fa03de 249CORE_ADDR
04714b91
AC
250find_function_addr (struct value *function, struct type **retval_type)
251{
df407dfe 252 struct type *ftype = check_typedef (value_type (function));
50810684 253 struct gdbarch *gdbarch = get_type_arch (ftype);
7788af6d 254 struct type *value_type = NULL;
09b58708
JK
255 /* Initialize it just to avoid a GCC false warning. */
256 CORE_ADDR funaddr = 0;
04714b91
AC
257
258 /* If it's a member function, just look at the function
259 part of it. */
260
261 /* Determine address to call. */
300f8e10
JK
262 if (TYPE_CODE (ftype) == TYPE_CODE_FUNC
263 || TYPE_CODE (ftype) == TYPE_CODE_METHOD)
264 funaddr = value_address (function);
265 else if (TYPE_CODE (ftype) == TYPE_CODE_PTR)
04714b91
AC
266 {
267 funaddr = value_as_address (function);
268 ftype = check_typedef (TYPE_TARGET_TYPE (ftype));
269 if (TYPE_CODE (ftype) == TYPE_CODE_FUNC
270 || TYPE_CODE (ftype) == TYPE_CODE_METHOD)
300f8e10
JK
271 funaddr = gdbarch_convert_from_func_ptr_addr (gdbarch, funaddr,
272 &current_target);
04714b91 273 }
300f8e10
JK
274 if (TYPE_CODE (ftype) == TYPE_CODE_FUNC
275 || TYPE_CODE (ftype) == TYPE_CODE_METHOD)
07be84bf
JK
276 {
277 value_type = TYPE_TARGET_TYPE (ftype);
278
279 if (TYPE_GNU_IFUNC (ftype))
280 {
281 funaddr = gnu_ifunc_resolve_addr (gdbarch, funaddr);
282
283 /* Skip querying the function symbol if no RETVAL_TYPE has been
284 asked for. */
285 if (retval_type)
286 value_type = find_function_return_type (funaddr);
287 }
288 }
300f8e10 289 else if (TYPE_CODE (ftype) == TYPE_CODE_INT)
04714b91
AC
290 {
291 /* Handle the case of functions lacking debugging info.
1777feb0 292 Their values are characters since their addresses are char. */
04714b91
AC
293 if (TYPE_LENGTH (ftype) == 1)
294 funaddr = value_as_address (value_addr (function));
295 else
2bbe3cc1
DJ
296 {
297 /* Handle function descriptors lacking debug info. */
298 int found_descriptor = 0;
abbb1732 299
87bc73ea 300 funaddr = 0; /* pacify "gcc -Werror" */
2bbe3cc1
DJ
301 if (VALUE_LVAL (function) == lval_memory)
302 {
303 CORE_ADDR nfunaddr;
abbb1732 304
2bbe3cc1
DJ
305 funaddr = value_as_address (value_addr (function));
306 nfunaddr = funaddr;
50810684 307 funaddr = gdbarch_convert_from_func_ptr_addr (gdbarch, funaddr,
2bbe3cc1
DJ
308 &current_target);
309 if (funaddr != nfunaddr)
310 found_descriptor = 1;
311 }
312 if (!found_descriptor)
313 /* Handle integer used as address of a function. */
314 funaddr = (CORE_ADDR) value_as_long (function);
315 }
04714b91
AC
316 }
317 else
8a3fe4f8 318 error (_("Invalid data type for function to be called."));
04714b91 319
7d9b040b
RC
320 if (retval_type != NULL)
321 *retval_type = value_type;
50810684 322 return funaddr + gdbarch_deprecated_function_start_offset (gdbarch);
04714b91
AC
323}
324
d3712828
AC
325/* For CALL_DUMMY_ON_STACK, push a breakpoint sequence that the called
326 function returns to. */
7043d8dc
AC
327
328static CORE_ADDR
329push_dummy_code (struct gdbarch *gdbarch,
82585c72 330 CORE_ADDR sp, CORE_ADDR funaddr,
7043d8dc
AC
331 struct value **args, int nargs,
332 struct type *value_type,
e4fd649a
UW
333 CORE_ADDR *real_pc, CORE_ADDR *bp_addr,
334 struct regcache *regcache)
7043d8dc 335{
50a834af
MK
336 gdb_assert (gdbarch_push_dummy_code_p (gdbarch));
337
338 return gdbarch_push_dummy_code (gdbarch, sp, funaddr,
339 args, nargs, value_type, real_pc, bp_addr,
340 regcache);
7043d8dc
AC
341}
342
7022349d
PA
343/* See infcall.h. */
344
345void
346error_call_unknown_return_type (const char *func_name)
347{
348 if (func_name != NULL)
349 error (_("'%s' has unknown return type; "
350 "cast the call to its declared return type"),
351 func_name);
352 else
353 error (_("function has unknown return type; "
354 "cast the call to its declared return type"));
355}
356
b89667eb
DE
357/* Fetch the name of the function at FUNADDR.
358 This is used in printing an error message for call_function_by_hand.
359 BUF is used to print FUNADDR in hex if the function name cannot be
360 determined. It must be large enough to hold formatted result of
361 RAW_FUNCTION_ADDRESS_FORMAT. */
362
363static const char *
364get_function_name (CORE_ADDR funaddr, char *buf, int buf_size)
365{
366 {
367 struct symbol *symbol = find_pc_function (funaddr);
abbb1732 368
b89667eb
DE
369 if (symbol)
370 return SYMBOL_PRINT_NAME (symbol);
371 }
372
373 {
374 /* Try the minimal symbols. */
7cbd4a93 375 struct bound_minimal_symbol msymbol = lookup_minimal_symbol_by_pc (funaddr);
abbb1732 376
7cbd4a93 377 if (msymbol.minsym)
efd66ac6 378 return MSYMBOL_PRINT_NAME (msymbol.minsym);
b89667eb
DE
379 }
380
381 {
382 char *tmp = xstrprintf (_(RAW_FUNCTION_ADDRESS_FORMAT),
383 hex_string (funaddr));
abbb1732 384
b89667eb
DE
385 gdb_assert (strlen (tmp) + 1 <= buf_size);
386 strcpy (buf, tmp);
387 xfree (tmp);
388 return buf;
389 }
390}
391
388a7084
PA
392/* All the meta data necessary to extract the call's return value. */
393
394struct call_return_meta_info
395{
396 /* The caller frame's architecture. */
397 struct gdbarch *gdbarch;
398
399 /* The called function. */
400 struct value *function;
401
402 /* The return value's type. */
403 struct type *value_type;
404
405 /* Are we returning a value using a structure return or a normal
406 value return? */
407 int struct_return_p;
408
409 /* If using a structure return, this is the structure's address. */
410 CORE_ADDR struct_addr;
411
412 /* Whether stack temporaries are enabled. */
413 int stack_temporaries_enabled;
414};
415
416/* Extract the called function's return value. */
417
418static struct value *
419get_call_return_value (struct call_return_meta_info *ri)
420{
421 struct value *retval = NULL;
422 int stack_temporaries = thread_stack_temporaries_enabled_p (inferior_ptid);
423
424 if (TYPE_CODE (ri->value_type) == TYPE_CODE_VOID)
425 retval = allocate_value (ri->value_type);
426 else if (ri->struct_return_p)
427 {
428 if (stack_temporaries)
429 {
430 retval = value_from_contents_and_address (ri->value_type, NULL,
431 ri->struct_addr);
432 push_thread_stack_temporary (inferior_ptid, retval);
433 }
434 else
435 {
436 retval = allocate_value (ri->value_type);
437 read_value_memory (retval, 0, 1, ri->struct_addr,
438 value_contents_raw (retval),
439 TYPE_LENGTH (ri->value_type));
440 }
441 }
442 else
443 {
444 retval = allocate_value (ri->value_type);
445 gdbarch_return_value (ri->gdbarch, ri->function, ri->value_type,
446 get_current_regcache (),
447 value_contents_raw (retval), NULL);
448 if (stack_temporaries && class_or_union_p (ri->value_type))
449 {
450 /* Values of class type returned in registers are copied onto
451 the stack and their lval_type set to lval_memory. This is
452 required because further evaluation of the expression
453 could potentially invoke methods on the return value
454 requiring GDB to evaluate the "this" pointer. To evaluate
455 the this pointer, GDB needs the memory address of the
456 value. */
457 value_force_lval (retval, ri->struct_addr);
458 push_thread_stack_temporary (inferior_ptid, retval);
459 }
460 }
461
462 gdb_assert (retval != NULL);
463 return retval;
464}
465
466/* Data for the FSM that manages an infcall. It's main job is to
467 record the called function's return value. */
468
469struct call_thread_fsm
470{
471 /* The base class. */
472 struct thread_fsm thread_fsm;
473
474 /* All the info necessary to be able to extract the return
475 value. */
476 struct call_return_meta_info return_meta_info;
477
478 /* The called function's return value. This is extracted from the
479 target before the dummy frame is popped. */
480 struct value *return_value;
3b12939d
PA
481
482 /* The top level that started the infcall (and is synchronously
483 waiting for it to end). */
484 struct ui *waiting_ui;
388a7084
PA
485};
486
8980e177
PA
487static int call_thread_fsm_should_stop (struct thread_fsm *self,
488 struct thread_info *thread);
388a7084
PA
489static int call_thread_fsm_should_notify_stop (struct thread_fsm *self);
490
491/* call_thread_fsm's vtable. */
492
493static struct thread_fsm_ops call_thread_fsm_ops =
494{
495 NULL, /*dtor */
496 NULL, /* clean_up */
497 call_thread_fsm_should_stop,
498 NULL, /* return_value */
499 NULL, /* async_reply_reason*/
500 call_thread_fsm_should_notify_stop,
501};
502
503/* Allocate a new call_thread_fsm object. */
504
505static struct call_thread_fsm *
8980e177 506new_call_thread_fsm (struct ui *waiting_ui, struct interp *cmd_interp,
3b12939d 507 struct gdbarch *gdbarch, struct value *function,
388a7084
PA
508 struct type *value_type,
509 int struct_return_p, CORE_ADDR struct_addr)
510{
511 struct call_thread_fsm *sm;
512
513 sm = XCNEW (struct call_thread_fsm);
8980e177 514 thread_fsm_ctor (&sm->thread_fsm, &call_thread_fsm_ops, cmd_interp);
388a7084
PA
515
516 sm->return_meta_info.gdbarch = gdbarch;
517 sm->return_meta_info.function = function;
518 sm->return_meta_info.value_type = value_type;
519 sm->return_meta_info.struct_return_p = struct_return_p;
520 sm->return_meta_info.struct_addr = struct_addr;
521
3b12939d
PA
522 sm->waiting_ui = waiting_ui;
523
388a7084
PA
524 return sm;
525}
526
527/* Implementation of should_stop method for infcalls. */
528
529static int
8980e177
PA
530call_thread_fsm_should_stop (struct thread_fsm *self,
531 struct thread_info *thread)
388a7084
PA
532{
533 struct call_thread_fsm *f = (struct call_thread_fsm *) self;
534
535 if (stop_stack_dummy == STOP_STACK_DUMMY)
536 {
537 /* Done. */
538 thread_fsm_set_finished (self);
539
540 /* Stash the return value before the dummy frame is popped and
541 registers are restored to what they were before the
542 call.. */
543 f->return_value = get_call_return_value (&f->return_meta_info);
544
545 /* Break out of wait_sync_command_done. */
4b6749b9 546 scoped_restore save_ui = make_scoped_restore (&current_ui, f->waiting_ui);
223ffa71 547 target_terminal::ours ();
3b12939d 548 f->waiting_ui->prompt_state = PROMPT_NEEDED;
388a7084
PA
549 }
550
551 return 1;
552}
553
554/* Implementation of should_notify_stop method for infcalls. */
555
556static int
557call_thread_fsm_should_notify_stop (struct thread_fsm *self)
558{
559 if (thread_fsm_finished_p (self))
560 {
561 /* Infcall succeeded. Be silent and proceed with evaluating the
562 expression. */
563 return 0;
564 }
565
566 /* Something wrong happened. E.g., an unexpected breakpoint
567 triggered, or a signal was intercepted. Notify the stop. */
568 return 1;
569}
570
b89667eb
DE
571/* Subroutine of call_function_by_hand to simplify it.
572 Start up the inferior and wait for it to stop.
573 Return the exception if there's an error, or an exception with
574 reason >= 0 if there's no error.
575
576 This is done inside a TRY_CATCH so the caller needn't worry about
577 thrown errors. The caller should rethrow if there's an error. */
578
579static struct gdb_exception
388a7084
PA
580run_inferior_call (struct call_thread_fsm *sm,
581 struct thread_info *call_thread, CORE_ADDR real_pc)
b89667eb 582{
492d29ea 583 struct gdb_exception caught_error = exception_none;
16c381f0 584 int saved_in_infcall = call_thread->control.in_infcall;
b89667eb 585 ptid_t call_thread_ptid = call_thread->ptid;
3b12939d 586 enum prompt_state saved_prompt_state = current_ui->prompt_state;
28bf096c 587 int was_running = call_thread->state == THREAD_RUNNING;
cb814510 588 int saved_ui_async = current_ui->async;
c933f875
PA
589
590 /* Infcalls run synchronously, in the foreground. */
3b12939d 591 current_ui->prompt_state = PROMPT_BLOCKED;
0b333c5e
PA
592 /* So that we don't print the prompt prematurely in
593 fetch_inferior_event. */
cb814510 594 current_ui->async = 0;
b89667eb 595
6d61dee5
PA
596 delete_file_handler (current_ui->input_fd);
597
16c381f0 598 call_thread->control.in_infcall = 1;
c5a4d20b 599
70509625 600 clear_proceed_status (0);
b89667eb 601
388a7084
PA
602 /* Associate the FSM with the thread after clear_proceed_status
603 (otherwise it'd clear this FSM), and before anything throws, so
604 we don't leak it (and any resources it manages). */
605 call_thread->thread_fsm = &sm->thread_fsm;
606
b89667eb 607 disable_watchpoints_before_interactive_call_start ();
16c381f0 608
46c03469 609 /* We want to print return value, please... */
16c381f0 610 call_thread->control.proceed_to_finish = 1;
b89667eb 611
492d29ea 612 TRY
3dd5b83d 613 {
64ce06e4 614 proceed (real_pc, GDB_SIGNAL_0);
3dd5b83d
PA
615
616 /* Inferior function calls are always synchronous, even if the
0b333c5e
PA
617 target supports asynchronous execution. */
618 wait_sync_command_done ();
3dd5b83d 619 }
492d29ea
PA
620 CATCH (e, RETURN_MASK_ALL)
621 {
622 caught_error = e;
623 }
624 END_CATCH
b89667eb 625
3b12939d
PA
626 /* If GDB has the prompt blocked before, then ensure that it remains
627 so. normal_stop calls async_enable_stdin, so reset the prompt
628 state again here. In other cases, stdin will be re-enabled by
0b333c5e 629 inferior_event_handler, when an exception is thrown. */
3b12939d 630 current_ui->prompt_state = saved_prompt_state;
6d61dee5
PA
631 if (current_ui->prompt_state == PROMPT_BLOCKED)
632 delete_file_handler (current_ui->input_fd);
633 else
634 ui_register_input_event_handler (current_ui);
cb814510 635 current_ui->async = saved_ui_async;
0b333c5e 636
c5a4d20b
PA
637 /* At this point the current thread may have changed. Refresh
638 CALL_THREAD as it could be invalid if its thread has exited. */
e09875d4 639 call_thread = find_thread_ptid (call_thread_ptid);
b89667eb 640
28bf096c
PA
641 /* If the infcall does NOT succeed, normal_stop will have already
642 finished the thread states. However, on success, normal_stop
643 defers here, so that we can set back the thread states to what
644 they were before the call. Note that we must also finish the
645 state of new threads that might have spawned while the call was
646 running. The main cases to handle are:
647
648 - "(gdb) print foo ()", or any other command that evaluates an
649 expression at the prompt. (The thread was marked stopped before.)
650
651 - "(gdb) break foo if return_false()" or similar cases where we
652 do an infcall while handling an event (while the thread is still
653 marked running). In this example, whether the condition
654 evaluates true and thus we'll present a user-visible stop is
655 decided elsewhere. */
656 if (!was_running
657 && ptid_equal (call_thread_ptid, inferior_ptid)
658 && stop_stack_dummy == STOP_STACK_DUMMY)
659 finish_thread_state (user_visible_resume_ptid (0));
660
b89667eb
DE
661 enable_watchpoints_after_interactive_call_stop ();
662
663 /* Call breakpoint_auto_delete on the current contents of the bpstat
664 of inferior call thread.
665 If all error()s out of proceed ended up calling normal_stop
666 (and perhaps they should; it already does in the special case
667 of error out of resume()), then we wouldn't need this. */
492d29ea 668 if (caught_error.reason < 0)
b89667eb 669 {
c5a4d20b 670 if (call_thread != NULL)
16c381f0 671 breakpoint_auto_delete (call_thread->control.stop_bpstat);
b89667eb
DE
672 }
673
c5a4d20b 674 if (call_thread != NULL)
16c381f0 675 call_thread->control.in_infcall = saved_in_infcall;
c5a4d20b 676
492d29ea 677 return caught_error;
b89667eb
DE
678}
679
aa7d318d
TT
680/* A cleanup function that calls delete_std_terminate_breakpoint. */
681static void
682cleanup_delete_std_terminate_breakpoint (void *ignore)
683{
684 delete_std_terminate_breakpoint ();
685}
686
ed12ef62
JK
687/* See infcall.h. */
688
689struct value *
7022349d
PA
690call_function_by_hand (struct value *function,
691 type *default_return_type,
692 int nargs, struct value **args)
ed12ef62 693{
7022349d
PA
694 return call_function_by_hand_dummy (function, default_return_type,
695 nargs, args, NULL, NULL);
ed12ef62
JK
696}
697
04714b91
AC
698/* All this stuff with a dummy frame may seem unnecessarily complicated
699 (why not just save registers in GDB?). The purpose of pushing a dummy
700 frame which looks just like a real frame is so that if you call a
701 function and then hit a breakpoint (get a signal, etc), "backtrace"
702 will look right. Whether the backtrace needs to actually show the
703 stack at the time the inferior function was called is debatable, but
704 it certainly needs to not display garbage. So if you are contemplating
705 making dummy frames be different from normal frames, consider that. */
706
707/* Perform a function call in the inferior.
708 ARGS is a vector of values of arguments (NARGS of them).
709 FUNCTION is a value, the function to be called.
710 Returns a value representing what the function returned.
711 May fail to return, if a breakpoint or signal is hit
712 during the execution of the function.
713
1777feb0 714 ARGS is modified to contain coerced values. */
04714b91
AC
715
716struct value *
ed12ef62 717call_function_by_hand_dummy (struct value *function,
7022349d 718 type *default_return_type,
ed12ef62 719 int nargs, struct value **args,
558e5469 720 dummy_frame_dtor_ftype *dummy_dtor,
ed12ef62 721 void *dummy_dtor_data)
04714b91 722{
52f0bd74 723 CORE_ADDR sp;
41f1b697 724 struct type *values_type, *target_values_type;
18648a37 725 unsigned char struct_return = 0, hidden_first_param_p = 0;
04714b91 726 CORE_ADDR struct_addr = 0;
16c381f0 727 struct infcall_control_state *inf_status;
04714b91 728 struct cleanup *inf_status_cleanup;
16c381f0 729 struct infcall_suspend_state *caller_state;
04714b91 730 CORE_ADDR funaddr;
04714b91 731 CORE_ADDR real_pc;
df407dfe 732 struct type *ftype = check_typedef (value_type (function));
d585e13a 733 CORE_ADDR bp_addr;
96860204 734 struct frame_id dummy_id;
41f1b697 735 struct cleanup *args_cleanup;
0b9dfe2b
MD
736 struct frame_info *frame;
737 struct gdbarch *gdbarch;
aa7d318d 738 struct cleanup *terminate_bp_cleanup;
b89667eb
DE
739 ptid_t call_thread_ptid;
740 struct gdb_exception e;
b89667eb 741 char name_buf[RAW_FUNCTION_ADDRESS_SIZE];
6c659fc2 742 int stack_temporaries = thread_stack_temporaries_enabled_p (inferior_ptid);
04714b91 743
4c850810
DJ
744 if (TYPE_CODE (ftype) == TYPE_CODE_PTR)
745 ftype = check_typedef (TYPE_TARGET_TYPE (ftype));
746
04714b91
AC
747 if (!target_has_execution)
748 noprocess ();
749
573cda03
SS
750 if (get_traceframe_number () >= 0)
751 error (_("May not call functions while looking at trace frames."));
752
949dc678 753 if (execution_direction == EXEC_REVERSE)
c2949be0 754 error (_("Cannot call functions in reverse mode."));
949dc678 755
0b9dfe2b
MD
756 frame = get_current_frame ();
757 gdbarch = get_frame_arch (frame);
758
759 if (!gdbarch_push_dummy_call_p (gdbarch))
2e74121d 760 error (_("This target does not support function calls."));
a86c5fc9 761
b89667eb
DE
762 /* A cleanup for the inferior status.
763 This is only needed while we're preparing the inferior function call. */
16c381f0
JK
764 inf_status = save_infcall_control_state ();
765 inf_status_cleanup
766 = make_cleanup_restore_infcall_control_state (inf_status);
04714b91 767
b89667eb
DE
768 /* Save the caller's registers and other state associated with the
769 inferior itself so that they can be restored once the
96860204
AC
770 callee returns. To allow nested calls the registers are (further
771 down) pushed onto a dummy frame stack. Include a cleanup (which
772 is tossed once the regcache has been pushed). */
16c381f0
JK
773 caller_state = save_infcall_suspend_state ();
774 make_cleanup_restore_infcall_suspend_state (caller_state);
04714b91 775
04714b91 776 /* Ensure that the initial SP is correctly aligned. */
ebc7896c 777 {
0b9dfe2b 778 CORE_ADDR old_sp = get_frame_sp (frame);
abbb1732 779
0b9dfe2b 780 if (gdbarch_frame_align_p (gdbarch))
ebc7896c 781 {
0b9dfe2b 782 sp = gdbarch_frame_align (gdbarch, old_sp);
8b148df9
AC
783 /* NOTE: cagney/2003-08-13: Skip the "red zone". For some
784 ABIs, a function can use memory beyond the inner most stack
785 address. AMD64 called that region the "red zone". Skip at
786 least the "red zone" size before allocating any space on
787 the stack. */
0b9dfe2b
MD
788 if (gdbarch_inner_than (gdbarch, 1, 2))
789 sp -= gdbarch_frame_red_zone_size (gdbarch);
8b148df9 790 else
0b9dfe2b 791 sp += gdbarch_frame_red_zone_size (gdbarch);
8b148df9 792 /* Still aligned? */
0b9dfe2b 793 gdb_assert (sp == gdbarch_frame_align (gdbarch, sp));
ebc7896c
AC
794 /* NOTE: cagney/2002-09-18:
795
796 On a RISC architecture, a void parameterless generic dummy
797 frame (i.e., no parameters, no result) typically does not
798 need to push anything the stack and hence can leave SP and
c48a845b 799 FP. Similarly, a frameless (possibly leaf) function does
ebc7896c
AC
800 not push anything on the stack and, hence, that too can
801 leave FP and SP unchanged. As a consequence, a sequence of
802 void parameterless generic dummy frame calls to frameless
803 functions will create a sequence of effectively identical
804 frames (SP, FP and TOS and PC the same). This, not
805 suprisingly, results in what appears to be a stack in an
806 infinite loop --- when GDB tries to find a generic dummy
807 frame on the internal dummy frame stack, it will always
808 find the first one.
809
810 To avoid this problem, the code below always grows the
811 stack. That way, two dummy frames can never be identical.
812 It does burn a few bytes of stack but that is a small price
813 to pay :-). */
ebc7896c
AC
814 if (sp == old_sp)
815 {
0b9dfe2b 816 if (gdbarch_inner_than (gdbarch, 1, 2))
ebc7896c 817 /* Stack grows down. */
0b9dfe2b 818 sp = gdbarch_frame_align (gdbarch, old_sp - 1);
ebc7896c
AC
819 else
820 /* Stack grows up. */
0b9dfe2b 821 sp = gdbarch_frame_align (gdbarch, old_sp + 1);
ebc7896c 822 }
0e095b7e
JK
823 /* SP may have underflown address zero here from OLD_SP. Memory access
824 functions will probably fail in such case but that is a target's
825 problem. */
ebc7896c
AC
826 }
827 else
a59fe496
AC
828 /* FIXME: cagney/2002-09-18: Hey, you loose!
829
8b148df9
AC
830 Who knows how badly aligned the SP is!
831
832 If the generic dummy frame ends up empty (because nothing is
833 pushed) GDB won't be able to correctly perform back traces.
834 If a target is having trouble with backtraces, first thing to
1777feb0 835 do is add FRAME_ALIGN() to the architecture vector. If that
669fac23 836 fails, try dummy_id().
8b148df9
AC
837
838 If the ABI specifies a "Red Zone" (see the doco) the code
839 below will quietly trash it. */
ebc7896c 840 sp = old_sp;
6c659fc2
SC
841
842 /* Skip over the stack temporaries that might have been generated during
843 the evaluation of an expression. */
844 if (stack_temporaries)
845 {
846 struct value *lastval;
847
848 lastval = get_last_thread_stack_temporary (inferior_ptid);
849 if (lastval != NULL)
850 {
851 CORE_ADDR lastval_addr = value_address (lastval);
852
853 if (gdbarch_inner_than (gdbarch, 1, 2))
854 {
855 gdb_assert (sp >= lastval_addr);
856 sp = lastval_addr;
857 }
858 else
859 {
860 gdb_assert (sp <= lastval_addr);
861 sp = lastval_addr + TYPE_LENGTH (value_type (lastval));
862 }
863
864 if (gdbarch_frame_align_p (gdbarch))
865 sp = gdbarch_frame_align (gdbarch, sp);
866 }
867 }
ebc7896c 868 }
04714b91 869
df407dfe 870 funaddr = find_function_addr (function, &values_type);
7022349d
PA
871 if (values_type == NULL)
872 values_type = default_return_type;
873 if (values_type == NULL)
874 {
875 const char *name = get_function_name (funaddr,
876 name_buf, sizeof (name_buf));
877 error (_("'%s' has unknown return type; "
878 "cast the call to its declared return type"),
879 name);
880 }
7788af6d 881
f168693b 882 values_type = check_typedef (values_type);
04714b91 883
41f1b697
DJ
884 /* Are we returning a value using a structure return (passing a
885 hidden argument pointing to storage) or a normal value return?
886 There are two cases: language-mandated structure return and
887 target ABI structure return. The variable STRUCT_RETURN only
888 describes the latter. The language version is handled by passing
889 the return location as the first parameter to the function,
890 even preceding "this". This is different from the target
891 ABI version, which is target-specific; for instance, on ia64
892 the first argument is passed in out0 but the hidden structure
893 return pointer would normally be passed in r8. */
894
18648a37 895 if (gdbarch_return_in_first_hidden_param_p (gdbarch, values_type))
41f1b697 896 {
18648a37 897 hidden_first_param_p = 1;
04714b91 898
41f1b697
DJ
899 /* Tell the target specific argument pushing routine not to
900 expect a value. */
48319d1f 901 target_values_type = builtin_type (gdbarch)->builtin_void;
41f1b697
DJ
902 }
903 else
904 {
6a3a010b 905 struct_return = using_struct_return (gdbarch, function, values_type);
41f1b697
DJ
906 target_values_type = values_type;
907 }
04714b91 908
162078c8
NB
909 observer_notify_inferior_call_pre (inferior_ptid, funaddr);
910
7043d8dc
AC
911 /* Determine the location of the breakpoint (and possibly other
912 stuff) that the called function will return to. The SPARC, for a
913 function returning a structure or union, needs to make space for
914 not just the breakpoint but also an extra word containing the
915 size (?) of the structure being passed. */
916
0b9dfe2b 917 switch (gdbarch_call_dummy_location (gdbarch))
04714b91
AC
918 {
919 case ON_STACK:
a14dd77e
JK
920 {
921 const gdb_byte *bp_bytes;
922 CORE_ADDR bp_addr_as_address;
923 int bp_size;
924
925 /* Be careful BP_ADDR is in inferior PC encoding while
926 BP_ADDR_AS_ADDRESS is a plain memory address. */
927
928 sp = push_dummy_code (gdbarch, sp, funaddr, args, nargs,
929 target_values_type, &real_pc, &bp_addr,
930 get_current_regcache ());
931
932 /* Write a legitimate instruction at the point where the infcall
933 breakpoint is going to be inserted. While this instruction
934 is never going to be executed, a user investigating the
935 memory from GDB would see this instruction instead of random
936 uninitialized bytes. We chose the breakpoint instruction
937 as it may look as the most logical one to the user and also
938 valgrind 3.7.0 needs it for proper vgdb inferior calls.
939
940 If software breakpoints are unsupported for this target we
941 leave the user visible memory content uninitialized. */
942
943 bp_addr_as_address = bp_addr;
944 bp_bytes = gdbarch_breakpoint_from_pc (gdbarch, &bp_addr_as_address,
945 &bp_size);
946 if (bp_bytes != NULL)
947 write_memory (bp_addr_as_address, bp_bytes, bp_size);
948 }
7043d8dc 949 break;
5931a2fa
JK
950 case AT_ENTRY_POINT:
951 {
952 CORE_ADDR dummy_addr;
953
954 real_pc = funaddr;
955 dummy_addr = entry_point_address ();
a14dd77e 956
5931a2fa 957 /* A call dummy always consists of just a single breakpoint, so
a14dd77e
JK
958 its address is the same as the address of the dummy.
959
960 The actual breakpoint is inserted separatly so there is no need to
961 write that out. */
5931a2fa
JK
962 bp_addr = dummy_addr;
963 break;
964 }
04714b91 965 default:
e2e0b3e5 966 internal_error (__FILE__, __LINE__, _("bad switch"));
04714b91
AC
967 }
968
04714b91 969 if (nargs < TYPE_NFIELDS (ftype))
2e74121d 970 error (_("Too few arguments in function call."));
04714b91 971
ebc7896c
AC
972 {
973 int i;
abbb1732 974
ebc7896c
AC
975 for (i = nargs - 1; i >= 0; i--)
976 {
977 int prototyped;
978 struct type *param_type;
979
980 /* FIXME drow/2002-05-31: Should just always mark methods as
981 prototyped. Can we respect TYPE_VARARGS? Probably not. */
982 if (TYPE_CODE (ftype) == TYPE_CODE_METHOD)
983 prototyped = 1;
7022349d
PA
984 if (TYPE_TARGET_TYPE (ftype) == NULL && TYPE_NFIELDS (ftype) == 0
985 && default_return_type != NULL)
986 {
987 /* Calling a no-debug function with the return type
988 explicitly cast. Assume the function is prototyped,
989 with a prototype matching the types of the arguments.
990 E.g., with:
991 float mult (float v1, float v2) { return v1 * v2; }
992 This:
993 (gdb) p (float) mult (2.0f, 3.0f)
994 Is a simpler alternative to:
995 (gdb) p ((float (*) (float, float)) mult) (2.0f, 3.0f)
996 */
997 prototyped = 1;
998 }
ebc7896c
AC
999 else if (i < TYPE_NFIELDS (ftype))
1000 prototyped = TYPE_PROTOTYPED (ftype);
1001 else
1002 prototyped = 0;
1003
1004 if (i < TYPE_NFIELDS (ftype))
1005 param_type = TYPE_FIELD_TYPE (ftype, i);
1006 else
1007 param_type = NULL;
41f1b697 1008
7788af6d
UW
1009 args[i] = value_arg_coerce (gdbarch, args[i],
1010 param_type, prototyped, &sp);
ebc7896c 1011
41f1b697
DJ
1012 if (param_type != NULL && language_pass_by_reference (param_type))
1013 args[i] = value_addr (args[i]);
ebc7896c
AC
1014 }
1015 }
04714b91 1016
04714b91
AC
1017 /* Reserve space for the return structure to be written on the
1018 stack, if necessary. Make certain that the value is correctly
6c659fc2
SC
1019 aligned.
1020
1021 While evaluating expressions, we reserve space on the stack for
1022 return values of class type even if the language ABI and the target
1023 ABI do not require that the return value be passed as a hidden first
1024 argument. This is because we want to store the return value as an
1025 on-stack temporary while the expression is being evaluated. This
1026 enables us to have chained function calls in expressions.
04714b91 1027
6c659fc2
SC
1028 Keeping the return values as on-stack temporaries while the expression
1029 is being evaluated is OK because the thread is stopped until the
1030 expression is completely evaluated. */
1031
1032 if (struct_return || hidden_first_param_p
1033 || (stack_temporaries && class_or_union_p (values_type)))
04714b91 1034 {
0b9dfe2b 1035 if (gdbarch_inner_than (gdbarch, 1, 2))
04714b91
AC
1036 {
1037 /* Stack grows downward. Align STRUCT_ADDR and SP after
1038 making space for the return value. */
744a8059 1039 sp -= TYPE_LENGTH (values_type);
0b9dfe2b
MD
1040 if (gdbarch_frame_align_p (gdbarch))
1041 sp = gdbarch_frame_align (gdbarch, sp);
04714b91
AC
1042 struct_addr = sp;
1043 }
1044 else
1045 {
1046 /* Stack grows upward. Align the frame, allocate space, and
1777feb0 1047 then again, re-align the frame??? */
0b9dfe2b
MD
1048 if (gdbarch_frame_align_p (gdbarch))
1049 sp = gdbarch_frame_align (gdbarch, sp);
04714b91 1050 struct_addr = sp;
744a8059 1051 sp += TYPE_LENGTH (values_type);
0b9dfe2b
MD
1052 if (gdbarch_frame_align_p (gdbarch))
1053 sp = gdbarch_frame_align (gdbarch, sp);
04714b91
AC
1054 }
1055 }
1056
18648a37 1057 if (hidden_first_param_p)
41f1b697
DJ
1058 {
1059 struct value **new_args;
1060
1061 /* Add the new argument to the front of the argument list. */
8d749320 1062 new_args = XNEWVEC (struct value *, nargs + 1);
41f1b697
DJ
1063 new_args[0] = value_from_pointer (lookup_pointer_type (values_type),
1064 struct_addr);
1065 memcpy (&new_args[1], &args[0], sizeof (struct value *) * nargs);
1066 args = new_args;
1067 nargs++;
1068 args_cleanup = make_cleanup (xfree, args);
1069 }
1070 else
1071 args_cleanup = make_cleanup (null_cleanup, NULL);
1072
04714b91
AC
1073 /* Create the dummy stack frame. Pass in the call dummy address as,
1074 presumably, the ABI code knows where, in the call dummy, the
1075 return address should be pointed. */
0b9dfe2b
MD
1076 sp = gdbarch_push_dummy_call (gdbarch, function, get_current_regcache (),
1077 bp_addr, nargs, args,
594f7785 1078 sp, struct_return, struct_addr);
04714b91 1079
41f1b697
DJ
1080 do_cleanups (args_cleanup);
1081
96860204
AC
1082 /* Set up a frame ID for the dummy frame so we can pass it to
1083 set_momentary_breakpoint. We need to give the breakpoint a frame
1084 ID so that the breakpoint code can correctly re-identify the
1085 dummy breakpoint. */
8241eaa6 1086 /* Sanity. The exact same SP value is returned by PUSH_DUMMY_CALL,
669fac23 1087 saved as the dummy-frame TOS, and used by dummy_id to form
8241eaa6 1088 the frame ID's stack address. */
96860204 1089 dummy_id = frame_id_build (sp, bp_addr);
04714b91 1090
74cfe982
AC
1091 /* Create a momentary breakpoint at the return address of the
1092 inferior. That way it breaks when it returns. */
04714b91 1093
74cfe982 1094 {
51abb421 1095 symtab_and_line sal;
6c95b8df 1096 sal.pspace = current_program_space;
74cfe982
AC
1097 sal.pc = bp_addr;
1098 sal.section = find_pc_overlay (sal.pc);
51abb421 1099
8241eaa6
AC
1100 /* Sanity. The exact same SP value is returned by
1101 PUSH_DUMMY_CALL, saved as the dummy-frame TOS, and used by
669fac23 1102 dummy_id to form the frame ID's stack address. */
51abb421
PA
1103 breakpoint *bpt = set_momentary_breakpoint (gdbarch, sal,
1104 dummy_id, bp_call_dummy);
c70a6932
JK
1105
1106 /* set_momentary_breakpoint invalidates FRAME. */
1107 frame = NULL;
1108
74cfe982 1109 bpt->disposition = disp_del;
e2e4d78b
JK
1110 gdb_assert (bpt->related_breakpoint == bpt);
1111
51abb421 1112 breakpoint *longjmp_b = set_longjmp_breakpoint_for_call_dummy ();
e2e4d78b
JK
1113 if (longjmp_b)
1114 {
1115 /* Link BPT into the chain of LONGJMP_B. */
1116 bpt->related_breakpoint = longjmp_b;
1117 while (longjmp_b->related_breakpoint != bpt->related_breakpoint)
1118 longjmp_b = longjmp_b->related_breakpoint;
1119 longjmp_b->related_breakpoint = bpt;
1120 }
74cfe982 1121 }
04714b91 1122
7cd1089b
PM
1123 /* Create a breakpoint in std::terminate.
1124 If a C++ exception is raised in the dummy-frame, and the
1125 exception handler is (normally, and expected to be) out-of-frame,
1126 the default C++ handler will (wrongly) be called in an inferior
1127 function call. This is wrong, as an exception can be normally
1128 and legally handled out-of-frame. The confines of the dummy frame
1129 prevent the unwinder from finding the correct handler (or any
1130 handler, unless it is in-frame). The default handler calls
1131 std::terminate. This will kill the inferior. Assert that
1132 terminate should never be called in an inferior function
1133 call. Place a momentary breakpoint in the std::terminate function
1134 and if triggered in the call, rewind. */
1135 if (unwind_on_terminating_exception_p)
aa7d318d 1136 set_std_terminate_breakpoint ();
7cd1089b 1137
8a6c4031
JK
1138 /* Discard both inf_status and caller_state cleanups.
1139 From this point on we explicitly restore the associated state
1140 or discard it. */
1141 discard_cleanups (inf_status_cleanup);
1142
96860204
AC
1143 /* Everything's ready, push all the info needed to restore the
1144 caller (and identify the dummy-frame) onto the dummy-frame
1145 stack. */
b67a2c6f 1146 dummy_frame_push (caller_state, &dummy_id, inferior_ptid);
ed12ef62
JK
1147 if (dummy_dtor != NULL)
1148 register_dummy_frame_dtor (dummy_id, inferior_ptid,
1149 dummy_dtor, dummy_dtor_data);
b89667eb 1150
7cd1089b 1151 /* Register a clean-up for unwind_on_terminating_exception_breakpoint. */
aa7d318d
TT
1152 terminate_bp_cleanup = make_cleanup (cleanup_delete_std_terminate_breakpoint,
1153 NULL);
7cd1089b 1154
96860204
AC
1155 /* - SNIP - SNIP - SNIP - SNIP - SNIP - SNIP - SNIP - SNIP - SNIP -
1156 If you're looking to implement asynchronous dummy-frames, then
1157 just below is the place to chop this function in two.. */
1158
b89667eb
DE
1159 /* TP is invalid after run_inferior_call returns, so enclose this
1160 in a block so that it's only in scope during the time it's valid. */
74cfe982 1161 {
32400beb 1162 struct thread_info *tp = inferior_thread ();
388a7084
PA
1163 struct thread_fsm *saved_sm;
1164 struct call_thread_fsm *sm;
1165
1166 /* Save the current FSM. We'll override it. */
1167 saved_sm = tp->thread_fsm;
1168 tp->thread_fsm = NULL;
74cfe982 1169
b89667eb
DE
1170 /* Save this thread's ptid, we need it later but the thread
1171 may have exited. */
1172 call_thread_ptid = tp->ptid;
74cfe982 1173
b89667eb 1174 /* Run the inferior until it stops. */
f5871ec0 1175
388a7084
PA
1176 /* Create the FSM used to manage the infcall. It tells infrun to
1177 not report the stop to the user, and captures the return value
1178 before the dummy frame is popped. run_inferior_call registers
1179 it with the thread ASAP. */
8980e177 1180 sm = new_call_thread_fsm (current_ui, command_interp (),
3b12939d 1181 gdbarch, function,
388a7084
PA
1182 values_type,
1183 struct_return || hidden_first_param_p,
1184 struct_addr);
1185
1186 e = run_inferior_call (sm, tp, real_pc);
1187
1188 observer_notify_inferior_call_post (call_thread_ptid, funaddr);
1189
1190 tp = find_thread_ptid (call_thread_ptid);
1191 if (tp != NULL)
1192 {
1193 /* The FSM should still be the same. */
1194 gdb_assert (tp->thread_fsm == &sm->thread_fsm);
1195
1196 if (thread_fsm_finished_p (tp->thread_fsm))
1197 {
1198 struct value *retval;
1199
1200 /* The inferior call is successful. Pop the dummy frame,
1201 which runs its destructors and restores the inferior's
1202 suspend state, and restore the inferior control
1203 state. */
1204 dummy_frame_pop (dummy_id, call_thread_ptid);
1205 restore_infcall_control_state (inf_status);
1206
1207 /* Get the return value. */
1208 retval = sm->return_value;
1209
1210 /* Clean up / destroy the call FSM, and restore the
1211 original one. */
8980e177 1212 thread_fsm_clean_up (tp->thread_fsm, tp);
388a7084
PA
1213 thread_fsm_delete (tp->thread_fsm);
1214 tp->thread_fsm = saved_sm;
04714b91 1215
388a7084
PA
1216 maybe_remove_breakpoints ();
1217
1218 do_cleanups (terminate_bp_cleanup);
1219 gdb_assert (retval != NULL);
1220 return retval;
1221 }
1222
1223 /* Didn't complete. Restore previous state machine, and
1224 handle the error. */
1225 tp->thread_fsm = saved_sm;
1226 }
1227 }
162078c8 1228
b89667eb
DE
1229 /* Rethrow an error if we got one trying to run the inferior. */
1230
1231 if (e.reason < 0)
1232 {
1233 const char *name = get_function_name (funaddr,
1234 name_buf, sizeof (name_buf));
1235
16c381f0 1236 discard_infcall_control_state (inf_status);
b89667eb
DE
1237
1238 /* We could discard the dummy frame here if the program exited,
1239 but it will get garbage collected the next time the program is
1240 run anyway. */
1241
1242 switch (e.reason)
1243 {
1244 case RETURN_ERROR:
ac74f770
MS
1245 throw_error (e.error, _("%s\n\
1246An error occurred while in a function called from GDB.\n\
1247Evaluation of the expression containing the function\n\
1248(%s) will be abandoned.\n\
1249When the function is done executing, GDB will silently stop."),
b89667eb
DE
1250 e.message, name);
1251 case RETURN_QUIT:
1252 default:
1253 throw_exception (e);
1254 }
1255 }
1256
1257 /* If the program has exited, or we stopped at a different thread,
1258 exit and inform the user. */
1259
de04a248
DE
1260 if (! target_has_execution)
1261 {
b89667eb
DE
1262 const char *name = get_function_name (funaddr,
1263 name_buf, sizeof (name_buf));
1264
1265 /* If we try to restore the inferior status,
de04a248 1266 we'll crash as the inferior is no longer running. */
16c381f0 1267 discard_infcall_control_state (inf_status);
b89667eb
DE
1268
1269 /* We could discard the dummy frame here given that the program exited,
1270 but it will get garbage collected the next time the program is
1271 run anyway. */
1272
3e43a32a
MS
1273 error (_("The program being debugged exited while in a function "
1274 "called from GDB.\n"
1275 "Evaluation of the expression containing the function\n"
1276 "(%s) will be abandoned."),
b89667eb
DE
1277 name);
1278 }
1279
1280 if (! ptid_equal (call_thread_ptid, inferior_ptid))
1281 {
1282 const char *name = get_function_name (funaddr,
1283 name_buf, sizeof (name_buf));
1284
1285 /* We've switched threads. This can happen if another thread gets a
1286 signal or breakpoint while our thread was running.
1287 There's no point in restoring the inferior status,
1288 we're in a different thread. */
16c381f0 1289 discard_infcall_control_state (inf_status);
b89667eb
DE
1290 /* Keep the dummy frame record, if the user switches back to the
1291 thread with the hand-call, we'll need it. */
1292 if (stopped_by_random_signal)
ac74f770
MS
1293 error (_("\
1294The program received a signal in another thread while\n\
1295making a function call from GDB.\n\
1296Evaluation of the expression containing the function\n\
1297(%s) will be abandoned.\n\
1298When the function is done executing, GDB will silently stop."),
b89667eb
DE
1299 name);
1300 else
ac74f770
MS
1301 error (_("\
1302The program stopped in another thread while making a function call from GDB.\n\
1303Evaluation of the expression containing the function\n\
1304(%s) will be abandoned.\n\
1305When the function is done executing, GDB will silently stop."),
b89667eb 1306 name);
de04a248
DE
1307 }
1308
52557533 1309 {
5fe75eec 1310 /* Make a copy as NAME may be in an objfile freed by dummy_frame_pop. */
395423c4
TT
1311 std::string name = get_function_name (funaddr, name_buf,
1312 sizeof (name_buf));
b89667eb 1313
52557533
AC
1314 if (stopped_by_random_signal)
1315 {
1316 /* We stopped inside the FUNCTION because of a random
1317 signal. Further execution of the FUNCTION is not
1777feb0 1318 allowed. */
04714b91 1319
52557533
AC
1320 if (unwind_on_signal_p)
1321 {
1777feb0 1322 /* The user wants the context restored. */
52557533
AC
1323
1324 /* We must get back to the frame we were before the
b89667eb 1325 dummy call. */
b67a2c6f 1326 dummy_frame_pop (dummy_id, call_thread_ptid);
b89667eb
DE
1327
1328 /* We also need to restore inferior status to that before the
1329 dummy call. */
16c381f0 1330 restore_infcall_control_state (inf_status);
04714b91 1331
52557533
AC
1332 /* FIXME: Insert a bunch of wrap_here; name can be very
1333 long if it's a C++ name with arguments and stuff. */
ac74f770
MS
1334 error (_("\
1335The program being debugged was signaled while in a function called from GDB.\n\
1336GDB has restored the context to what it was before the call.\n\
1337To change this behavior use \"set unwindonsignal off\".\n\
1338Evaluation of the expression containing the function\n\
1339(%s) will be abandoned."),
395423c4 1340 name.c_str ());
52557533
AC
1341 }
1342 else
1343 {
1344 /* The user wants to stay in the frame where we stopped
b89667eb
DE
1345 (default).
1346 Discard inferior status, we're not at the same point
1347 we started at. */
16c381f0 1348 discard_infcall_control_state (inf_status);
b89667eb 1349
52557533
AC
1350 /* FIXME: Insert a bunch of wrap_here; name can be very
1351 long if it's a C++ name with arguments and stuff. */
ac74f770
MS
1352 error (_("\
1353The program being debugged was signaled while in a function called from GDB.\n\
1354GDB remains in the frame where the signal was received.\n\
1355To change this behavior use \"set unwindonsignal on\".\n\
1356Evaluation of the expression containing the function\n\
1357(%s) will be abandoned.\n\
1358When the function is done executing, GDB will silently stop."),
395423c4 1359 name.c_str ());
52557533
AC
1360 }
1361 }
04714b91 1362
aa7d318d 1363 if (stop_stack_dummy == STOP_STD_TERMINATE)
52557533 1364 {
aa7d318d
TT
1365 /* We must get back to the frame we were before the dummy
1366 call. */
b67a2c6f 1367 dummy_frame_pop (dummy_id, call_thread_ptid);
7cd1089b 1368
aa7d318d
TT
1369 /* We also need to restore inferior status to that before
1370 the dummy call. */
16c381f0 1371 restore_infcall_control_state (inf_status);
aa7d318d 1372
ac74f770
MS
1373 error (_("\
1374The program being debugged entered a std::terminate call, most likely\n\
1375caused by an unhandled C++ exception. GDB blocked this call in order\n\
1376to prevent the program from being terminated, and has restored the\n\
1377context to its original state before the call.\n\
1378To change this behaviour use \"set unwind-on-terminating-exception off\".\n\
1379Evaluation of the expression containing the function (%s)\n\
1380will be abandoned."),
395423c4 1381 name.c_str ());
aa7d318d
TT
1382 }
1383 else if (stop_stack_dummy == STOP_NONE)
1384 {
1385
b89667eb
DE
1386 /* We hit a breakpoint inside the FUNCTION.
1387 Keep the dummy frame, the user may want to examine its state.
1388 Discard inferior status, we're not at the same point
1389 we started at. */
16c381f0 1390 discard_infcall_control_state (inf_status);
b89667eb 1391
52557533
AC
1392 /* The following error message used to say "The expression
1393 which contained the function call has been discarded."
1394 It is a hard concept to explain in a few words. Ideally,
1395 GDB would be able to resume evaluation of the expression
1396 when the function finally is done executing. Perhaps
1397 someday this will be implemented (it would not be easy). */
1398 /* FIXME: Insert a bunch of wrap_here; name can be very long if it's
1399 a C++ name with arguments and stuff. */
ac74f770
MS
1400 error (_("\
1401The program being debugged stopped while in a function called from GDB.\n\
1402Evaluation of the expression containing the function\n\
1403(%s) will be abandoned.\n\
1404When the function is done executing, GDB will silently stop."),
395423c4 1405 name.c_str ());
52557533
AC
1406 }
1407
52557533 1408 }
04714b91 1409
388a7084
PA
1410 /* The above code errors out, so ... */
1411 gdb_assert_not_reached ("... should not be here");
04714b91 1412}
04714b91
AC
1413
1414void
1415_initialize_infcall (void)
1416{
1417 add_setshow_boolean_cmd ("coerce-float-to-double", class_obscure,
7915a72c
AC
1418 &coerce_float_to_double_p, _("\
1419Set coercion of floats to doubles when calling functions."), _("\
1420Show coercion of floats to doubles when calling functions"), _("\
04714b91
AC
1421Variables of type float should generally be converted to doubles before\n\
1422calling an unprototyped function, and left alone when calling a prototyped\n\
1423function. However, some older debug info formats do not provide enough\n\
1424information to determine that a function is prototyped. If this flag is\n\
1425set, GDB will perform the conversion for a function it considers\n\
1426unprototyped.\n\
7915a72c 1427The default is to perform the conversion.\n"),
2c5b56ce 1428 NULL,
920d2a44 1429 show_coerce_float_to_double_p,
2c5b56ce 1430 &setlist, &showlist);
04714b91
AC
1431
1432 add_setshow_boolean_cmd ("unwindonsignal", no_class,
7915a72c
AC
1433 &unwind_on_signal_p, _("\
1434Set unwinding of stack if a signal is received while in a call dummy."), _("\
1435Show unwinding of stack if a signal is received while in a call dummy."), _("\
04714b91
AC
1436The unwindonsignal lets the user determine what gdb should do if a signal\n\
1437is received while in a function called from gdb (call dummy). If set, gdb\n\
1438unwinds the stack and restore the context to what as it was before the call.\n\
7915a72c 1439The default is to stop in the frame where the signal was received."),
2c5b56ce 1440 NULL,
920d2a44 1441 show_unwind_on_signal_p,
2c5b56ce 1442 &setlist, &showlist);
7cd1089b
PM
1443
1444 add_setshow_boolean_cmd ("unwind-on-terminating-exception", no_class,
1445 &unwind_on_terminating_exception_p, _("\
1446Set unwinding of stack if std::terminate is called while in call dummy."), _("\
3e43a32a
MS
1447Show unwinding of stack if std::terminate() is called while in a call dummy."),
1448 _("\
7cd1089b
PM
1449The unwind on terminating exception flag lets the user determine\n\
1450what gdb should do if a std::terminate() call is made from the\n\
1451default exception handler. If set, gdb unwinds the stack and restores\n\
1452the context to what it was before the call. If unset, gdb allows the\n\
1453std::terminate call to proceed.\n\
1454The default is to unwind the frame."),
1455 NULL,
1456 show_unwind_on_terminating_exception_p,
1457 &setlist, &showlist);
1458
04714b91 1459}
This page took 1.994395 seconds and 4 git commands to generate.