The Tor Browser: xpcom/io/nsIObjectInputStream.idl@97036ab72558

Conditionally force memory storage according to privacy.thirdparty.isolate;
This solves Tor bug #9701, complying with disk avoidance documented in
https://www.torproject.org/projects/torbrowser/design/#disk-avoidance.

     1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */

     2 /* This Source Code Form is subject to the terms of the Mozilla Public

     3  * License, v. 2.0. If a copy of the MPL was not distributed with this

     4  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

     6 #include "nsIBinaryInputStream.idl"

     8 /**

     9  * @see nsIObjectOutputStream

    10  * @see nsIBinaryInputStream

    11  */

    13 [scriptable, uuid(6c248606-4eae-46fa-9df0-ba58502368eb)]

    14 interface nsIObjectInputStream : nsIBinaryInputStream

    15 {

    16     /**

    17      * Read an object from this stream to satisfy a strong or weak reference

    18      * to one of its interfaces.  If the interface was not along the primary

    19      * inheritance chain ending in the "root" or XPCOM-identity nsISupports,

    20      * readObject will QueryInterface from the deserialized object root to the

    21      * correct interface, which was specified when the object was serialized.

    22      *

    23      * @see nsIObjectOutputStream

    24      */

    25     nsISupports readObject(in boolean aIsStrongRef);

    27     [notxpcom] nsresult readID(out nsID aID);

    29     /**

    30      * Optimized deserialization support -- see nsIStreamBufferAccess.idl.

    31      */

    32     [notxpcom] charPtr getBuffer(in uint32_t aLength, in uint32_t aAlignMask);

    33     [notxpcom] void    putBuffer(in charPtr aBuffer, in uint32_t aLength);

    34 };

    36 %{C++

    38 inline nsresult

    39 NS_ReadOptionalObject(nsIObjectInputStream* aStream, bool aIsStrongRef,

    40                       nsISupports* *aResult)

    41 {

    42     bool nonnull;

    43     nsresult rv = aStream->ReadBoolean(&nonnull);

    44     if (NS_SUCCEEDED(rv)) {

    45         if (nonnull)

    46             rv = aStream->ReadObject(aIsStrongRef, aResult);

    47         else

    48             *aResult = nullptr;

    49     }

    50     return rv;

    51 }

    53 %}

The Tor Browser / file revision

xpcom/io/nsIObjectInputStream.idl@97036ab72558

xpcom/io/nsIObjectInputStream.idl