|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.opensolaris.os.dtrace.Error
public final class Error
An error encountered in the native DTrace library while tracing probe
data. Each of the fault name constants beginning with DTRACEFLT_
identifies a specific fault with a name that is
guaranteed not to change across API versions.
Immutable. Supports persistence using XMLEncoder
.
ConsumerListener.errorEncountered(ErrorEvent e)
,
Serialized FormField Summary | |
---|---|
static java.lang.String |
DTRACEFLT_BADADDR
Invalid address. |
static java.lang.String |
DTRACEFLT_BADALIGN
Invalid alignment. |
static java.lang.String |
DTRACEFLT_DIVZERO
Divide-by-zero. |
static java.lang.String |
DTRACEFLT_ILLOP
Illegal operation. |
static java.lang.String |
DTRACEFLT_KPRIV
Invalid kernel access. |
static java.lang.String |
DTRACEFLT_LIBRARY
Library-level fault. |
static java.lang.String |
DTRACEFLT_NOSCRATCH
Out of scratch space. |
static java.lang.String |
DTRACEFLT_TUPOFLOW
Tuple stack overflow. |
static java.lang.String |
DTRACEFLT_UPRIV
Invalid user access. |
Constructor Summary | |
---|---|
Error(ProbeDescription pdesc,
int enabledProbeID,
int errorCPU,
int errorAction,
int errorOffset,
java.lang.String faultName,
long faultAddress,
java.lang.String errorMessage)
Creates a DTrace error with the given properties. |
Method Summary | |
---|---|
int |
getAction()
Gets the error-inducing action as the nth action (starting at one) in the error-inducing probe, or zero if the error is in the predicate rather than in an action. |
long |
getAddress()
Gets the address of the fault, if any. |
int |
getCPU()
Gets the CPU that encountered the error. |
java.lang.String |
getDefaultMessage()
Gets the default message from the native DTrace library preconstructed from the properties of this error. |
int |
getEnabledProbeID()
Gets the enabled probe ID. |
java.lang.String |
getFault()
Gets the name identifying the specific fault. |
int |
getOffset()
Gets the error offset in compiled DTrace Intermediate Format (DIF), or a negative number if the offset is not available. |
ProbeDescription |
getProbeDescription()
Gets the probe description that identifies the error-inducing probe among all the probes on the system. |
java.lang.String |
toString()
Gets a string representation of this error useful for logging and not intended for display. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final java.lang.String DTRACEFLT_BADADDR
public static final java.lang.String DTRACEFLT_BADALIGN
public static final java.lang.String DTRACEFLT_ILLOP
public static final java.lang.String DTRACEFLT_DIVZERO
public static final java.lang.String DTRACEFLT_NOSCRATCH
public static final java.lang.String DTRACEFLT_KPRIV
public static final java.lang.String DTRACEFLT_UPRIV
public static final java.lang.String DTRACEFLT_TUPOFLOW
public static final java.lang.String DTRACEFLT_LIBRARY
Constructor Detail |
---|
public Error(ProbeDescription pdesc, int enabledProbeID, int errorCPU, int errorAction, int errorOffset, java.lang.String faultName, long faultAddress, java.lang.String errorMessage)
pdesc
- probe description that identifies the error-inducing
probe among all the probes on the systemenabledProbeID
- identifies the error-inducing probe among
all probes enabled by the same Consumer
errorCPU
- non-negative ID of the CPU where the error was
encountered, or a negative number if the CPU is unknownerrorAction
- integer that identifies the error-inducing
action as the nth action (starting at one) in the error-inducing
probe, or zero if the error is in the predicate rather than in an
actionerrorOffset
- error offset in compiled DTrace Intermediate
Format (DIF), or a negative number if the offset is not availablefaultName
- name of the specific fault, or null
if the fault is unknown to the Java DTrace APIfaultAddress
- address of fault, or -1 if address is not
applicable to the specific faulterrorMessage
- default message from the native DTrace
library preconstructed from the properties of this error
java.lang.NullPointerException
- if the given probe description or
default message is null
Method Detail |
---|
public ProbeDescription getProbeDescription()
public int getEnabledProbeID()
ProbeDescription.getID()
because it identifies a probe among all
the probes enabled by a Consumer
, rather than among all
the probes on the system.
public int getCPU()
public int getAction()
public int getOffset()
public java.lang.String getFault()
null
if the
fault is unknown to the Java DTrace APIpublic long getAddress()
DTRACEFLT_BADADDR
or DTRACEFLT_BADALIGN
)public java.lang.String getDefaultMessage()
public java.lang.String toString()
class-name[property1 = value1, property2 = value2]
toString
in class java.lang.Object
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |