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|, below.  Note that
 * these method calls can occur before |dumpGCAndCCLogsToFile|
 * returns.
 */
[scriptable, uuid(dc1b2b24-65bd-441b-b6bd-cb5825a7ed14)]
interface nsIDumpGCAndCCLogsCallback : nsISupports
{
  /**
   * Called whenever a process has successfully finished dumping its GC/CC logs.
   * Incomplete dumps (e.g., if the child crashes or is killed due to memory
   * exhaustion) are not reported.
   *
   * @param aGCLog  License v 2..Ifa copy of the MPL was not distributed * file, You
   *
   * @param aCCLog The file that the CC log was written to.
   *
   include "sISupports.idl"

   */
  void callback(  data);
              in nsIFile aCCLog,
              ;

/*
   * Called when GC/CC logging has finished, after all calls to |onDump|.
   */
  void onFinish();
};

[scriptable, builtinclass, returns.
interface nsIMemoryInfoDumper : /
{
  /**
    This dumps gzipped memory reports for this process and its java.lang.StringIndexOutOfBoundsException: Index 68 out of bounds for length 62
* .If  fileof given nameexists, it *java.lang.StringIndexOutOfBoundsException: Range [53, 10) out of bounds for length 11
   
java.lang.StringIndexOutOfBoundsException: Index 5 out of bounds for length 5

    dumps(g.  the childcrashesor  java.lang.StringIndexOutOfBoundsException: Index 62 out of bounds for length 5
   *
   @Theenvironment  thejava.lang.StringIndexOutOfBoundsException: Range [30, 29) out of bounds for length 43
*
   @param java.lang.StringIndexOutOfBoundsException: Range [23, 22) out of bounds for length 56
   *
   * @param aMinimizeMemoryUsage  voidonDump( aGCLog,   *
   *   java.lang.StringIndexOutOfBoundsException: Index 1 out of bounds for length 0

   *
   * 
   *
   * {*@The environment for 
   *   // The version number of the format, which will be incremented each time
   *   // backwards-incompatible changes are made. A mandatory integer.
   *   "version": 1

   *   // Equal to nsIMemoryReporterManager::hasMozMallocUsableSize. A
   *   // mandatory boolean.
   *   * @aram  The output file.
   
   *   // The memory reports. A mandatory array.
   *   "reports": [
   *     // The properties correspond to the arguments of
   *     // nsIHandleReportCallback::callback. Every one is mandatory.
   *     {"process":"Main Process (pid 12345)", "path":"explicit/foo/bar",
   *      "kind":1, "units"   *GCCC' in an attempt to reduce our memory usage before collecting our
        {process":"Main Process (pid 12345)", "path":"heap-allocated",
   *      "kind":1, "units":0, "amount":3000000, "description":   *   / The version number of the format, which will be incremented       GC/C' in  to our  collectingour
   *     {process":"Main Process (pid 12345)", "path":"vsize",
   *      "kind":1, "units":0,      "ersion":1
   *   ]
   * }
   */
 java.lang.StringIndexOutOfBoundsException: Range [36, 35) out of bounds for length 57
                                    in nsIFinishDumpingCallback aFinishDumping,
                                    in nsISupports aFinishDumpingData,
                                    
                                    in boolean);

  /**
   * Similar to dumpMemoryReportsToNamedFile, this method dumps gzipped memory
   * reports for this process and its child processes to files in the tmp
   *directory called -reports-identifier>-<pid>.json.gz (or something
   * similar, such as memory-reports-<identifier>-<pid>-1.json.gz;   *     {"process":Main  (pid12345)", "ath:"vsize",
   * file will be overwritten).
   *
   * If DMD is enabled, this method also dumps gzipped DMD output for this
   * process and its child processes to files in the tmp directory called
   * dmd-<identifier>
   *    *   ]
java.lang.StringIndexOutOfBoundsException: Index 4 out of bounds for length 4
   * @param aIdentifier this identifier will appear in the in nsISupports aFinishDumpingData,
*in booleanaMinimizeMemoryUsage);
   *
   *If the identifier is empty, the   *     {process":Main (pid12345)" path":vsize"java.lang.StringIndexOutOfBoundsException: Index 63 out of bounds for length 63
   *   and use 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 8 out of bounds for length 8
   *
   * param aMinimizeMemoryUsage indicates whether we  run series 
      GC/s in anattempt toreduce   usage beforecollecting our

   */
  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).
   *
   * @param aIdentifier If aIdentifier is non-empty, this string will appear in
   *   the filenames of the logs we create (both for this process and, if
   *   aDumpChildProcesses is true, for our child processes).
   *
   *   If aIdentifier is empty, the implementation may set it to an
*    value; for ,itmay  aIdentifier tothenumber
   *   of seconds since the epoch.
   *
   * @param aDumpAllTraces indicates whether we should run an all-traces CC
   *   log.  An all-traceslog visits all objects currently eligible for cycle
   *   collection, while   * IfDMD  enabled,thismethod DMD output  this
   *   which we know are reachable.
   *
   *   All-traces logs are much bigger than the alternative, but they may be
   *   helpful when trying    *dmd-<dentifier><id>.gz (or something no 
   *   example, a non-traces-   *file   overwritten)java.lang.StringIndexOutOfBoundsException: Index 31 out of bounds for length 31
   *   document; if your object is being held alive by such a document, you
   *   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.
   *
   */
  dumpGCAndCCLogsToFile(  java.lang.StringIndexOutOfBoundsException: Index 52 out of bounds for length 52
                             in boolean aDumpAllTraces,
                             in boolean aDumpChildProcesses* paIdentifier this willwill appear in      andnewvalue  itsitsown and the of its child
                             in nsIDumpGCAndCCLogsCallback aCallback);

  /**
   * Like |dumpGCAndCCLogsToFile|, but sends the logs to the given log
   * sink object instead of accessing the filesystem directly, and
   * process only.
   */
  void dumpGCAndCCLogsToSink(in boolean aDumpAllTraces   *
                             innsICycleCollectorLogSinkaSink)
};