1 /* UI_FILE - a generic STDIO like output stream.
3 Copyright (C) 1999-2016 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
20 /* Implement the ``struct ui_file'' object. */
24 #include "gdb_obstack.h"
25 #include "gdb_select.h"
26 #include "filestuff.h"
28 static ui_file_isatty_ftype null_file_isatty;
29 static ui_file_write_ftype null_file_write;
30 static ui_file_write_ftype null_file_write_async_safe;
31 static ui_file_fputs_ftype null_file_fputs;
32 static ui_file_read_ftype null_file_read;
33 static ui_file_flush_ftype null_file_flush;
34 static ui_file_delete_ftype null_file_delete;
35 static ui_file_rewind_ftype null_file_rewind;
36 static ui_file_put_ftype null_file_put;
37 static ui_file_fseek_ftype null_file_fseek;
42 ui_file_flush_ftype *to_flush;
43 ui_file_write_ftype *to_write;
44 ui_file_write_async_safe_ftype *to_write_async_safe;
45 ui_file_fputs_ftype *to_fputs;
46 ui_file_read_ftype *to_read;
47 ui_file_delete_ftype *to_delete;
48 ui_file_isatty_ftype *to_isatty;
49 ui_file_rewind_ftype *to_rewind;
50 ui_file_put_ftype *to_put;
51 ui_file_fseek_ftype *to_fseek;
59 struct ui_file *file = XNEW (struct ui_file);
61 file->magic = &ui_file_magic;
62 set_ui_file_data (file, NULL, null_file_delete);
63 set_ui_file_flush (file, null_file_flush);
64 set_ui_file_write (file, null_file_write);
65 set_ui_file_write_async_safe (file, null_file_write_async_safe);
66 set_ui_file_fputs (file, null_file_fputs);
67 set_ui_file_read (file, null_file_read);
68 set_ui_file_isatty (file, null_file_isatty);
69 set_ui_file_rewind (file, null_file_rewind);
70 set_ui_file_put (file, null_file_put);
71 set_ui_file_fseek (file, null_file_fseek);
76 ui_file_delete (struct ui_file *file)
78 file->to_delete (file);
83 null_file_isatty (struct ui_file *file)
89 null_file_rewind (struct ui_file *file)
95 null_file_put (struct ui_file *file,
96 ui_file_put_method_ftype *write,
103 null_file_flush (struct ui_file *file)
109 null_file_write (struct ui_file *file,
113 if (file->to_fputs == null_file_fputs)
114 /* Both the write and fputs methods are null. Discard the
119 /* The fputs method isn't null, slowly pass the write request
120 onto that. FYI, this isn't as bad as it may look - the
121 current (as of 1999-11-07) printf_* function calls fputc and
122 fputc does exactly the below. By having a write function it
123 is possible to clean up that code. */
128 for (i = 0; i < sizeof_buf; i++)
131 file->to_fputs (b, file);
138 null_file_read (struct ui_file *file,
147 null_file_fputs (const char *buf, struct ui_file *file)
149 if (file->to_write == null_file_write)
150 /* Both the write and fputs methods are null. Discard the
155 /* The write method was implemented, use that. */
156 file->to_write (file, buf, strlen (buf));
161 null_file_write_async_safe (struct ui_file *file,
169 null_file_delete (struct ui_file *file)
175 null_file_fseek (struct ui_file *stream, long offset, int whence)
183 ui_file_data (struct ui_file *file)
185 if (file->magic != &ui_file_magic)
186 internal_error (__FILE__, __LINE__,
187 _("ui_file_data: bad magic number"));
188 return file->to_data;
192 gdb_flush (struct ui_file *file)
194 file->to_flush (file);
198 ui_file_isatty (struct ui_file *file)
200 return file->to_isatty (file);
204 ui_file_rewind (struct ui_file *file)
206 file->to_rewind (file);
210 ui_file_put (struct ui_file *file,
211 ui_file_put_method_ftype *write,
214 file->to_put (file, write, dest);
218 ui_file_write (struct ui_file *file,
222 file->to_write (file, buf, length_buf);
226 ui_file_write_for_put (void *data, const char *buffer, long length_buffer)
228 ui_file_write ((struct ui_file *) data, buffer, length_buffer);
232 ui_file_write_async_safe (struct ui_file *file,
236 file->to_write_async_safe (file, buf, length_buf);
240 ui_file_read (struct ui_file *file, char *buf, long length_buf)
242 return file->to_read (file, buf, length_buf);
246 ui_file_fseek (struct ui_file *file, long offset, int whence)
248 return file->to_fseek (file, offset, whence);
252 fputs_unfiltered (const char *buf, struct ui_file *file)
254 file->to_fputs (buf, file);
258 set_ui_file_flush (struct ui_file *file, ui_file_flush_ftype *flush_ptr)
260 file->to_flush = flush_ptr;
264 set_ui_file_isatty (struct ui_file *file, ui_file_isatty_ftype *isatty_ptr)
266 file->to_isatty = isatty_ptr;
270 set_ui_file_rewind (struct ui_file *file, ui_file_rewind_ftype *rewind_ptr)
272 file->to_rewind = rewind_ptr;
276 set_ui_file_put (struct ui_file *file, ui_file_put_ftype *put_ptr)
278 file->to_put = put_ptr;
282 set_ui_file_write (struct ui_file *file,
283 ui_file_write_ftype *write_ptr)
285 file->to_write = write_ptr;
289 set_ui_file_write_async_safe (struct ui_file *file,
290 ui_file_write_async_safe_ftype *write_async_safe_ptr)
292 file->to_write_async_safe = write_async_safe_ptr;
296 set_ui_file_read (struct ui_file *file, ui_file_read_ftype *read_ptr)
298 file->to_read = read_ptr;
302 set_ui_file_fputs (struct ui_file *file, ui_file_fputs_ftype *fputs_ptr)
304 file->to_fputs = fputs_ptr;
308 set_ui_file_fseek (struct ui_file *file, ui_file_fseek_ftype *fseek_ptr)
310 file->to_fseek = fseek_ptr;
314 set_ui_file_data (struct ui_file *file, void *data,
315 ui_file_delete_ftype *delete_ptr)
317 file->to_data = data;
318 file->to_delete = delete_ptr;
321 /* ui_file utility function for converting a ``struct ui_file'' into
324 struct accumulated_ui_file
331 do_ui_file_xstrdup (void *context, const char *buffer, long length)
333 struct accumulated_ui_file *acc = (struct accumulated_ui_file *) context;
335 if (acc->buffer == NULL)
336 acc->buffer = (char *) xmalloc (length + 1);
338 acc->buffer = (char *) xrealloc (acc->buffer, acc->length + length + 1);
339 memcpy (acc->buffer + acc->length, buffer, length);
340 acc->length += length;
341 acc->buffer[acc->length] = '\0';
345 ui_file_xstrdup (struct ui_file *file, long *length)
347 struct accumulated_ui_file acc;
351 ui_file_put (file, do_ui_file_xstrdup, &acc);
352 if (acc.buffer == NULL)
353 acc.buffer = xstrdup ("");
355 *length = acc.length;
360 do_ui_file_obsavestring (void *context, const char *buffer, long length)
362 struct obstack *obstack = (struct obstack *) context;
364 obstack_grow (obstack, buffer, length);
368 ui_file_obsavestring (struct ui_file *file, struct obstack *obstack,
371 ui_file_put (file, do_ui_file_obsavestring, obstack);
372 *length = obstack_object_size (obstack);
373 obstack_1grow (obstack, '\0');
374 return (char *) obstack_finish (obstack);
377 /* A pure memory based ``struct ui_file'' that can be used an output
378 buffer. The buffers accumulated contents are available via
389 static ui_file_rewind_ftype mem_file_rewind;
390 static ui_file_put_ftype mem_file_put;
391 static ui_file_write_ftype mem_file_write;
392 static ui_file_delete_ftype mem_file_delete;
393 static struct ui_file *mem_file_new (void);
394 static int mem_file_magic;
396 static struct ui_file *
399 struct mem_file *stream = XNEW (struct mem_file);
400 struct ui_file *file = ui_file_new ();
402 set_ui_file_data (file, stream, mem_file_delete);
403 set_ui_file_rewind (file, mem_file_rewind);
404 set_ui_file_put (file, mem_file_put);
405 set_ui_file_write (file, mem_file_write);
406 stream->magic = &mem_file_magic;
407 stream->buffer = NULL;
408 stream->sizeof_buffer = 0;
409 stream->length_buffer = 0;
414 mem_file_delete (struct ui_file *file)
416 struct mem_file *stream = (struct mem_file *) ui_file_data (file);
418 if (stream->magic != &mem_file_magic)
419 internal_error (__FILE__, __LINE__,
420 _("mem_file_delete: bad magic number"));
421 if (stream->buffer != NULL)
422 xfree (stream->buffer);
429 return mem_file_new ();
433 mem_file_rewind (struct ui_file *file)
435 struct mem_file *stream = (struct mem_file *) ui_file_data (file);
437 if (stream->magic != &mem_file_magic)
438 internal_error (__FILE__, __LINE__,
439 _("mem_file_rewind: bad magic number"));
440 stream->length_buffer = 0;
444 mem_file_put (struct ui_file *file,
445 ui_file_put_method_ftype *write,
448 struct mem_file *stream = (struct mem_file *) ui_file_data (file);
450 if (stream->magic != &mem_file_magic)
451 internal_error (__FILE__, __LINE__,
452 _("mem_file_put: bad magic number"));
453 if (stream->length_buffer > 0)
454 write (dest, stream->buffer, stream->length_buffer);
458 mem_file_write (struct ui_file *file,
462 struct mem_file *stream = (struct mem_file *) ui_file_data (file);
464 if (stream->magic != &mem_file_magic)
465 internal_error (__FILE__, __LINE__,
466 _("mem_file_write: bad magic number"));
467 if (stream->buffer == NULL)
469 stream->length_buffer = length_buffer;
470 stream->sizeof_buffer = length_buffer;
471 stream->buffer = (char *) xmalloc (stream->sizeof_buffer);
472 memcpy (stream->buffer, buffer, length_buffer);
476 int new_length = stream->length_buffer + length_buffer;
478 if (new_length >= stream->sizeof_buffer)
480 stream->sizeof_buffer = new_length;
482 = (char *) xrealloc (stream->buffer, stream->sizeof_buffer);
484 memcpy (stream->buffer + stream->length_buffer, buffer, length_buffer);
485 stream->length_buffer = new_length;
489 /* ``struct ui_file'' implementation that maps directly onto
492 static ui_file_write_ftype stdio_file_write;
493 static ui_file_write_async_safe_ftype stdio_file_write_async_safe;
494 static ui_file_fputs_ftype stdio_file_fputs;
495 static ui_file_read_ftype stdio_file_read;
496 static ui_file_isatty_ftype stdio_file_isatty;
497 static ui_file_delete_ftype stdio_file_delete;
498 static struct ui_file *stdio_file_new (FILE *file, int close_p);
499 static ui_file_flush_ftype stdio_file_flush;
500 static ui_file_fseek_ftype stdio_file_fseek;
502 static int stdio_file_magic;
508 /* The associated file descriptor is extracted ahead of time for
509 stdio_file_write_async_safe's benefit, in case fileno isn't async-safe. */
514 static struct ui_file *
515 stdio_file_new (FILE *file, int close_p)
517 struct ui_file *ui_file = ui_file_new ();
518 struct stdio_file *stdio = XNEW (struct stdio_file);
520 stdio->magic = &stdio_file_magic;
522 stdio->fd = fileno (file);
523 stdio->close_p = close_p;
524 set_ui_file_data (ui_file, stdio, stdio_file_delete);
525 set_ui_file_flush (ui_file, stdio_file_flush);
526 set_ui_file_write (ui_file, stdio_file_write);
527 set_ui_file_write_async_safe (ui_file, stdio_file_write_async_safe);
528 set_ui_file_fputs (ui_file, stdio_file_fputs);
529 set_ui_file_read (ui_file, stdio_file_read);
530 set_ui_file_isatty (ui_file, stdio_file_isatty);
531 set_ui_file_fseek (ui_file, stdio_file_fseek);
536 stdio_file_delete (struct ui_file *file)
538 struct stdio_file *stdio = (struct stdio_file *) ui_file_data (file);
540 if (stdio->magic != &stdio_file_magic)
541 internal_error (__FILE__, __LINE__,
542 _("stdio_file_delete: bad magic number"));
545 fclose (stdio->file);
551 stdio_file_flush (struct ui_file *file)
553 struct stdio_file *stdio = (struct stdio_file *) ui_file_data (file);
555 if (stdio->magic != &stdio_file_magic)
556 internal_error (__FILE__, __LINE__,
557 _("stdio_file_flush: bad magic number"));
558 fflush (stdio->file);
562 stdio_file_read (struct ui_file *file, char *buf, long length_buf)
564 struct stdio_file *stdio = (struct stdio_file *) ui_file_data (file);
566 if (stdio->magic != &stdio_file_magic)
567 internal_error (__FILE__, __LINE__,
568 _("stdio_file_read: bad magic number"));
570 /* For the benefit of Windows, call gdb_select before reading from
571 the file. Wait until at least one byte of data is available.
572 Control-C can interrupt gdb_select, but not read. */
576 FD_SET (stdio->fd, &readfds);
577 if (gdb_select (stdio->fd + 1, &readfds, NULL, NULL, NULL) == -1)
581 return read (stdio->fd, buf, length_buf);
585 stdio_file_write (struct ui_file *file, const char *buf, long length_buf)
587 struct stdio_file *stdio = (struct stdio_file *) ui_file_data (file);
589 if (stdio->magic != &stdio_file_magic)
590 internal_error (__FILE__, __LINE__,
591 _("stdio_file_write: bad magic number"));
592 /* Calling error crashes when we are called from the exception framework. */
593 if (fwrite (buf, length_buf, 1, stdio->file))
600 stdio_file_write_async_safe (struct ui_file *file,
601 const char *buf, long length_buf)
603 struct stdio_file *stdio = (struct stdio_file *) ui_file_data (file);
605 if (stdio->magic != &stdio_file_magic)
607 /* gettext isn't necessarily async safe, so we can't use _("error message") here.
608 We could extract the correct translation ahead of time, but this is an extremely
609 rare event, and one of the other stdio_file_* routines will presumably catch
610 the problem anyway. For now keep it simple and ignore the error here. */
614 /* This is written the way it is to avoid a warning from gcc about not using the
615 result of write (since it can be declared with attribute warn_unused_result).
616 Alas casting to void doesn't work for this. */
617 if (write (stdio->fd, buf, length_buf))
624 stdio_file_fputs (const char *linebuffer, struct ui_file *file)
626 struct stdio_file *stdio = (struct stdio_file *) ui_file_data (file);
628 if (stdio->magic != &stdio_file_magic)
629 internal_error (__FILE__, __LINE__,
630 _("stdio_file_fputs: bad magic number"));
631 /* Calling error crashes when we are called from the exception framework. */
632 if (fputs (linebuffer, stdio->file))
639 stdio_file_isatty (struct ui_file *file)
641 struct stdio_file *stdio = (struct stdio_file *) ui_file_data (file);
643 if (stdio->magic != &stdio_file_magic)
644 internal_error (__FILE__, __LINE__,
645 _("stdio_file_isatty: bad magic number"));
646 return (isatty (stdio->fd));
650 stdio_file_fseek (struct ui_file *file, long offset, int whence)
652 struct stdio_file *stdio = (struct stdio_file *) ui_file_data (file);
654 if (stdio->magic != &stdio_file_magic)
655 internal_error (__FILE__, __LINE__,
656 _("stdio_file_fseek: bad magic number"));
658 return fseek (stdio->file, offset, whence);
662 /* This is the implementation of ui_file method to_write for stderr.
663 gdb_stdout is flushed before writing to gdb_stderr. */
666 stderr_file_write (struct ui_file *file, const char *buf, long length_buf)
668 gdb_flush (gdb_stdout);
669 stdio_file_write (file, buf, length_buf);
672 /* This is the implementation of ui_file method to_fputs for stderr.
673 gdb_stdout is flushed before writing to gdb_stderr. */
676 stderr_file_fputs (const char *linebuffer, struct ui_file *file)
678 gdb_flush (gdb_stdout);
679 stdio_file_fputs (linebuffer, file);
684 stderr_fileopen (void)
686 struct ui_file *ui_file = stdio_fileopen (stderr);
689 /* There is no real line-buffering on Windows, see
690 http://msdn.microsoft.com/en-us/library/86cebhfs%28v=vs.71%29.aspx
691 so the stdout is either fully-buffered or non-buffered. We can't
692 make stdout non-buffered, because of two concerns,
693 1. non-buffering hurts performance,
694 2. non-buffering may change GDB's behavior when it is interacting
695 with front-end, such as Emacs.
697 We decided to leave stdout as fully buffered, but flush it first
698 when something is written to stderr. */
700 /* Method 'to_write_async_safe' is not overwritten, because there's
701 no way to flush a stream in an async-safe manner. Fortunately,
702 it doesn't really matter, because:
703 - that method is only used for printing internal debug output
704 from signal handlers.
705 - Windows hosts don't have a concept of async-safeness. Signal
706 handlers run in a separate thread, so they can call
707 the regular non-async-safe output routines freely. */
708 set_ui_file_write (ui_file, stderr_file_write);
709 set_ui_file_fputs (ui_file, stderr_file_fputs);
715 /* Like fdopen(). Create a ui_file from a previously opened FILE. */
718 stdio_fileopen (FILE *file)
720 return stdio_file_new (file, 0);
724 gdb_fopen (const char *name, const char *mode)
726 FILE *f = gdb_fopen_cloexec (name, mode);
730 return stdio_file_new (f, 1);
733 /* ``struct ui_file'' implementation that maps onto two ui-file objects. */
735 static ui_file_write_ftype tee_file_write;
736 static ui_file_fputs_ftype tee_file_fputs;
737 static ui_file_isatty_ftype tee_file_isatty;
738 static ui_file_delete_ftype tee_file_delete;
739 static ui_file_flush_ftype tee_file_flush;
741 static int tee_file_magic;
746 struct ui_file *one, *two;
747 int close_one, close_two;
751 tee_file_new (struct ui_file *one, int close_one,
752 struct ui_file *two, int close_two)
754 struct ui_file *ui_file = ui_file_new ();
755 struct tee_file *tee = XNEW (struct tee_file);
757 tee->magic = &tee_file_magic;
760 tee->close_one = close_one;
761 tee->close_two = close_two;
762 set_ui_file_data (ui_file, tee, tee_file_delete);
763 set_ui_file_flush (ui_file, tee_file_flush);
764 set_ui_file_write (ui_file, tee_file_write);
765 set_ui_file_fputs (ui_file, tee_file_fputs);
766 set_ui_file_isatty (ui_file, tee_file_isatty);
771 tee_file_delete (struct ui_file *file)
773 struct tee_file *tee = (struct tee_file *) ui_file_data (file);
775 if (tee->magic != &tee_file_magic)
776 internal_error (__FILE__, __LINE__,
777 _("tee_file_delete: bad magic number"));
779 ui_file_delete (tee->one);
781 ui_file_delete (tee->two);
787 tee_file_flush (struct ui_file *file)
789 struct tee_file *tee = (struct tee_file *) ui_file_data (file);
791 if (tee->magic != &tee_file_magic)
792 internal_error (__FILE__, __LINE__,
793 _("tee_file_flush: bad magic number"));
794 tee->one->to_flush (tee->one);
795 tee->two->to_flush (tee->two);
799 tee_file_write (struct ui_file *file, const char *buf, long length_buf)
801 struct tee_file *tee = (struct tee_file *) ui_file_data (file);
803 if (tee->magic != &tee_file_magic)
804 internal_error (__FILE__, __LINE__,
805 _("tee_file_write: bad magic number"));
806 ui_file_write (tee->one, buf, length_buf);
807 ui_file_write (tee->two, buf, length_buf);
811 tee_file_fputs (const char *linebuffer, struct ui_file *file)
813 struct tee_file *tee = (struct tee_file *) ui_file_data (file);
815 if (tee->magic != &tee_file_magic)
816 internal_error (__FILE__, __LINE__,
817 _("tee_file_fputs: bad magic number"));
818 tee->one->to_fputs (linebuffer, tee->one);
819 tee->two->to_fputs (linebuffer, tee->two);
823 tee_file_isatty (struct ui_file *file)
825 struct tee_file *tee = (struct tee_file *) ui_file_data (file);
827 if (tee->magic != &tee_file_magic)
828 internal_error (__FILE__, __LINE__,
829 _("tee_file_isatty: bad magic number"));
831 return ui_file_isatty (tee->one);