Index for Section 3

Alphabetical listing for I

Bottom of page

imc_lkrelease(3)
NAME
  imc_lkrelease - Releases a lock in a lock set

LIBRARY
  Memory Channel API library (libimc.a)

SYNOPSIS
  #include <sys/imc.h>
  int imc_lkrelease (
	  imc_lkid_t lock,
	  int	     index );

PARAMETERS
  lock	    Identifies the lock set that contains the lock to be released.
	    The lock set specified by the lock parameter must previously have
	    been allocated by a call to the imc_lkalloc() function.

  index	    Specifies the lock to be released. The value of the index
	    parameter is in the range zero (0) to (count-1), where count is
	    the value returned by the imc_lkalloc() function when it created
	    the lock set.

DESCRIPTION
  The imc_lkrelease() function releases a lock that is being held as a result
  of a call to the imc_lkacquire() function or a call to the imc_lkalloc()
  function.

  If the lock specified by the lock and index parameters is not being held,
  an error condition will result.

  If a system failure occurs on a host on which a process that holds a lock
  is executing, all locks associated with the host are automatically
  released.

  All locks acquired by a process are automatically released when the process
  exits.

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

  IMC_SUCCESS
	    Normal successful completion.

  IMC_BADLOCK
	    Either the lock set specified by the lock parameter or the lock
	    specified by the index parameter does not exist.

  IMC_CORRUPTLOCK
	    An attempt was made to release a lock in an invalid or corrupted
	    lock set.

  IMC_LOCKNOTHELD
	    The lock that the imc_lkrelease() function tried to release was
	    not being held.

RELATED INFORMATION
  Introduction: imc(3)

  Commands: imc_init(1), imcs(1)

  Functions: imc_api_init(3), imc_lkacquire(3), imc_lkalloc(3),
  imc_lkdealloc(3)

  Cluster Highly Available Applications

Index for Section 3

Alphabetical listing for I

Top of page