Process names, and predictable thread and process ordering in about:tracing

base/debug/trace_event_impl.h

Index: base/debug/trace_event_impl.h
diff --git a/base/debug/trace_event_impl.h b/base/debug/trace_event_impl.h
index a7ebaf2d4d155132f9c3f4e4bb70905e27f42c46..2dcbf6b8764eff6f5c0096ad55d25c472aee7512 100644
--- a/base/debug/trace_event_impl.h
+++ b/base/debug/trace_event_impl.h
@@ -451,6 +451,24 @@ class BASE_EXPORT TraceLog {
 
   void SetProcessID(int process_id);
 
+  // Process sort indices, if set, override the order of a process will appear
+  // relative to other processes in the trace viewer. Processes are sorted first
+  // on their sort index, ascending, then by their name, and then tid.
+  void SetProcessSortIndex(int sort_index);
+
+  // Sets the name of the process.
+  void SetProcessName(const std::string& current_label);

[dsinclair, 2013/06/21 14:22:51]

s/current_label/name/

[dsinclair, 2013/06/21 14:22:51]

Should probably mention that this string needs to live forever.

+
+  // Processes can have labels in addition to their names. Use labels, for
+  // instance, to list out the web page titles that a process is handling.
+  void UpdateProcessLabel(int label_id, const std::string& current_label);

[dsinclair, 2013/06/21 14:22:51]

Should probably mention living forever here as well.

+  void RemoveProcessLabel(int label_id);
+
+  // Thread sort indices, if set, override the order of a thread will appear
+  // within its process in the trace viewer. Threads are sorted first on their
+  // sort index, ascending, then by their name, and then tid.
+  void SetThreadSortIndex(PlatformThreadId , int sort_index);
+
   // Allow setting an offset between the current TimeTicks time and the time
   // that should be reported.
   void SetTimeOffset(TimeDelta offset);
@@ -509,7 +527,7 @@ class BASE_EXPORT TraceLog {
   TraceLog();
   ~TraceLog();
   const unsigned char* GetCategoryGroupEnabledInternal(const char* name);
-  void AddThreadNameMetadataEvents();
+  void AddMetadataEvents();
 
 #if defined(OS_ANDROID)
   void SendToATrace(char phase,
@@ -539,6 +557,11 @@ class BASE_EXPORT TraceLog {
   bool dispatching_to_observer_list_;
   std::vector<EnabledStateObserver*> enabled_state_observer_list_;
 
+  std::string process_name_;
+  base::hash_map<int, std::string> process_labels_;
+  int process_sort_index_;
+  base::hash_map<int, int> thread_sort_indices_;
+
   base::hash_map<int, std::string> thread_names_;
   base::hash_map<int, std::stack<TimeTicks> > thread_event_start_times_;
   base::hash_map<std::string, int> thread_colors_;