1 // Copyright (c) 2011 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.
5 #ifndef IPC_IPC_LOGGING_H_
6 #define IPC_IPC_LOGGING_H_
9 #include "ipc/ipc_message.h" // For IPC_MESSAGE_LOG_ENABLED.
11 #ifdef IPC_MESSAGE_LOG_ENABLED
15 #include "base/hash_tables.h"
16 #include "base/memory/scoped_ptr.h"
17 #include "base/memory/singleton.h"
18 #include "base/message_loop.h"
19 #include "ipc/ipc_export.h"
21 // Logging function. |name| is a string in ASCII and |params| is a string in
23 typedef void (*LogFunction
)(std::string
* name
,
24 const IPC::Message
* msg
,
27 typedef base::hash_map
<uint32
, LogFunction
> LogFunctionMap
;
33 // One instance per process. Needs to be created on the main thread (the UI
34 // thread in the browser) but OnPreDispatchMessage/OnPostDispatchMessage
35 // can be called on other threads.
36 class IPC_EXPORT Logging
{
38 // Implemented by consumers of log messages.
41 virtual void Log(const LogData
& data
) = 0;
44 virtual ~Consumer() {}
47 void SetConsumer(Consumer
* consumer
);
50 static Logging
* GetInstance();
52 // Enable and Disable are NOT cross-process; they only affect the
53 // current thread/process. If you want to modify the value for all
54 // processes, perhaps your intent is to call
55 // g_browser_process->SetIPCLoggingEnabled().
58 bool Enabled() const { return enabled_
; }
60 // Called by child processes to give the logger object the channel to send
61 // logging data to the browser process.
62 void SetIPCSender(Message::Sender
* sender
);
64 // Called in the browser process when logging data from a child process is
66 void OnReceivedLoggingMessage(const Message
& message
);
68 void OnSendMessage(Message
* message
, const std::string
& channel_id
);
69 void OnPreDispatchMessage(const Message
& message
);
70 void OnPostDispatchMessage(const Message
& message
,
71 const std::string
& channel_id
);
73 // Like the *MsgLog functions declared for each message class, except this
74 // calls the correct one based on the message type automatically. Defined in
76 static void GetMessageText(uint32 type
, std::string
* name
,
77 const Message
* message
, std::string
* params
);
79 static void set_log_function_map(LogFunctionMap
* functions
) {
80 log_function_map_
= functions
;
83 static LogFunctionMap
* log_function_map() {
84 return log_function_map_
;
89 ANSI_COLOR_RESET
= -1,
99 const char* ANSIEscape(ANSIColor color
);
100 ANSIColor
DelayColor(double delay
);
102 friend struct DefaultSingletonTraits
<Logging
>;
106 void Log(const LogData
& data
);
109 bool enabled_on_stderr_
; // only used on POSIX for now
110 bool enabled_color_
; // only used on POSIX for now
112 std::vector
<LogData
> queued_logs_
;
113 bool queue_invoke_later_pending_
;
115 Message::Sender
* sender_
;
116 MessageLoop
* main_thread_
;
120 static LogFunctionMap
* log_function_map_
;
125 #endif // IPC_MESSAGE_LOG_ENABLED
127 #endif // IPC_IPC_LOGGING_H_