public interface ICDITraceManager extends ICDISessionObject
Modifier and Type | Method and Description |
---|---|
void |
allowProgramInterruption(boolean allow)
Allows the manager to interrupt the excution of program
when setting a tracepoint.
|
ICDILocation |
createLocation(java.math.BigInteger address)
Creates an ICDILocation object for given address.
|
ICDILocation |
createLocation(java.lang.String file,
java.lang.String function,
int line)
Creates an ICDILocation object for given file name and line number or function.
|
void |
deleteAllTracepoints()
Deletes all tracepoints.
|
void |
deleteTracepoint(ICDITracepoint tracepoint)
Deletes the given tracepoint.
|
void |
deleteTracepoints(ICDITracepoint[] tracepoints)
Deletes the given array of tracepoints.
|
void |
enableSnapshotMode(boolean enabled)
Enables/disables the snapshot debugging mode.
|
ICDITraceSnapshot[] |
getSnapshots()
Returns all trace snapshots for this session.
|
ICDITraceSnapshot[] |
getSnapshots(ICDILocation[] locations)
Returns all trace snapshots associated with the given locations.
|
ICDITraceSnapshot[] |
getSnapshots(ICDITracepoint[] tracepoints)
Returns all trace snapshots associated with the given tracepoints.
|
ICDITracepoint[] |
getTracepoints()
Returns a collection of all tracepoints set for this session.
|
boolean |
isTracing()
Returns the status of tracing.
|
ICDITracepoint |
setTracepoint(ICDILocation location)
Sets a tracepoint at the given location.
|
void |
startTracing()
Starts the tracing and begins collecting data.
|
void |
stopTracing()
Stops the tracing and ends collecting data.
|
getSession
ICDITracepoint[] getTracepoints() throws CDIException
CDIException
- on failure. Reasons include:void deleteTracepoint(ICDITracepoint tracepoint) throws CDIException
tracepoint
- - a tracepoint to be deletedCDIException
- on failure. Reasons include:void deleteTracepoints(ICDITracepoint[] tracepoints) throws CDIException
tracepoints
- - the array of tracepoints to be deletedCDIException
- on failure. Reasons include:void deleteAllTracepoints() throws CDIException
CDIException
- on failure. Reasons include:ICDITracepoint setTracepoint(ICDILocation location) throws CDIException
if location.getFile() != null then if location.getFunction() != null then tracepoint = file:function else tracepoint = file:line else if (location.getFuntion() != null) then tracepoint = function else if (location.getLineNumber() != 0 then tracepoint = line else tracepoint = address end
location
- - the locationCDIException
- on failure. Reasons include:void allowProgramInterruption(boolean allow)
void startTracing() throws CDIException
CDIException
- on failure. Reasons include:void stopTracing() throws CDIException
CDIException
- on failure. Reasons include:boolean isTracing() throws CDIException
CDIException
- on failure. Reasons include:void enableSnapshotMode(boolean enabled) throws CDIException
enabled
- true
to enable, and false
to disableCDIException
- on failure. Reasons include:ICDITraceSnapshot[] getSnapshots() throws CDIException
CDIException
- on failure. Reasons include:ICDITraceSnapshot[] getSnapshots(ICDITracepoint[] tracepoints) throws CDIException
tracepoints
- - an array of tracepointsCDIException
- on failure. Reasons include:ICDITraceSnapshot[] getSnapshots(ICDILocation[] locations) throws CDIException
locations
- - an array of locationsCDIException
- on failure. Reasons include:ICDILocation createLocation(java.lang.String file, java.lang.String function, int line)
file
- - a file namefunction
- - a function nameline
- - a line numberICDILocation createLocation(java.math.BigInteger address)
address
- - an addressCopyright (c) IBM Corp. and others 2004, 2014. All Rights Reserved.