Commit | Line | Data |
---|---|---|
ac264b3b MS |
1 | /* GNU/Linux native-dependent code for debugging multiple forks. |
2 | ||
1dce6535 | 3 | Copyright (C) 2005, 2006 Free Software Foundation, Inc. |
ac264b3b MS |
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 | |
9 | the Free Software Foundation; either version 2 of the License, or | |
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 | |
18 | along with this program; if not, write to the Free Software | |
19 | Foundation, Inc., 51 Franklin Street, Fifth Floor, | |
20 | Boston, MA 02110-1301, USA. */ | |
21 | ||
22 | #include "defs.h" | |
23 | #include "inferior.h" | |
24 | #include "regcache.h" | |
25 | #include "gdbcmd.h" | |
26 | #include "infcall.h" | |
27 | #include "gdb_string.h" | |
28 | #include "linux-fork.h" | |
29 | ||
30 | #include <sys/ptrace.h> | |
31 | #include <sys/wait.h> | |
32 | #include <sys/param.h> | |
33 | #include <dirent.h> | |
34 | #include <ctype.h> | |
35 | ||
36 | struct fork_info *fork_list; | |
37 | static int highest_fork_num; | |
38 | ||
39 | /* Prevent warning from -Wmissing-prototypes. */ | |
40 | extern void _initialize_linux_fork (void); | |
41 | ||
42 | int detach_fork = 1; /* Default behavior is to detach | |
43 | newly forked processes (legacy). */ | |
44 | ||
45 | /* Fork list data structure: */ | |
46 | struct fork_info | |
47 | { | |
48 | struct fork_info *next; | |
49 | ptid_t ptid; | |
50 | int num; /* Convenient handle (GDB fork id) */ | |
51 | struct regcache *savedregs; /* Convenient for info fork, saves | |
52 | having to actually switch contexts. */ | |
53 | int clobber_regs; /* True if we should restore saved regs. */ | |
54 | ULONGEST pc; /* PC for info fork. */ | |
55 | off_t *filepos; /* Set of open file descriptors' offsets. */ | |
56 | int maxfd; | |
57 | }; | |
58 | ||
59 | /* Fork list methods: */ | |
60 | ||
61 | extern int | |
62 | forks_exist_p (void) | |
63 | { | |
64 | return (fork_list != NULL); | |
65 | } | |
66 | ||
67 | /* Add a fork to internal fork list. | |
68 | Called from linux child_follow_fork. */ | |
69 | ||
70 | extern struct fork_info * | |
71 | add_fork (pid_t pid) | |
72 | { | |
73 | struct fork_info *fp; | |
74 | ||
56aac7e8 | 75 | if (fork_list == NULL && pid != PIDGET (inferior_ptid)) |
ac264b3b MS |
76 | { |
77 | /* Special case -- if this is the first fork in the list | |
78 | (the list is hitherto empty), and if this new fork is | |
79 | NOT the current inferior_ptid, then add inferior_ptid | |
80 | first, as a special zeroeth fork id. */ | |
81 | highest_fork_num = -1; | |
82 | add_fork (PIDGET (inferior_ptid)); /* safe recursion */ | |
83 | } | |
84 | ||
85 | fp = XZALLOC (struct fork_info); | |
86 | fp->ptid = pid_to_ptid (pid); | |
87 | fp->num = ++highest_fork_num; | |
88 | fp->next = fork_list; | |
89 | fork_list = fp; | |
90 | return fp; | |
91 | } | |
92 | ||
93 | static void | |
94 | free_fork (struct fork_info *fp) | |
95 | { | |
96 | /* Notes on step-resume breakpoints: since this is a concern for | |
97 | threads, let's convince ourselves that it's not a concern for | |
98 | forks. There are two ways for a fork_info to be created. First, | |
99 | by the checkpoint command, in which case we're at a gdb prompt | |
100 | and there can't be any step-resume breakpoint. Second, by a fork | |
101 | in the user program, in which case we *may* have stepped into the | |
102 | fork call, but regardless of whether we follow the parent or the | |
103 | child, we will return to the same place and the step-resume | |
104 | breakpoint, if any, will take care of itself as usual. And | |
105 | unlike threads, we do not save a private copy of the step-resume | |
106 | breakpoint -- so we're OK. */ | |
107 | ||
108 | if (fp) | |
109 | { | |
110 | if (fp->savedregs) | |
111 | regcache_xfree (fp->savedregs); | |
112 | if (fp->filepos) | |
113 | xfree (fp->filepos); | |
114 | xfree (fp); | |
115 | } | |
116 | } | |
117 | ||
118 | static void | |
119 | delete_fork (ptid_t ptid) | |
120 | { | |
121 | struct fork_info *fp, *fpprev; | |
122 | ||
123 | fpprev = NULL; | |
124 | ||
125 | for (fp = fork_list; fp; fpprev = fp, fp = fp->next) | |
126 | if (ptid_equal (fp->ptid, ptid)) | |
127 | break; | |
128 | ||
129 | if (!fp) | |
130 | return; | |
131 | ||
132 | if (fpprev) | |
133 | fpprev->next = fp->next; | |
134 | else | |
135 | fork_list = fp->next; | |
136 | ||
137 | free_fork (fp); | |
138 | ||
139 | /* Special case: if there is now only one process in the list, | |
140 | and if it is (hopefully!) the current inferior_ptid, then | |
141 | remove it, leaving the list empty -- we're now down to the | |
142 | default case of debugging a single process. */ | |
143 | if (fork_list != NULL && fork_list->next == NULL && | |
144 | ptid_equal (fork_list->ptid, inferior_ptid)) | |
145 | { | |
146 | /* Last fork -- delete from list and handle as solo process | |
147 | (should be a safe recursion). */ | |
148 | delete_fork (inferior_ptid); | |
149 | } | |
150 | } | |
151 | ||
152 | /* Find a fork_info by matching PTID. */ | |
153 | static struct fork_info * | |
154 | find_fork_ptid (ptid_t ptid) | |
155 | { | |
156 | struct fork_info *fp; | |
157 | ||
158 | for (fp = fork_list; fp; fp = fp->next) | |
159 | if (ptid_equal (fp->ptid, ptid)) | |
160 | return fp; | |
161 | ||
162 | return NULL; | |
163 | } | |
164 | ||
165 | /* Find a fork_info by matching ID. */ | |
166 | static struct fork_info * | |
167 | find_fork_id (int num) | |
168 | { | |
169 | struct fork_info *fp; | |
170 | ||
171 | for (fp = fork_list; fp; fp = fp->next) | |
172 | if (fp->num == num) | |
173 | return fp; | |
174 | ||
175 | return NULL; | |
176 | } | |
177 | ||
178 | /* Find a fork_info by matching pid. */ | |
179 | extern struct fork_info * | |
180 | find_fork_pid (pid_t pid) | |
181 | { | |
182 | struct fork_info *fp; | |
183 | ||
184 | for (fp = fork_list; fp; fp = fp->next) | |
185 | if (pid == ptid_get_pid (fp->ptid)) | |
186 | return fp; | |
187 | ||
188 | return NULL; | |
189 | } | |
190 | ||
191 | static ptid_t | |
192 | fork_id_to_ptid (int num) | |
193 | { | |
194 | struct fork_info *fork = find_fork_id (num); | |
195 | if (fork) | |
196 | return fork->ptid; | |
197 | else | |
198 | return pid_to_ptid (-1); | |
199 | } | |
200 | ||
201 | static void | |
202 | init_fork_list (void) | |
203 | { | |
204 | struct fork_info *fp, *fpnext; | |
205 | ||
206 | if (!fork_list) | |
207 | return; | |
208 | ||
209 | for (fp = fork_list; fp; fp = fpnext) | |
210 | { | |
211 | fpnext = fp->next; | |
212 | free_fork (fp); | |
213 | } | |
214 | ||
215 | fork_list = NULL; | |
216 | } | |
217 | ||
218 | /* Fork list <-> gdb interface. */ | |
219 | ||
220 | /* Utility function for fork_load/fork_save. | |
221 | Calls lseek in the (current) inferior process. */ | |
222 | ||
223 | static off_t | |
224 | call_lseek (int fd, off_t offset, int whence) | |
225 | { | |
226 | char exp[80]; | |
227 | ||
228 | snprintf (&exp[0], sizeof (exp), "lseek (%d, %ld, %d)", | |
229 | fd, (long) offset, whence); | |
230 | return (off_t) parse_and_eval_long (&exp[0]); | |
231 | } | |
232 | ||
233 | /* Load infrun state for the fork PTID. */ | |
234 | ||
235 | static void | |
236 | fork_load_infrun_state (struct fork_info *fp) | |
237 | { | |
238 | extern void nullify_last_target_wait_ptid (); | |
239 | int i; | |
240 | ||
241 | if (fp->savedregs && fp->clobber_regs) | |
242 | regcache_cpy (current_regcache, fp->savedregs); | |
243 | ||
244 | nullify_last_target_wait_ptid (); | |
245 | ||
246 | /* Now restore the file positions of open file descriptors. */ | |
247 | if (fp->filepos) | |
248 | { | |
249 | for (i = 0; i <= fp->maxfd; i++) | |
250 | if (fp->filepos[i] != (off_t) -1) | |
251 | call_lseek (i, fp->filepos[i], SEEK_SET); | |
252 | /* NOTE: I can get away with using SEEK_SET and SEEK_CUR because | |
253 | this is native-only. If it ever has to be cross, we'll have | |
254 | to rethink this. */ | |
255 | } | |
256 | } | |
257 | ||
258 | /* Save infrun state for the fork PTID. | |
259 | Exported for use by linux child_follow_fork. */ | |
260 | ||
261 | extern void | |
262 | fork_save_infrun_state (struct fork_info *fp, int clobber_regs) | |
263 | { | |
264 | char path[MAXPATHLEN]; | |
265 | struct dirent *de; | |
266 | DIR *d; | |
267 | ||
268 | if (fp->savedregs) | |
269 | regcache_xfree (fp->savedregs); | |
270 | ||
271 | fp->savedregs = regcache_dup (current_regcache); | |
272 | fp->clobber_regs = clobber_regs; | |
273 | fp->pc = read_pc (); | |
274 | ||
275 | if (clobber_regs) | |
276 | { | |
277 | /* Now save the 'state' (file position) of all open file descriptors. | |
278 | Unfortunately fork does not take care of that for us... */ | |
279 | snprintf (path, MAXPATHLEN, "/proc/%ld/fd", (long) PIDGET (fp->ptid)); | |
280 | if ((d = opendir (path)) != NULL) | |
281 | { | |
282 | long tmp; | |
283 | ||
284 | fp->maxfd = 0; | |
285 | while ((de = readdir (d)) != NULL) | |
286 | { | |
287 | /* Count open file descriptors (actually find highest | |
288 | numbered). */ | |
289 | tmp = strtol (&de->d_name[0], NULL, 10); | |
290 | if (fp->maxfd < tmp) | |
291 | fp->maxfd = tmp; | |
292 | } | |
293 | /* Allocate array of file positions. */ | |
294 | fp->filepos = xrealloc (fp->filepos, | |
295 | (fp->maxfd + 1) * sizeof (*fp->filepos)); | |
296 | ||
297 | /* Initialize to -1 (invalid). */ | |
298 | for (tmp = 0; tmp <= fp->maxfd; tmp++) | |
299 | fp->filepos[tmp] = -1; | |
300 | ||
301 | /* Now find actual file positions. */ | |
302 | rewinddir (d); | |
303 | while ((de = readdir (d)) != NULL) | |
304 | if (isdigit (de->d_name[0])) | |
305 | { | |
306 | tmp = strtol (&de->d_name[0], NULL, 10); | |
307 | fp->filepos[tmp] = call_lseek (tmp, 0, SEEK_CUR); | |
308 | } | |
309 | closedir (d); | |
310 | } | |
311 | } | |
312 | } | |
313 | ||
314 | /* Kill 'em all, let God sort 'em out... */ | |
315 | ||
316 | extern void | |
317 | linux_fork_killall (void) | |
318 | { | |
319 | /* Walk list and kill every pid. No need to treat the | |
320 | current inferior_ptid as special (we do not return a | |
321 | status for it) -- however any process may be a child | |
322 | or a parent, so may get a SIGCHLD from a previously | |
323 | killed child. Wait them all out. */ | |
56aac7e8 | 324 | struct fork_info *fp; |
ac264b3b MS |
325 | pid_t pid, ret; |
326 | int status; | |
327 | ||
56aac7e8 MS |
328 | for (fp = fork_list; fp; fp = fp->next) |
329 | { | |
330 | pid = PIDGET (fp->ptid); | |
331 | do { | |
332 | ptrace (PT_KILL, pid, 0, 0); | |
333 | ret = waitpid (pid, &status, 0); | |
334 | /* We might get a SIGCHLD instead of an exit status. This is | |
335 | aggravated by the first kill above - a child has just | |
336 | died. MVS comment cut-and-pasted from linux-nat. */ | |
337 | } while (ret == pid && WIFSTOPPED (status)); | |
338 | } | |
339 | init_fork_list (); /* Clear list, prepare to start fresh. */ | |
ac264b3b MS |
340 | } |
341 | ||
342 | /* The current inferior_ptid has exited, but there are other viable | |
343 | forks to debug. Delete the exiting one and context-switch to the | |
344 | first available. */ | |
345 | ||
346 | extern void | |
347 | linux_fork_mourn_inferior (void) | |
348 | { | |
349 | /* Wait just one more time to collect the inferior's exit status. | |
350 | Do not check whether this succeeds though, since we may be | |
351 | dealing with a process that we attached to. Such a process will | |
352 | only report its exit status to its original parent. */ | |
353 | int status; | |
354 | ||
355 | waitpid (ptid_get_pid (inferior_ptid), &status, 0); | |
356 | ||
357 | /* OK, presumably inferior_ptid is the one who has exited. | |
358 | We need to delete that one from the fork_list, and switch | |
359 | to the next available fork. */ | |
360 | delete_fork (inferior_ptid); | |
361 | if (fork_list) /* Paranoia, shouldn't happen. */ | |
362 | { | |
363 | inferior_ptid = fork_list[0].ptid; | |
364 | printf_filtered (_("[Switching to %s]\n"), | |
365 | target_pid_to_str (inferior_ptid)); | |
366 | } | |
367 | } | |
368 | ||
369 | /* Fork list <-> user interface. */ | |
370 | ||
371 | static void | |
372 | delete_fork_command (char *args, int from_tty) | |
373 | { | |
374 | ptid_t ptid; | |
375 | ||
376 | if (!args || !*args) | |
377 | error (_("Requires argument (fork/checkpoint id to delete)")); | |
378 | ||
379 | ptid = fork_id_to_ptid (parse_and_eval_long (args)); | |
380 | if (ptid_equal (ptid, minus_one_ptid)) | |
381 | error (_("No such fork/checkpoint id, %s"), args); | |
382 | ||
383 | if (ptid_equal (ptid, inferior_ptid)) | |
384 | error (_("Please switch to another fork/checkpoint before deleting the current one")); | |
385 | ||
1dce6535 | 386 | if (ptrace (PTRACE_KILL, PIDGET (ptid), 0, 0)) |
ac264b3b MS |
387 | error (_("Unable to kill pid %s"), target_tid_to_str (ptid)); |
388 | ||
389 | if (from_tty) | |
390 | printf_filtered (_("Killed %s\n"), target_pid_to_str (ptid)); | |
391 | ||
392 | delete_fork (ptid); | |
393 | } | |
394 | ||
395 | static void | |
396 | detach_fork_command (char *args, int from_tty) | |
397 | { | |
398 | ptid_t ptid; | |
399 | ||
400 | if (!args || !*args) | |
401 | error (_("Requires argument (fork id to detach)")); | |
402 | ||
403 | ptid = fork_id_to_ptid (parse_and_eval_long (args)); | |
404 | if (ptid_equal (ptid, minus_one_ptid)) | |
405 | error (_("No such fork id, %s"), args); | |
406 | ||
407 | if (ptid_equal (ptid, inferior_ptid)) | |
408 | error (_("Please switch to another fork before detaching the current one")); | |
409 | ||
1dce6535 | 410 | if (ptrace (PTRACE_DETACH, PIDGET (ptid), 0, 0)) |
ac264b3b MS |
411 | error (_("Unable to detach %s"), target_pid_to_str (ptid)); |
412 | ||
413 | if (from_tty) | |
414 | printf_filtered (_("Detached %s\n"), target_pid_to_str (ptid)); | |
415 | ||
416 | delete_fork (ptid); | |
417 | } | |
418 | ||
419 | /* Print information about currently known forks. */ | |
420 | ||
421 | static void | |
422 | info_forks_command (char *arg, int from_tty) | |
423 | { | |
424 | struct frame_info *cur_frame; | |
425 | struct symtab_and_line sal; | |
426 | struct symtab *cur_symtab; | |
427 | struct fork_info *fp; | |
428 | int cur_line; | |
429 | ULONGEST pc; | |
430 | ||
431 | for (fp = fork_list; fp; fp = fp->next) | |
432 | { | |
433 | if (ptid_equal (fp->ptid, inferior_ptid)) | |
434 | { | |
435 | printf_filtered ("* "); | |
436 | pc = read_pc (); | |
437 | } | |
438 | else | |
439 | { | |
440 | printf_filtered (" "); | |
441 | pc = fp->pc; | |
442 | } | |
443 | printf_filtered ("%d %s", fp->num, target_pid_to_str (fp->ptid)); | |
444 | if (fp->num == 0) | |
445 | printf_filtered (_(" (main process)")); | |
446 | printf_filtered (_(" at ")); | |
447 | deprecated_print_address_numeric (pc, 1, gdb_stdout); | |
448 | ||
449 | sal = find_pc_line (pc, 0); | |
450 | if (sal.symtab) | |
451 | { | |
452 | char *tmp = strrchr (sal.symtab->filename, '/'); | |
453 | ||
454 | if (tmp) | |
455 | printf_filtered (_(", file %s"), tmp + 1); | |
456 | else | |
457 | printf_filtered (_(", file %s"), sal.symtab->filename); | |
458 | } | |
459 | if (sal.line) | |
460 | printf_filtered (_(", line %d"), sal.line); | |
461 | if (!sal.symtab && !sal.line) | |
462 | { | |
463 | struct minimal_symbol *msym; | |
464 | ||
465 | msym = lookup_minimal_symbol_by_pc (pc); | |
466 | if (msym) | |
467 | printf_filtered (", <%s>", SYMBOL_LINKAGE_NAME (msym)); | |
468 | } | |
469 | ||
470 | putchar_filtered ('\n'); | |
471 | } | |
472 | } | |
473 | ||
474 | /* Save/restore mode variable 'detach_fork': | |
475 | We need to temporarily take over this mode variable, while | |
476 | preserving the user-specified state, and make sure that it | |
477 | gets restored in case of error. | |
478 | ||
479 | The int pointer that we use comes from the caller, so we can | |
480 | be called more than once (even though currently we don't need to). */ | |
481 | ||
482 | static void | |
483 | restore_detach_fork (void *arg) | |
484 | { | |
485 | detach_fork = *(int *) arg; | |
486 | } | |
487 | ||
488 | static struct cleanup * | |
489 | save_detach_fork (int *saved_val) | |
490 | { | |
491 | *saved_val = detach_fork; | |
492 | return make_cleanup (restore_detach_fork, (void *) saved_val); | |
493 | } | |
494 | ||
495 | static void | |
496 | checkpoint_command (char *args, int from_tty) | |
497 | { | |
498 | struct target_waitstatus last_target_waitstatus; | |
499 | ptid_t last_target_ptid; | |
500 | struct value *fork_fn = NULL, *ret; | |
501 | struct fork_info *fp; | |
502 | pid_t retpid; | |
503 | struct cleanup *old_chain; | |
504 | long i; | |
505 | /* Make this temp var static, 'cause it's used in the error context. */ | |
506 | static int temp_detach_fork; | |
507 | ||
508 | /* Make the inferior fork, record its (and gdb's) state. */ | |
509 | ||
510 | if (lookup_minimal_symbol ("fork", NULL, NULL) != NULL) | |
511 | fork_fn = find_function_in_inferior ("fork"); | |
512 | if (!fork_fn) | |
513 | if (lookup_minimal_symbol ("_fork", NULL, NULL) != NULL) | |
514 | fork_fn = find_function_in_inferior ("fork"); | |
515 | if (!fork_fn) | |
516 | error (_("checkpoint: can't find fork function in inferior.")); | |
517 | ||
518 | ret = value_from_longest (builtin_type_int, 0); | |
519 | old_chain = save_detach_fork (&temp_detach_fork); | |
520 | detach_fork = 0; | |
521 | ret = call_function_by_hand (fork_fn, 0, &ret); | |
522 | do_cleanups (old_chain); | |
523 | if (!ret) /* Probably can't happen. */ | |
524 | error (_("checkpoint: call_function_by_hand returned null.")); | |
525 | ||
526 | retpid = value_as_long (ret); | |
527 | get_last_target_status (&last_target_ptid, &last_target_waitstatus); | |
528 | if (from_tty) | |
529 | { | |
530 | int parent_pid; | |
531 | ||
532 | printf_filtered (_("checkpoint: fork returned pid %ld.\n"), | |
533 | (long) retpid); | |
534 | if (info_verbose) | |
535 | { | |
536 | parent_pid = ptid_get_lwp (last_target_ptid); | |
537 | if (parent_pid == 0) | |
538 | parent_pid = ptid_get_pid (last_target_ptid); | |
539 | printf_filtered (_(" gdb says parent = %ld.\n"), | |
540 | (long) parent_pid); | |
541 | } | |
542 | } | |
543 | ||
544 | fp = find_fork_pid (retpid); | |
545 | if (!fp) | |
546 | error (_("Failed to find new fork")); | |
547 | fork_save_infrun_state (fp, 1); | |
548 | } | |
549 | ||
550 | static void | |
551 | linux_fork_context (struct fork_info *newfp, int from_tty) | |
552 | { | |
553 | /* Now we attempt to switch processes. */ | |
554 | struct fork_info *oldfp = find_fork_ptid (inferior_ptid); | |
555 | ptid_t ptid; | |
556 | int id, i; | |
557 | ||
558 | if (!newfp) | |
559 | error (_("No such fork/process")); | |
560 | ||
561 | if (!oldfp) | |
562 | { | |
563 | oldfp = add_fork (ptid_get_pid (inferior_ptid)); | |
564 | } | |
565 | ||
566 | fork_save_infrun_state (oldfp, 1); | |
567 | inferior_ptid = newfp->ptid; | |
568 | fork_load_infrun_state (newfp); | |
569 | registers_changed (); | |
570 | reinit_frame_cache (); | |
571 | stop_pc = read_pc (); | |
572 | select_frame (get_current_frame ()); | |
573 | ||
574 | printf_filtered (_("Switching to %s\n"), | |
575 | target_pid_to_str (inferior_ptid)); | |
576 | ||
577 | print_stack_frame (get_selected_frame (NULL), 1, SRC_AND_LOC); | |
578 | } | |
579 | ||
580 | /* Switch inferior process (fork) context, by process id. */ | |
581 | static void | |
582 | process_command (char *args, int from_tty) | |
583 | { | |
584 | struct fork_info *fp; | |
585 | ||
586 | if (!args || !*args) | |
587 | error (_("Requires argument (process id to switch to)")); | |
588 | ||
589 | if ((fp = find_fork_pid (parse_and_eval_long (args))) == NULL) | |
590 | error (_("Not found: process id %s"), args); | |
591 | ||
592 | linux_fork_context (fp, from_tty); | |
593 | } | |
594 | ||
595 | /* Switch inferior process (fork) context, by fork id. */ | |
596 | static void | |
597 | fork_command (char *args, int from_tty) | |
598 | { | |
599 | struct fork_info *fp; | |
600 | ||
601 | if (!args || !*args) | |
602 | error (_("Requires argument (fork id to switch to)")); | |
603 | ||
604 | if ((fp = find_fork_id (parse_and_eval_long (args))) == NULL) | |
605 | error (_("Not found: fork id %s"), args); | |
606 | ||
607 | linux_fork_context (fp, from_tty); | |
608 | } | |
609 | ||
610 | /* Switch inferior process (fork) context, by checkpoint id. */ | |
611 | static void | |
612 | restart_command (char *args, int from_tty) | |
613 | { | |
614 | struct fork_info *fp; | |
615 | ||
616 | if (!args || !*args) | |
617 | error (_("Requires argument (checkpoint id to restart)")); | |
618 | ||
619 | if ((fp = find_fork_id (parse_and_eval_long (args))) == NULL) | |
620 | error (_("Not found: checkpoint id %s"), args); | |
621 | ||
622 | linux_fork_context (fp, from_tty); | |
623 | } | |
624 | ||
625 | void | |
626 | _initialize_linux_fork (void) | |
627 | { | |
628 | init_fork_list (); | |
629 | ||
630 | /* Set/show detach-on-fork: user-settable mode. */ | |
631 | ||
632 | add_setshow_boolean_cmd ("detach-on-fork", class_obscure, &detach_fork, _("\ | |
633 | Set whether gdb will detach the child of a fork."), _("\ | |
634 | Show whether gdb will detach the child of a fork."), _("\ | |
635 | Tells gdb whether to detach the child of a fork."), | |
636 | NULL, NULL, &setlist, &showlist); | |
637 | ||
638 | /* Set/show restart-auto-finish: user-settable count. Causes the | |
639 | first "restart" of a fork to do some number of "finish" commands | |
640 | before returning to user. | |
641 | ||
642 | Useful because otherwise the virgin fork process will be stopped | |
643 | somewhere in the un-interesting fork system call. */ | |
644 | ||
645 | /* Checkpoint command: create a fork of the inferior process | |
646 | and set it aside for later debugging. */ | |
647 | ||
648 | add_com ("checkpoint", class_obscure, checkpoint_command, _("\ | |
649 | Fork a duplicate process (experimental).")); | |
650 | ||
651 | /* Restart command: restore the context of a specified fork | |
652 | process. May be used for "program forks" as well as for | |
653 | "debugger forks" (checkpoints). */ | |
654 | ||
655 | add_com ("restart", class_obscure, restart_command, _("\ | |
656 | restart <n>: restore program context from a checkpoint.\n\ | |
657 | Argument 'n' is checkpoint ID, as displayed by 'info checkpoints'.")); | |
658 | ||
659 | /* Delete-checkpoint command: kill the process and remove it from | |
660 | fork list. */ | |
661 | ||
662 | add_com ("delete-checkpoint", class_obscure, delete_fork_command, _("\ | |
663 | Delete a fork/checkpoint (experimental).")); | |
664 | ||
665 | /* Detach-checkpoint command: release the process to run independantly, | |
666 | and remove it from the fork list. */ | |
667 | ||
668 | add_com ("detach-checkpoint", class_obscure, detach_fork_command, _("\ | |
669 | Detach from a fork/checkpoint (experimental).")); | |
670 | ||
671 | /* Info checkpoints command: list all forks/checkpoints | |
672 | currently under gdb's control. */ | |
673 | ||
674 | add_info ("checkpoints", info_forks_command, | |
675 | _("IDs of currently known forks/checkpoints.")); | |
676 | ||
677 | /* Command aliases (let "fork" and "checkpoint" be used | |
678 | interchangeably). */ | |
679 | ||
680 | add_com_alias ("delete-fork", "delete-checkpoint", class_obscure, 1); | |
681 | add_com_alias ("detach-fork", "detach-checkpoint", class_obscure, 1); | |
682 | add_info_alias ("forks", "checkpoints", 0); | |
683 | ||
684 | /* "fork <n>" (by analogy to "thread <n>"). */ | |
685 | add_com ("fork", class_obscure, fork_command, _("\ | |
686 | fork <n>: Switch between forked processes.\n\ | |
687 | Argument 'n' is fork ID, as displayed by 'info forks'.")); | |
688 | ||
689 | /* "process <proc id>" as opposed to "fork <fork id>". */ | |
690 | add_com ("process", class_obscure, process_command, _("\ | |
691 | process <pid>: Switch between forked processes.\n\ | |
692 | Argument 'pid' is process ID, as displayed by 'info forks' or 'shell ps'.")); | |
693 | } |