Index for Section 3

Alphabetical listing for C

Bottom of page

clua_getaliasinfo(3)
NAME
  clua_getaliasinfo - Get information about one cluster alias and its members

LIBRARY
  Cluster Alias Library (libclua.a and libclua.so)

SYNOPSIS
  #include <clua/clua.h>

  #include <sys/socket.h>

  clua_status_t clua_getaliasinfo (
	  struct sockaddr *addr ,
	  struct clua_info *outbuf );

PARAMETERS
  addr	    Pointer to a sockaddr structure that contains the IP address of a
	    cluster alias.

  outbuf    Pointer to a caller-allocated clua_info structure in which
	    clua_getaliasinfo() puts information about this alias.

DESCRIPTION
  The clua_getaliasinfo() function returns information about one cluster
  alias and its members.

  The data is returned in the form of a clua_info structure, which contains
  global information about the cluster alias, plus an array of
  clua_member_info structures containing information relative to this alias
  about each of the alias's members. The two structures are declared in
  <clua/clua.h>.

  Programs that use cluster alias functions include the cluster alias header
  file, <clua/clua.h>, and are compiled with the cluster alias library,
  libclua. Programs that use the clua_getaliasaddress(), clua_getaliasinfo(),
  clua_getdefaultalias(), clua_isalias(), clua_registerservice(), or
  clua_unregisterservice() functions are also compiled with the configuration
  management library, libcfg.

EXAMPLES
  The following code fragment shows a typical calling sequence:

	   #include <sys/socket.h>
	   #include <netinet/in.h>
	   #include <clua/clua.h>

	   int context = 0;
	   struct sockaddr addr;
	   struct clua_info outbuf;
	   clua_status_t result1, result2;

	   while ((result1=clua_getaliasaddress(&addr, &context)) == CLUA_SUCCESS) {
	     if ((result2=clua_getaliasinfo(&addr, &outbuf)) == CLUA_SUCCESS) {
		       /* do something with outbuf */
	     }
	     else {
		print_clua_liberror(result2);
		break;
	     }
	   }
	   if (result1 != CLUA_SUCCESS && result1 != CLUA_NOMOREALIASES)
	      print_clua_liberror(result1);

RETURN VALUES
  The clua_getaliasinfo() function returns one of the following values:

  CLUA_SUCCESS
	    Successful completion.

  CLUA_NOTALIAS
	    Specified address is not a cluster alias.

  CLUA_ENOCLUSTER
	    Caller is not in a cluster.

SEE ALSO
  Commands: cluamgr(8), clua_active(8)

  Functions: clua_error(3), clua_getaliasaddress(3), clua_getdefaultalias(3),
  clua_isalias(3), clua_registerservice(3)

  Files: clua_services(4) clu_alias.config(4), exports.aliases(4)

Index for Section 3

Alphabetical listing for C

Top of page