net/base/net_log_util.h

   1 // Copyright 2014 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 #ifndef NET_BASE_NET_LOG_UTIL_H_
   6 #define NET_BASE_NET_LOG_UTIL_H_
   7
   8 #include <set>
   9
  10 #include "base/memory/scoped_ptr.h"
  11 #include "net/base/net_export.h"
  12 #include "net/base/net_log.h"
  13
  14 namespace base {
  15 class DictionaryValue;
  16 class Value;
  17 }
  18
  19 namespace net {
  20
  21 class URLRequestContext;
  22
  23 // A set of flags that can be OR'd together to request specific information
  24 // about the current state of the URLRequestContext.  See GetNetInfo, below.
  25 enum NetInfoSource {
  26 #define NET_INFO_SOURCE(label, string, value) NET_INFO_ ## label = value,
  27 #include "net/base/net_info_source_list.h"
  28 #undef NET_INFO_SOURCE
  29   NET_INFO_ALL_SOURCES = -1,
  30 };
  31
  32 // Utility methods for creating NetLog dumps.
  33
  34 // Create a dictionary containing a legend for net/ constants.
  35 NET_EXPORT scoped_ptr<base::DictionaryValue> GetNetConstants();
  36
  37 // Retrieves a dictionary containing information about the current state of
  38 // |context|.  |info_sources| is a set of NetInfoSources OR'd together,
  39 // indicating just what information is being requested.  Each NetInfoSource adds
  40 // one top-level entry to the returned dictionary.
  41 //
  42 // May only be called on |context|'s thread.
  43 NET_EXPORT scoped_ptr<base::DictionaryValue> GetNetInfo(
  44     URLRequestContext* context, int info_sources);
  45
  46 // Takes in a set of contexts and a NetLog::Observer, and passes in
  47 // NetLog::Entries to the observer for certain NetLog::Sources with pending
  48 // events.  This allows requests that were ongoing when logging was started to
  49 // have an initial event that has some information.  This is particularly useful
  50 // for hung requests.  Note that these calls are not protected by the NetLog's
  51 // lock, so this should generally be invoked before the observer starts watching
  52 // the NetLog.
  53 //
  54 // All members of |contexts| must be using the same NetLog, and live on the
  55 // current thread.
  56 //
  57 // Currently only creates events for URLRequests.
  58 //
  59 // The reason for not returning a list of NetLog::Entries is that entries don't
  60 // own most of their data, so it's simplest just to pass them in to the observer
  61 // directly while their data is on the stack.
  62 NET_EXPORT void CreateNetLogEntriesForActiveObjects(
  63     const std::set<URLRequestContext*>& contexts,
  64     NetLog::ThreadSafeObserver* observer);
  65
  66 }  // namespace net
  67
  68 #endif  // NET_BASE_NET_LOG_UTIL_H_