From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 111846 invoked by alias); 18 Oct 2018 20:21:40 -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 111832 invoked by uid 89); 18 Oct 2018 20:21:40 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-26.9 required=5.0 tests=BAYES_00,GIT_PATCH_0,GIT_PATCH_1,GIT_PATCH_2,GIT_PATCH_3,SPF_HELO_PASS autolearn=ham version=3.3.2 spammy=smallexample, @smallexample X-HELO: mx1.redhat.com Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Thu, 18 Oct 2018 20:21:38 +0000 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id C7968C065F7B; Thu, 18 Oct 2018 20:21:37 +0000 (UTC) Received: from localhost (unused-10-15-17-196.yyz.redhat.com [10.15.17.196]) by smtp.corp.redhat.com (Postfix) with ESMTP id 98A2D1057047; Thu, 18 Oct 2018 20:21:37 +0000 (UTC) From: Sergio Durigan Junior To: John Darrington Cc: gdb-patches@sourceware.org Subject: Re: [PATCH 2/4] GDB: Document the unix::/path/to/socket of remote connection. References: <20181013175801.2670-1-john@darrington.wattle.id.au> <20181013175801.2670-2-john@darrington.wattle.id.au> Date: Thu, 18 Oct 2018 20:21:00 -0000 In-Reply-To: <20181013175801.2670-2-john@darrington.wattle.id.au> (John Darrington's message of "Sat, 13 Oct 2018 19:57:59 +0200") Message-ID: <875zxzxay6.fsf@redhat.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-IsSubscribed: yes X-SW-Source: 2018-10/txt/msg00402.txt.bz2 On Saturday, October 13 2018, John Darrington wrote: > gdb/doc: > * gdb.texinfo (Connecting)[Remote Connection Commands]: Provide alternative > unix::/tmp/xxx example. Include @code{unix::@var{local-socket} in ^ Missing close-curly bracket. > 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 -- Sergio GPG key ID: 237A 54B1 0287 28BF 00EF 31F4 D0EB 7628 65FC 5E36 Please send encrypted e-mail if possible http://sergiodj.net/