From b1fe945553d0667aac48fb912b9f46d26bbcdcd9 Mon Sep 17 00:00:00 2001 From: Daniel Jacobowitz Date: Thu, 24 Jul 2003 18:55:04 +0000 Subject: * gdb.texinfo (Server): Mention pidof. --- gdb/doc/ChangeLog | 4 ++++ gdb/doc/gdb.texinfo | 13 +++++++++++++ 2 files changed, 17 insertions(+) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index b877983..d631020 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,7 @@ +2003-07-24 Daniel Jacobowitz + + * gdb.texinfo (Server): Mention pidof. + 2003-07-22 Andrew Cagney * gdbint.texinfo (Coding): Add -Wformat-nonliteral to -Werror diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index e6da37c..5db0bce 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -10746,6 +10746,19 @@ target> gdbserver @var{comm} --attach @var{pid} @var{pid} is the process ID of a currently running process. It isn't necessary to point @code{gdbserver} at a binary for the running process. +@pindex pidof +@cindex attach to a program by name +You can debug processes by name instead of process ID if your target has the +@code{pidof} utility: + +@smallexample +target> gdbserver @var{comm} --attach `pidof @var{PROGRAM}` +@end smallexample + +In case more than one copy of @var{PROGRAM} is running, or @var{PROGRAM} +has multiple threads, most versions of @code{pidof} support the +@code{-s} option to only return the first process ID. + @item On the host machine, connect to your target (@pxref{Connecting,,Connecting to a remote target}). For TCP connections, you must start up @code{gdbserver} prior to using -- cgit v1.1