mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-10-13 21:35:39 +00:00
8924022f9d
The point of this exercise is to make the thread name available in the thread func of the thread, so that we can register the thread with the profiler from the very start of its lifetime, and so that registration and unregistration can be inside the same function. MozReview-Commit-ID: DiiMKUQVr55 --HG-- extra : rebase_source : 24b15d56315ad49e72b3e9b76db7fb634f3bfe01
83 lines
2.5 KiB
Plaintext
83 lines
2.5 KiB
Plaintext
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* vim:set ts=2 sw=2 sts=2 et cindent: */
|
|
/* 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"
|
|
|
|
[ptr] native PRThread(PRThread);
|
|
|
|
interface nsIThread;
|
|
|
|
/**
|
|
* An interface for creating and locating nsIThread instances.
|
|
*/
|
|
[scriptable, uuid(1be89eca-e2f7-453b-8d38-c11ba247f6f3)]
|
|
interface nsIThreadManager : nsISupports
|
|
{
|
|
/**
|
|
* Default number of bytes reserved for a thread's stack, if no stack size
|
|
* is specified in newThread(). 0 means use platform default.
|
|
*/
|
|
const unsigned long DEFAULT_STACK_SIZE = 0;
|
|
|
|
/**
|
|
* Create a new thread (a global, user PRThread).
|
|
*
|
|
* @param creationFlags
|
|
* Reserved for future use. Pass 0.
|
|
* @param stackSize
|
|
* Number of bytes to reserve for the thread's stack.
|
|
*
|
|
* @returns
|
|
* The newly created nsIThread object.
|
|
*/
|
|
nsIThread newThread(in unsigned long creationFlags, [optional] in unsigned long stackSize);
|
|
|
|
/**
|
|
* Create a new thread (a global, user PRThread) with the specified name.
|
|
*
|
|
* @param name
|
|
* The name of the thread. Passing an empty name is equivalent to
|
|
* calling newThread(0, stackSize), i.e. the thread will not be named.
|
|
* @param stackSize
|
|
* Number of bytes to reserve for the thread's stack.
|
|
*
|
|
* @returns
|
|
* The newly created nsIThread object.
|
|
*/
|
|
[noscript] nsIThread newNamedThread(in ACString name, [optional] in unsigned long stackSize);
|
|
|
|
/**
|
|
* Get the nsIThread object (if any) corresponding to the given PRThread.
|
|
* This method returns null if there is no corresponding nsIThread.
|
|
*
|
|
* @param prthread
|
|
* The PRThread of the nsIThread being requested.
|
|
*
|
|
* @returns
|
|
* The nsIThread object corresponding to the given PRThread or null if no
|
|
* such nsIThread exists.
|
|
*/
|
|
[noscript] nsIThread getThreadFromPRThread(in PRThread prthread);
|
|
|
|
/**
|
|
* Get the main thread.
|
|
*/
|
|
readonly attribute nsIThread mainThread;
|
|
|
|
/**
|
|
* Get the current thread. If the calling thread does not already have a
|
|
* nsIThread associated with it, then a new nsIThread will be created and
|
|
* associated with the current PRThread.
|
|
*/
|
|
readonly attribute nsIThread currentThread;
|
|
|
|
/**
|
|
* This attribute is true if the calling thread is the main thread of the
|
|
* application process.
|
|
*/
|
|
readonly attribute boolean isMainThread;
|
|
};
|