20.1.2 ead_init_client_n() (initializes the EADS client)
- Organization of this subsection
(1) Description
This function initializes the EADS client according to the EADS client name and client properties.
In addition, it obtains a handle (pointer) to the cache manager that manages the cache.
Each time ead_init_client_n() is executed, a thread for monitoring the cluster is generated. This thread is terminated when ead_terminate_client() is executed.
(2) Format
#include <eads.h> EAD_CACHE_MANAGER *ead_init_client_n ( const char *client_name, /* In */ const char *file_name, /* In */ int *error_code /* Out */ );
(3) Arguments
- client_name
-
Specifies an EADS client name.
For details about the data that can be specified, see 15.2.2(5) Data that can be specified as EADS client names.
For the relationships between EADS client names and log file output destinations, see 8.4.2 Specifying the file output destinations.
- file_name
-
Specifies the path of the client property file for the EADS client.
- error_code
-
Specifies the pointer from which to retrieve the error code.
For details about error codes, see 20.2 Error codes in the client library (C).
(4) Return value
If ead_init_client_n() terminates normally, it returns a handle (pointer) to the cache manager that manages the cache.
If ead_init_client_n() terminates abnormally, it returns NULL.
(5) Notes
-
If you execute multiple EADS clients concurrently on the same machine, specify a different log output destination for each EADS client. If you specify the same log output destination, valid operation is not guaranteed. For details about specifying the log output destination, see 8.4.2 Specifying the file output destinations.
-
Always make sure that you execute ead_terminate_client() to terminate an initialized EADS client.