rcclSetSimulator(3)

NAME
rcclSetSimulator, rcclGetSimulator -- set simulator for an RCCL program.

USAGE
#include <rccl.h>

rcclSetSimulator(simAddr)
  const char *simAddr;

char *rcclGetSimulator();

ARGUMENTS

addr --
    String specifying which simulator the program should try and connect to.

RESTRICTIONS
These routines must be called from the planning level. To be effective, rcclSetSimulator() must also be called before the first call to rcclCreate().

DESCRIPTION
rcclSetSimulator() can be used to make an RCCL program run in simulation mode. Its effect is similar to calling rcclSetOptions(RCCL_SIMULATE), but it also allows the simulator program to be explicitly specified.

rcclSetSimulator() in fact calls rcclSetOptions(RCCL_SIMULATE), unless simAddr is NULL, in which case it calls rcclClearOptions(RCCL_SIMULATE). In addtion to this, simAddr can be used to specify the desired simulator program. For a description of the format used by simAddr, see simAddress(5).

rcclGetSimulator() returns the simulator address most recently specified by rcclSetSimulator().

DIAGNOSTICS
rcclSetSimulator() returns -1 in the event of an error, although no errors are currently implemented. An error condition may be implemented in the future for passing an illegal simAddr string.

These routines will abort the program if called from the control level.

SEE ALSO
rcclSetOptions(3).