20.1.36 ead_get_slave_nodelist() (acquires information about the original target EADS server for data)

Organization of this subsection

(1) Description
(2) Format
(3) Arguments
(4) Return value
(5) Notes

(1) Description

This function acquires information about the original target EADS servers to which data stored on a specified EADS server is copied.

By original target EADS server is meant an EADS server to which data stored on a specified EADS server (source EADS server) is copied when all EADS servers making up the cluster can be connected successfully.

To Page Top

(2) Format

#include <eads.h>
ead_nodelist ead_get_slave_nodelist
(
  const EAD_CACHE_MANAGER *cmp,               /* In */
  const ead_node          *master_node,       /* In */
  int                     *error_code         /* Out */
);

To Page Top

(3) Arguments

cmp

Specifies the handle (pointer) to the cache manager that is managing the cache. Specify a handle obtained from ead_init_client() or ead_init_client_n().

master_node

Specifies a pointer to the EADS server (ead_node structure) from which data is copied.

You can only specify the pointer of the ead_node structure obtained by using the EADS client library. If you specify any other pointer, correct operation is not guaranteed.

For the format and details of the ead_node structure, see 20.1.50 ead_node structure (object used in a user function with an EADS server specified).

An error results if the address information (IP address and port number) managed by the specified ead_node structure does not match the address information of any EADS servers maintained by 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

This function returns information about the original target EADS servers (ead_nodelist structure).

For the format and details of the ead_nodelist structure, see 20.1.49 ead_nodelist structure (EADS server information).

If redundant copies of data are not created (multiplicity is 1), zero is returned to the list_size member of the ead_nodelist structure and NULL to the nodes member.

If the function terminates abnormally, NULL is returned in the nodes member of the ead_nodelist structure.

To Page Top

(5) Notes

If the nodes member of the ead_nodelist structure returned as the return value is not NULL, the memory area is not freed automatically. You must free it in the application program. For details, see 19.1.1(10) Freeing a memory area returned as a return value.
Execution of the application program does not establish communication with the EADS servers. Therefore, the returned information about the connection-target EADS servers might not be the most recent information.
Whether the specified EADS server and the target EADS server for information acquisition are connected is not checked when this function is executed. Therefore, the acquired information might contain EADS servers that cannot be connected, for example, because the EADS servers are isolated.

To Page Top