Index for Section 3

Alphabetical listing for P

pthread_debug_cmd(3)
NAME
  pthread_debug_cmd - Passes a list of pthread_debug commands to DECthreads.

LIBRARY
  DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS
  #include <pthread.h>

  pthreadDbgStatus_t  pthread_debug_cmd(
				   char	   *cmd);

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  IEEE Std 1003.1c-1995, POSIX System Application Program Interface

PARAMETERS
  cmd	    NULL-terminated pthread_debug command string to pass to
	    DECthreads debug. Use semicolons to separate debug commands.

DESCRIPTION
  This routine passes a list of debugging commands to DECthreads.  Each
  command (separated by a semicolon) is executed in sequence.  Any output is
  written to standard output.  This routine returns the status of the last
  specified operation in the command string when the final command (or Exit
  command) is executed.

  To invoke the DECthreads debugger for interactive commands, use
  pthread_debug.

EXAMPLES
  The following are two examples of listing commands in a call to this
  routine:

	  pthread_debug_cmd("thread -b; mu -lq; cond -wq");
	  pthread_debug_cmd("att");

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	    Command successful.

  [PTHREAD_DBG_QUIT] (1)
	    Last command was quit or exit

  [PTHREAD_DBG_NONESEL] (2)
	    No objects selected (for example, thread -br)

  [PTHREAD_DBG_SUCCESSPEND] (3)
	    Alternate success

  [PTHREAD_DBG_NOPRIV] (-1)
	    No privilege for command

  [PTHREAD_DBG_INVPARAM] (-2)
	    Invalid parameter on command

  [PTHREAD_DBG_INVSEQ] (-3)
	    Invalid object sequence number given

  [PTHREAD_DBG_INCONSTATE] (-4)
	    Inconsistent state for operation

  [PTHREAD_DBG_CORRUPT] (-5)
	    Unable to complete due to internal corruption

  [PTHREAD_DBG_INVOPTION] (-6)
	    Invalid command options

  [PTHREAD_DBG_NOARG] (-7)
	    Missing command argument

  [PTHREAD_DBG_INVADDR] (-8)
	    Invalid address

  [PTHREAD_DBG_INVCMD] (-9)
	    Invalid command

  [PTHREAD_DBG_NULLCMD] (-10)
	    No command given

  [PTHREAD_DBG_CONFLICT] (-11)
	    Conflicting options

  [PTHREAD_DBG_UNIMPL] (-12)
	    Unimplemented feature

ERRORS
  None

RELATED INFORMATION
  Functions: pthread_debug(3)

  Manuals: Guide to DECthreads and Programmer's Guide