Index for Section 3

Alphabetical listing for I

Bottom of page

imc_asdealloc(3)
NAME
  imc_asdealloc - Deallocates a region of Memory Channel address space

LIBRARY
  Memory Channel API library (libimc.a)

SYNOPSIS
  #include <sys/imc.h>
  int imc_asdealloc (
	  imc_asid_t id );

PARAMETER
  id	    Identifies the region of Memory Channel address space to be
	    deallocated.  The identifier specified by the id parameter must
	    have previously been generated by a call to the imc_asalloc
	    function.

DESCRIPTION
  The imc_asdealloc() function deallocates a region of Memory Channel address
  space.  Mapped regions must be detached by means of a call to the
  imc_asdetach() function before being deallocated; otherwise, an error
  condition will result.

  Deallocating a region will not necessarily free the region of Memory
  Channel address space. This is because multiple processes can allocate a
  given region; the space is freed only when the last process on the cluster
  deallocates the region.

  All Memory Channel regions allocated by a process are automatically
  deallocated when the process exits.

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

  IMC_SUCCESS
	    Normal successful completion.

  IMC_ATTACHED
	    The specified region of Memory Channel address space is attached
	    by the process. The region must be detached before it can be
	    deallocated.

  IMC_BADPARM
	    An invalid parameter was specified in the call to the
	    imc_asdealloc() function.

  IMC_BADREGION
	    The region specified by the id parameter was not found.

  IMC_NOTALLOC
	    The region is not allocated.

  IMC_NOTINIT
	    This host has not been initialized to use the Memory Channel
	    Application Programming Interface (API) library.

RELATED INFORMATION
  Introduction: imc(3)

  Commands: imc_init(1), imcs(1)

  Functions:  imc_api_init(3), imc_asalloc(3), imc_asattach(3),
  imc_asattach_ptp(3), imc_asdetach(3)

  Cluster Highly Available Applications

Index for Section 3

Alphabetical listing for I

Top of page