sema_destroy(3synch)                            sema_destroy(3synch)


       NAME
             sema_destroy - destroy a semaphore

       SYNOPSIS
             cc [options] -Kthread file
             #include <synch.h>
             int sema_destroy(sema_t *sema);

          Parameters
             sema    pointer to the semaphore to destroy

       DESCRIPTION
             sema_destroy destroys the semaphore pointed to by sema.  This
             includes invalidating sema and freeing any associated
             dynamically allocated resources.

          sema Parameter
             sema must have been previously initialized, either by
             sema_init or statically (see sema_init).

          Return Values
             sema_destroy returns zero for success and an error number for
             failure, as described below.

          Errors
             If any of the following conditions is detected, sema_destroy
             returns the corresponding value:

             EBUSY    sema still has threads waiting.

             EINVAL   Invalid argument specified.

       REFERENCES
             semaphore(3synch), sema_init(3synch), sema_post(3synch),
             sema_trywait(3synch), sema_wait(3synch), synch(3synch)













                           Copyright 1994 Novell, Inc.               Page 1