20.1.1 ead_init_client() (initializes the EADS client)

(1) Description

This function performs initial setup of the EADS client according to the client properties.

The EADS client name is treated as a null character string.

In addition, it obtains a handle (pointer) to the cache manager that manages the cache.

Each time ead_init_client() 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
(
  const char     *filename,      /* In */
  int            *error_code     /* Out */
);

To Page Top

(3) Arguments

filename

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() terminates normally, it returns a handle (pointer) to the cache manager for managing the cache.

If ead_init_client() 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, 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