Guardian Procedure Calls Reference Manual

options
input
INT (32):value
controls the behavior of BINSEM_GETSTATS_ for a specified binary semaphore. Set to one of
the following:
obtains counter statistics.BINSEM_STAT_OPT_DEFAULT
obtains statistics and clear counters.BINSEM_STAT_OPT_CLEAR
obtains statistics and resets the maximum number of contenders.BINSEM_STAT_OPT_RESETMAX
obtains statistics, resets the maximum number of contenders, and resets all of
the counters.
BINSEM_STAT_OPT_RESET_ALL
statsP
output
INT .EXT:ref:32
specifies a pointer to the binSemStats_t structure that contains the statistics for a particular
binary semaphore.
statsLen
input
INT (32):value
specifies the length of the buffer that contains the statistics.
Returned Value
INT
Outcome of the call:
BINSEM_RET_OK0
Successful call.
BINSEM_RET_EOF1
There are no more binary semaphores to process.
BINSEM_RET_BADCOUNT21
The statsLen parameter, which reflects the size of the statsP buffer, is not large enough to hold the next
binary semaphore passed back by this routine. This error is also returned if the length, represented as a signed
integer, is negative.
Recovery: Call BINSEM_GETSTATS_ again with a larger buffer and size.
BINSEM_RET_EBOUNDSERR22
The buffer containing the output statsP structure or the process handle did not pass NSK bounds check.
Recovery: Be sure to pass in arguments with the appropriate length and permissions.
BINSEM_RET_EINVAL4022
Either:
Invalid options specified to BINSEM_GETSTATS_.
Recovery: Be sure to pass only the specified options.
or
Unexpected process flags in the process handle.
Recovery: Verify that the process handle passed into this routine is valid.
BINSEM_RET_ENOENT4002
The process specified is nonexistent. Either the process is not active or it is running on a different processor.
94 Guardian Procedure Calls (A-B)