NAME
dacs_num_processes_running
- Return the number of processes currently running on a DE.
SYNOPSIS
DACS_ERR_T
dacs_num_processes_running ( de_id_t de, uint32_t *num_processes )
| Call parameter |
|
| de |
The DE to query. |
| Return parameter |
|
| *num_processes |
A pointer to a location where the
number of processes currently running on the target DE is
stored. |
DESCRIPTION
The dacs_num_processes_running service
returns the number of processes currently running on the specified DE. This
includes all processes that have been started (with dacs_de_start())
and have not yet had their exit status reaped (with dacs_de_test() or dacs_de_wait()). The target DE must have
been reserved by the caller.
RETURN VALUE
The
dacs_num_processes_running service
returns an error indicator defined as:
- DACS_SUCCESS: normal return.
- DACS_ERR_INVALID_DE: the specified DE is either invalid
or not reserved.
- DACS_ERR_INVALID_ADDR: the pointer is invalid.
- DACS_ERR_INVALID_TARGET: the
operation is not allowed for the target de.