xpcom/components/nsIComponentManager.idl

Tue, 06 Jan 2015 21:39:09 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Tue, 06 Jan 2015 21:39:09 +0100
branch
TOR_BUG_9701
changeset 8
97036ab72558
permissions
-rw-r--r--

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.

michael@0 1 /* -*- Mode: IDL; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
michael@0 2 /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0 3 * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0 4 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0 5
michael@0 6 /**
michael@0 7 * The nsIComponentManager interface.
michael@0 8 */
michael@0 9
michael@0 10 #include "nsISupports.idl"
michael@0 11
michael@0 12 interface nsIFile;
michael@0 13 interface nsIFactory;
michael@0 14 interface nsIArray;
michael@0 15
michael@0 16 [scriptable, uuid(d604ffc3-1ba3-4f6c-b65f-1ed4199364c3)]
michael@0 17 interface nsIComponentManager : nsISupports
michael@0 18 {
michael@0 19 /**
michael@0 20 * getClassObject
michael@0 21 *
michael@0 22 * Returns the factory object that can be used to create instances of
michael@0 23 * CID aClass
michael@0 24 *
michael@0 25 * @param aClass The classid of the factory that is being requested
michael@0 26 */
michael@0 27 void getClassObject(in nsCIDRef aClass,
michael@0 28 in nsIIDRef aIID,
michael@0 29 [iid_is(aIID),retval] out nsQIResult result);
michael@0 30
michael@0 31 /**
michael@0 32 * getClassObjectByContractID
michael@0 33 *
michael@0 34 * Returns the factory object that can be used to create instances of
michael@0 35 * CID aClass
michael@0 36 *
michael@0 37 * @param aClass The classid of the factory that is being requested
michael@0 38 */
michael@0 39 void getClassObjectByContractID(in string aContractID,
michael@0 40 in nsIIDRef aIID,
michael@0 41 [iid_is(aIID),retval] out nsQIResult result);
michael@0 42
michael@0 43
michael@0 44 /**
michael@0 45 * createInstance
michael@0 46 *
michael@0 47 * Create an instance of the CID aClass and return the interface aIID.
michael@0 48 *
michael@0 49 * @param aClass : ClassID of object instance requested
michael@0 50 * @param aDelegate : Used for aggregation
michael@0 51 * @param aIID : IID of interface requested
michael@0 52 */
michael@0 53 void createInstance(in nsCIDRef aClass,
michael@0 54 in nsISupports aDelegate,
michael@0 55 in nsIIDRef aIID,
michael@0 56 [iid_is(aIID),retval] out nsQIResult result);
michael@0 57
michael@0 58 /**
michael@0 59 * createInstanceByContractID
michael@0 60 *
michael@0 61 * Create an instance of the CID that implements aContractID and return the
michael@0 62 * interface aIID.
michael@0 63 *
michael@0 64 * @param aContractID : aContractID of object instance requested
michael@0 65 * @param aDelegate : Used for aggregation
michael@0 66 * @param aIID : IID of interface requested
michael@0 67 */
michael@0 68 void createInstanceByContractID(in string aContractID,
michael@0 69 in nsISupports aDelegate,
michael@0 70 in nsIIDRef aIID,
michael@0 71 [iid_is(aIID),retval] out nsQIResult result);
michael@0 72
michael@0 73 /**
michael@0 74 * addBootstrappedManifestLocation
michael@0 75 *
michael@0 76 * Adds a bootstrapped manifest location on runtime.
michael@0 77 *
michael@0 78 * @param aLocation : A directory where chrome.manifest resides,
michael@0 79 * or an XPI with it on the root.
michael@0 80 */
michael@0 81 void addBootstrappedManifestLocation(in nsIFile aLocation);
michael@0 82
michael@0 83 /**
michael@0 84 * removeBootstrappedManifestLocation
michael@0 85 *
michael@0 86 * Removes a bootstrapped manifest location on runtime.
michael@0 87 *
michael@0 88 * @param aLocation : A directory where chrome.manifest resides,
michael@0 89 * or an XPI with it on the root.
michael@0 90 */
michael@0 91 void removeBootstrappedManifestLocation(in nsIFile aLocation);
michael@0 92
michael@0 93 /**
michael@0 94 * getManifestLocations
michael@0 95 *
michael@0 96 * Get an array of nsIURIs of all registered and builtin manifest locations.
michael@0 97 */
michael@0 98 nsIArray getManifestLocations();
michael@0 99 };
michael@0 100
michael@0 101
michael@0 102 %{ C++
michael@0 103 #ifdef MOZILLA_INTERNAL_API
michael@0 104 #include "nsComponentManagerUtils.h"
michael@0 105 #endif
michael@0 106 %} C++

mercurial