coregrind/pub_core_libcprint.h

   1
   2 /*--------------------------------------------------------------------*/
   3 /*--- Printing libc stuff.                    pub_core_libcprint.h ---*/
   4 /*--------------------------------------------------------------------*/
   5
   6 /*
   7    This file is part of Valgrind, a dynamic binary instrumentation
   8    framework.
   9
  10    Copyright (C) 2000-2017 Julian Seward
  11       jseward@acm.org
  12
  13    This program is free software; you can redistribute it and/or
  14    modify it under the terms of the GNU General Public License as
  15    published by the Free Software Foundation; either version 2 of the
  16    License, or (at your option) any later version.
  17
  18    This program is distributed in the hope that it will be useful, but
  19    WITHOUT ANY WARRANTY; without even the implied warranty of
  20    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  21    General Public License for more details.
  22
  23    You should have received a copy of the GNU General Public License
  24    along with this program; if not, write to the Free Software
  25    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  26    02111-1307, USA.
  27
  28    The GNU General Public License is contained in the file COPYING.
  29 */
  30
  31 #ifndef __PUB_CORE_LIBCPRINT_H
  32 #define __PUB_CORE_LIBCPRINT_H
  33
  34 //--------------------------------------------------------------------
  35 // PURPOSE: This module contains all the libc code that is related to
  36 // higher-level (ie. higher than DebugLog) printing, eg. VG_(printf)().
  37 //--------------------------------------------------------------------
  38
  39 #include "pub_tool_libcprint.h"
  40
  41 typedef
  42    enum {
  43       VgLogTo_Fd,
  44       VgLogTo_File,
  45       VgLogTo_Socket
  46    }
  47    VgLogTo;
  48
  49 /* An output file descriptor wrapped up with its type and expanded name. */
  50 typedef
  51    struct {
  52       Int fd;
  53       VgLogTo type;
  54       HChar *fsname_expanded; // 'fs' stands for file or socket
  55    }
  56    OutputSink;
  57
  58 /* And the destinations for normal and XML output. */
  59 extern OutputSink VG_(log_output_sink);
  60 extern OutputSink VG_(xml_output_sink);
  61
  62 /* Initializes normal log and xml sinks (of type fd, file, or socket).
  63    Any problem encountered is considered a hard error and causes V. to exit. */
  64 extern void VG_(init_log_xml_sinks)(VgLogTo log_to, VgLogTo xml_to,
  65                                   Int /*initial*/log_fd, Int /*initial*/xml_fd);
  66
  67 extern void VG_(print_preamble)(Bool logging_to_fd);
  68
  69 extern void VG_(logging_atfork_child)(ThreadId tid);
  70
  71 /* Get the elapsed wallclock time since startup into buf which has size
  72    bufsize. The function will assert if bufsize is not large enough.
  73    Upon return, buf will contain the zero-terminated wallclock time as
  74    a string. The function also relies on the
  75    millisecond timer having been set to zero by an initial read in
  76    m_main during startup. */
  77 void VG_(elapsed_wallclock_time) ( /*OUT*/HChar* buf, SizeT bufsize );
  78
  79 /* Call this if the executable is missing.  This function prints an
  80    error message, then shuts down the entire system. */
  81 __attribute__((noreturn))
  82 extern void VG_(err_missing_prog) ( void );
  83
  84 /* Similarly - complain and stop if there is some kind of config
  85    error. */
  86 __attribute__((noreturn))
  87 extern void VG_(err_config_error) ( const HChar* format, ... );
  88
  89 /* Called by main_process_cmd_line_options to indicate an unrecognised
  90    command line option. */
  91 __attribute__((noreturn))
  92 extern void VG_(fmsg_unknown_option) ( const HChar *opt );
  93
  94 #endif   // __PUB_CORE_LIBCPRINT_H
  95
  96 /*--------------------------------------------------------------------*/
  97 /*--- end                                                          ---*/
  98 /*--------------------------------------------------------------------*/