barrier_destroy(SYNCH)

barrier_destroy -- destroy a blocking barrier

Synopsis

   cc [options] -Kthread file
   
   #include <synch.h>
   

   int barrier_destroy(barrier_t *barrier);

Description

barrier_destroy destroys the barrier pointed to by barrier. This includes invalidating the barrier and freeing any associated implementation-allocated dynamic resources.

Any user-allocated dynamic storage is unaffected by barrier_destroy and must be explicitly released by the program.

Parameters

barrier: pointer to barrier to be destroyed

Return values

barrier_destroy returns zero for success and an error number for failure.

Errors

If one of the following conditions is detected, barrier_destroy returns the corresponding value:

EBUSY: a thread is still waiting at the barrier
EINVAL: invalid argument specified

References

Intro(SYNCH), barrier(SYNCH), barrier_init(SYNCH), barrier_wait(SYNCH)