summaryrefslogtreecommitdiffstats
path: root/docs/nspr/reference/prthreadtype.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/nspr/reference/prthreadtype.rst')
-rw-r--r--docs/nspr/reference/prthreadtype.rst40
1 files changed, 40 insertions, 0 deletions
diff --git a/docs/nspr/reference/prthreadtype.rst b/docs/nspr/reference/prthreadtype.rst
new file mode 100644
index 0000000000..4934af7a2f
--- /dev/null
+++ b/docs/nspr/reference/prthreadtype.rst
@@ -0,0 +1,40 @@
+PRThreadType
+============
+
+The type of an NSPR thread, specified as a parameter to
+:ref:`PR_CreateThread`.
+
+
+Syntax
+------
+
+.. code::
+
+ #include <prthread.h>
+
+ typedef enum PRThreadType {
+ PR_USER_THREAD,
+ PR_SYSTEM_THREAD
+ } PRThreadType;
+
+
+Enumerators
+~~~~~~~~~~~
+
+``PR_USER_THREAD``
+ :ref:`PR_Cleanup` blocks until the last thread of type
+ ``PR_USER_THREAD`` terminates.
+``PR_SYSTEM_THREAD``
+ NSPR ignores threads of type ``PR_SYSTEM_THREAD`` when determining
+ when a call to :ref:`PR_Cleanup` should return.
+
+
+Description
+-----------
+
+Threads can be either user threads or system threads. NSPR allows the
+client to synchronize the termination of all user threads and ignores
+those created as system threads. This arrangement implies that a system
+thread should not have volatile data that needs to be safely stored
+away. The applicability of system threads is somewhat dubious;
+therefore, they should be used with caution.