// Copyright (c) 2014 The Chromium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #include "base/trace_event/trace_event_argument.h" #include <stdint.h> #include <utility> #include "base/bits.h" #include "base/json/json_writer.h" #include "base/memory/ptr_util.h" #include "base/trace_event/trace_event_memory_overhead.h" #include "base/values.h" namespace base { namespace trace_event { namespace { const char kTypeStartDict = '{'; const char kTypeEndDict = '}'; const char kTypeStartArray = '['; const char kTypeEndArray = ']'; const char kTypeBool = 'b'; const char kTypeInt = 'i'; const char kTypeDouble = 'd'; const char kTypeString = 's'; const char kTypeCStr = '*'; #ifndef NDEBUG const bool kStackTypeDict = false; const bool kStackTypeArray = true; #define DCHECK_CURRENT_CONTAINER_IS(x) DCHECK_EQ(x, nesting_stack_.back()) #define DCHECK_CONTAINER_STACK_DEPTH_EQ(x) DCHECK_EQ(x, nesting_stack_.size()) #define DEBUG_PUSH_CONTAINER(x) nesting_stack_.push_back(x) #define DEBUG_POP_CONTAINER() nesting_stack_.pop_back() #else #define DCHECK_CURRENT_CONTAINER_IS(x) do {} while (0) #define DCHECK_CONTAINER_STACK_DEPTH_EQ(x) do {} while (0) #define DEBUG_PUSH_CONTAINER(x) do {} while (0) #define DEBUG_POP_CONTAINER() do {} while (0) #endif inline void WriteKeyNameAsRawPtr(Pickle& pickle, const char* ptr) { pickle.WriteBytes(&kTypeCStr, 1); pickle.WriteUInt64(static_cast<uint64_t>(reinterpret_cast<uintptr_t>(ptr))); } inline void WriteKeyNameWithCopy(Pickle& pickle, base::StringPiece str) { pickle.WriteBytes(&kTypeString, 1); pickle.WriteString(str); } std::string ReadKeyName(PickleIterator& pickle_iterator) { const char* type = nullptr; bool res = pickle_iterator.ReadBytes(&type, 1); std::string key_name; if (res && *type == kTypeCStr) { uint64_t ptr_value = 0; res = pickle_iterator.ReadUInt64(&ptr_value); key_name = reinterpret_cast<const char*>(static_cast<uintptr_t>(ptr_value)); } else if (res && *type == kTypeString) { res = pickle_iterator.ReadString(&key_name); } DCHECK(res); return key_name; } } // namespace TracedValue::TracedValue() : TracedValue(0) { } TracedValue::TracedValue(size_t capacity) { DEBUG_PUSH_CONTAINER(kStackTypeDict); if (capacity) pickle_.Reserve(capacity); } TracedValue::~TracedValue() { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); DEBUG_POP_CONTAINER(); DCHECK_CONTAINER_STACK_DEPTH_EQ(0u); } void TracedValue::SetInteger(const char* name, int value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); pickle_.WriteBytes(&kTypeInt, 1); pickle_.WriteInt(value); WriteKeyNameAsRawPtr(pickle_, name); } void TracedValue::SetIntegerWithCopiedName(base::StringPiece name, int value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); pickle_.WriteBytes(&kTypeInt, 1); pickle_.WriteInt(value); WriteKeyNameWithCopy(pickle_, name); } void TracedValue::SetDouble(const char* name, double value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); pickle_.WriteBytes(&kTypeDouble, 1); pickle_.WriteDouble(value); WriteKeyNameAsRawPtr(pickle_, name); } void TracedValue::SetDoubleWithCopiedName(base::StringPiece name, double value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); pickle_.WriteBytes(&kTypeDouble, 1); pickle_.WriteDouble(value); WriteKeyNameWithCopy(pickle_, name); } void TracedValue::SetBoolean(const char* name, bool value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); pickle_.WriteBytes(&kTypeBool, 1); pickle_.WriteBool(value); WriteKeyNameAsRawPtr(pickle_, name); } void TracedValue::SetBooleanWithCopiedName(base::StringPiece name, bool value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); pickle_.WriteBytes(&kTypeBool, 1); pickle_.WriteBool(value); WriteKeyNameWithCopy(pickle_, name); } void TracedValue::SetString(const char* name, base::StringPiece value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); pickle_.WriteBytes(&kTypeString, 1); pickle_.WriteString(value); WriteKeyNameAsRawPtr(pickle_, name); } void TracedValue::SetStringWithCopiedName(base::StringPiece name, base::StringPiece value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); pickle_.WriteBytes(&kTypeString, 1); pickle_.WriteString(value); WriteKeyNameWithCopy(pickle_, name); } void TracedValue::SetValue(const char* name, const TracedValue& value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); BeginDictionary(name); pickle_.WriteBytes(value.pickle_.payload(), static_cast<int>(value.pickle_.payload_size())); EndDictionary(); } void TracedValue::SetValueWithCopiedName(base::StringPiece name, const TracedValue& value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); BeginDictionaryWithCopiedName(name); pickle_.WriteBytes(value.pickle_.payload(), static_cast<int>(value.pickle_.payload_size())); EndDictionary(); } void TracedValue::BeginDictionary(const char* name) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); DEBUG_PUSH_CONTAINER(kStackTypeDict); pickle_.WriteBytes(&kTypeStartDict, 1); WriteKeyNameAsRawPtr(pickle_, name); } void TracedValue::BeginDictionaryWithCopiedName(base::StringPiece name) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); DEBUG_PUSH_CONTAINER(kStackTypeDict); pickle_.WriteBytes(&kTypeStartDict, 1); WriteKeyNameWithCopy(pickle_, name); } void TracedValue::BeginArray(const char* name) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); DEBUG_PUSH_CONTAINER(kStackTypeArray); pickle_.WriteBytes(&kTypeStartArray, 1); WriteKeyNameAsRawPtr(pickle_, name); } void TracedValue::BeginArrayWithCopiedName(base::StringPiece name) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); DEBUG_PUSH_CONTAINER(kStackTypeArray); pickle_.WriteBytes(&kTypeStartArray, 1); WriteKeyNameWithCopy(pickle_, name); } void TracedValue::EndDictionary() { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); DEBUG_POP_CONTAINER(); pickle_.WriteBytes(&kTypeEndDict, 1); } void TracedValue::AppendInteger(int value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeArray); pickle_.WriteBytes(&kTypeInt, 1); pickle_.WriteInt(value); } void TracedValue::AppendDouble(double value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeArray); pickle_.WriteBytes(&kTypeDouble, 1); pickle_.WriteDouble(value); } void TracedValue::AppendBoolean(bool value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeArray); pickle_.WriteBytes(&kTypeBool, 1); pickle_.WriteBool(value); } void TracedValue::AppendString(base::StringPiece value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeArray); pickle_.WriteBytes(&kTypeString, 1); pickle_.WriteString(value); } void TracedValue::BeginArray() { DCHECK_CURRENT_CONTAINER_IS(kStackTypeArray); DEBUG_PUSH_CONTAINER(kStackTypeArray); pickle_.WriteBytes(&kTypeStartArray, 1); } void TracedValue::BeginDictionary() { DCHECK_CURRENT_CONTAINER_IS(kStackTypeArray); DEBUG_PUSH_CONTAINER(kStackTypeDict); pickle_.WriteBytes(&kTypeStartDict, 1); } void TracedValue::EndArray() { DCHECK_CURRENT_CONTAINER_IS(kStackTypeArray); DEBUG_POP_CONTAINER(); pickle_.WriteBytes(&kTypeEndArray, 1); } void TracedValue::SetValue(const char* name, std::unique_ptr<base::Value> value) { SetBaseValueWithCopiedName(name, *value); } void TracedValue::SetBaseValueWithCopiedName(base::StringPiece name, const base::Value& value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); switch (value.GetType()) { case base::Value::TYPE_NULL: case base::Value::TYPE_BINARY: NOTREACHED(); break; case base::Value::TYPE_BOOLEAN: { bool bool_value; value.GetAsBoolean(&bool_value); SetBooleanWithCopiedName(name, bool_value); } break; case base::Value::TYPE_INTEGER: { int int_value; value.GetAsInteger(&int_value); SetIntegerWithCopiedName(name, int_value); } break; case base::Value::TYPE_DOUBLE: { double double_value; value.GetAsDouble(&double_value); SetDoubleWithCopiedName(name, double_value); } break; case base::Value::TYPE_STRING: { const StringValue* string_value; value.GetAsString(&string_value); SetStringWithCopiedName(name, string_value->GetString()); } break; case base::Value::TYPE_DICTIONARY: { const DictionaryValue* dict_value; value.GetAsDictionary(&dict_value); BeginDictionaryWithCopiedName(name); for (DictionaryValue::Iterator it(*dict_value); !it.IsAtEnd(); it.Advance()) { SetBaseValueWithCopiedName(it.key(), it.value()); } EndDictionary(); } break; case base::Value::TYPE_LIST: { const ListValue* list_value; value.GetAsList(&list_value); BeginArrayWithCopiedName(name); for (const auto& base_value : *list_value) AppendBaseValue(*base_value); EndArray(); } break; } } void TracedValue::AppendBaseValue(const base::Value& value) { DCHECK_CURRENT_CONTAINER_IS(kStackTypeArray); switch (value.GetType()) { case base::Value::TYPE_NULL: case base::Value::TYPE_BINARY: NOTREACHED(); break; case base::Value::TYPE_BOOLEAN: { bool bool_value; value.GetAsBoolean(&bool_value); AppendBoolean(bool_value); } break; case base::Value::TYPE_INTEGER: { int int_value; value.GetAsInteger(&int_value); AppendInteger(int_value); } break; case base::Value::TYPE_DOUBLE: { double double_value; value.GetAsDouble(&double_value); AppendDouble(double_value); } break; case base::Value::TYPE_STRING: { const StringValue* string_value; value.GetAsString(&string_value); AppendString(string_value->GetString()); } break; case base::Value::TYPE_DICTIONARY: { const DictionaryValue* dict_value; value.GetAsDictionary(&dict_value); BeginDictionary(); for (DictionaryValue::Iterator it(*dict_value); !it.IsAtEnd(); it.Advance()) { SetBaseValueWithCopiedName(it.key(), it.value()); } EndDictionary(); } break; case base::Value::TYPE_LIST: { const ListValue* list_value; value.GetAsList(&list_value); BeginArray(); for (const auto& base_value : *list_value) AppendBaseValue(*base_value); EndArray(); } break; } } std::unique_ptr<base::Value> TracedValue::ToBaseValue() const { std::unique_ptr<DictionaryValue> root(new DictionaryValue); DictionaryValue* cur_dict = root.get(); ListValue* cur_list = nullptr; std::vector<Value*> stack; PickleIterator it(pickle_); const char* type; while (it.ReadBytes(&type, 1)) { DCHECK((cur_dict && !cur_list) || (cur_list && !cur_dict)); switch (*type) { case kTypeStartDict: { auto* new_dict = new DictionaryValue(); if (cur_dict) { cur_dict->SetWithoutPathExpansion(ReadKeyName(it), WrapUnique(new_dict)); stack.push_back(cur_dict); cur_dict = new_dict; } else { cur_list->Append(WrapUnique(new_dict)); stack.push_back(cur_list); cur_list = nullptr; cur_dict = new_dict; } } break; case kTypeEndArray: case kTypeEndDict: { if (stack.back()->GetAsDictionary(&cur_dict)) { cur_list = nullptr; } else if (stack.back()->GetAsList(&cur_list)) { cur_dict = nullptr; } stack.pop_back(); } break; case kTypeStartArray: { auto* new_list = new ListValue(); if (cur_dict) { cur_dict->SetWithoutPathExpansion(ReadKeyName(it), WrapUnique(new_list)); stack.push_back(cur_dict); cur_dict = nullptr; cur_list = new_list; } else { cur_list->Append(WrapUnique(new_list)); stack.push_back(cur_list); cur_list = new_list; } } break; case kTypeBool: { bool value; CHECK(it.ReadBool(&value)); if (cur_dict) { cur_dict->SetBooleanWithoutPathExpansion(ReadKeyName(it), value); } else { cur_list->AppendBoolean(value); } } break; case kTypeInt: { int value; CHECK(it.ReadInt(&value)); if (cur_dict) { cur_dict->SetIntegerWithoutPathExpansion(ReadKeyName(it), value); } else { cur_list->AppendInteger(value); } } break; case kTypeDouble: { double value; CHECK(it.ReadDouble(&value)); if (cur_dict) { cur_dict->SetDoubleWithoutPathExpansion(ReadKeyName(it), value); } else { cur_list->AppendDouble(value); } } break; case kTypeString: { std::string value; CHECK(it.ReadString(&value)); if (cur_dict) { cur_dict->SetStringWithoutPathExpansion(ReadKeyName(it), value); } else { cur_list->AppendString(value); } } break; default: NOTREACHED(); } } DCHECK(stack.empty()); return std::move(root); } void TracedValue::AppendAsTraceFormat(std::string* out) const { DCHECK_CURRENT_CONTAINER_IS(kStackTypeDict); DCHECK_CONTAINER_STACK_DEPTH_EQ(1u); // TODO(primiano): this could be smarter, skip the ToBaseValue encoding and // produce the JSON on its own. This will require refactoring JSONWriter // to decouple the base::Value traversal from the JSON writing bits std::string tmp; JSONWriter::Write(*ToBaseValue(), &tmp); *out += tmp; } void TracedValue::EstimateTraceMemoryOverhead( TraceEventMemoryOverhead* overhead) { overhead->Add("TracedValue", /* allocated size */ pickle_.GetTotalAllocatedSize(), /* resident size */ pickle_.size()); } } // namespace trace_event } // namespace base