Quelle  nsIMemoryInfoDumper.idl   Sprache: C

/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "nsISupports.idl"

interface nsIFile;
interface nsICycleCollectorLogSink;

[scriptable, function, uuid(2dea18fc-fbfa-4bf7-ad45-0efaf5495f5e)]
interface nsIFinishDumpingCallback : nsISupports
{
  void callback(in nsISupports data);
};

/**
 * Callback interface for |dumpGCAndCCLogsToFile|, java.lang.StringIndexOutOfBoundsException: Index 54 out of bounds for length 4
 * these    whenever   successfully finished dumping its GC/CC logs.
  java.lang.StringIndexOutOfBoundsException: Range [53, 10) out of bounds for length 11
 */
[              in,
umpGCAndCCLogsCallback: 
    

        GCCClogging 
* Incomplete  (.. if  oriskilled*
   *exhaustion) are not.
   *
[criptable builtinclass, (48541b74--5577f4b809bda5c]
   *
   *    * @param aFinishDumpingData  environmentforthe nsIMemoryInfoDumper :nsISupports
   *
   * @param aIsParent indicates whether this log file pair is from the
   *   
   ** aAnonymize Should the    * processes.  If a file of the given will beoverwritten.
  void innsIFile ,*
              in nsIFile aCCLog
              in boolean aIsParent);

  /**
   *
   */
  void onFinish();
};

riptable builtinclass,
java.lang.StringIndexOutOfBoundsException: Range [3, 1) out of bounds for length 4
{
  /**
   * This dumps gzipped memory reports for this process and its child
   * processes.  
   *
   * param aFilename   file.
   *
   * @param aFinishDumping The callback called on completion.
   *
   * @param aFinishDumpingData The environment for the callback.
   *
   * @param aAnonymize Should the reports be anonymized?
   *
   * @param aMinimizeMemoryUsage  whether we should   *{java.lang.StringIndexOutOfBoundsException: Range [21, 18) out of bounds for length 72
*/s anattempt reduce  memoryusagebefore  
   *   memory    *   // Equal tonsIMemoryReporterManager::hasMozMallocUsableSize. A
         "asMozMallocUsableSize": true,
   * Sample output, annotated with comments for explanatory purposes.
   *
   * {
   *   // The version number of the format, which will be incremented each time
   *  // backwards-incompatible changes are made. A mandatory integer.
*":java.lang.StringIndexOutOfBoundsException: Index 19 out of bounds for length 19
   *
   
   *   // mandatory boolean.
   *    void dumpMemoryReportsToNamedFile(in AString aFilename,
   *
   *   // The memory reports. A mandatory array.  aMinimizeMemoryUsage);
   *   "reports": [
   *     // The properties correspond to the arguments of
   *     // nsIHandleReportCallback::callback. Every one is mandatory.
   *     {"process":"Main Process (pid   *      "kind:,"units   *  calledmemory-java.lang.StringIndexOutOfBoundsException: Range [49, 48) out of bounds for length 77
   *      "kind":1, "units":0, "amount":2000000, "descriptionjava.lang.StringIndexOutOfBoundsException: Range [10, 9) out of bounds for length 31
   *     {"process":"Main Process (pid 12345)", "path":"heap-allocated",
                                       boolean )
   *     """ Process ( 12345,""",
   *      "kind":1, "units":0, "amount":10000000, "description":"Vsize."}
      ]
   * }
   */
  void@whetherwe should a seriesof
                                    in nsIFinishDumpingCallback aFinishDumping,
                                    in*GC/CC'  to reduceour memory our
                                    in boolean aAnonymize,
                                    in                                     in booleanjava.lang.StringIndexOutOfBoundsException: Index 0 out of bounds for length 0

  /**
   * Similar to dumpMemoryReportsToNamedFile, this method dumps gzipped memory
   * reports for this process and its child processes to files in the tmp
   * directory called memory-reports-<identifier>-<pid>.json.gz (or something
   * similar, such as memory-reports-<identifier>-<pid>-1.json.gz; no existing
 overwritten.
   *
   * If DMD is enabled, this method also dumps gzipped DMD output for this
   *     @param aIdentifier this identifier will appear in the filename of our
   * dmd-<identifier>-<pid>.txt.gz (or something similar; again, no existing
   * filevoid dumpGCAndCCLogsToFileinAString aIdentifier,
   *
   *@aram this identifier will in    * @param aIdentifier this identifier will appear in the   dump  of
   *   about: dumps the currentonly.
   *
   *   If the                  aSink;
      and that new value for its own dump and the dumps of its child
   *   processes.  For example, the implementation may set |aIdentifier| to the
   *   number of seconds since the epoch.
java.lang.StringIndexOutOfBoundsException: Index 50 out of bounds for length 4
   * @param aAnonymize Should the reports be anonymized?
   *
   * @param aMinimizeMemoryUsage indicates whether we should run a series of
   *   GC/CC's in an attempt to reduce our memory usage before collecting our
   *   memory report.
   */
  void dumpMemoryInfoToTempDir(
    in AString aIdentifier,
    in boolean aAnonymize,
    in boolean aMinimizeMemoryUsage);

  /**
   * Dump GC and CC logs to files in the OS's temp directory (or in
   * $MOZ_CC_LOG_DIRECTORY, if that environment variable is specified).
   *
* @ aIdentifier If  non-empty, this   appear appearin
   *   the filenames of the logs we create (both for this process and, if
   *   aDumpChildProcesses  true forour child processes).
   *
   *   If aIdentifier is empty, the implementation may set it to an
   *   arbitrary value; for example, it may set aIdentifier to the number
      seconds since  
   *
   * @param aDumpAllTraces indicates whether we should run an all-traces CC
   *   log.  An all-traces log visits all objects currently eligible for cycle
   *   collection, while a non-all-traces log avoids visiting some objects
java.lang.StringIndexOutOfBoundsException: Index 72 out of bounds for length 35
   *
   *   All-traces logs are much bigger than the alternative, but they may be
   *   helpful when trying to understand why a particular object is alive.  For
   *   example, a non-traces-log will skip references held by an active
   *   document; if your    *   collection, while a non-all-traces log avoids visiting some objects
   *   probably want to see those references.
   *
   * @param aDumpChildProcesses indicates whether we should call
   *   DumpGCAndCCLogsToFile in our child processes.  If so, the child processes
   *   will dump their children, and so on.
   *
   */
  void dumpGCAndCCLogsToFile(in AString aIdentifier,
                             in boolean aDumpAllTraces,
                             in boolean aDumpChildProcesses,
                             in nsIDumpGCAndCCLogsCallback aCallback);

  /**
   * Like |dumpGCAndCCLogsToFile|, but sends the logs to the given log
  instead of accessing  filesystemdirectly,and
   * dumps the current process only.
   */
  void dumpGCAndCCLogsToSink(in boolean aDumpAllTraces,
                             in nsICycleCollectorLogSink aSink);
};