Ingres CL CX
From Ingres Community Wiki
|
Ingres Compatability Library |
Compatibility Library Specification - CX
Contents |
Abstract
This is the specification of the CX facility provided by the compatibility library to provide an operating system independent interface to services needed to support clusters.
Document History
- Revision 1.4, circa June 2003
- from Linux Cluster Support Detailed Design Specificaitons
Specification
Introduction
<description of facility>
Library
CL (although it is currently mapped to gl/glf/cx)
Header File <cx.h>
The header file <cx.h> must be included before using any of the functions provided.
Executable Interface
The following functions are provided.
CXcluster_configured
- Is Ingres configured for clustering?
Checks to see if clustering is configured at the Ingres level. OS or hardware support may be lacking, but presumably the configuration program has performed these checks.
- Inputs
- None
- Outputs
- None
- Returns
TRUE Installation is configured for clustering FALSE Ingres was not configured for cluster support
- Definition
bool CXcluster_configured()
CXhost_name
- Get host name for current machine
A wrapper for PMhost, which assures the name is not more than CX_MAX_NODE_NAME_LEN characters long and is entirely lower case.
- Inputs
- None
- Outputs
- None
- Returns
- Address of cached host name
- Definition
char * CXhost_name()
CXnode_name
- Get node name for current machine
Gets the node name of the current machine. This is identical to the host name unless running on a NUMA node of a NUMA cluster.
- Inputs
- node_name - pointer to buffer to fill with node name, or NULL
- Outputs
- node_name - filled in with node name, unless input was NULL
- Returns
- Address of input nodename, or internal buffer if NULL was passed
- Definition
char *
CXnode_name(
char *node_name)
CXnode_name_from_id
- Get node name given a machine ID
Gets the node name given a machine ID.
- Inputs
- node_id - numeric identifier given to a machine (on VMS clusters, the CSID)
- Outputs
- node_name - filled in node name
- Returns
- None
- Definition
void
CXnode_name_from_id(
u_i4 node_id,
char *node_name)
CXnode_number
- Get Ingres cluster node number
Return the Ingres cluster node number for the given node name, or the current machine if NULL was passed.
- Inputs
- node_name - pointer to target node name, or NULL
- Outputs
- None
- Returns
- Ingres cluster node number for target node name, or
- 0 if target is not configured as part of cluster, or
- -1 if configured number is invalid
- Definition
i4
CXnode_number(
char *node_name)
|
Ingres Compatability Library |
