Index for Section 3

Alphabetical listing for P

Bottom of page

pthread_exc_get_status_np(3)
NAME
  pthread_exc_get_status_np - (Macro) Obtains a system-defined error status
  from a DECthreads status exception object

SYNOPSIS
  #include <pthread_exception.h>

  int pthread_exc_get_status_np(
	  EXCEPTION *exception,
	  unsigned long *code );

LIBRARY
  DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS
  None

PARAMETERS
  exception
      DECthreads status exception object whose status code is obtained.

  code
      Receives the system-specific status code associated with the specified
      DECthreads status exception object.

DESCRIPTION
  This routine obtains and returns the system-specific status value from the
  DECthreads status exception object specified in the exception argument.
  This value must have already been associated with the exception object
  using the pthread_exc_set_status_np(3) routine.

  In a program that uses DECthreads status exceptions, use this routine
  within a CATCH, CATCH_ALL, or FINALLY code block to obtain the status code
  value associated with a caught exception. Note that any exception objects
  set to the same status value are considered equivalent by DECthreads.

RETURN VALUES
  If an error condition occurs, this routine returns an integer value
  indicating the type of error. If the routine's exception object argument is
  a DECthreads status exception, it sets the code argument and return zero
  (0). Possible return values are as follows:

  0   Successful completion.

  [EINVAL]
      The exception argument is not a valid DECthreads status exception
      object.

ERRORS
  None

SEE ALSO
  Functions: pthread_exc_set_status_np(3)

  Manuals: Guide to DECthreads and Programmer's Guide

Index for Section 3

Alphabetical listing for P

Top of page