FreeChainXenon/binutils-gdb
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Revert "GDB: Fix documentation for invoking GDBSERVER"

Browse source 
This reverts commit 0a163825df.
This commit is contained in:
Simon Marchi 2018-10-29 13:24:23 -04:00
parent 431f22cc09
commit 6cf3675653
1 changed files with 16 additions and 44 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

60
gdb/doc/gdb.texinfo
View file

@ -21198,19 +21198,9 @@ syntax is:
target> gdbserver @var{comm} @var{program} [ @var{args} @dots{} ] target> gdbserver @var{comm} @var{program} [ @var{args} @dots{} ]
@end smallexample @end smallexample
@code{gdbserver} waits passively for the host @value{GDBN} to communicate @var{comm} is either a device name (to use a serial line), or a TCP
with it. hostname and portnumber, or @code{-} or @code{stdio} to use
stdin/stdout of @code{gdbserver}.
@var{comm} may take several forms:
@table @code
@item @var{device}
A serial line device.
@item -
@itemx stdio
To use the stdin/stdout of @code{gdbserver}.
For example, to debug Emacs with the argument For example, to debug Emacs with the argument
@samp{foo.txt} and communicate with @value{GDBN} over the serial port @samp{foo.txt} and communicate with @value{GDBN} over the serial port
@file{/dev/com1}: @file{/dev/com1}:
@ -21219,27 +21209,8 @@ For example, to debug Emacs with the argument
target> gdbserver /dev/com1 emacs foo.txt target> gdbserver /dev/com1 emacs foo.txt
@end smallexample @end smallexample
The @code{stdio} connection is useful when starting @code{gdbserver} @code{gdbserver} waits passively for the host @value{GDBN} to communicate
with ssh: with it.
@smallexample
(gdb) target remote | ssh -T hostname gdbserver - hello
@end smallexample
The @samp{-T} option to ssh is provided because we don't need a remote pty,
and we don't want escape-character handling. Ssh does this by default when
a command is provided, the flag is provided to make it explicit.
You could elide it if you want to.
Programs started with stdio-connected gdbserver have @file{/dev/null} for
@code{stdin}, and @code{stdout},@code{stderr} are sent back to gdb for
display through a pipe connected to gdbserver.
Both @code{stdout} and @code{stderr} use the same pipe.
@item @var{host}:@var{port}
@itemx tcp:@var{host}:@var{port}
@itemx tcp4:@var{host}:@var{port}
To use a @acronym{TCP} @acronym{IPv4} socket connection on port number @var{port}.
To use a TCP connection instead of a serial line: To use a TCP connection instead of a serial line:
@ -21259,21 +21230,22 @@ conflicts with another service, @code{gdbserver} prints an error message
and exits.} You must use the same port number with the host @value{GDBN} and exits.} You must use the same port number with the host @value{GDBN}
@code{target remote} command. @code{target remote} command.
The @code{stdio} connection is useful when starting @code{gdbserver}
@item tcp6:@var{host}:@var{port} with ssh:
To use a @acronym{TCP} @acronym{IPv6} socket connection on port number @var{port}.
@item unix:@var{host}:@var{local-socket}
To use a Unix domain socket. This will create a socket with the file
system entry @var{local-socket} and listen on that. For example:
@smallexample @smallexample
target> gdbserver unix:localhost:/tmp/gdb-socket0 emacs foo.txt (gdb) target remote | ssh -T hostname gdbserver - hello
@end smallexample @end smallexample
@var{host} must either be the empty string or the literal string @code{localhost}. The @samp{-T} option to ssh is provided because we don't need a remote pty,
@end table and we don't want escape-character handling. Ssh does this by default when
a command is provided, the flag is provided to make it explicit.
You could elide it if you want to.
Programs started with stdio-connected gdbserver have @file{/dev/null} for
@code{stdin}, and @code{stdout},@code{stderr} are sent back to gdb for
display through a pipe connected to gdbserver.
Both @code{stdout} and @code{stderr} use the same pipe.
@anchor{Attaching to a program} @anchor{Attaching to a program}
@subsubsection Attaching to a Running Program @subsubsection Attaching to a Running Program