X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gdb%2Finferior.c;h=d732690a3cd66ca68af5ad2b30bee3b879c8ff12;hb=5b6d1e4fa4fc6827c7b3f0e99ff120dfa14d65d2;hp=9fa2dadd857d980c960376987e045b2d4cb68f1a;hpb=9a6c7d9c021cfeb290d76584db7a01e57e7c3d4e;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/inferior.c b/gdb/inferior.c index 9fa2dadd85..d732690a3c 100644 --- a/gdb/inferior.c +++ b/gdb/inferior.c @@ -1,6 +1,6 @@ /* Multi-process control for GDB, the GNU debugger. - Copyright (C) 2008-2017 Free Software Foundation, Inc. + Copyright (C) 2008-2020 Free Software Foundation, Inc. This file is part of GDB. @@ -26,10 +26,10 @@ #include "gdbcmd.h" #include "gdbthread.h" #include "ui-out.h" -#include "observer.h" +#include "observable.h" #include "gdbcore.h" #include "symfile.h" -#include "environ.h" +#include "gdbsupport/environ.h" #include "cli/cli-utils.h" #include "continuations.h" #include "arch-utils.h" @@ -37,8 +37,6 @@ #include "readline/tilde.h" #include "progspace-and-thread.h" -void _initialize_inferiors (void); - /* Keep a registry of per-inferior data-pointers required by other GDB modules. */ @@ -47,9 +45,8 @@ DEFINE_REGISTRY (inferior, REGISTRY_ACCESS_FIELD) struct inferior *inferior_list = NULL; static int highest_inferior_num; -/* Print notices on inferior events (attach, detach, etc.), set with - `set print inferior-events'. */ -static int print_inferior_events = 0; +/* See inferior.h. */ +bool print_inferior_events = true; /* The Current Inferior. This is a strong reference. I.e., whenever an inferior is the current inferior, its refcount is @@ -73,6 +70,8 @@ set_current_inferior (struct inferior *inf) current_inferior_ = inf; } +private_inferior::~private_inferior () = default; + inferior::~inferior () { inferior *inf = this; @@ -82,7 +81,6 @@ inferior::~inferior () xfree (inf->args); xfree (inf->terminal); target_desc_info_free (inf->tdesc_info); - xfree (inf->priv); } inferior::inferior (int pid_) @@ -92,6 +90,8 @@ inferior::inferior (int pid_) registry_data () { inferior_alloc_data (this); + + m_target_stack.push (get_dummy_target ()); } struct inferior * @@ -110,7 +110,7 @@ add_inferior_silent (int pid) last->next = inf; } - observer_notify_inferior_added (inf); + gdb::observers::inferior_added.notify (inf); if (pid != 0) inferior_appeared (inf, pid); @@ -124,39 +124,22 @@ add_inferior (int pid) struct inferior *inf = add_inferior_silent (pid); if (print_inferior_events) - printf_unfiltered (_("[New inferior %d]\n"), pid); - - return inf; -} - -struct delete_thread_of_inferior_arg -{ - int pid; - int silent; -}; - -static int -delete_thread_of_inferior (struct thread_info *tp, void *data) -{ - struct delete_thread_of_inferior_arg *arg - = (struct delete_thread_of_inferior_arg *) data; - - if (ptid_get_pid (tp->ptid) == arg->pid) { - if (arg->silent) - delete_thread_silent (tp->ptid); + if (pid != 0) + printf_unfiltered (_("[New inferior %d (%s)]\n"), + inf->num, + target_pid_to_str (ptid_t (pid)).c_str ()); else - delete_thread (tp->ptid); + printf_unfiltered (_("[New inferior %d]\n"), inf->num); } - return 0; + return inf; } void delete_inferior (struct inferior *todel) { struct inferior *inf, *infprev; - struct delete_thread_of_inferior_arg arg; infprev = NULL; @@ -167,17 +150,15 @@ delete_inferior (struct inferior *todel) if (!inf) return; - arg.pid = inf->pid; - arg.silent = 1; - - iterate_over_threads (delete_thread_of_inferior, &arg); + for (thread_info *tp : inf->threads_safe ()) + delete_thread_silent (tp); if (infprev) infprev->next = inf->next; else inferior_list = inf->next; - observer_notify_inferior_removed (inf); + gdb::observers::inferior_removed.notify (inf); /* If this program space is rendered useless, remove it. */ if (program_space_empty_p (inf->pspace)) @@ -193,7 +174,6 @@ static void exit_inferior_1 (struct inferior *inftoex, int silent) { struct inferior *inf; - struct delete_thread_of_inferior_arg arg; for (inf = inferior_list; inf; inf = inf->next) if (inf == inftoex) @@ -202,16 +182,18 @@ exit_inferior_1 (struct inferior *inftoex, int silent) if (!inf) return; - arg.pid = inf->pid; - arg.silent = silent; - - iterate_over_threads (delete_thread_of_inferior, &arg); + for (thread_info *tp : inf->threads_safe ()) + { + if (silent) + delete_thread_silent (tp); + else + delete_thread (tp); + } - observer_notify_inferior_exit (inf); + gdb::observers::inferior_exit.notify (inf); inf->pid = 0; - inf->fake_pid_p = 0; - xfree (inf->priv); + inf->fake_pid_p = false; inf->priv = NULL; if (inf->vfork_parent != NULL) @@ -226,74 +208,69 @@ exit_inferior_1 (struct inferior *inftoex, int silent) } inf->pending_detach = 0; + /* Reset it. */ + inf->control = inferior_control_state (NO_STOP_QUIETLY); + + /* Clear the register cache and the frame cache. */ + registers_changed (); + reinit_frame_cache (); } void -exit_inferior (int pid) +exit_inferior (inferior *inf) { - struct inferior *inf = find_inferior_pid (pid); - exit_inferior_1 (inf, 0); - - if (print_inferior_events) - printf_unfiltered (_("[Inferior %d exited]\n"), pid); } void -exit_inferior_silent (int pid) +exit_inferior_silent (inferior *inf) { - struct inferior *inf = find_inferior_pid (pid); - exit_inferior_1 (inf, 1); } -void -exit_inferior_num_silent (int num) -{ - struct inferior *inf = find_inferior_id (num); - - exit_inferior_1 (inf, 1); -} +/* See inferior.h. */ void -detach_inferior (int pid) +detach_inferior (inferior *inf) { - struct inferior *inf = find_inferior_pid (pid); + /* Save the pid, since exit_inferior_1 will reset it. */ + int pid = inf->pid; exit_inferior_1 (inf, 0); if (print_inferior_events) - printf_unfiltered (_("[Inferior %d detached]\n"), pid); + printf_unfiltered (_("[Inferior %d (%s) detached]\n"), + inf->num, + target_pid_to_str (ptid_t (pid)).c_str ()); } void inferior_appeared (struct inferior *inf, int pid) { + /* If this is the first inferior with threads, reset the global + thread id. */ + delete_exited_threads (); + if (!any_thread_p ()) + init_thread_list (); + inf->pid = pid; inf->has_exit_code = 0; inf->exit_code = 0; - observer_notify_inferior_appeared (inf); + gdb::observers::inferior_appeared.notify (inf); } void discard_all_inferiors (void) { - struct inferior *inf; - - for (inf = inferior_list; inf; inf = inf->next) - { - if (inf->pid != 0) - exit_inferior_silent (inf->pid); - } + for (inferior *inf : all_non_exited_inferiors ()) + exit_inferior_silent (inf); } struct inferior * find_inferior_id (int num) { - struct inferior *inf; - - for (inf = inferior_list; inf; inf = inf->next) + for (inferior *inf : all_inferiors ()) if (inf->num == num) return inf; @@ -301,16 +278,14 @@ find_inferior_id (int num) } struct inferior * -find_inferior_pid (int pid) +find_inferior_pid (process_stratum_target *targ, int pid) { - struct inferior *inf; - /* Looking for inferior pid == 0 is always wrong, and indicative of a bug somewhere else. There may be more than one with pid == 0, for instance. */ gdb_assert (pid != 0); - for (inf = inferior_list; inf; inf = inf->next) + for (inferior *inf : all_inferiors (targ)) if (inf->pid == pid) return inf; @@ -320,9 +295,9 @@ find_inferior_pid (int pid) /* See inferior.h */ struct inferior * -find_inferior_ptid (ptid_t ptid) +find_inferior_ptid (process_stratum_target *targ, ptid_t ptid) { - return find_inferior_pid (ptid_get_pid (ptid)); + return find_inferior_pid (targ, ptid.pid ()); } /* See inferior.h. */ @@ -330,16 +305,14 @@ find_inferior_ptid (ptid_t ptid) struct inferior * find_inferior_for_program_space (struct program_space *pspace) { - struct inferior *inf = current_inferior (); + struct inferior *cur_inf = current_inferior (); - if (inf->pspace == pspace) - return inf; + if (cur_inf->pspace == pspace) + return cur_inf; - for (inf = inferior_list; inf != NULL; inf = inf->next) - { - if (inf->pspace == pspace) - return inf; - } + for (inferior *inf : all_inferiors ()) + if (inf->pspace == pspace) + return inf; return NULL; } @@ -348,72 +321,18 @@ struct inferior * iterate_over_inferiors (int (*callback) (struct inferior *, void *), void *data) { - struct inferior *inf, *infnext; - - for (inf = inferior_list; inf; inf = infnext) - { - infnext = inf->next; - if ((*callback) (inf, data)) - return inf; - } + for (inferior *inf : all_inferiors_safe ()) + if ((*callback) (inf, data)) + return inf; return NULL; } -int -valid_gdb_inferior_id (int num) -{ - struct inferior *inf; - - for (inf = inferior_list; inf; inf = inf->next) - if (inf->num == num) - return 1; - - return 0; -} - -int -pid_to_gdb_inferior_id (int pid) -{ - struct inferior *inf; - - for (inf = inferior_list; inf; inf = inf->next) - if (inf->pid == pid) - return inf->num; - - return 0; -} - -int -gdb_inferior_id_to_pid (int num) -{ - struct inferior *inferior = find_inferior_id (num); - if (inferior) - return inferior->pid; - else - return -1; -} - -int -in_inferior_list (int pid) -{ - struct inferior *inf; - - for (inf = inferior_list; inf; inf = inf->next) - if (inf->pid == pid) - return 1; - - return 0; -} - int have_inferiors (void) { - struct inferior *inf; - - for (inf = inferior_list; inf; inf = inf->next) - if (inf->pid != 0) - return 1; + for (inferior *inf ATTRIBUTE_UNUSED : all_non_exited_inferiors ()) + return 1; return 0; } @@ -423,26 +342,19 @@ have_inferiors (void) in the middle of a 'mourn' operation. */ int -number_of_live_inferiors (void) +number_of_live_inferiors (process_stratum_target *proc_target) { - struct inferior *inf; int num_inf = 0; - for (inf = inferior_list; inf; inf = inf->next) - if (inf->pid != 0) - { - struct thread_info *tp; - - ALL_NON_EXITED_THREADS (tp) - if (tp && ptid_get_pid (tp->ptid) == inf->pid) - if (target_has_execution_1 (tp->ptid)) - { - /* Found a live thread in this inferior, go to the next - inferior. */ - ++num_inf; - break; - } - } + for (inferior *inf : all_non_exited_inferiors (proc_target)) + if (inf->has_execution ()) + for (thread_info *tp ATTRIBUTE_UNUSED : inf->non_exited_threads ()) + { + /* Found a live thread in this inferior, go to the next + inferior. */ + ++num_inf; + break; + } return num_inf; } @@ -452,7 +364,7 @@ number_of_live_inferiors (void) int have_live_inferiors (void) { - return number_of_live_inferiors () > 0; + return number_of_live_inferiors (NULL) > 0; } /* Prune away any unused inferiors, and then prune away no longer used @@ -461,24 +373,22 @@ have_live_inferiors (void) void prune_inferiors (void) { - struct inferior *ss, **ss_link; + inferior *ss; ss = inferior_list; - ss_link = &inferior_list; while (ss) { if (!ss->deletable () || !ss->removable || ss->pid != 0) { - ss_link = &ss->next; - ss = *ss_link; + ss = ss->next; continue; } - *ss_link = ss->next; + inferior *ss_next = ss->next; delete_inferior (ss); - ss = *ss_link; + ss = ss_next; } } @@ -487,23 +397,18 @@ prune_inferiors (void) int number_of_inferiors (void) { - struct inferior *inf; - int count = 0; - - for (inf = inferior_list; inf != NULL; inf = inf->next) - count++; - - return count; + auto rng = all_inferiors (); + return std::distance (rng.begin (), rng.end ()); } /* Converts an inferior process id to a string. Like target_pid_to_str, but special cases the null process. */ -static const char * +static std::string inferior_pid_to_str (int pid) { if (pid != 0) - return target_pid_to_str (pid_to_ptid (pid)); + return target_pid_to_str (ptid_t (pid)); else return _(""); } @@ -520,7 +425,7 @@ print_selected_inferior (struct ui_out *uiout) filename = _(""); uiout->message (_("[Switching to inferior %d [%s] (%s)]\n"), - inf->num, inferior_pid_to_str (inf->pid), filename); + inf->num, inferior_pid_to_str (inf->pid).c_str (), filename); } /* Prints the list of inferiors and their details on UIOUT. This is a @@ -531,14 +436,12 @@ print_selected_inferior (struct ui_out *uiout) printed. */ static void -print_inferior (struct ui_out *uiout, char *requested_inferiors) +print_inferior (struct ui_out *uiout, const char *requested_inferiors) { - struct inferior *inf; - struct cleanup *old_chain; int inf_count = 0; /* Compute number of inferiors we will print. */ - for (inf = inferior_list; inf; inf = inf->next) + for (inferior *inf : all_inferiors ()) { if (!number_is_in_list (requested_inferiors, inf->num)) continue; @@ -552,15 +455,14 @@ print_inferior (struct ui_out *uiout, char *requested_inferiors) return; } - old_chain = make_cleanup_ui_out_table_begin_end (uiout, 4, inf_count, - "inferiors"); + ui_out_emit_table table_emitter (uiout, 4, inf_count, "inferiors"); uiout->table_header (1, ui_left, "current", ""); uiout->table_header (4, ui_left, "number", "Num"); uiout->table_header (17, ui_left, "target-id", "Description"); uiout->table_header (17, ui_left, "exec", "Executable"); uiout->table_body (); - for (inf = inferior_list; inf; inf = inf->next) + for (inferior *inf : all_inferiors ()) { if (!number_is_in_list (requested_inferiors, inf->num)) continue; @@ -572,7 +474,7 @@ print_inferior (struct ui_out *uiout, char *requested_inferiors) else uiout->field_skip ("current"); - uiout->field_int ("number", inf->num); + uiout->field_signed ("number", inf->num); uiout->field_string ("target-id", inferior_pid_to_str (inf->pid)); @@ -587,25 +489,21 @@ print_inferior (struct ui_out *uiout, char *requested_inferiors) if (inf->vfork_parent) { uiout->text (_("\n\tis vfork child of inferior ")); - uiout->field_int ("vfork-parent", inf->vfork_parent->num); + uiout->field_signed ("vfork-parent", inf->vfork_parent->num); } if (inf->vfork_child) { uiout->text (_("\n\tis vfork parent of inferior ")); - uiout->field_int ("vfork-child", inf->vfork_child->num); + uiout->field_signed ("vfork-child", inf->vfork_child->num); } uiout->text ("\n"); } - - do_cleanups (old_chain); } static void -detach_inferior_command (char *args, int from_tty) +detach_inferior_command (const char *args, int from_tty) { - struct thread_info *tp; - if (!args || !*args) error (_("Requires argument (inferior id(s) to detach)")); @@ -614,37 +512,35 @@ detach_inferior_command (char *args, int from_tty) { int num = parser.get_number (); - if (!valid_gdb_inferior_id (num)) + inferior *inf = find_inferior_id (num); + if (inf == NULL) { warning (_("Inferior ID %d not known."), num); continue; } - int pid = gdb_inferior_id_to_pid (num); - if (pid == 0) + if (inf->pid == 0) { warning (_("Inferior ID %d is not running."), num); continue; } - tp = any_thread_of_process (pid); - if (!tp) + thread_info *tp = any_thread_of_inferior (inf); + if (tp == NULL) { warning (_("Inferior ID %d has no threads."), num); continue; } - switch_to_thread (tp->ptid); + switch_to_thread (tp); detach_command (NULL, from_tty); } } static void -kill_inferior_command (char *args, int from_tty) +kill_inferior_command (const char *args, int from_tty) { - struct thread_info *tp; - if (!args || !*args) error (_("Requires argument (inferior id(s) to kill)")); @@ -653,27 +549,27 @@ kill_inferior_command (char *args, int from_tty) { int num = parser.get_number (); - if (!valid_gdb_inferior_id (num)) + inferior *inf = find_inferior_id (num); + if (inf == NULL) { warning (_("Inferior ID %d not known."), num); continue; } - int pid = gdb_inferior_id_to_pid (num); - if (pid == 0) + if (inf->pid == 0) { warning (_("Inferior ID %d is not running."), num); continue; } - tp = any_thread_of_process (pid); - if (!tp) + thread_info *tp = any_thread_of_inferior (inf); + if (tp == NULL) { warning (_("Inferior ID %d has no threads."), num); continue; } - switch_to_thread (tp->ptid); + switch_to_thread (tp); target_kill (); } @@ -681,8 +577,18 @@ kill_inferior_command (char *args, int from_tty) bfd_cache_close_all (); } +/* See inferior.h. */ + +void +switch_to_inferior_no_thread (inferior *inf) +{ + set_current_inferior (inf); + switch_to_no_thread (); + set_current_program_space (inf->pspace); +} + static void -inferior_command (char *args, int from_tty) +inferior_command (const char *args, int from_tty) { struct inferior *inf; int num; @@ -695,36 +601,33 @@ inferior_command (char *args, int from_tty) if (inf->pid != 0) { - if (inf->pid != ptid_get_pid (inferior_ptid)) + if (inf != current_inferior ()) { - struct thread_info *tp; - - tp = any_thread_of_process (inf->pid); - if (!tp) + thread_info *tp = any_thread_of_inferior (inf); + if (tp == NULL) error (_("Inferior has no threads.")); - switch_to_thread (tp->ptid); + switch_to_thread (tp); } - observer_notify_user_selected_context_changed + gdb::observers::user_selected_context_changed.notify (USER_SELECTED_INFERIOR | USER_SELECTED_THREAD | USER_SELECTED_FRAME); } else { - set_current_inferior (inf); - switch_to_thread (null_ptid); - set_current_program_space (inf->pspace); + switch_to_inferior_no_thread (inf); - observer_notify_user_selected_context_changed (USER_SELECTED_INFERIOR); + gdb::observers::user_selected_context_changed.notify + (USER_SELECTED_INFERIOR); } } /* Print information about currently known inferiors. */ static void -info_inferiors_command (char *args, int from_tty) +info_inferiors_command (const char *args, int from_tty) { print_inferior (current_uiout, args); } @@ -732,7 +635,7 @@ info_inferiors_command (char *args, int from_tty) /* remove-inferior ID */ static void -remove_inferior_command (char *args, int from_tty) +remove_inferior_command (const char *args, int from_tty) { if (args == NULL || *args == '\0') error (_("Requires an argument (inferior id(s) to remove)")); @@ -777,7 +680,7 @@ add_inferior_with_spaces (void) doesn't really return a new address space; otherwise, it really does. */ aspace = maybe_new_address_space (); - pspace = add_program_space (aspace); + pspace = new program_space (aspace); inf = add_inferior (0); inf->pspace = pspace; inf->aspace = pspace->aspace; @@ -793,26 +696,45 @@ add_inferior_with_spaces (void) return inf; } -/* add-inferior [-copies N] [-exec FILENAME] */ +/* Switch to inferior NEW_INF, a new inferior, and unless + NO_CONNECTION is true, push the process_stratum_target of ORG_INF + to NEW_INF. */ static void -add_inferior_command (char *args, int from_tty) +switch_to_inferior_and_push_target (inferior *new_inf, + bool no_connection, inferior *org_inf) +{ + process_stratum_target *proc_target = org_inf->process_target (); + + /* Switch over temporarily, while reading executable and + symbols. */ + switch_to_inferior_no_thread (new_inf); + + /* Reuse the target for new inferior. */ + if (!no_connection && proc_target != NULL) + push_target (proc_target); + + printf_filtered (_("Added inferior %d\n"), new_inf->num); +} + +/* add-inferior [-copies N] [-exec FILENAME] [-no-connection] */ + +static void +add_inferior_command (const char *args, int from_tty) { int i, copies = 1; - char *exec = NULL; - char **argv; + gdb::unique_xmalloc_ptr exec; symfile_add_flags add_flags = 0; - struct cleanup *old_chain = make_cleanup (null_cleanup, NULL); + bool no_connection = false; if (from_tty) add_flags |= SYMFILE_VERBOSE; if (args) { - argv = gdb_buildargv (args); - make_cleanup_freeargv (argv); + gdb_argv built_argv (args); - for (; *argv != NULL; argv++) + for (char **argv = built_argv.get (); *argv != NULL; argv++) { if (**argv == '-') { @@ -823,13 +745,14 @@ add_inferior_command (char *args, int from_tty) error (_("No argument to -copies")); copies = parse_and_eval_long (*argv); } + else if (strcmp (*argv, "-no-connection") == 0) + no_connection = true; else if (strcmp (*argv, "-exec") == 0) { ++argv; if (!*argv) error (_("No argument to -exec")); - exec = tilde_expand (*argv); - make_cleanup (xfree, exec); + exec.reset (tilde_expand (*argv)); } } else @@ -837,45 +760,38 @@ add_inferior_command (char *args, int from_tty) } } + inferior *orginf = current_inferior (); + scoped_restore_current_pspace_and_thread restore_pspace_thread; for (i = 0; i < copies; ++i) { - struct inferior *inf = add_inferior_with_spaces (); + inferior *inf = add_inferior_with_spaces (); - printf_filtered (_("Added inferior %d\n"), inf->num); + switch_to_inferior_and_push_target (inf, no_connection, orginf); if (exec != NULL) { - /* Switch over temporarily, while reading executable and - symbols.q. */ - set_current_program_space (inf->pspace); - set_current_inferior (inf); - switch_to_thread (null_ptid); - - exec_file_attach (exec, from_tty); - symbol_file_add_main (exec, add_flags); + exec_file_attach (exec.get (), from_tty); + symbol_file_add_main (exec.get (), add_flags); } } - - do_cleanups (old_chain); } -/* clone-inferior [-copies N] [ID] */ +/* clone-inferior [-copies N] [ID] [-no-connection] */ static void -clone_inferior_command (char *args, int from_tty) +clone_inferior_command (const char *args, int from_tty) { int i, copies = 1; - char **argv; struct inferior *orginf = NULL; - struct cleanup *old_chain = make_cleanup (null_cleanup, NULL); + bool no_connection = false; if (args) { - argv = gdb_buildargv (args); - make_cleanup_freeargv (argv); + gdb_argv built_argv (args); + char **argv = built_argv.get (); for (; *argv != NULL; argv++) { if (**argv == '-') @@ -890,6 +806,8 @@ clone_inferior_command (char *args, int from_tty) if (copies < 0) error (_("Invalid copies number")); } + else if (strcmp (*argv, "-no-connection") == 0) + no_connection = true; } else { @@ -929,25 +847,21 @@ clone_inferior_command (char *args, int from_tty) doesn't really return a new address space; otherwise, it really does. */ aspace = maybe_new_address_space (); - pspace = add_program_space (aspace); + pspace = new program_space (aspace); inf = add_inferior (0); inf->pspace = pspace; inf->aspace = pspace->aspace; inf->gdbarch = orginf->gdbarch; + switch_to_inferior_and_push_target (inf, no_connection, orginf); + /* If the original inferior had a user specified target description, make the clone use it too. */ if (target_desc_info_from_user_p (inf->tdesc_info)) copy_inferior_target_desc_info (inf, orginf); - printf_filtered (_("Added inferior %d.\n"), inf->num); - - set_current_inferior (inf); - switch_to_thread (null_ptid); clone_program_space (pspace, orginf->pspace); } - - do_cleanups (old_chain); } /* Print notices when new inferiors are created and die. */ @@ -991,22 +905,28 @@ initialize_inferiors (void) can only allocate an inferior when all those modules have done that. Do this after initialize_progspace, due to the current_program_space reference. */ - current_inferior_ = add_inferior (0); + current_inferior_ = add_inferior_silent (0); current_inferior_->incref (); current_inferior_->pspace = current_program_space; current_inferior_->aspace = current_program_space->aspace; /* The architecture will be initialized shortly, by initialize_current_architecture. */ - add_info ("inferiors", info_inferiors_command, - _("IDs of specified inferiors (all inferiors if no argument).")); + add_info ("inferiors", info_inferiors_command, + _("Print a list of inferiors being managed.\n\ +Usage: info inferiors [ID]...\n\ +If IDs are specified, the list is limited to just those inferiors.\n\ +By default all inferiors are displayed.")); c = add_com ("add-inferior", no_class, add_inferior_command, _("\ Add a new inferior.\n\ -Usage: add-inferior [-copies ] [-exec ]\n\ +Usage: add-inferior [-copies N] [-exec FILENAME] [-no-connection]\n\ N is the optional number of inferiors to add, default is 1.\n\ FILENAME is the file name of the executable to use\n\ -as main program.")); +as main program.\n\ +By default, the new inferior inherits the current inferior's connection.\n\ +If -no-connection is specified, the new inferior begins with\n\ +no target connection yet.")); set_cmd_completer (c, filename_completer); add_com ("remove-inferiors", no_class, remove_inferior_command, _("\ @@ -1015,29 +935,35 @@ Usage: remove-inferiors ID...")); add_com ("clone-inferior", no_class, clone_inferior_command, _("\ Clone inferior ID.\n\ -Usage: clone-inferior [-copies ] [ID]\n\ -Add N copies of inferior ID. The new inferior has the same\n\ +Usage: clone-inferior [-copies N] [-no-connection] [ID]\n\ +Add N copies of inferior ID. The new inferiors have the same\n\ executable loaded as the copied inferior. If -copies is not specified,\n\ adds 1 copy. If ID is not specified, it is the current inferior\n\ -that is cloned.")); +that is cloned.\n\ +By default, the new inferiors inherit the copied inferior's connection.\n\ +If -no-connection is specified, the new inferiors begin with\n\ +no target connection yet.")); add_cmd ("inferiors", class_run, detach_inferior_command, _("\ -Detach from inferior ID (or list of IDS)."), +Detach from inferior ID (or list of IDS).\n\ +Usage; detach inferiors ID..."), &detachlist); add_cmd ("inferiors", class_run, kill_inferior_command, _("\ -Kill inferior ID (or list of IDs)."), +Kill inferior ID (or list of IDs).\n\ +Usage: kill inferiors ID..."), &killlist); add_cmd ("inferior", class_run, inferior_command, _("\ Use this command to switch between inferiors.\n\ +Usage: inferior ID\n\ The new inferior ID must be currently known."), &cmdlist); add_setshow_boolean_cmd ("inferior-events", no_class, &print_inferior_events, _("\ -Set printing of inferior events (e.g., inferior start and exit)."), _("\ -Show printing of inferior events (e.g., inferior start and exit)."), NULL, +Set printing of inferior events (such as inferior start and exit)."), _("\ +Show printing of inferior events (such as inferior start and exit)."), NULL, NULL, show_print_inferior_events, &setprintlist, &showprintlist);