NAME

grpc_config_file_read_np - Reads the configuration file.

SYNOPSIS

grpc_error_t grpc_config_file_read_np(char *config_file_name)

ARGUMENTS

char *config_file_name
The configuration file for the client

DESCRIPTION

The grpc_config_file_read_np() function reads the configuration file and changes the configuration of the running environment of the Ninf-G Client dynamically.

This function can be used for dynamic addition of the information about new computing resources which were not known at the startup time.

Once this function is called, the new configuration is effective for newly created function/object handles, i.e. existing handles keep their old configuration.

This function does not updates <CLIENT> sections. In each section, if an attribute value is not specified, the default value is used.

Once this function is called, following function/object handle creation will not reuse existing external modules but invoke new external modules.

As same as grpc_initialize() function, if NULL or an empty string is specified in config_file_name, the configuration file specified by the NG_CONFIG_FILE environment variable is used as the configuration file.

If the NG_CONFIG_FILE environment variable is also undefined or an empty string, then $HOME/.ngconf is used as the configuration file.

This function is MT-safe.

Note: No information will be discarded by this function. Only the addition and modification of the configuration are performed.

RETURN VALUE

If successful, GRPC_NO_ERROR is returned. In the case of an error, an error code is returned.

ERRORS

GRPC_NOT_INITIALIZED
GRPC client is not initialized yet.
GRPC_CONFIGFILE_NOT_FOUND
The configuration file does not exist.
The configuration file could not be read.
GRPC_CONFIGFILE_ERROR
The content of the configuration file is invalid.
GRPC_OTHER_ERROR_CODE
Internal error detected.

last update : $Date: 2010-04-16 01:09:23 +0900 (金, 16 4月 2010) $