USDUMPSEMA(3P)                                                  USDUMPSEMA(3P)


NAME
     usdumpsema - dump out information about a specific semaphore

C SYNOPSIS
     #include <ulocks.h>
     #include <stdio.h>

     int usdumpsema (usema_t *sema, FILE *fd, const char *str);

DESCRIPTION
     usdumpsema dumps information about sema in a readable form.  This
     information is written to the file descriptor given by fd.  The
     information printed includes where in memory the semaphore resides, what
     its count is, and the metering and debugging information (see
     usctlsema(3P)).  The argument str is simply printed as a string, and can
     be used to aid in identifying where usdumpsema was called from.

SEE ALSO
     usinit(3P), usctlsema(3P).

DIAGNOSTICS
     Upon successful completion, a value of 0 is returned. Otherwise, a value
     of -1 is returned and errno is set to indicate the error.


                                                                        Page 1