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 /*--------------------------------------------------------------------*/ 99