pthread_debug_cmd

Passes a list of pthread_debug commands to DECthreads.

Syntax

pthread_debug_cmd( cmd );

Argument Data Type Access

cmd character string read

C Binding

#include 


pthreadDbgStatus_t
pthread_debug_cmd (
            char   *cmd);

Arguments

cmd: pthread_debug command string to pass to DECthreads debug. Null- terminated string, commands separated by semicolons.

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.

For a list of pthread_debug commands, see Appendix D.

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");

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

Return Values

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

Return                       Description

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]    Alternate success
(3)

[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]     Inconsistent state for operation
(-4)

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

[PTHREAD_DBG_INVOPTION]      Invalid command options
(-6)

[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]       Conflicting options
(-11)

[PTHREAD_DBG_UNIMPL] (-12)   Unimplemented feature

Associated Routines

   pthread_debug