From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 106154 invoked by alias); 13 Oct 2018 17:58:10 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 106020 invoked by uid 89); 13 Oct 2018 17:58:09 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-25.0 required=5.0 tests=AWL,BAYES_00,GIT_PATCH_0,GIT_PATCH_1,GIT_PATCH_2,GIT_PATCH_3,SPF_PASS autolearn=ham version=3.3.2 spammy=Provide, Connection, @value, GDBN X-HELO: jocasta.intra Received: from de.cellform.com (HELO jocasta.intra) (88.217.224.109) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Sat, 13 Oct 2018 17:58:06 +0000 Received: from jocasta.intra (localhost [127.0.0.1]) by jocasta.intra (8.15.2/8.15.2/Debian-8) with ESMTPS id w9DHw4wU002725 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Sat, 13 Oct 2018 19:58:04 +0200 Received: (from john@localhost) by jocasta.intra (8.15.2/8.15.2/Submit) id w9DHw4WX002722; Sat, 13 Oct 2018 19:58:04 +0200 From: John Darrington To: gdb-patches@sourceware.org Cc: John Darrington Subject: [PATCH 2/4] GDB: Document the unix::/path/to/socket of remote connection. Date: Sat, 13 Oct 2018 17:58:00 -0000 Message-Id: <20181013175801.2670-2-john@darrington.wattle.id.au> In-Reply-To: <20181013175801.2670-1-john@darrington.wattle.id.au> References: <20181013175801.2670-1-john@darrington.wattle.id.au> X-SW-Source: 2018-10/txt/msg00305.txt.bz2 gdb/doc: * gdb.texinfo (Connecting)[Remote Connection Commands]: Provide alternative unix::/tmp/xxx example. Include @code{unix::@var{local-socket} in the list of remote and extended-remote syntaxes. --- gdb/doc/gdb.texinfo | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index b0dc3bf67c..1e97d692b6 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -20829,6 +20829,15 @@ Note that this command has the same form as the command to connect to a serial line. @value{GDBN} will automatically determine which kind of file you have specified and will make the appropriate kind of connection. +The above command is identical to the command: + +@smallexample +target remote unix::/tmp/gdb-socket1 +@end smallexample +@noindent + +See below for the explanation of this syntax. + This feature is not available if the host system does not support Unix domain sockets. @@ -20839,6 +20848,7 @@ Unix domain sockets. @itemx target remote @code{tcp4:@var{host}:@var{port}} @itemx target remote @code{tcp6:@var{host}:@var{port}} @itemx target remote @code{tcp6:@var{[host]}:@var{port}} +@itemx target remote @code{unix::@var{local-socket}} @itemx target extended-remote @code{@var{host}:@var{port}} @itemx target extended-remote @code{@var{[host]}:@var{port}} @itemx target extended-remote @code{tcp:@var{host}:@var{port}} @@ -20846,8 +20856,10 @@ Unix domain sockets. @itemx target extended-remote @code{tcp4:@var{host}:@var{port}} @itemx target extended-remote @code{tcp6:@var{host}:@var{port}} @itemx target extended-remote @code{tcp6:@var{[host]}:@var{port}} +@itemx target extended-remote @code{unix::@var{local-socket}} @cindex @acronym{TCP} port, @code{target remote} -Debug using a @acronym{TCP} connection to @var{port} on @var{host}. +Debug using a @acronym{TCP} connection to @var{port} on @var{host} +or using the Unix domain socket @var{local-socket} on the local machine. The @var{host} may be either a host name, a numeric @acronym{IPv4} address, or a numeric @acronym{IPv6} address (with or without the square brackets to separate the address from the port); @var{port} @@ -20895,6 +20907,16 @@ target remote :1234 @noindent Note that the colon is still required here. +Alternatively you can use a Unix domain socket: + +@smallexample +target remote unix::/tmp/gdb-socket1 +@end smallexample +@noindent + +This has the advantage that it'll not fail if the port number is already +in use. + @item target remote @code{udp:@var{host}:@var{port}} @itemx target remote @code{udp:@var{[host]}:@var{port}} -- 2.11.0