20.1.2 ead_init_client_n() (initializes the EADS client)

(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.

To Page Top

(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 */
);

To Page Top

(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).

To Page Top

(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.

To Page Top

(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.

To Page Top