X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=gdb%2Finferior.c;h=40ab3e7e90b9e5d8979fcf634fa6af197ea7e6d4;hb=aa95b2d43883666937d31335d0178d2218d9c9aa;hp=76f5581b7dbe4e00100d1e2d846d24fc160ebfa5;hpb=8d49165d8382e29bff8d60d208934596e3994305;p=binutils-gdb.git diff --git a/gdb/inferior.c b/gdb/inferior.c index 76f5581b7db..40ab3e7e90b 100644 --- a/gdb/inferior.c +++ b/gdb/inferior.c @@ -1,6 +1,6 @@ /* Multi-process control for GDB, the GNU debugger. - Copyright (C) 2008-2018 Free Software Foundation, Inc. + Copyright (C) 2008-2021 Free Software Foundation, Inc. This file is part of GDB. @@ -29,9 +29,8 @@ #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" #include "target-descriptions.h" #include "readline/tilde.h" @@ -42,21 +41,21 @@ DEFINE_REGISTRY (inferior, REGISTRY_ACCESS_FIELD) -struct inferior *inferior_list = NULL; +intrusive_list inferior_list; static int highest_inferior_num; /* See inferior.h. */ -int print_inferior_events = 1; +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 incremented. */ -static struct inferior *current_inferior_ = NULL; +static inferior_ref current_inferior_; struct inferior* current_inferior (void) { - return current_inferior_; + return current_inferior_.get (); } void @@ -65,9 +64,7 @@ set_current_inferior (struct inferior *inf) /* There's always an inferior. */ gdb_assert (inf != NULL); - inf->incref (); - current_inferior_->decref (); - current_inferior_ = inf; + current_inferior_ = inferior_ref::new_reference (inf); } private_inferior::~private_inferior () = default; @@ -76,10 +73,8 @@ inferior::~inferior () { inferior *inf = this; - discard_all_inferior_continuations (inf); + m_continuations.clear (); inferior_free_data (inf); - xfree (inf->args); - xfree (inf->terminal); target_desc_info_free (inf->tdesc_info); } @@ -90,24 +85,67 @@ inferior::inferior (int pid_) registry_data () { inferior_alloc_data (this); + + m_target_stack.push (get_dummy_target ()); } -struct inferior * -add_inferior_silent (int pid) +/* See inferior.h. */ + +int +inferior::unpush_target (struct target_ops *t) { - inferior *inf = new inferior (pid); + /* If unpushing the process stratum target from the inferior while threads + exist in the inferior, ensure that we don't leave any threads of the + inferior in the target's "resumed with pending wait status" list. - if (inferior_list == NULL) - inferior_list = inf; - else + See also the comment in set_thread_exited. */ + if (t->stratum () == process_stratum) { - inferior *last; + process_stratum_target *proc_target = as_process_stratum_target (t); - for (last = inferior_list; last->next != NULL; last = last->next) - ; - last->next = inf; + for (thread_info *thread : this->non_exited_threads ()) + proc_target->maybe_remove_resumed_with_pending_wait_status (thread); } + return m_target_stack.unpush (t); +} + +void +inferior::set_tty (std::string terminal_name) +{ + m_terminal = std::move (terminal_name); +} + +const std::string & +inferior::tty () +{ + return m_terminal; +} + +void +inferior::add_continuation (std::function &&cont) +{ + m_continuations.emplace_front (std::move (cont)); +} + +void +inferior::do_all_continuations () +{ + while (!m_continuations.empty ()) + { + auto iter = m_continuations.begin (); + (*iter) (); + m_continuations.erase (iter); + } +} + +struct inferior * +add_inferior_silent (int pid) +{ + inferior *inf = new inferior (pid); + + inferior_list.push_back (*inf); + gdb::observers::inferior_added.notify (inf); if (pid != 0) @@ -122,66 +160,45 @@ add_inferior (int pid) struct inferior *inf = add_inferior_silent (pid); if (print_inferior_events) - printf_unfiltered (_("[New inferior %d (%s)]\n"), - inf->num, - target_pid_to_str (ptid_t (pid))); + { + if (pid != 0) + printf_unfiltered (_("[New inferior %d (%s)]\n"), + inf->num, + target_pid_to_str (ptid_t (pid)).c_str ()); + else + printf_unfiltered (_("[New inferior %d]\n"), inf->num); + } return inf; } -struct delete_thread_of_inferior_arg -{ - int pid; - int silent; -}; +/* See inferior.h. */ -static int -delete_thread_of_inferior (struct thread_info *tp, void *data) +void +inferior::clear_thread_list (bool silent) { - struct delete_thread_of_inferior_arg *arg - = (struct delete_thread_of_inferior_arg *) data; - - if (tp->ptid.pid () == arg->pid) + thread_list.clear_and_dispose ([=] (thread_info *thr) { - if (arg->silent) - delete_thread_silent (tp); - else - delete_thread (tp); - } - - return 0; + set_thread_exited (thr, silent); + if (thr->deletable ()) + delete thr; + }); + ptid_thread_map.clear (); } void -delete_inferior (struct inferior *todel) +delete_inferior (struct inferior *inf) { - struct inferior *inf, *infprev; - struct delete_thread_of_inferior_arg arg; - - infprev = NULL; - - for (inf = inferior_list; inf; infprev = inf, inf = inf->next) - if (inf == todel) - break; - - if (!inf) - return; - - arg.pid = inf->pid; - arg.silent = 1; - - iterate_over_threads (delete_thread_of_inferior, &arg); + inf->clear_thread_list (true); - if (infprev) - infprev->next = inf->next; - else - inferior_list = inf->next; + auto it = inferior_list.iterator_to (*inf); + inferior_list.erase (it); gdb::observers::inferior_removed.notify (inf); /* If this program space is rendered useless, remove it. */ - if (program_space_empty_p (inf->pspace)) - delete_program_space (inf->pspace); + if (inf->pspace->empty ()) + delete inf->pspace; delete inf; } @@ -190,27 +207,14 @@ delete_inferior (struct inferior *todel) exit of its threads. */ static void -exit_inferior_1 (struct inferior *inftoex, int silent) +exit_inferior_1 (struct inferior *inf, int silent) { - struct inferior *inf; - struct delete_thread_of_inferior_arg arg; - - for (inf = inferior_list; inf; inf = inf->next) - if (inf == inftoex) - break; - - if (!inf) - return; - - arg.pid = inf->pid; - arg.silent = silent; - - iterate_over_threads (delete_thread_of_inferior, &arg); + inf->clear_thread_list (silent); gdb::observers::inferior_exit.notify (inf); inf->pid = 0; - inf->fake_pid_p = 0; + inf->fake_pid_p = false; inf->priv = NULL; if (inf->vfork_parent != NULL) @@ -226,7 +230,11 @@ exit_inferior_1 (struct inferior *inftoex, int silent) inf->pending_detach = 0; /* Reset it. */ - inf->control = {NO_STOP_QUIETLY}; + inf->control = inferior_control_state (NO_STOP_QUIETLY); + + /* Clear the register cache and the frame cache. */ + registers_changed (); + reinit_frame_cache (); } void @@ -235,14 +243,6 @@ exit_inferior (inferior *inf) exit_inferior_1 (inf, 0); } -void -exit_inferior_silent (int pid) -{ - struct inferior *inf = find_inferior_pid (pid); - - exit_inferior_1 (inf, 1); -} - void exit_inferior_silent (inferior *inf) { @@ -262,12 +262,18 @@ detach_inferior (inferior *inf) if (print_inferior_events) printf_unfiltered (_("[Inferior %d (%s) detached]\n"), inf->num, - target_pid_to_str (ptid_t (pid))); + 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; @@ -275,24 +281,10 @@ inferior_appeared (struct inferior *inf, int pid) 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); - } -} - 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; @@ -300,16 +292,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; @@ -319,9 +309,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.pid ()); + return find_inferior_pid (targ, ptid.pid ()); } /* See inferior.h. */ @@ -329,32 +319,14 @@ find_inferior_ptid (ptid_t ptid) struct inferior * find_inferior_for_program_space (struct program_space *pspace) { - struct inferior *inf = current_inferior (); - - if (inf->pspace == pspace) - return inf; - - for (inf = inferior_list; inf != NULL; inf = inf->next) - { - if (inf->pspace == pspace) - return inf; - } + struct inferior *cur_inf = current_inferior (); - return NULL; -} + if (cur_inf->pspace == pspace) + return cur_inf; -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 ()) + if (inf->pspace == pspace) + return inf; return NULL; } @@ -362,11 +334,8 @@ iterate_over_inferiors (int (*callback) (struct inferior *, void *), 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; } @@ -376,26 +345,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 && tp->ptid.pid () == 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; } @@ -405,7 +367,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 @@ -414,24 +376,14 @@ have_live_inferiors (void) void prune_inferiors (void) { - struct inferior *ss, **ss_link; - - ss = inferior_list; - ss_link = &inferior_list; - while (ss) + for (inferior *inf : all_inferiors_safe ()) { - if (!ss->deletable () - || !ss->removable - || ss->pid != 0) - { - ss_link = &ss->next; - ss = *ss_link; - continue; - } + if (!inf->deletable () + || !inf->removable + || inf->pid != 0) + continue; - *ss_link = ss->next; - delete_inferior (ss); - ss = *ss_link; + delete_inferior (inf); } } @@ -440,19 +392,14 @@ 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) @@ -467,13 +414,38 @@ void print_selected_inferior (struct ui_out *uiout) { struct inferior *inf = current_inferior (); - const char *filename = inf->pspace->pspace_exec_filename; + const char *filename = inf->pspace->exec_filename.get (); if (filename == NULL) 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); +} + +/* Helper for print_inferior. Returns the 'connection-id' string for + PROC_TARGET. */ + +static std::string +uiout_field_connection (process_stratum_target *proc_target) +{ + if (proc_target == NULL) + { + return {}; + } + else if (proc_target->connection_string () != NULL) + { + return string_printf ("%d (%s %s)", + proc_target->connection_number, + proc_target->shortname (), + proc_target->connection_string ()); + } + else + { + return string_printf ("%d (%s)", + proc_target->connection_number, + proc_target->shortname ()); + } } /* Prints the list of inferiors and their details on UIOUT. This is a @@ -486,15 +458,19 @@ print_selected_inferior (struct ui_out *uiout) static void print_inferior (struct ui_out *uiout, const char *requested_inferiors) { - struct inferior *inf; int inf_count = 0; + size_t connection_id_len = 20; /* 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; + std::string conn = uiout_field_connection (inf->process_target ()); + if (connection_id_len < conn.size ()) + connection_id_len = conn.size (); + ++inf_count; } @@ -504,31 +480,45 @@ print_inferior (struct ui_out *uiout, const char *requested_inferiors) return; } - ui_out_emit_table table_emitter (uiout, 4, inf_count, "inferiors"); + ui_out_emit_table table_emitter (uiout, 5, 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 (connection_id_len, ui_left, + "connection-id", "Connection"); uiout->table_header (17, ui_left, "exec", "Executable"); uiout->table_body (); - for (inf = inferior_list; inf; inf = inf->next) + + /* Restore the current thread after the loop because we switch the + inferior in the loop. */ + scoped_restore_current_pspace_and_thread restore_pspace_thread; + inferior *current_inf = current_inferior (); + for (inferior *inf : all_inferiors ()) { if (!number_is_in_list (requested_inferiors, inf->num)) continue; ui_out_emit_tuple tuple_emitter (uiout, NULL); - if (inf == current_inferior ()) + if (inf == current_inf) uiout->field_string ("current", "*"); else uiout->field_skip ("current"); - uiout->field_int ("number", inf->num); + uiout->field_signed ("number", inf->num); + + /* Because target_pid_to_str uses the current inferior, + switch the inferior. */ + switch_to_inferior_no_thread (inf); uiout->field_string ("target-id", inferior_pid_to_str (inf->pid)); - if (inf->pspace->pspace_exec_filename != NULL) - uiout->field_string ("exec", inf->pspace->pspace_exec_filename); + std::string conn = uiout_field_connection (inf->process_target ()); + uiout->field_string ("connection-id", conn); + + if (inf->pspace->exec_filename != nullptr) + uiout->field_string ("exec", inf->pspace->exec_filename.get ()); else uiout->field_skip ("exec"); @@ -538,12 +528,12 @@ print_inferior (struct ui_out *uiout, const 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"); @@ -556,6 +546,8 @@ detach_inferior_command (const char *args, int from_tty) if (!args || !*args) error (_("Requires argument (inferior id(s) to detach)")); + scoped_restore_current_thread restore_thread; + number_or_range_parser parser (args); while (!parser.finished ()) { @@ -593,6 +585,8 @@ kill_inferior_command (const char *args, int from_tty) if (!args || !*args) error (_("Requires argument (inferior id(s) to kill)")); + scoped_restore_current_thread restore_thread; + number_or_range_parser parser (args); while (!parser.finished ()) { @@ -626,42 +620,66 @@ kill_inferior_command (const 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 (const char *args, int from_tty) { struct inferior *inf; int num; - num = parse_and_eval_long (args); - - inf = find_inferior_id (num); - if (inf == NULL) - error (_("Inferior ID %d not known."), num); - - if (inf->pid != 0) + if (args == nullptr) { - if (inf != current_inferior ()) - { - thread_info *tp = any_thread_of_inferior (inf); - if (tp == NULL) - error (_("Inferior has no threads.")); + inf = current_inferior (); + gdb_assert (inf != nullptr); + const char *filename = inf->pspace->exec_filename.get (); - switch_to_thread (tp); - } + if (filename == nullptr) + filename = _(""); - gdb::observers::user_selected_context_changed.notify - (USER_SELECTED_INFERIOR - | USER_SELECTED_THREAD - | USER_SELECTED_FRAME); + printf_filtered (_("[Current inferior is %d [%s] (%s)]\n"), + inf->num, inferior_pid_to_str (inf->pid).c_str (), + filename); } else { - set_current_inferior (inf); - switch_to_no_thread (); - set_current_program_space (inf->pspace); + num = parse_and_eval_long (args); + + inf = find_inferior_id (num); + if (inf == NULL) + error (_("Inferior ID %d not known."), num); + + if (inf->pid != 0) + { + if (inf != current_inferior ()) + { + thread_info *tp = any_thread_of_inferior (inf); + if (tp == NULL) + error (_("Inferior has no threads.")); + + switch_to_thread (tp); + } - gdb::observers::user_selected_context_changed.notify - (USER_SELECTED_INFERIOR); + gdb::observers::user_selected_context_changed.notify + (USER_SELECTED_INFERIOR + | USER_SELECTED_THREAD + | USER_SELECTED_FRAME); + } + else + { + switch_to_inferior_no_thread (inf); + + gdb::observers::user_selected_context_changed.notify + (USER_SELECTED_INFERIOR); + } } } @@ -715,7 +733,6 @@ add_inferior_with_spaces (void) struct address_space *aspace; struct program_space *pspace; struct inferior *inf; - struct gdbarch_info info; /* If all inferiors share an address space on this system, this doesn't really return a new address space; otherwise, it @@ -728,7 +745,7 @@ add_inferior_with_spaces (void) /* Setup the inferior's initial arch, based on information obtained from the global "set ..." options. */ - gdbarch_info_init (&info); + gdbarch_info info; inf->gdbarch = gdbarch_find_by_info (info); /* The "set ..." options reject invalid settings, so we should always have a valid arch by now. */ @@ -737,7 +754,41 @@ 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 +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) + { + new_inf->push_target (proc_target); + if (proc_target->connection_string () != NULL) + printf_filtered (_("Added inferior %d on connection %d (%s %s)\n"), + new_inf->num, + proc_target->connection_number, + proc_target->shortname (), + proc_target->connection_string ()); + else + printf_filtered (_("Added inferior %d on connection %d (%s)\n"), + new_inf->num, + proc_target->connection_number, + proc_target->shortname ()); + } + else + 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) @@ -745,6 +796,7 @@ add_inferior_command (const char *args, int from_tty) int i, copies = 1; gdb::unique_xmalloc_ptr exec; symfile_add_flags add_flags = 0; + bool no_connection = false; if (from_tty) add_flags |= SYMFILE_VERBOSE; @@ -764,6 +816,8 @@ add_inferior_command (const 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; @@ -777,35 +831,32 @@ add_inferior_command (const 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_no_thread (); - exec_file_attach (exec.get (), from_tty); symbol_file_add_main (exec.get (), add_flags); } } } -/* clone-inferior [-copies N] [ID] */ +/* clone-inferior [-copies N] [ID] [-no-connection] */ static void clone_inferior_command (const char *args, int from_tty) { int i, copies = 1; struct inferior *orginf = NULL; + bool no_connection = false; if (args) { @@ -826,6 +877,8 @@ clone_inferior_command (const char *args, int from_tty) if (copies < 0) error (_("Invalid copies number")); } + else if (strcmp (*argv, "-no-connection") == 0) + no_connection = true; } else { @@ -871,15 +924,13 @@ clone_inferior_command (const char *args, int from_tty) 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_no_thread (); clone_program_space (pspace, orginf->pspace); } } @@ -925,8 +976,7 @@ 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_silent (0); - current_inferior_->incref (); + set_current_inferior (add_inferior_silent (0)); current_inferior_->pspace = current_program_space; current_inferior_->aspace = current_program_space->aspace; /* The architecture will be initialized shortly, by @@ -940,10 +990,13 @@ 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 N] [-exec FILENAME]\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, _("\ @@ -952,11 +1005,14 @@ Usage: remove-inferiors ID...")); add_com ("clone-inferior", no_class, clone_inferior_command, _("\ Clone inferior ID.\n\ -Usage: clone-inferior [-copies N] [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).\n\ @@ -975,12 +1031,12 @@ 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, - NULL, - show_print_inferior_events, - &setprintlist, &showprintlist); + &print_inferior_events, _("\ +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); create_internalvar_type_lazy ("_inferior", &inferior_funcs, NULL); }