1 # This file is ingested by `ThreadAllows.py` to produce a list of thread names
2 # which our clang plugin will allow to be used with `NS_NewNamedThread`.
4 # Permitted thread names are a maximum of 15 characters in length, and must be
5 # string literals at their point-of-use in the code -- i.e., in the invocation
6 # of `NS_NewNamedThread`.
8 # Within this file, each permitted thread name is on a separate line. Comments
9 # begin with `#`, as seen here. Leading and trailing whitespace, trailing
10 # comments, and blank lines are ignored, and may be used freely.
12 # Please explain the addition of any new thread names in comments, preferably
13 # with a pointer to a relevant bug. (Do not add thread names only used in tests
14 # to this file; instead, add the test file to `ThreadFileAllows.txt`.)
17 # Gecko/Firefox thread names
18 # (See also "Unsorted thread names", below.)
20 # Used by `nsUpdateProcessor` to check for updates. May also be used for polling
25 # Thunderbird-only thread names
30 Checker Test # used only as part of tests for the thread-checker itself
31 Testing Thread # used only as part of tests for toolkit/components/url-classifier/tests/gtest/
34 # Unsorted thread names
36 # Thread names below this point are grandfathered in. Please do not add new
37 # thread names to this list -- and please remove any that you can, whether by
38 # documenting and moving them or by confirming that they are no longer required.
40 # In particular, if a thread name is only used for testing, please consider
41 # moving its declarator to `ThreadFileAllows.txt`.