2002-01-05 Michael Snyder <msnyder@redhat.com>

* gdb.texinfo (--pid): Document new command line option (attach).
This commit is contained in:
Michael Snyder 2002-01-10 23:03:35 +00:00
parent 00546b04b2
commit 198377909c
2 changed files with 22 additions and 9 deletions

View File

@ -1,3 +1,7 @@
2002-01-05 Michael Snyder <msnyder@redhat.com>
* gdb.texinfo (--pid): Document new command line option (attach).
2002-01-07 Eli Zaretskii <eliz@is.elta.co.il> 2002-01-07 Eli Zaretskii <eliz@is.elta.co.il>
* gdb.texinfo (Tracepoints): Clarify that tracepoints need support * gdb.texinfo (Tracepoints): Clarify that tracepoints need support

View File

@ -891,11 +891,16 @@ in sequential order. The order makes a difference when the
When @value{GDBN} starts, it reads any arguments other than options as When @value{GDBN} starts, it reads any arguments other than options as
specifying an executable file and core file (or process ID). This is specifying an executable file and core file (or process ID). This is
the same as if the arguments were specified by the @samp{-se} and the same as if the arguments were specified by the @samp{-se} and
@samp{-c} options respectively. (@value{GDBN} reads the first argument @samp{-c} (or @samp{-p} options respectively. (@value{GDBN} reads the
that does not have an associated option flag as equivalent to the first argument that does not have an associated option flag as
@samp{-se} option followed by that argument; and the second argument equivalent to the @samp{-se} option followed by that argument; and the
that does not have an associated option flag, if any, as equivalent to second argument that does not have an associated option flag, if any, as
the @samp{-c} option followed by that argument.) equivalent to the @samp{-c}/@samp{-p} option followed by that argument.)
If the second argument begins with a decimal digit, @value{GDBN} will
first attempt to attach to it as a process, and if that fails, attempt
to open it as a corefile. If you have a corefile whose name begins with
a digit, you can prevent @value{GDBN} from treating it as a pid by
prefixing it with @samp{"./"}, eg. @samp{"./12345"}.
If @value{GDBN} has not been configured to included core file support, If @value{GDBN} has not been configured to included core file support,
such as for most embedded targets, then it will complain about a second such as for most embedded targets, then it will complain about a second
@ -934,12 +939,16 @@ file.
@itemx -c @var{file} @itemx -c @var{file}
@cindex @code{--core} @cindex @code{--core}
@cindex @code{-c} @cindex @code{-c}
Use file @var{file} as a core dump to examine. Use file @var{file} as a core dump to examine.
@item -c @var{number} @item -c @var{number}
Connect to process ID @var{number}, as with the @code{attach} command @item -pid @var{number}
(unless there is a file in core-dump format named @var{number}, in which @itemx -p @var{number}
case @samp{-c} specifies that file as a core dump to read). @cindex @code{--pid}
@cindex @code{-p}
Connect to process ID @var{number}, as with the @code{attach} command.
If there is no such process, @value{GDBN} will attempt to open a core
file named @var{number}.
@item -command @var{file} @item -command @var{file}
@itemx -x @var{file} @itemx -x @var{file}