Index for Section 3

Alphabetical listing for I

Bottom of page

imc_rderrcnt_mr(3)
NAME
  imc_rderrcnt_mr - Reads the clusterwide error count for the specified
  logical rail

LIBRARY
  Memory Channel API library (libimc.a)

SYNOPSIS
  #include <sys/imc.h>
  int imc_rderrcnt_mr (
	 int logical_rail );

PARAMETER
  logical_rail
	    Specifies the Memory Channel logical rail for which the error
	    count is to be read. The first logical rail is numbered 0, the
	    second logical rail is numbered 1, and so on, up to a maximum
	    defined by a constant, IMC_MAXRAILS.

DESCRIPTION
  The imc_rderrcnt_mr() function reads the error count for the specified
  logical rail and returns the value to the calling program. The error count
  is updated whenever a Memory Channel error occurs. The count is not
  guaranteed to be up to date with the most recent Memory Channel transfer.
  However, you can use it with the imc_ckerrcnt_mr() function to determine
  whether any errors occurred since the last time the count was updated.

  The Memory Channel hardware guarantees that no corrupt data will be written
  to host systems, and that all data will be delivered to the host systems in
  the sequence in which the data is written to the Memory Channel hardware.
  The atomic unit of transfer on Memory Channel is 32 bits.  Statistically,
  the error rate of the Memory Channel hardware is of the order of three
  errors per year.

  If the error count is being updated at the time the imc_rderrcnt_mr()
  function is called, the function returns a negative value. Programs should
  check for this eventuality and call the function again to ensure that it
  reads the correct error count.

  You can use the imc_rderrcnt_mr() function along with the imc_ckerrcnt_mr()
  function to construct application-specific error detection protocols.

RETURN VALUES
  On successful completion, the imc_rderrcnt_mr() function returns a positive
  integer that contains the error count for the specified logical rail.

  The imc_rderrcnt_mr() function returns a negative value if the error count
  is being updated when the function is called.

RELATED INFORMATION
  Introduction: imc(3)

  Commands: imc_init(1), imcs(1)

  Functions:  imc_api_init(3), imc_ckerrcnt_mr(3), imc_perror(3)

  Cluster Highly Available Applications

Index for Section 3

Alphabetical listing for I

Top of page