Index for Section 3

Alphabetical listing for T

Bottom of page

tis_mutex_init(3)
NAME
  tis_mutex_init - Initializes a mutex object

SYNOPSIS
  #include <tis.h>

  int tis_mutex_init(
	  pthread_mutex_t *mutex );

LIBRARY
  Standard C Library (libc.so, libc.a)

STANDARDS
  None

PARAMETERS
  mutex
      Pointer to a mutex object (passed by reference) to be initialized.

DESCRIPTION
  This routine initializes a mutex object with the DECthreads default mutex
  attributes. A mutex is a synchronization object that allows multiple
  threads to serialize their access to shared data. The mutex is initialized
  and set to an unlocked state.

  Your program can use the PTHREAD_MUTEX_INITIALIZER macro to statically
  initialize a mutex object without calling this routine. Static
  initialization can be used only for a condition variable with class extern
  or static - automatic (stack local) objects must be initialized by calling
  tis_mutex_init(3).  Use this macro as follows:

  pthread_mutex_t mutex= PTHREAD_MUTEX_INITIALIZER

RETURN VALUES
  If an error condition occurs, this routine returns an integer value
  indicating the type of error, the mutex is not initialized, and the
  contents of mutex are undefined. Possible return values are as follows:

  0   Successful completion.

  [EAGAIN]
      The system lacks the necessary resources to initialize a mutex.

  [EBUSY]
      The implementation has detected an attempt to reinitialize mutex (a
      previously initialized, but not yet destroyed mutex).

  [EINVAL]
      The value specified by mutex is not a valid mutex.

  [ENOMEM]
      Insufficient memory exists to initialize the mutex.

  [EPERM]
      The caller does not have privileges to perform this operation.

ERRORS
  None

SEE ALSO
  Functions: tis_mutex_destroy(3), tis_mutex_lock(3), tis_mutex_trylock(3),
  tis_mutex_unlock(3)

  Manuals: Guide to DECthreads and Programmer's Guide

Index for Section 3

Alphabetical listing for T

Top of page