Index for Section 3

Alphabetical listing for I

Bottom of page

imc_gethosts(3)
NAME
  imc_gethosts - Gets information about the hosts participating in a Memory
  Channel Application Programming Interface (API) cluster

				     Note

       This function is now obsolete; the imc_getclusterinfo function
       should be used instead.


LIBRARY
  Memory Channel API library (libimc.a) (provided on Production Server and
  Memory Channel Software configurations)

SYNOPSIS
  #include <sys/imc.h>
  int imc_gethosts (
	  imc_hostinfo *hosts );

PARAMETER
  hosts

	    Returns a data structure that contains the information about the
	    hosts in the Memory Channel API cluster.

DESCRIPTION
  The imc_gethosts function returns a count of the number of hosts
  participating in a Memory Channel API cluster, as well as the name of each
  host. It returns the information in a data structure of type imc_hostinfo,
  which contains the following fields:

  name [IMC_MAXHOSTS][MAXHOSTNAMELEN]
	    The host names are returned in the two-dimensional name array.
	    The string containing the host name is zero-terminated. The
	    elements in the array are numbered 0 to (num-1).

  num	    The number of hosts in the Memory Channel API cluster is returned
	    in the num field.

				     Note

       The imc_gethosts function lists only those hosts that have
       initialized the Memory Channel API library.





RETURN VALUES
  The imc_gethosts function returns one of the following values:

  IMC_SUCCESS
	    Normal successful completion.

  IMC_NOTINIT
	    This host has not been initialized to use the Memory Channel API
	    library.

RELATED INFORMATION
  Introduction: imc(3)

  Commands: imc_init(1), imcs(1)

  Functions:  imc_api_init(3), imc_kill(3)

  TruCluster Software Products Memory Channel Application Programming
  Interfaces

Index for Section 3

Alphabetical listing for I

Top of page