Adding support for storing webrtc logs locally with an extension supplied unique id, for later uplo…

chrome/common/extensions/api/webrtc_logging_private.idl

 // Copyright 2013 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.
 
 // Use the <code>chrome.webrtcLoggingPrivate</code> API to control diagnostic
 // WebRTC logging.
 namespace webrtcLoggingPrivate {
   dictionary MetaDataEntry {
     // The meta data entry key.
     DOMString key;
@@ skipping 49 matching lines @@
                                        DOMString securityOrigin,
                                        boolean shouldUpload);
 
     // Stops logging. After stop has finished, either upload() or discard()
     // should be called, otherwise the log will be kept in memory until the
     // render process is closed or logging restarted.
     static void stop(RequestInfo request,
                      DOMString securityOrigin,
                      GenericDoneCallback callback);
 
+    // Stores the current log without uploading. The log may stay around for
+    // as much as 5 days. The application has the option of supplying an id
+    // for uniquely identifying the log for later upload via a call to
+    // uploadStored().
+    static void store(RequestInfo request,
+                      DOMString securityOrigin,
+                      DOMString logId,
+                      GenericDoneCallback callback);
+
+    // Uploads a previously kept log that was stored via a call to store().
+    // The caller needs to know the logId as was originally provided in the
+    // call to store().
+    static void uploadStored(RequestInfo request,
+                             DOMString securityOrigin,
+                             DOMString logId,
+                             UploadDoneCallback callback);
+
     // Uploads the log and the RTP dumps, if they exist. Logging and RTP dumping
     // must be stopped before this function is called.
     static void upload(RequestInfo request,
                        DOMString securityOrigin,
                        UploadDoneCallback callback);
 
     // Discards the log. Logging must be stopped before this function is called.
     static void discard(RequestInfo request,
                         DOMString securityOrigin,
                         GenericDoneCallback callback);
 
     // Starts RTP dumping. If it has already been started for this render
     // process, the call will be ignored.
     static void startRtpDump(RequestInfo request,
                              DOMString securityOrigin,
                              boolean incoming,
                              boolean outgoing,
                              GenericDoneCallback callback);
 
     // Stops RTP dumping. After stop has finished, the dumps will be
     // uploaded with the log if upload is called. Otherwise, the dumps will be
     // discarded.
     static void stopRtpDump(RequestInfo request,
                             DOMString securityOrigin,
                             boolean incoming,
                             boolean outgoing,
                             GenericDoneCallback callback);
   };
 };