aboutsummaryrefslogtreecommitdiff
path: root/gdb/doc
diff options
context:
space:
mode:
authorMichael Snyder <msnyder@vmware.com>2002-01-10 23:03:35 +0000
committerMichael Snyder <msnyder@vmware.com>2002-01-10 23:03:35 +0000
commit198377909c9eb3f9179e7afd4b9c9849f2a41fdf (patch)
treebc8dfe63a2a959bbd5f143eb22e5d8fce50d299f /gdb/doc
parent00546b04b221e63bf3307f5da6f2ca19c83d16ea (diff)
downloadgdb-198377909c9eb3f9179e7afd4b9c9849f2a41fdf.zip
gdb-198377909c9eb3f9179e7afd4b9c9849f2a41fdf.tar.gz
gdb-198377909c9eb3f9179e7afd4b9c9849f2a41fdf.tar.bz2
2002-01-05 Michael Snyder <msnyder@redhat.com>
* gdb.texinfo (--pid): Document new command line option (attach).
Diffstat (limited to 'gdb/doc')
-rw-r--r--gdb/doc/ChangeLog4
-rw-r--r--gdb/doc/gdb.texinfo27
2 files changed, 22 insertions, 9 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 9d64c34..8888a23 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -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>
* gdb.texinfo (Tracepoints): Clarify that tracepoints need support
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index d0aade0..5646b25 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -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
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
-@samp{-c} options respectively. (@value{GDBN} reads the first argument
-that does not have an associated option flag as equivalent to the
-@samp{-se} option followed by that argument; and the second argument
-that does not have an associated option flag, if any, as equivalent to
-the @samp{-c} option followed by that argument.)
+@samp{-c} (or @samp{-p} options respectively. (@value{GDBN} reads the
+first argument that does not have an associated option flag as
+equivalent to the @samp{-se} option followed by that argument; and the
+second argument that does not have an associated option flag, if any, as
+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,
such as for most embedded targets, then it will complain about a second
@@ -934,12 +939,16 @@ file.
@itemx -c @var{file}
@cindex @code{--core}
@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}
-Connect to process ID @var{number}, as with the @code{attach} command
-(unless there is a file in core-dump format named @var{number}, in which
-case @samp{-c} specifies that file as a core dump to read).
+@item -pid @var{number}
+@itemx -p @var{number}
+@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}
@itemx -x @var{file}