diff options
Diffstat (limited to 'common/trace_format.hpp')
-rw-r--r-- | common/trace_format.hpp | 109 |
1 files changed, 109 insertions, 0 deletions
diff --git a/common/trace_format.hpp b/common/trace_format.hpp new file mode 100644 index 0000000..a8ee5eb --- /dev/null +++ b/common/trace_format.hpp @@ -0,0 +1,109 @@ +/************************************************************************** + * + * Copyright 2010 VMware, Inc. + * All Rights Reserved. + * + * Permission is hereby granted, free of charge, to any person obtaining a copy + * of this software and associated documentation files (the "Software"), to deal + * in the Software without restriction, including without limitation the rights + * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell + * copies of the Software, and to permit persons to whom the Software is + * furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, + * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN + * THE SOFTWARE. + * + **************************************************************************/ + +/* + * Trace binary format. + * + * Grammar: + * + * trace = event* EOF + * + * event = EVENT_ENTER call_sig call_detail+ + * | EVENT_LEAVE call_no call_detail+ + * + * call_sig = sig_id ( name arg_names )? + * + * call_detail = ARG index value + * | RET value + * | END + * + * value = NULL + * | FALSE + * | TRUE + * | SINT int + * | UINT int + * | FLOAT float + * | DOUBLE double + * | STRING string + * | BLOB string + * | ENUM enum_sig + * | BITMASK bitmask_sig value + * | ARRAY length value+ + * | STRUCT struct_sig value+ + * | OPAQUE int + * + * call_sig = id name arg_name* + * | id + * + * enum_sig = id name value + * | id + * + * bitmask_sig = id count (name value)+ + * | id + * + * string = length (BYTE)* + * + */ + +#ifndef _TRACE_FORMAT_HPP_ +#define _TRACE_FORMAT_HPP_ + +namespace Trace { + +#define TRACE_VERSION 1 + +enum Event { + EVENT_ENTER = 0, + EVENT_LEAVE, +}; + +enum CallDetail { + CALL_END = 0, + CALL_ARG, + CALL_RET, + CALL_THREAD, +}; + +enum Type { + TYPE_NULL = 0, + TYPE_FALSE, + TYPE_TRUE, + TYPE_SINT, + TYPE_UINT, + TYPE_FLOAT, + TYPE_DOUBLE, + TYPE_STRING, // Null terminated, human readible string + TYPE_BLOB, // Block of bytes + TYPE_ENUM, + TYPE_BITMASK, + TYPE_ARRAY, + TYPE_STRUCT, + TYPE_OPAQUE, +}; + + +} /* namespace Trace */ + +#endif /* _TRACE_FORMAT_HPP_ */ |