From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 29709 invoked by alias); 5 Apr 2013 15:37:57 -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 24470 invoked by uid 89); 5 Apr 2013 15:18:39 -0000 X-Spam-SWARE-Status: No, score=-7.5 required=5.0 tests=AWL,BAYES_00,KHOP_RCVD_UNTRUST,RCVD_IN_DNSWL_HI,RCVD_IN_HOSTKARMA_W,RP_MATCHES_RCVD,SPF_HELO_PASS autolearn=ham version=3.3.1 Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.84/v0.84-167-ge50287c) with ESMTP; Fri, 05 Apr 2013 15:18:37 +0000 Received: from int-mx11.intmail.prod.int.phx2.redhat.com (int-mx11.intmail.prod.int.phx2.redhat.com [10.5.11.24]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id r35FIZRW011796 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 5 Apr 2013 11:18:35 -0400 Received: from host2.jankratochvil.net (ovpn-116-44.ams2.redhat.com [10.36.116.44]) by int-mx11.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id r35FITQF007393 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO); Fri, 5 Apr 2013 11:18:32 -0400 Date: Fri, 05 Apr 2013 18:13:00 -0000 From: Jan Kratochvil To: Eli Zaretskii Cc: tromey@redhat.com, gdb-patches@sourceware.org Subject: [doc patch] gdb.1: Add -p PID Message-ID: <20130405151828.GA24147@host2.jankratochvil.net> References: <83lias3ybi.fsf@gnu.org> <20130219162741.GA4493@host2.jankratochvil.net> <838v6kp4gu.fsf@gnu.org> <20130220084353.GA801@host2.jankratochvil.net> <83fw0qokfw.fsf@gnu.org> <20130404160915.GA11966@host2.jankratochvil.net> <83sj36fcxb.fsf@gnu.org> <20130404171439.GA20464@host2.jankratochvil.net> <83obduf9ny.fsf@gnu.org> <20130405150101.GA15883@host2.jankratochvil.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20130405150101.GA15883@host2.jankratochvil.net> User-Agent: Mutt/1.5.21 (2010-09-15) X-IsSubscribed: yes X-SW-Source: 2013-04/txt/msg00129.txt.bz2 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 * 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: