From: Philippe Waroquiers Date: Sat, 4 May 2019 13:39:27 +0000 (+0200) Subject: NEWS and documentation for | (pipe) command. X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=e2c52041c02e2bdee5b28e97c7997caf0ee5bb2d;p=binutils-gdb.git NEWS and documentation for | (pipe) command. gdb/ChangeLog * NEWS: Mention new pipe command and new convenience variables. gdb/doc/ChangeLog * gdb.texinfo (Shell Commands): Document pipe command. (Logging Output): Add a reference to pipe command. (Convenience Variables): Document $_shell_exitcode and $_shell_exitstatus. --- diff --git a/gdb/ChangeLog b/gdb/ChangeLog index 01dd51ec8f5..6d41fc60cad 100644 --- a/gdb/ChangeLog +++ b/gdb/ChangeLog @@ -1,3 +1,7 @@ +2019-05-31 Philippe Waroquiers + + * NEWS: Mention new pipe command and new convenience variables. + 2019-05-31 Philippe Waroquiers * cli/cli-cmds.c (pipe_command): New function. diff --git a/gdb/NEWS b/gdb/NEWS index ab582c036dc..be1ec4eb411 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -27,8 +27,20 @@ 'array_indexes', 'symbols', 'unions', 'deref_refs', 'actual_objects', 'static_members', 'max_elements', 'repeat_threshold', and 'format'. +* New built-in convenience variables $_shell_exitcode and $_shell_exitsignal + provide the exitcode or exit status of the shell commands launched by + GDB commands such as "shell", "pipe" and "make". + * New commands +| [COMMAND] | SHELL_COMMAND +| -d DELIM COMMAND DELIM SHELL_COMMAND +pipe [COMMAND] | SHELL_COMMAND +pipe -d DELIM COMMAND DELIM SHELL_COMMAND + Executes COMMAND and sends its output to SHELL_COMMAND. + With no COMMAND, repeat the last executed command + and send its output to SHELL_COMMAND. + set may-call-functions [on|off] show may-call-functions This controls whether GDB will attempt to call functions in diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index c075d74eec8..00388244fda 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,10 @@ +2019-05-31 Philippe Waroquiers + + * gdb.texinfo (Shell Commands): Document pipe command. + (Logging Output): Add a reference to pipe command. + (Convenience Variables): Document $_shell_exitcode and + $_shell_exitstatus. + 2019-05-29 Tom Tromey * gdb.texinfo (Continuing and Stepping): Document new diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index f2d8710d7dc..79c22d07742 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -1454,6 +1454,68 @@ Execute the @code{make} program with the specified arguments. This is equivalent to @samp{shell make @var{make-args}}. @end table +@table @code +@kindex pipe +@kindex | +@cindex send the output of a gdb command to a shell command +@anchor{pipe} +@item pipe [@var{command}] | @var{shell_command} +@itemx | [@var{command}] | @var{shell_command} +@itemx pipe -d @var{delim} @var{command} @var{delim} @var{shell_command} +@itemx | -d @var{delim} @var{command} @var{delim} @var{shell_command} +Executes @var{command} and sends its output to @var{shell_command}. +Note that no space is needed around @code{|}. +If no @var{command} is provided, the last command executed is repeated. + +In case the @var{command} contains a @code{|}, the option @code{-d @var{delim}} +can be used to specify an alternate delimiter string @var{delim} that separates +the @var{command} from the @var{shell_command}. + +Example: +@smallexample +@group +(gdb) p var +$1 = @{ + black = 144, + red = 233, + green = 377, + blue = 610, + white = 987 +@} +@end group +@group +(gdb) pipe p var|wc + 7 19 80 +(gdb) |p var|wc -l +7 +@end group +@group +(gdb) p /x var +$4 = @{ + black = 0x90, + red = 0xe9, + green = 0x179, + blue = 0x262, + white = 0x3db +@} +(gdb) ||grep red + red => 0xe9, +@end group +@group +(gdb) | -d ! echo this contains a | char\n ! sed -e 's/|/PIPE/' +this contains a PIPE char +(gdb) | -d xxx echo this contains a | char!\n xxx sed -e 's/|/PIPE/' +this contains a PIPE char! +(gdb) +@end group +@end smallexample +@end table + +The convenience variables @code{$_shell_exitcode} and @code{$_shell_exitsignal} +can be used to examine the exit status of the last shell command launched +by @code{shell}, @code{make}, @code{pipe} and @code{|}. +@xref{Convenience Vars,, Convenience Variables}. + @node Logging Output @section Logging Output @cindex logging @value{GDBN} output @@ -1485,6 +1547,8 @@ Set @code{debugredirect} if you want debug output to go only to the log file. Show the current values of the logging settings. @end table +You can also redirect the output of a @value{GDBN} command to a +shell command. @xref{pipe}. @node Commands @chapter @value{GDBN} Commands @@ -11304,6 +11368,21 @@ the value 12 for @code{$_gdb_minor}. These variables allow you to write scripts that work with different versions of @value{GDBN} without errors caused by features unavailable in some of those versions. + +@item $_shell_exitcode +@itemx $_shell_exitsignal +@vindex $_shell_exitcode@r{, convenience variable} +@vindex $_shell_exitsignal@r{, convenience variable} +@cindex shell command, exit code +@cindex shell command, exit signal +@cindex exit status of shell commands +@value{GDBN} commands such as @code{shell} and @code{|} are launching +shell commands. When a launched command terminates, @value{GDBN} +automatically maintains the variables @code{$_shell_exitcode} +and @code{$_shell_exitsignal} according to the exit status of the last +launched command. These variables are set and used similarly to +the variables @code{$_exitcode} and @code{$_exitsignal}. + @end table @node Convenience Funs