NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES
#include <exec/chModules.h>int sysGetConf(const char *modName, int var, int *pvalue);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
CORE
The sysGetConf() system call copies the value from the ChorusOS module corresponding to the module name into the integer pointed to by pvalue. The module name is given by modName, as defined in <chModules.h>. The modName pointer must point to a NULL-terminated string containing the name of the module whose configuration value is required. The pvalue pointer points to an integer which, on successful completion, will contain the value corresponding to the var configuration parameter of modName.
The var value may be either K_GETCONF_VERSION, to obtain the version of a specified module, or a value defined in a specific module header. Examples of the latter include K_GETCONF_ACTOR_MAX in <exec/chExec.h> for the maximum number of actors on a site, andK_GETCONF_PORT_MAX in <ipc/chIpc.h> for the maximum number of ports on a site.
On successful completion, if the module specified is present, K_OK is returned. Otherwise, a negative error code is returned.
The modName module is not present in the current ChorusOS runtime configuration. This is an easy way to test for the presence of a module at runtime.
Some of the data provided are outside the current actor's address space.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | API RESTRICTIONS | FEATURES | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES