rms_prgaddcap(3)
NAME
rms_prgaddcap, rms_setcap – Associate Elan capabilities with a program or process
SYNOPSIS
cc [ flag ... ] file ... -lrmscall [ library ... ]
#include <rms/rmscall.h>
int rms_prgaddcap(int id, int index, ELAN_CAPABILITY *cap);
int rms_setcap(int index, int context);
PARAMETERS
id Program identifier.
index Index of the capability for this program.
cap Pointerto a capability.
context Context number for this process.
DESCRIPTION
rms_prgaddcap() and rms_setcap() associate Elan capabilities with a program and
its processes. The function rms_prgaddcap() adds a new capability to a program. It is
called once for each rail in use by the program. Each capability defines the range of node
numbers and Elan hardware contexts available to a parallel program. Capabilities are
indexed from 0to ncaps-1 where ncaps is the number of capabilities allocated.
rms_prgaddcap() requires administrator privileges. It is called by rmsd as it creates a
parallel program.
The function rms_setcap() assigns Elan hardware context numbers to the current
process. It is called by the RMS application loader, rmsloader, as it creates each new
application process. The contexts assigned must lie within a previously assigned
capability for the program.
RETURN VALUES
Upon successful completion, rms_prgaddcap() and rms_setcap() return 0.
Otherwise, they return -1 and set errno to indicate the error.
C-10 RMS Kernel Module