From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTPS id 3BFDD3858D35 for ; Wed, 15 Feb 2023 11:52:23 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 3BFDD3858D35 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1676461941; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=mdwAcopZxnm+J0CecVLktxVtSJheeyNcjkOBPv00jDc=; b=Y0GpC6tDK4nod9lldjOCBpdvToqfA9OauHZ1KfBUE1gCV4wkyIPcbEJSwCG19vpJu2R3wh 7YFN2uy6l3qxOnLcuz4i/5KFZiwIdYTAC0BC1e//At966kg6IjYESDiJuJhU19eDKXbTWE k6Ee7bRNpGyCgJz6y7XtBlBW1zCzGPE= Received: from mail-qk1-f200.google.com (mail-qk1-f200.google.com [209.85.222.200]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_128_GCM_SHA256) id us-mta-179-n2Tiv-8PPQqG2ueWaiNAdA-1; Wed, 15 Feb 2023 06:52:20 -0500 X-MC-Unique: n2Tiv-8PPQqG2ueWaiNAdA-1 Received: by mail-qk1-f200.google.com with SMTP id c9-20020a05620a11a900b0072a014ecc4aso11295179qkk.18 for ; Wed, 15 Feb 2023 03:52:20 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=mdwAcopZxnm+J0CecVLktxVtSJheeyNcjkOBPv00jDc=; b=evRjz43s9enoFbu8DoJYUITCyCMOcP5OXJDa/nu/BkUEzxKFMQgRiBRFZga1vMvH/e VrONsxPpe7wVoO3Qk36xDopCDctnfPCxgA+/st+/FyBtTOlhxoFxBAtHVsMDI+1EiT1S aSitgVG4jkiJG3Ug8xb28C2fOkEeR09BjOsopX3WbE4VVyre5JNeC6sdJJorZWFg+gY+ pdBOpu6qvHJBbnYa4sUDOgyn8SZagVh1/Lk48xCIzAZP93neoTxnxHHeOzzH3h+nVAoI t+cpv9bt9gjt0jeo4PxldOdwJw7b0wJIcQ7D1YJxYn+rLNbODpRCDRfWACONWmvEUIcT bZrw== X-Gm-Message-State: AO0yUKXZ11OboAhRFUd47NU6C95QSDH8Iof+sJLZFRihjRxN7NzGy5GB O3TWlxS9tuC/YbLZjWzzLoa9ihd/JbvoSccT/BRiyPDKpvltw+XD39n7jSQ7TBVCHHF3m3KqIyz VSypDl0+UqS3+BHKEQl8Tyg0VWuwVT+c/YmW6+7hKN/F7s0nYZXeFHTIQ+/4jpQ0yU+hr4sheA7 d6xG8= X-Received: by 2002:a05:6214:2522:b0:56e:bc57:d646 with SMTP id gg2-20020a056214252200b0056ebc57d646mr3628066qvb.43.1676461940231; Wed, 15 Feb 2023 03:52:20 -0800 (PST) X-Google-Smtp-Source: AK7set85yGS/roueHuKuXg9M8Cqw6sCzOZ0wHFJafGA4CwzODfrjc1u9J+nFPI626zZN07w5Ww29cQ== X-Received: by 2002:a05:6214:2522:b0:56e:bc57:d646 with SMTP id gg2-20020a056214252200b0056ebc57d646mr3628044qvb.43.1676461939959; Wed, 15 Feb 2023 03:52:19 -0800 (PST) Received: from localhost (95.72.115.87.dyn.plus.net. [87.115.72.95]) by smtp.gmail.com with ESMTPSA id q7-20020a378e07000000b0073b77063a12sm741922qkd.90.2023.02.15.03.52.19 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 15 Feb 2023 03:52:19 -0800 (PST) From: Andrew Burgess To: gdb-patches@sourceware.org Cc: Andrew Burgess Subject: [PATCH] gdb/doc: document MI -remove-inferior command Date: Wed, 15 Feb 2023 11:52:16 +0000 Message-Id: <49a2305e22e03e195dd157421cd97e0aaf9c3d37.1676461926.git.aburgess@redhat.com> X-Mailer: git-send-email 2.25.4 MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset="US-ASCII"; x-default=true X-Spam-Status: No, score=-11.7 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,GIT_PATCH_0,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_NONE,SPF_NONE,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: Back in 2010 the -remove-inferior command was added in commit a79b8f6ea8c2, unfortunately this command was never added to the documentation. This commit addresses that oversight. --- gdb/doc/gdb.texinfo | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 0beb45857c3..869c0724863 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -3384,6 +3384,7 @@ You can now simply switch focus to inferior 2 and run it. +@anchor{remove_inferiors_cli} @kindex remove-inferiors @item remove-inferiors @var{infno}@dots{} Removes the inferior or inferiors @var{infno}@dots{}. It is not @@ -38302,6 +38303,39 @@ ^done,inferior="i3" @end smallexample +@subheading The @code{-remove-inferior} Command +@findex -remove-inferior + +@subsubheading Synopsis + +@smallexample +-remove-inferior @var{inferior-id} +@end smallexample + +Removes an inferior (@pxref{Inferiors Connections and Programs}). +Only inferiors that have exited can be removed. The @var{inferior-id} +is the inferior to be removed, and should be the same id string as +returned by the @samp{-add-inferior} command. + +When an inferior is successfully removed a +@code{=thread-group-removed} notification (@pxref{GDB/MI Async +Records}) is emitted, the @var{id} field of which contains the +@var{inferior-id} for the removed inferior. + +@subsubheading @value{GDBN} Command + +The corresponding @value{GDBN} command is @samp{remove-inferiors} +(@pxref{remove_inferiors_cli,,@samp{remove-inferiors}}). + +@subsubheading Example + +@smallexample +(@value{GDBP}) +-remove-inferior i3 +=thread-group-removed,id="i3" +^done +@end smallexample + @subheading The @code{-interpreter-exec} Command @findex -interpreter-exec base-commit: 25a0d393c728314e257789b948c3a2c98aca7a70 -- 2.25.4