Module ps_parsers :: Class bpl_parser
[show private | hide private]
[frames | no frames]

Class bpl_parser


Breakpoint lists contain module names, function offset addresses and node offset addresses. Breakpoint lists are the main "technology" behind Process Stalker functionality. As such, breakpoint manipulation and filtering are important concepts which this class attempts to abstract.
Method Summary
  __init__(self)
Initialize internal member variables.
  __module_test__(self)
Run a few basic tests to ensure the class is working.
  add_bp_entry(self, module, function, node, dupe_check)
Add a breakpoint entry to the internal lists.
  del_bp_entry(self, index)
Delete the breakpoint entry at the specified index.
Tuple get_bp_entry(self, index)
Get the breakpoint entry at the specified index.
Integer num_entries(self)
Get the entry count for this breakpoint list.
  parse(self, filename)
Open the specified breakpoint list filename and process the data into the internal lists.
  save(self, filename)
Save a breakpoint list to the specified file.

Method Details

__init__(self)
(Constructor)

Initialize internal member variables.

__module_test__(self)

Run a few basic tests to ensure the class is working.

add_bp_entry(self, module, function, node, dupe_check=False)

Add a breakpoint entry to the internal lists.
Parameters:
module - Module name
           (type=String)
function - Function offset address
           (type=DWORD)
node - Node offset address
           (type=DWORD)
dupe_check - Optional flag specifying whether or not to check for duplicates before adding entry (slow).
           (type=Boolean)
Raises:
psx - An exception is raised if the entry to add already exists.

del_bp_entry(self, index)

Delete the breakpoint entry at the specified index.
Parameters:
index - Breakpoint index
           (type=Integer)
Raises:
psx - An exception is raisd if the requested index is out of range.

get_bp_entry(self, index)

Get the breakpoint entry at the specified index.
Parameters:
index - Breakpoint index
           (type=Integer)
Returns:
BP module name, BP function offset address, BP node offset address
           (type=Tuple)
Raises:
psx - An exception is raised if the requested index is out of range.

num_entries(self)

Get the entry count for this breakpoint list.
Returns:
Breakpoint count
           (type=Integer)

parse(self, filename)

Open the specified breakpoint list filename and process the data into the internal lists. Breakpoint list format:
   module:function offset address:node offset address
   irc.dll:00000000:00000000
Parameters:
filename - Filename
           (type=String)
Raises:
psx - An exception is raised if requested breakpoint list can not be opened.

save(self, filename)

Save a breakpoint list to the specified file. The contents of the breakpoint list are generated from our internal variables in sorted order. Breakpoint list format:
   module:function offset address:node offset address
   irc.dll:00000000:00000000
Parameters:
filename - Filename
           (type=String)
Raises:
psx - An exception is raised if the specified file can not be opened for writing.

Generated by Epydoc 2.1 on Tue Jul 05 12:05:31 2005 http://epydoc.sf.net