assumed to be executed serially, as is the case for C constructors.
registerGCFactory
fn
void registerGCFactory(string name, GCFactory factory,
GCThreadInitFunction threadInit = null) nothrow @nogcRegister a GC factory under the given name. This function must be called from a C constructor before druntime is initialized.
To use the registered GC, it's name must be specified gcopt runtime option, e.g. by passing , --DRT-gcopt=gc:my_gc_name as application argument.
The thread init function will be called only before the GC has been initialized to the registered GC. It is called as the first step in starting the new thread before the thread is registered with the runtime as a running thread. This allows any specific thread data that is needed for running the GC to be registered with the thread object.
After the GC is initialized, the GC interface function initThread is called instead. This function should expect the possibility that the reciprocal cleanupThread method may not be called if the GC is never initialized.
Parameters
name | name of the GC implementation; should be unique |
factory | function to instantiate the implementation |
threadInit | function to call from a new thread before registration in the list of running threads, to set up any GC-specific data. |
Note
The registry does not perform synchronization, as registration is