gdb/cli-out.c

   1 /* Output generating routines for GDB CLI.
   2
   3    Copyright (C) 1999-2022 Free Software Foundation, Inc.
   4
   5    Contributed by Cygnus Solutions.
   6    Written by Fernando Nasser for Cygnus.
   7
   8    This file is part of GDB.
   9
  10    This program is free software; you can redistribute it and/or modify
  11    it under the terms of the GNU General Public License as published by
  12    the Free Software Foundation; either version 3 of the License, or
  13    (at your option) any later version.
  14
  15    This program is distributed in the hope that it will be useful,
  16    but WITHOUT ANY WARRANTY; without even the implied warranty of
  17    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18    GNU General Public License for more details.
  19
  20    You should have received a copy of the GNU General Public License
  21    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  22
  23 #include "defs.h"
  24 #include "ui-out.h"
  25 #include "cli-out.h"
  26 #include "completer.h"
  27 #include "readline/readline.h"
  28 #include "cli/cli-style.h"
  29
  30 /* These are the CLI output functions */
  31
  32 /* Mark beginning of a table */
  33
  34 void
  35 cli_ui_out::do_table_begin (int nbrofcols, int nr_rows, const char *tblid)
  36 {
  37   if (nr_rows == 0)
  38     m_suppress_output = true;
  39   else
  40     /* Only the table suppresses the output and, fortunately, a table
  41        is not a recursive data structure.  */
  42     gdb_assert (!m_suppress_output);
  43 }
  44
  45 /* Mark beginning of a table body */
  46
  47 void
  48 cli_ui_out::do_table_body ()
  49 {
  50   if (m_suppress_output)
  51     return;
  52
  53   /* first, close the table header line */
  54   text ("\n");
  55 }
  56
  57 /* Mark end of a table */
  58
  59 void
  60 cli_ui_out::do_table_end ()
  61 {
  62   m_suppress_output = false;
  63 }
  64
  65 /* Specify table header */
  66
  67 void
  68 cli_ui_out::do_table_header (int width, ui_align alignment,
  69                              const std::string &col_name,
  70                              const std::string &col_hdr)
  71 {
  72   if (m_suppress_output)
  73     return;
  74
  75   do_field_string (0, width, alignment, 0, col_hdr.c_str (),
  76                    ui_file_style ());
  77 }
  78
  79 /* Mark beginning of a list */
  80
  81 void
  82 cli_ui_out::do_begin (ui_out_type type, const char *id)
  83 {
  84 }
  85
  86 /* Mark end of a list */
  87
  88 void
  89 cli_ui_out::do_end (ui_out_type type)
  90 {
  91 }
  92
  93 /* output an int field */
  94
  95 void
  96 cli_ui_out::do_field_signed (int fldno, int width, ui_align alignment,
  97                              const char *fldname, LONGEST value)
  98 {
  99   if (m_suppress_output)
 100     return;
 101
 102   do_field_string (fldno, width, alignment, fldname, plongest (value),
 103                    ui_file_style ());
 104 }
 105
 106 /* output an unsigned field */
 107
 108 void
 109 cli_ui_out::do_field_unsigned (int fldno, int width, ui_align alignment,
 110                                const char *fldname, ULONGEST value)
 111 {
 112   if (m_suppress_output)
 113     return;
 114
 115   do_field_string (fldno, width, alignment, fldname, pulongest (value),
 116                    ui_file_style ());
 117 }
 118
 119 /* used to omit a field */
 120
 121 void
 122 cli_ui_out::do_field_skip (int fldno, int width, ui_align alignment,
 123                            const char *fldname)
 124 {
 125   if (m_suppress_output)
 126     return;
 127
 128   do_field_string (fldno, width, alignment, fldname, "",
 129                    ui_file_style ());
 130 }
 131
 132 /* other specific cli_field_* end up here so alignment and field
 133    separators are both handled by cli_field_string */
 134
 135 void
 136 cli_ui_out::do_field_string (int fldno, int width, ui_align align,
 137                              const char *fldname, const char *string,
 138                              const ui_file_style &style)
 139 {
 140   int before = 0;
 141   int after = 0;
 142
 143   if (m_suppress_output)
 144     return;
 145
 146   if ((align != ui_noalign) && string)
 147     {
 148       before = width - strlen (string);
 149       if (before <= 0)
 150         before = 0;
 151       else
 152         {
 153           if (align == ui_right)
 154             after = 0;
 155           else if (align == ui_left)
 156             {
 157               after = before;
 158               before = 0;
 159             }
 160           else
 161             /* ui_center */
 162             {
 163               after = before / 2;
 164               before -= after;
 165             }
 166         }
 167     }
 168
 169   if (before)
 170     spaces (before);
 171
 172   if (string)
 173     {
 174       ui_file *stream = m_streams.back ();
 175       stream->emit_style_escape (style);
 176       stream->puts (string);
 177       stream->emit_style_escape (ui_file_style ());
 178     }
 179
 180   if (after)
 181     spaces (after);
 182
 183   if (align != ui_noalign)
 184     field_separator ();
 185 }
 186
 187 /* Output field containing ARGS using printf formatting in FORMAT.  */
 188
 189 void
 190 cli_ui_out::do_field_fmt (int fldno, int width, ui_align align,
 191                           const char *fldname, const ui_file_style &style,
 192                           const char *format, va_list args)
 193 {
 194   if (m_suppress_output)
 195     return;
 196
 197   std::string str = string_vprintf (format, args);
 198
 199   do_field_string (fldno, width, align, fldname, str.c_str (), style);
 200 }
 201
 202 void
 203 cli_ui_out::do_spaces (int numspaces)
 204 {
 205   if (m_suppress_output)
 206     return;
 207
 208   print_spaces (numspaces, m_streams.back ());
 209 }
 210
 211 void
 212 cli_ui_out::do_text (const char *string)
 213 {
 214   if (m_suppress_output)
 215     return;
 216
 217   gdb_puts (string, m_streams.back ());
 218 }
 219
 220 void
 221 cli_ui_out::do_message (const ui_file_style &style,
 222                         const char *format, va_list args)
 223 {
 224   if (m_suppress_output)
 225     return;
 226
 227   std::string str = string_vprintf (format, args);
 228   if (!str.empty ())
 229     {
 230       ui_file *stream = m_streams.back ();
 231       stream->emit_style_escape (style);
 232       stream->puts (str.c_str ());
 233       stream->emit_style_escape (ui_file_style ());
 234     }
 235 }
 236
 237 void
 238 cli_ui_out::do_wrap_hint (int indent)
 239 {
 240   if (m_suppress_output)
 241     return;
 242
 243   m_streams.back ()->wrap_here (indent);
 244 }
 245
 246 void
 247 cli_ui_out::do_flush ()
 248 {
 249   gdb_flush (m_streams.back ());
 250 }
 251
 252 /* OUTSTREAM as non-NULL will push OUTSTREAM on the stack of output streams
 253    and make it therefore active.  OUTSTREAM as NULL will pop the last pushed
 254    output stream; it is an internal error if it does not exist.  */
 255
 256 void
 257 cli_ui_out::do_redirect (ui_file *outstream)
 258 {
 259   if (outstream != NULL)
 260     m_streams.push_back (outstream);
 261   else
 262     m_streams.pop_back ();
 263 }
 264
 265 /* The cli_ui_out::do_progress_* functions result in the following:
 266    - printed for tty, SHOULD_PRINT == true:
 267      <NAME
 268       [#####                      ]\r>
 269    - printed for tty, SHOULD_PRINT == false:
 270      <>
 271    - printed for not-a-tty:
 272      <NAME...
 273      >
 274 */
 275
 276 void
 277 cli_ui_out::do_progress_start (const std::string &name, bool should_print)
 278 {
 279   struct ui_file *stream = m_streams.back ();
 280   cli_progress_info meter;
 281
 282   meter.last_value = 0;
 283   meter.name = name;
 284   if (!stream->isatty ())
 285     {
 286       gdb_printf (stream, "%s...", meter.name.c_str ());
 287       gdb_flush (stream);
 288       meter.printing = WORKING;
 289     }
 290   else
 291     {
 292       /* Don't actually emit anything until the first call notifies us
 293          of progress.  This makes it so a second progress message can
 294          be started before the first one has been notified, without
 295          messy output.  */
 296       meter.printing = should_print ? START : NO_PRINT;
 297     }
 298
 299   m_meters.push_back (std::move (meter));
 300 }
 301
 302 void
 303 cli_ui_out::do_progress_notify (double howmuch)
 304 {
 305   struct ui_file *stream = m_streams.back ();
 306   cli_progress_info &meter (m_meters.back ());
 307
 308   if (meter.printing == NO_PRINT)
 309     return;
 310
 311   if (meter.printing == START)
 312     {
 313       gdb_printf (stream, "%s\n", meter.name.c_str ());
 314       gdb_flush (stream);
 315       meter.printing = WORKING;
 316     }
 317
 318   if (meter.printing == WORKING && howmuch >= 1.0)
 319     return;
 320
 321   if (!stream->isatty ())
 322     return;
 323
 324   int chars_per_line = get_chars_per_line ();
 325   if (chars_per_line > 0)
 326     {
 327       int i, max;
 328       int width = chars_per_line - 3;
 329
 330       max = width * howmuch;
 331       gdb_printf (stream, "\r[");
 332       for (i = 0; i < width; ++i)
 333         gdb_printf (stream, i < max ? "#" : " ");
 334       gdb_printf (stream, "]");
 335       gdb_flush (stream);
 336       meter.printing = PROGRESS;
 337     }
 338 }
 339
 340 void
 341 cli_ui_out::do_progress_end ()
 342 {
 343   struct ui_file *stream = m_streams.back ();
 344   cli_progress_info &meter = m_meters.back ();
 345
 346   if (!stream->isatty ())
 347     {
 348       gdb_printf (stream, "\n");
 349       gdb_flush (stream);
 350     }
 351   else if (meter.printing == PROGRESS)
 352     {
 353       int i;
 354       int width = get_chars_per_line () - 3;
 355
 356       gdb_printf (stream, "\r");
 357       for (i = 0; i < width + 2; ++i)
 358         gdb_printf (stream, " ");
 359       gdb_printf (stream, "\r");
 360       gdb_flush (stream);
 361     }
 362
 363   m_meters.pop_back ();
 364 }
 365
 366 /* local functions */
 367
 368 void
 369 cli_ui_out::field_separator ()
 370 {
 371   gdb_putc (' ', m_streams.back ());
 372 }
 373
 374 /* Constructor for cli_ui_out.  */
 375
 376 cli_ui_out::cli_ui_out (ui_file *stream, ui_out_flags flags)
 377 : ui_out (flags),
 378   m_suppress_output (false)
 379 {
 380   gdb_assert (stream != NULL);
 381
 382   m_streams.push_back (stream);
 383 }
 384
 385 cli_ui_out::~cli_ui_out ()
 386 {
 387 }
 388
 389 ui_file *
 390 cli_ui_out::set_stream (struct ui_file *stream)
 391 {
 392   ui_file *old;
 393
 394   old = m_streams.back ();
 395   m_streams.back () = stream;
 396
 397   return old;
 398 }
 399
 400 bool
 401 cli_ui_out::can_emit_style_escape () const
 402 {
 403   return m_streams.back ()->can_emit_style_escape ();
 404 }
 405
 406 /* CLI interface to display tab-completion matches.  */
 407
 408 /* CLI version of displayer.crlf.  */
 409
 410 static void
 411 cli_mld_crlf (const struct match_list_displayer *displayer)
 412 {
 413   rl_crlf ();
 414 }
 415
 416 /* CLI version of displayer.putch.  */
 417
 418 static void
 419 cli_mld_putch (const struct match_list_displayer *displayer, int ch)
 420 {
 421   putc (ch, rl_outstream);
 422 }
 423
 424 /* CLI version of displayer.puts.  */
 425
 426 static void
 427 cli_mld_puts (const struct match_list_displayer *displayer, const char *s)
 428 {
 429   fputs (s, rl_outstream);
 430 }
 431
 432 /* CLI version of displayer.flush.  */
 433
 434 static void
 435 cli_mld_flush (const struct match_list_displayer *displayer)
 436 {
 437   fflush (rl_outstream);
 438 }
 439
 440 EXTERN_C void _rl_erase_entire_line (void);
 441
 442 /* CLI version of displayer.erase_entire_line.  */
 443
 444 static void
 445 cli_mld_erase_entire_line (const struct match_list_displayer *displayer)
 446 {
 447   _rl_erase_entire_line ();
 448 }
 449
 450 /* CLI version of displayer.beep.  */
 451
 452 static void
 453 cli_mld_beep (const struct match_list_displayer *displayer)
 454 {
 455   rl_ding ();
 456 }
 457
 458 /* CLI version of displayer.read_key.  */
 459
 460 static int
 461 cli_mld_read_key (const struct match_list_displayer *displayer)
 462 {
 463   return rl_read_key ();
 464 }
 465
 466 /* CLI version of rl_completion_display_matches_hook.
 467    See gdb_display_match_list for a description of the arguments.  */
 468
 469 void
 470 cli_display_match_list (char **matches, int len, int max)
 471 {
 472   struct match_list_displayer displayer;
 473
 474   rl_get_screen_size (&displayer.height, &displayer.width);
 475   displayer.crlf = cli_mld_crlf;
 476   displayer.putch = cli_mld_putch;
 477   displayer.puts = cli_mld_puts;
 478   displayer.flush = cli_mld_flush;
 479   displayer.erase_entire_line = cli_mld_erase_entire_line;
 480   displayer.beep = cli_mld_beep;
 481   displayer.read_key = cli_mld_read_key;
 482
 483   gdb_display_match_list (matches, len, max, &displayer);
 484   rl_forced_update_display ();
 485 }