gdb/inftarg.c

   1 /* Target-vector operations for controlling Unix child processes, for GDB.
   2    Copyright 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1998, 1999,
   3    2000, 2002
   4    Free Software Foundation, Inc.
   5    Contributed by Cygnus Support.
   6
   7    ## Contains temporary hacks..
   8
   9    This file is part of GDB.
  10
  11    This program is free software; you can redistribute it and/or modify
  12    it under the terms of the GNU General Public License as published by
  13    the Free Software Foundation; either version 2 of the License, or
  14    (at your option) any later version.
  15
  16    This program is distributed in the hope that it will be useful,
  17    but WITHOUT ANY WARRANTY; without even the implied warranty of
  18    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19    GNU General Public License for more details.
  20
  21    You should have received a copy of the GNU General Public License
  22    along with this program; if not, write to the Free Software
  23    Foundation, Inc., 59 Temple Place - Suite 330,
  24    Boston, MA 02111-1307, USA.  */
  25
  26 #include "defs.h"
  27 #include "frame.h"              /* required by inferior.h */
  28 #include "inferior.h"
  29 #include "target.h"
  30 #include "gdbcore.h"
  31 #include "command.h"
  32 #include "gdb_stat.h"
  33 #include <signal.h>
  34 #include <sys/types.h>
  35 #include <fcntl.h>
  36
  37 #include "gdb_wait.h"
  38
  39 extern struct symtab_and_line *child_enable_exception_callback (enum
  40                                                                 exception_event_kind,
  41                                                                 int);
  42
  43 extern struct exception_event_record
  44   *child_get_current_exception_event (void);
  45
  46 extern void _initialize_inftarg (void);
  47
  48 static void child_prepare_to_store (void);
  49
  50 #ifndef CHILD_WAIT
  51 static ptid_t child_wait (ptid_t, struct target_waitstatus *);
  52 #endif /* CHILD_WAIT */
  53
  54 #if !defined(CHILD_POST_WAIT)
  55 void child_post_wait (ptid_t, int);
  56 #endif
  57
  58 static void child_open (char *, int);
  59
  60 static void child_files_info (struct target_ops *);
  61
  62 static void child_detach (char *, int);
  63
  64 static void child_detach_from_process (int, char *, int, int);
  65
  66 static void child_attach (char *, int);
  67
  68 static void child_attach_to_process (char *, int, int);
  69
  70 #if !defined(CHILD_POST_ATTACH)
  71 extern void child_post_attach (int);
  72 #endif
  73
  74 static void child_require_attach (char *, int);
  75
  76 static void child_require_detach (int, char *, int);
  77
  78 static void ptrace_me (void);
  79
  80 static void ptrace_him (int);
  81
  82 static void child_create_inferior (char *, char *, char **);
  83
  84 static void child_mourn_inferior (void);
  85
  86 static int child_can_run (void);
  87
  88 static void child_stop (void);
  89
  90 #ifndef CHILD_THREAD_ALIVE
  91 int child_thread_alive (ptid_t);
  92 #endif
  93
  94 static void init_child_ops (void);
  95
  96 extern char **environ;
  97
  98 struct target_ops child_ops;
  99
 100 int child_suppress_run = 0;     /* Non-zero if inftarg should pretend not to
 101                                    be a runnable target.  Used by targets
 102                                    that can sit atop inftarg, such as HPUX
 103                                    thread support.  */
 104
 105 #ifndef CHILD_WAIT
 106
 107 /* Wait for child to do something.  Return pid of child, or -1 in case
 108    of error; store status through argument pointer OURSTATUS.  */
 109
 110 static ptid_t
 111 child_wait (ptid_t ptid, struct target_waitstatus *ourstatus)
 112 {
 113   int save_errno;
 114   int status;
 115   char *execd_pathname = NULL;
 116   int exit_status;
 117   int related_pid;
 118   int syscall_id;
 119   enum target_waitkind kind;
 120   int pid;
 121
 122   do
 123     {
 124       set_sigint_trap ();       /* Causes SIGINT to be passed on to the
 125                                    attached process. */
 126       set_sigio_trap ();
 127
 128       pid = ptrace_wait (inferior_ptid, &status);
 129
 130       save_errno = errno;
 131
 132       clear_sigio_trap ();
 133
 134       clear_sigint_trap ();
 135
 136       if (pid == -1)
 137         {
 138           if (save_errno == EINTR)
 139             continue;
 140
 141           fprintf_unfiltered (gdb_stderr, "Child process unexpectedly missing: %s.\n",
 142                               safe_strerror (save_errno));
 143
 144           /* Claim it exited with unknown signal.  */
 145           ourstatus->kind = TARGET_WAITKIND_SIGNALLED;
 146           ourstatus->value.sig = TARGET_SIGNAL_UNKNOWN;
 147           return pid_to_ptid (-1);
 148         }
 149
 150       /* Did it exit?
 151        */
 152       if (target_has_exited (pid, status, &exit_status))
 153         {
 154           /* ??rehrauer: For now, ignore this. */
 155           continue;
 156         }
 157
 158       if (!target_thread_alive (pid_to_ptid (pid)))
 159         {
 160           ourstatus->kind = TARGET_WAITKIND_SPURIOUS;
 161           return pid_to_ptid (pid);
 162         }
 163       } while (pid != PIDGET (inferior_ptid)); /* Some other child died or stopped */
 164
 165   store_waitstatus (ourstatus, status);
 166   return pid_to_ptid (pid);
 167 }
 168 #endif /* CHILD_WAIT */
 169
 170 #if !defined(CHILD_POST_WAIT)
 171 void
 172 child_post_wait (ptid_t ptid, int wait_status)
 173 {
 174   /* This version of Unix doesn't require a meaningful "post wait"
 175      operation.
 176    */
 177 }
 178 #endif
 179
 180
 181 #ifndef CHILD_THREAD_ALIVE
 182
 183 /* Check to see if the given thread is alive.
 184
 185    FIXME: Is kill() ever the right way to do this?  I doubt it, but
 186    for now we're going to try and be compatable with the old thread
 187    code.  */
 188 int
 189 child_thread_alive (ptid_t ptid)
 190 {
 191   pid_t pid = PIDGET (ptid);
 192
 193   return (kill (pid, 0) != -1);
 194 }
 195
 196 #endif
 197
 198 static void
 199 child_attach_to_process (char *args, int from_tty, int after_fork)
 200 {
 201   if (!args)
 202     error_no_arg ("process-id to attach");
 203
 204 #ifndef ATTACH_DETACH
 205   error ("Can't attach to a process on this machine.");
 206 #else
 207   {
 208     char *exec_file;
 209     int pid;
 210     char *dummy;
 211
 212     dummy = args;
 213     pid = strtol (args, &dummy, 0);
 214     /* Some targets don't set errno on errors, grrr! */
 215     if ((pid == 0) && (args == dummy))
 216       error ("Illegal process-id: %s\n", args);
 217
 218     if (pid == getpid ())       /* Trying to masturbate? */
 219       error ("I refuse to debug myself!");
 220
 221     if (from_tty)
 222       {
 223         exec_file = (char *) get_exec_file (0);
 224
 225         if (after_fork)
 226           printf_unfiltered ("Attaching after fork to %s\n",
 227                              target_pid_to_str (pid_to_ptid (pid)));
 228         else if (exec_file)
 229           printf_unfiltered ("Attaching to program: %s, %s\n", exec_file,
 230                              target_pid_to_str (pid_to_ptid (pid)));
 231         else
 232           printf_unfiltered ("Attaching to %s\n",
 233                              target_pid_to_str (pid_to_ptid (pid)));
 234
 235         gdb_flush (gdb_stdout);
 236       }
 237
 238     if (!after_fork)
 239       attach (pid);
 240     else
 241       REQUIRE_ATTACH (pid);
 242
 243     inferior_ptid = pid_to_ptid (pid);
 244     push_target (&child_ops);
 245   }
 246 #endif /* ATTACH_DETACH */
 247 }
 248
 249
 250 /* Attach to process PID, then initialize for debugging it.  */
 251
 252 static void
 253 child_attach (char *args, int from_tty)
 254 {
 255   child_attach_to_process (args, from_tty, 0);
 256 }
 257
 258 #if !defined(CHILD_POST_ATTACH)
 259 void
 260 child_post_attach (int pid)
 261 {
 262   /* This version of Unix doesn't require a meaningful "post attach"
 263      operation by a debugger.  */
 264 }
 265 #endif
 266
 267 static void
 268 child_require_attach (char *args, int from_tty)
 269 {
 270   child_attach_to_process (args, from_tty, 1);
 271 }
 272
 273 static void
 274 child_detach_from_process (int pid, char *args, int from_tty, int after_fork)
 275 {
 276 #ifdef ATTACH_DETACH
 277   {
 278     int siggnal = 0;
 279
 280     if (from_tty)
 281       {
 282         char *exec_file = get_exec_file (0);
 283         if (exec_file == 0)
 284           exec_file = "";
 285         if (after_fork)
 286           printf_unfiltered ("Detaching after fork from %s\n",
 287                              target_pid_to_str (pid_to_ptid (pid)));
 288         else
 289           printf_unfiltered ("Detaching from program: %s, %s\n", exec_file,
 290                              target_pid_to_str (pid_to_ptid (pid)));
 291         gdb_flush (gdb_stdout);
 292       }
 293     if (args)
 294       siggnal = atoi (args);
 295
 296     if (!after_fork)
 297       detach (siggnal);
 298     else
 299       REQUIRE_DETACH (pid, siggnal);
 300   }
 301 #else
 302   error ("This version of Unix does not support detaching a process.");
 303 #endif
 304 }
 305
 306 /* Take a program previously attached to and detaches it.
 307    The program resumes execution and will no longer stop
 308    on signals, etc.  We'd better not have left any breakpoints
 309    in the program or it'll die when it hits one.  For this
 310    to work, it may be necessary for the process to have been
 311    previously attached.  It *might* work if the program was
 312    started via the normal ptrace (PTRACE_TRACEME).  */
 313
 314 static void
 315 child_detach (char *args, int from_tty)
 316 {
 317   child_detach_from_process (PIDGET (inferior_ptid), args, from_tty, 0);
 318   inferior_ptid = null_ptid;
 319   unpush_target (&child_ops);
 320 }
 321
 322 static void
 323 child_require_detach (int pid, char *args, int from_tty)
 324 {
 325   child_detach_from_process (pid, args, from_tty, 1);
 326 }
 327
 328
 329 /* Get ready to modify the registers array.  On machines which store
 330    individual registers, this doesn't need to do anything.  On machines
 331    which store all the registers in one fell swoop, this makes sure
 332    that registers contains all the registers from the program being
 333    debugged.  */
 334
 335 static void
 336 child_prepare_to_store (void)
 337 {
 338 #ifdef CHILD_PREPARE_TO_STORE
 339   CHILD_PREPARE_TO_STORE ();
 340 #endif
 341 }
 342
 343 /* Print status information about what we're accessing.  */
 344
 345 static void
 346 child_files_info (struct target_ops *ignore)
 347 {
 348   printf_unfiltered ("\tUsing the running image of %s %s.\n",
 349       attach_flag ? "attached" : "child", target_pid_to_str (inferior_ptid));
 350 }
 351
 352 /* ARGSUSED */
 353 static void
 354 child_open (char *arg, int from_tty)
 355 {
 356   error ("Use the \"run\" command to start a Unix child process.");
 357 }
 358
 359 /* Stub function which causes the inferior that runs it, to be ptrace-able
 360    by its parent process.  */
 361
 362 static void
 363 ptrace_me (void)
 364 {
 365   /* "Trace me, Dr. Memory!" */
 366   call_ptrace (0, 0, (PTRACE_ARG3_TYPE) 0, 0);
 367 }
 368
 369 /* Stub function which causes the GDB that runs it, to start ptrace-ing
 370    the child process.  */
 371
 372 static void
 373 ptrace_him (int pid)
 374 {
 375   push_target (&child_ops);
 376
 377   /* On some targets, there must be some explicit synchronization
 378      between the parent and child processes after the debugger
 379      forks, and before the child execs the debuggee program.  This
 380      call basically gives permission for the child to exec.
 381    */
 382
 383   target_acknowledge_created_inferior (pid);
 384
 385   /* START_INFERIOR_TRAPS_EXPECTED is defined in inferior.h,
 386    * and will be 1 or 2 depending on whether we're starting
 387    * without or with a shell.
 388    */
 389   startup_inferior (START_INFERIOR_TRAPS_EXPECTED);
 390
 391   /* On some targets, there must be some explicit actions taken after
 392      the inferior has been started up.
 393    */
 394   target_post_startup_inferior (pid_to_ptid (pid));
 395 }
 396
 397 /* Start an inferior Unix child process and sets inferior_ptid to its pid.
 398    EXEC_FILE is the file to run.
 399    ALLARGS is a string containing the arguments to the program.
 400    ENV is the environment vector to pass.  Errors reported with error().  */
 401
 402 static void
 403 child_create_inferior (char *exec_file, char *allargs, char **env)
 404 {
 405 #ifdef HPUXHPPA
 406   fork_inferior (exec_file, allargs, env, ptrace_me, ptrace_him, pre_fork_inferior, NULL);
 407 #else
 408   fork_inferior (exec_file, allargs, env, ptrace_me, ptrace_him, NULL, NULL);
 409 #endif
 410   /* We are at the first instruction we care about.  */
 411   /* Pedal to the metal... */
 412   proceed ((CORE_ADDR) -1, TARGET_SIGNAL_0, 0);
 413 }
 414
 415 #if !defined(CHILD_POST_STARTUP_INFERIOR)
 416 void
 417 child_post_startup_inferior (ptid_t ptid)
 418 {
 419   /* This version of Unix doesn't require a meaningful "post startup inferior"
 420      operation by a debugger.
 421    */
 422 }
 423 #endif
 424
 425 #if !defined(CHILD_ACKNOWLEDGE_CREATED_INFERIOR)
 426 void
 427 child_acknowledge_created_inferior (int pid)
 428 {
 429   /* This version of Unix doesn't require a meaningful "acknowledge created inferior"
 430      operation by a debugger.
 431    */
 432 }
 433 #endif
 434
 435
 436 #if !defined(CHILD_INSERT_FORK_CATCHPOINT)
 437 int
 438 child_insert_fork_catchpoint (int pid)
 439 {
 440   /* This version of Unix doesn't support notification of fork events.  */
 441   return 0;
 442 }
 443 #endif
 444
 445 #if !defined(CHILD_REMOVE_FORK_CATCHPOINT)
 446 int
 447 child_remove_fork_catchpoint (int pid)
 448 {
 449   /* This version of Unix doesn't support notification of fork events.  */
 450   return 0;
 451 }
 452 #endif
 453
 454 #if !defined(CHILD_INSERT_VFORK_CATCHPOINT)
 455 int
 456 child_insert_vfork_catchpoint (int pid)
 457 {
 458   /* This version of Unix doesn't support notification of vfork events.  */
 459   return 0;
 460 }
 461 #endif
 462
 463 #if !defined(CHILD_REMOVE_VFORK_CATCHPOINT)
 464 int
 465 child_remove_vfork_catchpoint (int pid)
 466 {
 467   /* This version of Unix doesn't support notification of vfork events.  */
 468   return 0;
 469 }
 470 #endif
 471
 472 #if !defined(CHILD_FOLLOW_FORK)
 473 int
 474 child_follow_fork (int follow_child)
 475 {
 476   /* This version of Unix doesn't support following fork or vfork events.  */
 477   return 0;
 478 }
 479 #endif
 480
 481 #if !defined(CHILD_INSERT_EXEC_CATCHPOINT)
 482 int
 483 child_insert_exec_catchpoint (int pid)
 484 {
 485   /* This version of Unix doesn't support notification of exec events.  */
 486   return 0;
 487 }
 488 #endif
 489
 490 #if !defined(CHILD_REMOVE_EXEC_CATCHPOINT)
 491 int
 492 child_remove_exec_catchpoint (int pid)
 493 {
 494   /* This version of Unix doesn't support notification of exec events.  */
 495   return 0;
 496 }
 497 #endif
 498
 499 #if !defined(CHILD_REPORTED_EXEC_EVENTS_PER_EXEC_CALL)
 500 int
 501 child_reported_exec_events_per_exec_call (void)
 502 {
 503   /* This version of Unix doesn't support notification of exec events.
 504    */
 505   return 1;
 506 }
 507 #endif
 508
 509 #if !defined(CHILD_HAS_EXITED)
 510 int
 511 child_has_exited (int pid, int wait_status, int *exit_status)
 512 {
 513   if (WIFEXITED (wait_status))
 514     {
 515       *exit_status = WEXITSTATUS (wait_status);
 516       return 1;
 517     }
 518
 519   if (WIFSIGNALED (wait_status))
 520     {
 521       *exit_status = 0;         /* ?? Don't know what else to say here. */
 522       return 1;
 523     }
 524
 525   /* ?? Do we really need to consult the event state, too?  Assume the
 526      wait_state alone suffices.
 527    */
 528   return 0;
 529 }
 530 #endif
 531
 532
 533 static void
 534 child_mourn_inferior (void)
 535 {
 536   unpush_target (&child_ops);
 537   generic_mourn_inferior ();
 538 }
 539
 540 static int
 541 child_can_run (void)
 542 {
 543   /* This variable is controlled by modules that sit atop inftarg that may layer
 544      their own process structure atop that provided here.  hpux-thread.c does
 545      this because of the Hpux user-mode level thread model.  */
 546
 547   return !child_suppress_run;
 548 }
 549
 550 /* Send a SIGINT to the process group.  This acts just like the user typed a
 551    ^C on the controlling terminal.
 552
 553    XXX - This may not be correct for all systems.  Some may want to use
 554    killpg() instead of kill (-pgrp). */
 555
 556 static void
 557 child_stop (void)
 558 {
 559   extern pid_t inferior_process_group;
 560
 561   kill (-inferior_process_group, SIGINT);
 562 }
 563
 564 #if !defined(CHILD_ENABLE_EXCEPTION_CALLBACK)
 565 struct symtab_and_line *
 566 child_enable_exception_callback (enum exception_event_kind kind, int enable)
 567 {
 568   return (struct symtab_and_line *) NULL;
 569 }
 570 #endif
 571
 572 #if !defined(CHILD_GET_CURRENT_EXCEPTION_EVENT)
 573 struct exception_event_record *
 574 child_get_current_exception_event (void)
 575 {
 576   return (struct exception_event_record *) NULL;
 577 }
 578 #endif
 579
 580
 581 #if !defined(CHILD_PID_TO_EXEC_FILE)
 582 char *
 583 child_pid_to_exec_file (int pid)
 584 {
 585   /* This version of Unix doesn't support translation of a process ID
 586      to the filename of the executable file.
 587    */
 588   return NULL;
 589 }
 590 #endif
 591
 592 char *
 593 child_core_file_to_sym_file (char *core)
 594 {
 595   /* The target stratum for a running executable need not support
 596      this operation.
 597    */
 598   return NULL;
 599 }
 600 \f
 601
 602 #if !defined(CHILD_PID_TO_STR)
 603 char *
 604 child_pid_to_str (ptid_t ptid)
 605 {
 606   return normal_pid_to_str (ptid);
 607 }
 608 #endif
 609
 610 static void
 611 init_child_ops (void)
 612 {
 613   child_ops.to_shortname = "child";
 614   child_ops.to_longname = "Unix child process";
 615   child_ops.to_doc = "Unix child process (started by the \"run\" command).";
 616   child_ops.to_open = child_open;
 617   child_ops.to_attach = child_attach;
 618   child_ops.to_post_attach = child_post_attach;
 619   child_ops.to_require_attach = child_require_attach;
 620   child_ops.to_detach = child_detach;
 621   child_ops.to_require_detach = child_require_detach;
 622   child_ops.to_resume = child_resume;
 623   child_ops.to_wait = child_wait;
 624   child_ops.to_post_wait = child_post_wait;
 625   child_ops.to_fetch_registers = fetch_inferior_registers;
 626   child_ops.to_store_registers = store_inferior_registers;
 627   child_ops.to_prepare_to_store = child_prepare_to_store;
 628   child_ops.to_xfer_memory = child_xfer_memory;
 629   child_ops.to_files_info = child_files_info;
 630   child_ops.to_insert_breakpoint = memory_insert_breakpoint;
 631   child_ops.to_remove_breakpoint = memory_remove_breakpoint;
 632   child_ops.to_terminal_init = terminal_init_inferior;
 633   child_ops.to_terminal_inferior = terminal_inferior;
 634   child_ops.to_terminal_ours_for_output = terminal_ours_for_output;
 635   child_ops.to_terminal_save_ours = terminal_save_ours;
 636   child_ops.to_terminal_ours = terminal_ours;
 637   child_ops.to_terminal_info = child_terminal_info;
 638   child_ops.to_kill = kill_inferior;
 639   child_ops.to_create_inferior = child_create_inferior;
 640   child_ops.to_post_startup_inferior = child_post_startup_inferior;
 641   child_ops.to_acknowledge_created_inferior = child_acknowledge_created_inferior;
 642   child_ops.to_insert_fork_catchpoint = child_insert_fork_catchpoint;
 643   child_ops.to_remove_fork_catchpoint = child_remove_fork_catchpoint;
 644   child_ops.to_insert_vfork_catchpoint = child_insert_vfork_catchpoint;
 645   child_ops.to_remove_vfork_catchpoint = child_remove_vfork_catchpoint;
 646   child_ops.to_follow_fork = child_follow_fork;
 647   child_ops.to_insert_exec_catchpoint = child_insert_exec_catchpoint;
 648   child_ops.to_remove_exec_catchpoint = child_remove_exec_catchpoint;
 649   child_ops.to_reported_exec_events_per_exec_call = child_reported_exec_events_per_exec_call;
 650   child_ops.to_has_exited = child_has_exited;
 651   child_ops.to_mourn_inferior = child_mourn_inferior;
 652   child_ops.to_can_run = child_can_run;
 653   child_ops.to_thread_alive = child_thread_alive;
 654   child_ops.to_pid_to_str = child_pid_to_str;
 655   child_ops.to_stop = child_stop;
 656   child_ops.to_enable_exception_callback = child_enable_exception_callback;
 657   child_ops.to_get_current_exception_event = child_get_current_exception_event;
 658   child_ops.to_pid_to_exec_file = child_pid_to_exec_file;
 659   child_ops.to_stratum = process_stratum;
 660   child_ops.to_has_all_memory = 1;
 661   child_ops.to_has_memory = 1;
 662   child_ops.to_has_stack = 1;
 663   child_ops.to_has_registers = 1;
 664   child_ops.to_has_execution = 1;
 665   child_ops.to_magic = OPS_MAGIC;
 666 }
 667
 668 /* Take over the 'find_mapped_memory' vector from inftarg.c. */
 669 extern void
 670 inftarg_set_find_memory_regions (int (*func) (int (*) (CORE_ADDR,
 671                                                        unsigned long,
 672                                                        int, int, int,
 673                                                        void *),
 674                                               void *))
 675 {
 676   child_ops.to_find_memory_regions = func;
 677 }
 678
 679 /* Take over the 'make_corefile_notes' vector from inftarg.c. */
 680 extern void
 681 inftarg_set_make_corefile_notes (char * (*func) (bfd *, int *))
 682 {
 683   child_ops.to_make_corefile_notes = func;
 684 }
 685
 686 void
 687 _initialize_inftarg (void)
 688 {
 689 #ifdef HAVE_OPTIONAL_PROC_FS
 690   char procname[32];
 691   int fd;
 692
 693   /* If we have an optional /proc filesystem (e.g. under OSF/1),
 694      don't add ptrace support if we can access the running GDB via /proc.  */
 695 #ifndef PROC_NAME_FMT
 696 #define PROC_NAME_FMT "/proc/%05d"
 697 #endif
 698   sprintf (procname, PROC_NAME_FMT, getpid ());
 699   if ((fd = open (procname, O_RDONLY)) >= 0)
 700     {
 701       close (fd);
 702       return;
 703     }
 704 #endif
 705
 706   init_child_ops ();
 707   add_target (&child_ops);
 708 }