This is the mail archive of the
gdb-patches@sourceware.org
mailing list for the GDB project.
[doc patch] gdb.1: Add -p PID
- From: Jan Kratochvil <jan dot kratochvil at redhat dot com>
- To: Eli Zaretskii <eliz at gnu dot org>
- Cc: tromey at redhat dot com, gdb-patches at sourceware dot org
- Date: Fri, 5 Apr 2013 17:18:28 +0200
- Subject: [doc patch] gdb.1: Add -p PID
- References: <83lias3ybi dot fsf at gnu dot org> <20130219162741 dot GA4493 at host2 dot jankratochvil dot net> <838v6kp4gu dot fsf at gnu dot org> <20130220084353 dot GA801 at host2 dot jankratochvil dot net> <83fw0qokfw dot fsf at gnu dot org> <20130404160915 dot GA11966 at host2 dot jankratochvil dot net> <83sj36fcxb dot fsf at gnu dot org> <20130404171439 dot GA20464 at host2 dot jankratochvil dot net> <83obduf9ny dot fsf at gnu dot org> <20130405150101 dot GA15883 at host2 dot jankratochvil dot net>
On Fri, 05 Apr 2013 17:01:01 +0200, Jan Kratochvil wrote:
> > > +Fortran support will be added when a GNU Fortran compiler is ready.
> >
> > This list of languages is outdated, right?
> +
> > > +@smallexample
> > > +gdb program 1234
> > > +@end smallexample
> >
> > Should we mention "gdb -p PID" as well?
>
> Yes but that is unrelated to this patch which does only the technical
> conversion. OK, going to post a second patch for these.
Here.
Thanks,
jan
gdb/doc/
2013-04-04 Jan Kratochvil <jan.kratochvil@redhat.com>
* gdb.texinfo (gdb man): Mention option -p. Include Fortran to
the list of supported languages.
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 2f9c68a..08c708b 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -41623,8 +41623,9 @@ gdb [@option{-help}] [@option{-nh}] [@option{-nx}] [@option{-q}]
[@option{-b}@w{ }@var{bps}]
[@option{-tty=}@var{dev}] [@option{-s} @var{symfile}]
[@option{-e}@w{ }@var{prog}] [@option{-se}@w{ }@var{prog}]
-[@option{-c}@w{ }@var{core}] [@option{-x}@w{ }@var{cmds}]
- [@option{-d}@w{ }@var{dir}] [@var{prog}|@var{core}|@var{procID}]
+[@option{-c}@w{ }@var{core}] [@option{-p}@w{ }@var{procID}]
+ [@option{-x}@w{ }@var{cmds}] [@option{-d}@w{ }@var{dir}]
+[@var{prog}|@var{prog} @var{procID}|@var{prog} @var{core}]
@c man end
@c man begin DESCRIPTION gdb
@@ -41650,8 +41651,8 @@ Change things in your program, so you can experiment with correcting the
effects of one bug and go on to learn about another.
@end itemize
-You can use @value{GDBN} to debug programs written in C, C@t{++}, and Modula-2.
-Fortran support will be added when a GNU Fortran compiler is ready.
+You can use @value{GDBN} to debug programs written in C, C@t{++}, Fortran and
+Modula-2.
@value{GDBN} is invoked with the shell command @code{gdb}. Once started, it reads
commands from the terminal until you tell it to exit with the @value{GDBN}
@@ -41677,11 +41678,13 @@ to debug a running process:
@smallexample
gdb program 1234
+gdb -p 1234
@end smallexample
@noindent
would attach @value{GDBN} to process @code{1234} (unless you also have a file
named @file{1234}; @value{GDBN} does check for a core file first).
+With option @option{-p} you can omit the @var{program} filename.
Here are some of the most frequently needed @value{GDBN} commands: