1 // Copyright (c) 2009 The Chromium Authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style license that can be 3 // found in the LICENSE file. 4 // 5 // Implementation of a Windows event trace controller class. 6 #include "base/win/event_trace_controller.h" 7 #include "base/logging.h" 8 9 namespace base { 10 namespace win { 11 12 EtwTraceProperties::EtwTraceProperties() { 13 memset(buffer_, 0, sizeof(buffer_)); 14 EVENT_TRACE_PROPERTIES* prop = get(); 15 16 prop->Wnode.BufferSize = sizeof(buffer_); 17 prop->Wnode.Flags = WNODE_FLAG_TRACED_GUID; 18 prop->LoggerNameOffset = sizeof(EVENT_TRACE_PROPERTIES); 19 prop->LogFileNameOffset = sizeof(EVENT_TRACE_PROPERTIES) + 20 sizeof(wchar_t) * kMaxStringLen; 21 } 22 23 HRESULT EtwTraceProperties::SetLoggerName(const wchar_t* logger_name) { 24 size_t len = wcslen(logger_name) + 1; 25 if (kMaxStringLen < len) 26 return E_INVALIDARG; 27 28 memcpy(buffer_ + get()->LoggerNameOffset, 29 logger_name, 30 sizeof(wchar_t) * len); 31 return S_OK; 32 } 33 34 HRESULT EtwTraceProperties::SetLoggerFileName(const wchar_t* logger_file_name) { 35 size_t len = wcslen(logger_file_name) + 1; 36 if (kMaxStringLen < len) 37 return E_INVALIDARG; 38 39 memcpy(buffer_ + get()->LogFileNameOffset, 40 logger_file_name, 41 sizeof(wchar_t) * len); 42 return S_OK; 43 } 44 45 EtwTraceController::EtwTraceController() : session_(NULL) { 46 } 47 48 EtwTraceController::~EtwTraceController() { 49 Stop(NULL); 50 } 51 52 HRESULT EtwTraceController::Start(const wchar_t* session_name, 53 EtwTraceProperties* prop) { 54 DCHECK(NULL == session_ && session_name_.empty()); 55 EtwTraceProperties ignore; 56 if (prop == NULL) 57 prop = &ignore; 58 59 HRESULT hr = Start(session_name, prop, &session_); 60 if (SUCCEEDED(hr)) 61 session_name_ = session_name; 62 63 return hr; 64 } 65 66 HRESULT EtwTraceController::StartFileSession(const wchar_t* session_name, 67 const wchar_t* logfile_path, bool realtime) { 68 DCHECK(NULL == session_ && session_name_.empty()); 69 70 EtwTraceProperties prop; 71 prop.SetLoggerFileName(logfile_path); 72 EVENT_TRACE_PROPERTIES& p = *prop.get(); 73 p.Wnode.ClientContext = 1; // QPC timer accuracy. 74 p.LogFileMode = EVENT_TRACE_FILE_MODE_SEQUENTIAL; // Sequential log. 75 if (realtime) 76 p.LogFileMode |= EVENT_TRACE_REAL_TIME_MODE; 77 78 p.MaximumFileSize = 100; // 100M file size. 79 p.FlushTimer = 30; // 30 seconds flush lag. 80 return Start(session_name, &prop); 81 } 82 83 HRESULT EtwTraceController::StartRealtimeSession(const wchar_t* session_name, 84 size_t buffer_size) { 85 DCHECK(NULL == session_ && session_name_.empty()); 86 EtwTraceProperties prop; 87 EVENT_TRACE_PROPERTIES& p = *prop.get(); 88 p.LogFileMode = EVENT_TRACE_REAL_TIME_MODE | EVENT_TRACE_USE_PAGED_MEMORY; 89 p.FlushTimer = 1; // flush every second. 90 p.BufferSize = 16; // 16 K buffers. 91 p.LogFileNameOffset = 0; 92 return Start(session_name, &prop); 93 } 94 95 HRESULT EtwTraceController::EnableProvider(REFGUID provider, UCHAR level, 96 ULONG flags) { 97 ULONG error = ::EnableTrace(TRUE, flags, level, &provider, session_); 98 return HRESULT_FROM_WIN32(error); 99 } 100 101 HRESULT EtwTraceController::DisableProvider(REFGUID provider) { 102 ULONG error = ::EnableTrace(FALSE, 0, 0, &provider, session_); 103 return HRESULT_FROM_WIN32(error); 104 } 105 106 HRESULT EtwTraceController::Stop(EtwTraceProperties* properties) { 107 EtwTraceProperties ignore; 108 if (properties == NULL) 109 properties = &ignore; 110 111 ULONG error = ::ControlTrace(session_, NULL, properties->get(), 112 EVENT_TRACE_CONTROL_STOP); 113 if (ERROR_SUCCESS != error) 114 return HRESULT_FROM_WIN32(error); 115 116 session_ = NULL; 117 session_name_.clear(); 118 return S_OK; 119 } 120 121 HRESULT EtwTraceController::Flush(EtwTraceProperties* properties) { 122 EtwTraceProperties ignore; 123 if (properties == NULL) 124 properties = &ignore; 125 126 ULONG error = ::ControlTrace(session_, NULL, properties->get(), 127 EVENT_TRACE_CONTROL_FLUSH); 128 if (ERROR_SUCCESS != error) 129 return HRESULT_FROM_WIN32(error); 130 131 return S_OK; 132 } 133 134 HRESULT EtwTraceController::Start(const wchar_t* session_name, 135 EtwTraceProperties* properties, TRACEHANDLE* session_handle) { 136 DCHECK(properties != NULL); 137 ULONG err = ::StartTrace(session_handle, session_name, properties->get()); 138 return HRESULT_FROM_WIN32(err); 139 } 140 141 HRESULT EtwTraceController::Query(const wchar_t* session_name, 142 EtwTraceProperties* properties) { 143 ULONG err = ::ControlTrace(NULL, session_name, properties->get(), 144 EVENT_TRACE_CONTROL_QUERY); 145 return HRESULT_FROM_WIN32(err); 146 }; 147 148 HRESULT EtwTraceController::Update(const wchar_t* session_name, 149 EtwTraceProperties* properties) { 150 DCHECK(properties != NULL); 151 ULONG err = ::ControlTrace(NULL, session_name, properties->get(), 152 EVENT_TRACE_CONTROL_UPDATE); 153 return HRESULT_FROM_WIN32(err); 154 } 155 156 HRESULT EtwTraceController::Stop(const wchar_t* session_name, 157 EtwTraceProperties* properties) { 158 DCHECK(properties != NULL); 159 ULONG err = ::ControlTrace(NULL, session_name, properties->get(), 160 EVENT_TRACE_CONTROL_STOP); 161 return HRESULT_FROM_WIN32(err); 162 } 163 164 HRESULT EtwTraceController::Flush(const wchar_t* session_name, 165 EtwTraceProperties* properties) { 166 DCHECK(properties != NULL); 167 ULONG err = ::ControlTrace(NULL, session_name, properties->get(), 168 EVENT_TRACE_CONTROL_FLUSH); 169 return HRESULT_FROM_WIN32(err); 170 } 171 172 } // namespace win 173 } // namespace base 174