Index for Section 3

Alphabetical listing for P

Bottom of page

pthread_condattr_getpshared(3)
NAME
  pthread_condattr_getpshared - Obtain the process-shared attribute of a
  condition variable attributes object

SYNOPSIS
  #include <pthread.h>

  int pthread_condattr_getpshared(
	  const pthread_condattr_t attr,
	  int *pshared );

LIBRARY
  DECthreads POSIX 1003.1c Library (libpthread.so)

PARAMETERS
  attr
      Address of the condition variable attributes object whose process-
      shared attribute is to be obtained.

  pshared
      Location to store the value of the process-shared attribute of attr.

DESCRIPTION
  This routine obtains the value of the process-shared attribute in the
  condition variable attributes object referenced by attr and stores it at
  the location pshared.	 The object referenced by attr must be initialized
  before this routine is called.

  Creating a condition variable whose process-shared attribute is set to
  PTHREAD_PROCESS_PRIVATE permits it to be operated on by threads created
  within the same process as the thread that initialized that condition
  variable.  If threads other than processes attempt to operate on such a
  condition variable, the behavior is undefined.

  The default value of the process-shared attribute of an initialized
  condition variable attributes object is PTHREAD_PROCESS_PRIVATE.

  Creating a condition variable whose process-shared attribute is set to
  PTHREAD_PROCESS_SHARED permits it to be operated upon by any thread that
  has access to the memory where that condition variable is allocated, even
  if it is allocated in memory that is shared by multiple processes.

RETURN VALUES
  If an error condition occurs, this routine returns an integer value
  indicating the type of error. Possible return values are as follows:

  0   Successful completion.

  [EINVAL]
      The value specified by attr is not a valid attributes object.

ERRORS
  None

SEE ALSO
  Functions: pthread_condattr_init(3), pthread_condattr_setpshared(3)

  Manuals: Guide to DECthreads and Programmer's Guide

Index for Section 3

Alphabetical listing for P

Top of page