git.cworth.org Git - apitrace/blob - common/trace_writer.hpp

   1 /**************************************************************************
   2  *
   3  * Copyright 2007-2010 VMware, Inc.
   4  * All Rights Reserved.
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining a copy
   7  * of this software and associated documentation files (the "Software"), to deal
   8  * in the Software without restriction, including without limitation the rights
   9  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  10  * copies of the Software, and to permit persons to whom the Software is
  11  * furnished to do so, subject to the following conditions:
  12  *
  13  * The above copyright notice and this permission notice shall be included in
  14  * all copies or substantial portions of the Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  19  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  22  * THE SOFTWARE.
  23  *
  24  **************************************************************************/
  25
  26 /*
  27  * Trace writing functions.
  28  */
  29
  30 #ifndef _TRACE_WRITER_HPP_
  31 #define _TRACE_WRITER_HPP_
  32
  33
  34 #include <stddef.h>
  35
  36 #include <vector>
  37
  38 #include "trace_model.hpp"
  39
  40 namespace trace {
  41     class File;
  42
  43     class Writer {
  44     protected:
  45         File *m_file;
  46         unsigned call_no;
  47
  48         std::vector<bool> functions;
  49         std::vector<bool> structs;
  50         std::vector<bool> enums;
  51         std::vector<bool> bitmasks;
  52         std::vector<bool> frames;
  53
  54     public:
  55         Writer();
  56         ~Writer();
  57
  58         bool open(const char *filename);
  59         void close(void);
  60
  61         unsigned beginEnter(const FunctionSig *sig, unsigned thread_id);
  62         void endEnter(void);
  63
  64         void beginLeave(unsigned call);
  65         void endLeave(void);
  66
  67         void beginArg(unsigned index);
  68         inline void endArg(void) {}
  69
  70         void beginReturn(void);
  71         inline void endReturn(void) {}
  72
  73         void beginBacktrace(unsigned num_frames);
  74         void writeStackFrame(const RawStackFrame *frame);
  75         inline void endBacktrace(void) {}
  76
  77         void beginArray(size_t length);
  78         inline void endArray(void) {}
  79
  80         inline void beginElement(void) {}
  81         inline void endElement(void) {}
  82
  83         void beginStruct(const StructSig *sig);
  84         inline void endStruct(void) {}
  85
  86         void beginRepr(void);
  87         inline void endRepr(void) {}
  88
  89         void writeBool(bool value);
  90         void writeSInt(signed long long value);
  91         void writeUInt(unsigned long long value);
  92         void writeFloat(float value);
  93         void writeDouble(double value);
  94         void writeString(const char *str);
  95         void writeString(const char *str, size_t size);
  96         void writeWString(const wchar_t *str);
  97         void writeBlob(const void *data, size_t size);
  98         void writeEnum(const EnumSig *sig, signed long long value);
  99         void writeBitmask(const BitmaskSig *sig, unsigned long long value);
 100         void writeNull(void);
 101         void writePointer(unsigned long long addr);
 102
 103         void writeCall(Call *call);
 104
 105     protected:
 106         void inline _write(const void *sBuffer, size_t dwBytesToWrite);
 107         void inline _writeByte(char c);
 108         void inline _writeUInt(unsigned long long value);
 109         void inline _writeFloat(float value);
 110         void inline _writeDouble(double value);
 111         void inline _writeString(const char *str);
 112
 113     };
 114
 115 } /* namespace trace */
 116
 117 #endif /* _TRACE_WRITER_HPP_ */