flint_malloc size

Allocate size bytes of memory.

flint_realloc ptr size

Reallocate an area of memory previously allocated by flint_malloc, flint_realloc, or flint_calloc.

flint_calloc num size

Allocate num objects of size bytes each, and zero the allocated memory.

flint_rand_alloc

Allocates a flint_rand_t object to be used like a heap-allocated flint_rand_t in external libraries. The random state is not initialised.

flint_rand_free state

Frees a random state object as allocated using flint_rand_alloc.

flint_randinit state

Initialize a flint_rand_t.

flint_randclear state

Free all memory allocated by flint_rand_init.

flint_set_num_threads num_threads

Set up a thread pool of num_threads - 1 worker threads (in addition to the master thread) and set the maximum number of worker threads the master thread can start to num_threads - 1.

This function may only be called globally from the master thread. It can also be called at a global level to change the size of the thread pool, but an exception is raised if the thread pool is in use (threads have been woken but not given back). The function cannot be called from inside worker threads.

flint_get_num_threads

When called at the global level, this function returns one more than the number of worker threads in the Flint thread pool, i.e. it counts the workers in the thread pool plus one more for the master thread.

In general, this function returns one more than the number of additional worker threads that can be started by the current thread.

Use thread_pool_wake to set this number for a given worker thread.

flint_set_num_workers num_workers

Restricts the number of worker threads that can be started by the current thread to num_workers. This function can be called from any thread.

Assumes that the Flint thread pool is already set up.

The function returns the old number of worker threads that can be started.

The function can only be used to reduce the number of workers that can be started from a thread. It cannot be used to increase the number. If a higher number is passed, the function has no effect.

The number of workers must be restored to the original value by a call to flint_reset_num_workers before the thread is returned to the thread pool.

The main use of this function and flint_reset_num_workers is to cheaply and temporarily restrict the number of workers that can be started, e.g. by a function that one wishes to call from a thread, and cheaply restore the number of workers to its original value before exiting the current thread.

flint_reset_num_workers num_workers

After a call to flint_set_num_workers this function must be called to set the number of workers that may be started by the current thread back to its original value.