NAME

nthm_kill_all - request a shutdown of all locally tethered threads

SYNOPSIS

#include <nthm/nthm.h>

void nthm_kill_all ( int *err )

DESCRIPTION

The nthm_kill_all function informs all threads created with nthm_open in the current thread's context or tethered to it with nthm_tether (and in the current local scope as determined by nthm_enter_scope, if applicable) that they should shut themselves down because their results will be ignored and further activities curtailed.

The semantics of nthm_kill_all is identical to that of calling nthm_kill individually for each relevant thread. Notably it is an error to kill the same thread both individually and by way of nthm_kill_all. See the manual page of nthm_kill for further details.

RETURN VALUE

none

ERRORS

Error codes are reported in the *err parameter, with any non-zero value indicating an error.

• If *err is non-zero on entry, then it remains unchanged.
• If *err is zero on entry and non-zero on exit, then an internal consistency check has failed. Bug reports are gratefully received.

SEE ALSO

nthm, nthm_open, nthm_send, nthm_select, nthm_read, nthm_kill, nthm_killed, nthm_blocked, nthm_truncate, nthm_truncated, nthm_truncate_all, nthm_enter_scope, nthm_exit_scope, nthm_untether, nthm_tether, nthm_sync, nthm_strerror, nthm_busy

AUTHOR

Dennis Furey (milonga@delayinsensitive.com)

PROJECT PAGE

https://github.com/gueststar/nthm