Class InterruptorAgent

Represent a tracing agent

Hierarchy

InterruptorAgent

Implements

IStringIndex

Constructors

constructor

new InterruptorAgent(pOptions, pDoFollowThread?, pInterrupts?): InterruptorAgent
Parameters
- pOptions: InterruptorAgentConfig
- pDoFollowThread: any = null
- pInterrupts: InterruptSignatureMap = null
Returns InterruptorAgent
- Defined in src/common/InterruptorAgent.ts:251

Properties

_do_ft

_do_ft: any = null

_tids

_tids: number[] = []

`Optional` coverage

coverage?: CoverageAgent

debug

debug: DebugOptions = ...

emulator

emulator: boolean

followFork

followFork: boolean = false

followThread

followThread: boolean = false

hook

hook: InterruptorHooks = ...

interrupts

interrupts: InterruptSignatureMap

modules

modules: Module[] = []

onStart

onStart: any = ...

To use with startOnLoad() A callback function executed when the modules specified in "startOnLoad" are loaded

Field

output

output: OutputOpts = ...

pid

pid: number = -1

PID of process to stalk, when followFork is enabled or on attach

Field

ranges

ranges: any = ...

scope

scope: ScopeMap

tid

tid: number = -1

types

types: any = {}

uid

uid: number = 0

`Static` FLAVOR_DXC

FLAVOR_DXC: string = "dxc"

`Static` FLAVOR_STRACE

FLAVOR_STRACE: string = "strace"

Methods

`Private` _filterModuleScope

_filterModuleScope(): void
To compute the list of stalked module from include/exclude options

Returns void

Method
- Defined in src/common/InterruptorAgent.ts:490

`Private` _filterSyscallScope

_filterSyscallScope(): void
Private
Returns void
- Defined in src/common/InterruptorAgent.ts:443

`Protected` _setupDelegateFilters

_setupDelegateFilters(pType, pOpts): void
Protected
Parameters
- pType: string
- pOpts: any
Returns void
- Defined in src/common/InterruptorAgent.ts:340

getModuleList

getModuleList(pFilters, pSrcList?, pList?): string[]
To generate a filtered list of syscalls
Parameters
- pFilters: ScopeFilter[]
- pSrcList: Module[] = []
- pList: string[] = []
Returns string[]

Method
- Defined in src/common/InterruptorAgent.ts:351

getSyscallList

getSyscallList(pSyscalls): number[]
To generate a filtered list of syscalls
Parameters
- pSyscalls: ScopeFilter
  
  An array of syscall number
Returns number[]

Method
- Defined in src/common/InterruptorAgent.ts:390

isTrackCoverage

isTrackCoverage(): boolean
To check if coverage is enabled

Returns boolean
TRUE is coverage is enabled, else FALSE

Methpd
- Defined in src/common/InterruptorAgent.ts:583

parseOptions

parseOptions(pConfig): void
To parse object containing options
Parameters
- pConfig: any
  
  Options
Returns void

Method
- Defined in src/common/InterruptorAgent.ts:275

prepareScope

prepareScope(): void
The aim of this method is to ttr

Returns void
- Defined in src/common/InterruptorAgent.ts:326

printStats

printStats(pSyscallList?): void
To print statistics about implementation
Parameters
- pSyscallList: any[] = []
Returns void
- Defined in src/common/InterruptorAgent.ts:742

processBbsCoverage

processBbsCoverage(pStalkerEvents): void
To process coverage events
Parameters
- pStalkerEvents: StalkerEventFull[] | StalkerEventBare[]
Returns void
- Defined in src/common/InterruptorAgent.ts:592

start

start(pTID?): void
To start to trace
Parameters
- pTID: number = -1
Returns void
- Defined in src/common/InterruptorAgent.ts:621

startOnLoad

startOnLoad(pModuleRegExp, pOptions?): any
To start tracing when a specifc module is loaded, and an optional condition verified

Must be overridden by architecture specific interruptors
Parameters
- pModuleRegExp: RegExp
- pOptions: StartOnLoadOpts = {}
Returns any
- Defined in src/common/InterruptorAgent.ts:613

trace

trace(pStalkerInterator, pInstruction, pExtra): number
Parameters
- pStalkerInterator: any
- pInstruction: any
- pExtra: any
Returns number
- Defined in src/common/InterruptorAgent.ts:600

Class InterruptorAgent

Hierarchy

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

pOptions: InterruptorAgentConfig

pDoFollowThread: any = null

pInterrupts: InterruptSignatureMap = null

Returns InterruptorAgent

Properties

_do_ft

_tids

Optional coverage

debug

emulator

followFork

followThread

hook

interrupts

modules

onStart

Field

output

pid

Field

ranges

scope

tid

types

uid

Static FLAVOR_DXC

Static FLAVOR_STRACE

Methods

Private _filterModuleScope

Returns void

Method

Private _filterSyscallScope

Returns void

Protected _setupDelegateFilters

Parameters

pType: string

pOpts: any

Returns void

getModuleList

Parameters

pFilters: ScopeFilter[]

pSrcList: Module[] = []

pList: string[] = []

Returns string[]

Method

getSyscallList

Parameters

pSyscalls: ScopeFilter

Returns number[]

Method

isTrackCoverage

Returns boolean

Methpd

parseOptions

Parameters

pConfig: any

Returns void

Method

prepareScope

Returns void

printStats

Parameters

pSyscallList: any[] = []

Returns void

processBbsCoverage

Parameters

pStalkerEvents: StalkerEventFull[] | StalkerEventBare[]

Returns void

start

Parameters

`Optional` coverage

`Static` FLAVOR_DXC

`Static` FLAVOR_STRACE

`Private` _filterModuleScope

`Private` _filterSyscallScope

`Protected` _setupDelegateFilters