1 /* Target-vector operations for controlling Unix child processes, for GDB.
2 Copyright 1990-1996, 1998, 1999 Free Software Foundation, Inc.
3 Contributed by Cygnus Support.
5 ## Contains temporary hacks..
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program; if not, write to the Free Software
21 Foundation, Inc., 59 Temple Place - Suite 330,
22 Boston, MA 02111-1307, USA. */
25 #include "frame.h" /* required by inferior.h */
32 #include <sys/types.h>
37 extern struct symtab_and_line *child_enable_exception_callback (enum
41 extern struct exception_event_record
42 *child_get_current_exception_event (void);
44 extern void _initialize_inftarg (void);
46 static void child_prepare_to_store (void);
49 static int child_wait (int, struct target_waitstatus *);
50 #endif /* CHILD_WAIT */
52 #if !defined(CHILD_POST_WAIT)
53 void child_post_wait (int, int);
56 static void child_open (char *, int);
58 static void child_files_info (struct target_ops *);
60 static void child_detach (char *, int);
62 static void child_detach_from_process (int, char *, int, int);
64 static void child_attach (char *, int);
66 static void child_attach_to_process (char *, int, int);
68 #if !defined(CHILD_POST_ATTACH)
69 extern void child_post_attach (int);
72 static void child_require_attach (char *, int);
74 static void child_require_detach (int, char *, int);
76 static void ptrace_me (void);
78 static void ptrace_him (int);
80 static void child_create_inferior (char *, char *, char **);
82 static void child_mourn_inferior (void);
84 static int child_can_run (void);
86 static void child_stop (void);
88 #ifndef CHILD_THREAD_ALIVE
89 int child_thread_alive (int);
92 static void init_child_ops (void);
94 extern char **environ;
96 struct target_ops child_ops;
98 int child_suppress_run = 0; /* Non-zero if inftarg should pretend not to
99 be a runnable target. Used by targets
100 that can sit atop inftarg, such as HPUX
106 /* Enable HACK for ttrace work. In
107 * infttrace.c/require_notification_of_events,
108 * this is set to 0 so that the loop in child_wait
111 int not_same_real_pid = 1;
115 /* Wait for child to do something. Return pid of child, or -1 in case
116 of error; store status through argument pointer OURSTATUS. */
119 child_wait (pid, ourstatus)
121 struct target_waitstatus *ourstatus;
125 char *execd_pathname = NULL;
129 enum target_waitkind kind;
133 set_sigint_trap (); /* Causes SIGINT to be passed on to the
137 pid = ptrace_wait (inferior_pid, &status);
143 clear_sigint_trap ();
147 if (save_errno == EINTR)
150 fprintf_unfiltered (gdb_stderr, "Child process unexpectedly missing: %s.\n",
151 safe_strerror (save_errno));
153 /* Claim it exited with unknown signal. */
154 ourstatus->kind = TARGET_WAITKIND_SIGNALLED;
155 ourstatus->value.sig = TARGET_SIGNAL_UNKNOWN;
161 if (target_has_exited (pid, status, &exit_status))
163 /* ??rehrauer: For now, ignore this. */
167 if (!target_thread_alive (pid))
169 ourstatus->kind = TARGET_WAITKIND_SPURIOUS;
173 if (target_has_forked (pid, &related_pid)
174 && ((pid == inferior_pid) || (related_pid == inferior_pid)))
176 ourstatus->kind = TARGET_WAITKIND_FORKED;
177 ourstatus->value.related_pid = related_pid;
181 if (target_has_vforked (pid, &related_pid)
182 && ((pid == inferior_pid) || (related_pid == inferior_pid)))
184 ourstatus->kind = TARGET_WAITKIND_VFORKED;
185 ourstatus->value.related_pid = related_pid;
189 if (target_has_execd (pid, &execd_pathname))
191 /* Are we ignoring initial exec events? (This is likely because
192 we're in the process of starting up the inferior, and another
193 (older) mechanism handles those.) If so, we'll report this
194 as a regular stop, not an exec.
196 if (inferior_ignoring_startup_exec_events)
198 inferior_ignoring_startup_exec_events--;
202 ourstatus->kind = TARGET_WAITKIND_EXECD;
203 ourstatus->value.execd_pathname = execd_pathname;
208 /* All we must do with these is communicate their occurrence
209 to wait_for_inferior...
211 if (target_has_syscall_event (pid, &kind, &syscall_id))
213 ourstatus->kind = kind;
214 ourstatus->value.syscall_id = syscall_id;
218 /*## } while (pid != inferior_pid); ## *//* Some other child died or stopped */
219 /* hack for thread testing */
221 while ((pid != inferior_pid) && not_same_real_pid);
224 store_waitstatus (ourstatus, status);
227 #endif /* CHILD_WAIT */
229 #if !defined(CHILD_POST_WAIT)
231 child_post_wait (pid, wait_status)
235 /* This version of Unix doesn't require a meaningful "post wait"
242 #ifndef CHILD_THREAD_ALIVE
244 /* Check to see if the given thread is alive.
246 FIXME: Is kill() ever the right way to do this? I doubt it, but
247 for now we're going to try and be compatable with the old thread
250 child_thread_alive (pid)
253 return (kill (pid, 0) != -1);
259 child_attach_to_process (args, from_tty, after_fork)
265 error_no_arg ("process-id to attach");
267 #ifndef ATTACH_DETACH
268 error ("Can't attach to a process on this machine.");
276 pid = strtol (args, &dummy, 0);
277 /* Some targets don't set errno on errors, grrr! */
278 if ((pid == 0) && (args == dummy))
279 error ("Illegal process-id: %s\n", args);
281 if (pid == getpid ()) /* Trying to masturbate? */
282 error ("I refuse to debug myself!");
286 exec_file = (char *) get_exec_file (0);
289 printf_unfiltered ("Attaching after fork to %s\n",
290 target_pid_to_str (pid));
292 printf_unfiltered ("Attaching to program: %s, %s\n", exec_file,
293 target_pid_to_str (pid));
295 printf_unfiltered ("Attaching to %s\n", target_pid_to_str (pid));
297 gdb_flush (gdb_stdout);
303 REQUIRE_ATTACH (pid);
306 push_target (&child_ops);
308 #endif /* ATTACH_DETACH */
312 /* Attach to process PID, then initialize for debugging it. */
315 child_attach (args, from_tty)
319 child_attach_to_process (args, from_tty, 0);
322 #if !defined(CHILD_POST_ATTACH)
324 child_post_attach (pid)
327 /* This version of Unix doesn't require a meaningful "post attach"
328 operation by a debugger. */
333 child_require_attach (args, from_tty)
337 child_attach_to_process (args, from_tty, 1);
341 child_detach_from_process (pid, args, from_tty, after_fork)
353 char *exec_file = get_exec_file (0);
357 printf_unfiltered ("Detaching after fork from %s\n",
358 target_pid_to_str (pid));
360 printf_unfiltered ("Detaching from program: %s, %s\n", exec_file,
361 target_pid_to_str (pid));
362 gdb_flush (gdb_stdout);
365 siggnal = atoi (args);
370 REQUIRE_DETACH (pid, siggnal);
373 error ("This version of Unix does not support detaching a process.");
377 /* Take a program previously attached to and detaches it.
378 The program resumes execution and will no longer stop
379 on signals, etc. We'd better not have left any breakpoints
380 in the program or it'll die when it hits one. For this
381 to work, it may be necessary for the process to have been
382 previously attached. It *might* work if the program was
383 started via the normal ptrace (PTRACE_TRACEME). */
386 child_detach (args, from_tty)
390 child_detach_from_process (inferior_pid, args, from_tty, 0);
392 unpush_target (&child_ops);
396 child_require_detach (pid, args, from_tty)
401 child_detach_from_process (pid, args, from_tty, 1);
405 /* Get ready to modify the registers array. On machines which store
406 individual registers, this doesn't need to do anything. On machines
407 which store all the registers in one fell swoop, this makes sure
408 that registers contains all the registers from the program being
412 child_prepare_to_store ()
414 #ifdef CHILD_PREPARE_TO_STORE
415 CHILD_PREPARE_TO_STORE ();
419 /* Print status information about what we're accessing. */
422 child_files_info (ignore)
423 struct target_ops *ignore;
425 printf_unfiltered ("\tUsing the running image of %s %s.\n",
426 attach_flag ? "attached" : "child", target_pid_to_str (inferior_pid));
431 child_open (arg, from_tty)
435 error ("Use the \"run\" command to start a Unix child process.");
438 /* Stub function which causes the inferior that runs it, to be ptrace-able
439 by its parent process. */
444 /* "Trace me, Dr. Memory!" */
445 call_ptrace (0, 0, (PTRACE_ARG3_TYPE) 0, 0);
448 /* Stub function which causes the GDB that runs it, to start ptrace-ing
449 the child process. */
455 push_target (&child_ops);
457 /* On some targets, there must be some explicit synchronization
458 between the parent and child processes after the debugger
459 forks, and before the child execs the debuggee program. This
460 call basically gives permission for the child to exec.
463 target_acknowledge_created_inferior (pid);
465 /* START_INFERIOR_TRAPS_EXPECTED is defined in inferior.h,
466 * and will be 1 or 2 depending on whether we're starting
467 * without or with a shell.
469 startup_inferior (START_INFERIOR_TRAPS_EXPECTED);
471 /* On some targets, there must be some explicit actions taken after
472 the inferior has been started up.
474 target_post_startup_inferior (pid);
477 /* Start an inferior Unix child process and sets inferior_pid to its pid.
478 EXEC_FILE is the file to run.
479 ALLARGS is a string containing the arguments to the program.
480 ENV is the environment vector to pass. Errors reported with error(). */
483 child_create_inferior (exec_file, allargs, env)
489 fork_inferior (exec_file, allargs, env, ptrace_me, ptrace_him, pre_fork_inferior, NULL);
491 fork_inferior (exec_file, allargs, env, ptrace_me, ptrace_him, NULL, NULL);
493 /* We are at the first instruction we care about. */
494 /* Pedal to the metal... */
495 proceed ((CORE_ADDR) -1, TARGET_SIGNAL_0, 0);
498 #if !defined(CHILD_POST_STARTUP_INFERIOR)
500 child_post_startup_inferior (pid)
503 /* This version of Unix doesn't require a meaningful "post startup inferior"
504 operation by a debugger.
509 #if !defined(CHILD_ACKNOWLEDGE_CREATED_INFERIOR)
511 child_acknowledge_created_inferior (pid)
514 /* This version of Unix doesn't require a meaningful "acknowledge created inferior"
515 operation by a debugger.
522 child_clone_and_follow_inferior (child_pid, followed_child)
526 clone_and_follow_inferior (child_pid, followed_child);
528 /* Don't resume CHILD_PID; it's stopped where it ought to be, until
529 the decision gets made elsewhere how to continue it.
534 #if !defined(CHILD_POST_FOLLOW_INFERIOR_BY_CLONE)
536 child_post_follow_inferior_by_clone ()
538 /* This version of Unix doesn't require a meaningful "post follow inferior"
539 operation by a clone debugger.
544 #if !defined(CHILD_INSERT_FORK_CATCHPOINT)
546 child_insert_fork_catchpoint (pid)
549 /* This version of Unix doesn't support notification of fork events. */
554 #if !defined(CHILD_REMOVE_FORK_CATCHPOINT)
556 child_remove_fork_catchpoint (pid)
559 /* This version of Unix doesn't support notification of fork events. */
564 #if !defined(CHILD_INSERT_VFORK_CATCHPOINT)
566 child_insert_vfork_catchpoint (pid)
569 /* This version of Unix doesn't support notification of vfork events. */
574 #if !defined(CHILD_REMOVE_VFORK_CATCHPOINT)
576 child_remove_vfork_catchpoint (pid)
579 /* This version of Unix doesn't support notification of vfork events. */
584 #if !defined(CHILD_HAS_FORKED)
586 child_has_forked (pid, child_pid)
590 /* This version of Unix doesn't support notification of fork events. */
596 #if !defined(CHILD_HAS_VFORKED)
598 child_has_vforked (pid, child_pid)
602 /* This version of Unix doesn't support notification of vfork events.
609 #if !defined(CHILD_CAN_FOLLOW_VFORK_PRIOR_TO_EXEC)
611 child_can_follow_vfork_prior_to_exec ()
613 /* This version of Unix doesn't support notification of vfork events.
614 However, if it did, it probably wouldn't allow vforks to be followed
615 before the following exec.
622 #if !defined(CHILD_POST_FOLLOW_VFORK)
624 child_post_follow_vfork (parent_pid, followed_parent, child_pid, followed_child)
630 /* This version of Unix doesn't require a meaningful "post follow vfork"
631 operation by a clone debugger.
636 #if !defined(CHILD_INSERT_EXEC_CATCHPOINT)
638 child_insert_exec_catchpoint (pid)
641 /* This version of Unix doesn't support notification of exec events. */
646 #if !defined(CHILD_REMOVE_EXEC_CATCHPOINT)
648 child_remove_exec_catchpoint (pid)
651 /* This version of Unix doesn't support notification of exec events. */
656 #if !defined(CHILD_HAS_EXECD)
658 child_has_execd (pid, execd_pathname)
660 char **execd_pathname;
662 /* This version of Unix doesn't support notification of exec events.
669 #if !defined(CHILD_REPORTED_EXEC_EVENTS_PER_EXEC_CALL)
671 child_reported_exec_events_per_exec_call ()
673 /* This version of Unix doesn't support notification of exec events.
680 #if !defined(CHILD_HAS_SYSCALL_EVENT)
682 child_has_syscall_event (pid, kind, syscall_id)
684 enum target_waitkind *kind;
687 /* This version of Unix doesn't support notification of syscall events.
694 #if !defined(CHILD_HAS_EXITED)
696 child_has_exited (pid, wait_status, exit_status)
701 if (WIFEXITED (wait_status))
703 *exit_status = WEXITSTATUS (wait_status);
707 if (WIFSIGNALED (wait_status))
709 *exit_status = 0; /* ?? Don't know what else to say here. */
713 /* ?? Do we really need to consult the event state, too? Assume the
714 wait_state alone suffices.
722 child_mourn_inferior ()
724 unpush_target (&child_ops);
725 generic_mourn_inferior ();
731 /* This variable is controlled by modules that sit atop inftarg that may layer
732 their own process structure atop that provided here. hpux-thread.c does
733 this because of the Hpux user-mode level thread model. */
735 return !child_suppress_run;
738 /* Send a SIGINT to the process group. This acts just like the user typed a
739 ^C on the controlling terminal.
741 XXX - This may not be correct for all systems. Some may want to use
742 killpg() instead of kill (-pgrp). */
747 extern pid_t inferior_process_group;
749 kill (-inferior_process_group, SIGINT);
752 #if !defined(CHILD_ENABLE_EXCEPTION_CALLBACK)
753 struct symtab_and_line *
754 child_enable_exception_callback (kind, enable)
755 enum exception_event_kind kind;
758 return (struct symtab_and_line *) NULL;
762 #if !defined(CHILD_GET_CURRENT_EXCEPTION_EVENT)
763 struct exception_event_record *
764 child_get_current_exception_event ()
766 return (struct exception_event_record *) NULL;
771 #if !defined(CHILD_PID_TO_EXEC_FILE)
773 child_pid_to_exec_file (pid)
776 /* This version of Unix doesn't support translation of a process ID
777 to the filename of the executable file.
784 child_core_file_to_sym_file (core)
787 /* The target stratum for a running executable need not support
794 #if !defined(CHILD_PID_TO_STR)
796 child_pid_to_str (pid)
799 return normal_pid_to_str (pid);
806 child_ops.to_shortname = "child";
807 child_ops.to_longname = "Unix child process";
808 child_ops.to_doc = "Unix child process (started by the \"run\" command).";
809 child_ops.to_open = child_open;
810 child_ops.to_attach = child_attach;
811 child_ops.to_post_attach = child_post_attach;
812 child_ops.to_require_attach = child_require_attach;
813 child_ops.to_detach = child_detach;
814 child_ops.to_require_detach = child_require_detach;
815 child_ops.to_resume = child_resume;
816 child_ops.to_wait = child_wait;
817 child_ops.to_post_wait = child_post_wait;
818 child_ops.to_fetch_registers = fetch_inferior_registers;
819 child_ops.to_store_registers = store_inferior_registers;
820 child_ops.to_prepare_to_store = child_prepare_to_store;
821 child_ops.to_xfer_memory = child_xfer_memory;
822 child_ops.to_files_info = child_files_info;
823 child_ops.to_insert_breakpoint = memory_insert_breakpoint;
824 child_ops.to_remove_breakpoint = memory_remove_breakpoint;
825 child_ops.to_terminal_init = terminal_init_inferior;
826 child_ops.to_terminal_inferior = terminal_inferior;
827 child_ops.to_terminal_ours_for_output = terminal_ours_for_output;
828 child_ops.to_terminal_ours = terminal_ours;
829 child_ops.to_terminal_info = child_terminal_info;
830 child_ops.to_kill = kill_inferior;
831 child_ops.to_create_inferior = child_create_inferior;
832 child_ops.to_post_startup_inferior = child_post_startup_inferior;
833 child_ops.to_acknowledge_created_inferior = child_acknowledge_created_inferior;
834 child_ops.to_clone_and_follow_inferior = child_clone_and_follow_inferior;
835 child_ops.to_post_follow_inferior_by_clone = child_post_follow_inferior_by_clone;
836 child_ops.to_insert_fork_catchpoint = child_insert_fork_catchpoint;
837 child_ops.to_remove_fork_catchpoint = child_remove_fork_catchpoint;
838 child_ops.to_insert_vfork_catchpoint = child_insert_vfork_catchpoint;
839 child_ops.to_remove_vfork_catchpoint = child_remove_vfork_catchpoint;
840 child_ops.to_has_forked = child_has_forked;
841 child_ops.to_has_vforked = child_has_vforked;
842 child_ops.to_can_follow_vfork_prior_to_exec = child_can_follow_vfork_prior_to_exec;
843 child_ops.to_post_follow_vfork = child_post_follow_vfork;
844 child_ops.to_insert_exec_catchpoint = child_insert_exec_catchpoint;
845 child_ops.to_remove_exec_catchpoint = child_remove_exec_catchpoint;
846 child_ops.to_has_execd = child_has_execd;
847 child_ops.to_reported_exec_events_per_exec_call = child_reported_exec_events_per_exec_call;
848 child_ops.to_has_syscall_event = child_has_syscall_event;
849 child_ops.to_has_exited = child_has_exited;
850 child_ops.to_mourn_inferior = child_mourn_inferior;
851 child_ops.to_can_run = child_can_run;
852 child_ops.to_thread_alive = child_thread_alive;
853 child_ops.to_pid_to_str = child_pid_to_str;
854 child_ops.to_stop = child_stop;
855 child_ops.to_enable_exception_callback = child_enable_exception_callback;
856 child_ops.to_get_current_exception_event = child_get_current_exception_event;
857 child_ops.to_pid_to_exec_file = child_pid_to_exec_file;
858 child_ops.to_core_file_to_sym_file = child_core_file_to_sym_file;
859 child_ops.to_stratum = process_stratum;
860 child_ops.to_has_all_memory = 1;
861 child_ops.to_has_memory = 1;
862 child_ops.to_has_stack = 1;
863 child_ops.to_has_registers = 1;
864 child_ops.to_has_execution = 1;
865 child_ops.to_magic = OPS_MAGIC;
869 _initialize_inftarg ()
871 #ifdef HAVE_OPTIONAL_PROC_FS
875 /* If we have an optional /proc filesystem (e.g. under OSF/1),
876 don't add ptrace support if we can access the running GDB via /proc. */
877 #ifndef PROC_NAME_FMT
878 #define PROC_NAME_FMT "/proc/%05d"
880 sprintf (procname, PROC_NAME_FMT, getpid ());
881 if ((fd = open (procname, O_RDONLY)) >= 0)
889 add_target (&child_ops);