COM.claymoresystems.ptls

Class SSLDebug

java.lang.Object

COM.claymoresystems.ptls.SSLDebug

public class SSLDebug
extends java.lang.Object

This class is intended for use in debugging PureTLS.

By default, no debugging data is logged to the console, but you can exert some selective control over what types of data will be logged by using setDebug(). The taxonomy of data types is somewhat idiosyncratic and the exact places that debugging callouts have been inserted is somewhat dependent on where problems have been found in the past.

This class is largely useful for sending message traces to the developers.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEBUG_ALL Print out all debugging information available.
static int	DEBUG_CERT Certificate processing debugging
static int	DEBUG_CODEC Print codec activities to the console.
static int	DEBUG_CRYPTO Print out the input and output for crypto operations.
static int	DEBUG_HANDSHAKE Print out handshake results
static int	DEBUG_INIT Print out commentary during the initialization phase, including keyfile loading
static int	DEBUG_MSG This provides some basic diagnostics about message processing.
static int	DEBUG_STATE Print out state changes in the handshake.

Constructor Summary

Constructors

Constructor and Description
SSLDebug()

Method Summary

Methods

Modifier and Type	Method and Description
static void	debug(int type, java.lang.String val)
static void	debug(int type, java.lang.String label, byte[] hd)
static boolean	getDebug(int flag)
static void	setDebug(int flag) Set the debugging value.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEBUG_CODEC

public static final int DEBUG_CODEC

Print codec activities to the console. This allows you to watch low-level PDUs and basic types being decoded

See Also:

Constant Field Values

DEBUG_MSG

public static final int DEBUG_MSG

This provides some basic diagnostics about message processing. There isn't as much information being logged here as one would like

See Also:

Constant Field Values

DEBUG_STATE

public static final int DEBUG_STATE

Print out state changes in the handshake. This is useful for diagnosing problems in the handshake state machine. Unfortunately, these are currently printed as integers which means you need to examine the source to see what's going on

See Also:

Constant Field Values

DEBUG_CRYPTO

public static final int DEBUG_CRYPTO

Print out the input and output for crypto operations. This is useful for comparing the operation of PureTLS to another TLS implementation

See Also:

Constant Field Values

DEBUG_INIT

public static final int DEBUG_INIT

Print out commentary during the initialization phase, including keyfile loading

See Also:

Constant Field Values

DEBUG_CERT

public static final int DEBUG_CERT

Certificate processing debugging

See Also:

Constant Field Values

DEBUG_HANDSHAKE

public static final int DEBUG_HANDSHAKE

Print out handshake results

See Also:

Constant Field Values

DEBUG_ALL

public static final int DEBUG_ALL

Print out all debugging information available. This produces incredibly copious output

See Also:

Constant Field Values

Constructor Detail

SSLDebug

public SSLDebug()

Method Detail

setDebug

public static void setDebug(int flag)

Set the debugging value.

Parameters:

flag - the bitwise OR of the debugging values of your choice or 0 for none

getDebug

public static boolean getDebug(int flag)

debug

public static void debug(int type,
         java.lang.String val)

debug

public static void debug(int type,
         java.lang.String label,
         byte[] hd)