Index for Section 3

Alphabetical listing for C

Bottom of page

clu_get_clock(3)
NAME
  clu_get_clock - Gets the current value of a cluster member's systemwide
  clock.

LIBRARY
  Connection Manager Library (libcnx.a) (provided on Production Server
  configurations only)

SYNOPSIS
  #include <sys/param.h>

  #include <sys/cluster_defs.h>

  int clu_get_clock (
	  char *name,
	  timespec_t *timespec_ptr );

PARAMETERS
  name	    Specifies the host name of the remote cluster member from which
	    the information is being requested.	 Setting the name parameter
	    to NULL indicates that the information is being requested from
	    the local node.

  timespec_ptr
	    Specifies the address of a timespec_t structure to which the
	    clu_get_clock function returns the system time.

DESCRIPTION
  The clu_get_clock function is a version of the getclock function, which
  returns the value of the time-of-day clock on a specified cluster member.
  The value of the time-of-day clock represents the time elapsed since the
  epoch.  The epoch is referenced to 00:00:00 CUT (Coordinated Universal
  Time) 1 Jan 1970.

  The clu_get_clock function returns a timespec_t structure, which is defined
  in the sys/timers.h header file.  It has the following members:

  time_t tv_sec
	    Elapsed time, in seconds, since the epoch.

  long tv_nsec
	    Elapsed time, in nanoseconds, since the epoch (always zero [0]
	    when returned by the clu_get_clock function).

RETURN VALUES
  Upon completion, the clu_get_clock function returns one of the following
  values:

  CLU_SUCCESS
	    The requested information was returned successfully.

  CLU_BADPARAM
	    A required parameter was not specified or was invalid.

  CLU_ERROR The function was unable to return the requested information.

FILES
  /usr/include/sys/cluster_defs.h
	    Cluster information services header file.

  /usr/examples/cluster/cluinfo.c
	    Source file for example demonstrating cluster information
	    services.

  /usr/examples/cluster/cludo.c
	    Source file for example demonstrating cluster information
	    services.

RELATED INFORMATION
  Functions: getclock(3), clu_get_cluster(3), clu_get_ase_enabled(3)

  TruCluster Production Server Software Application Programming Interfaces

Index for Section 3

Alphabetical listing for C

Top of page