Name

Synopsis

int
qthread_fork(const qthread_f *f, const void *arg, aligned_t *ret);

int
qthread_fork_to(const qthread_f *f, const void *arg, aligned_t *ret, const qthread_shepherd_id_t shepherd);

Description

The first argument to these functions, f, is a function that will be run to completion by the created qthread. (Note that f is a qthread_f and not a qthread_t.) The second argument to these functions, arg, is an argument that will be passed to the specified function. Finally, ret is a pointer to the location that the return value of f will be placed into.

The qthread_f function must have a prototype like this:

aligned_t function(qthread_t *me, void *arg);

The qthread_fork_to() function spawns the qthread to a specific shepherd.

When a qthread is spawned, it is immediately scheduled to be run, and may be executed by its shepherd at any time.

The return value of the function f will be placed into the memory pointed to by ret, in accordance with the full-empty bits. When qthread_fork() or qthread_fork_to() is called, ret will be emptied (as if it had been passed to qthread_empty()). When the function f returns, the returned value will be stored into ret and ret will be filled. The way to block until a function has finished is to use qthread_readFF() on the ret pointer.

Environment

QTHREAD_STACK_SIZE

This variable adjusts the size of the stacks that will be created for each thread. Changes to this value during the course of the program run are ignored; the value is only considered when qthread_init() is run.

Return Value

Errors

ENOMEM

Not enough memory could be allocated.

See Also

Table of Contents

• Name
• Synopsis
• Description
• Environment
• Return Value
• Errors
• See Also