Improve debugger/BP doc + add sample + small fixes in WMI/LocalDebugger + new data in ApiProxy for FunctionBP

This commit is contained in:
Clement Rouault
2016-08-19 15:06:26 +02:00
parent 0d38c1e268
commit 943945225a
9 changed files with 66 additions and 22 deletions
+8 -4
View File
@@ -44,8 +44,6 @@ There is not much documentation for now as the code might change soon.
:class:`Breakpoint`
"""""""""""""""""""
@@ -77,8 +75,14 @@ When a breakpoint is hit, its ``trigger`` function is called with the debugger a
:special-members: __init__
.. note::
MemoryBreakpoint are triggered based on the fault address only (as I don't know a way to get the size of the read/write causing the fault without embeding a disassembler).
MemoryBreakpoint are triggered based on the fault address only (as I don't know a way to get the size of the read/write causing the fault without embedding a disassembler).
This means that a MEMBP at address ``X`` won't be triggered by a write of size 4 at address ``X - 1`` (it's sad I know :( )
This means that a MEMBP at address ``X`` won't be triggered by a write of size 4 at address ``X - 1``. it's sad I know.
.. autoclass:: FunctionBP
:members:
:inherited-members:
:special-members: __init__
+22
View File
@@ -362,6 +362,9 @@ Ouput::
Ask to load <ole32.dll>: exiting process
Single stepping
~~~~~~~~~~~~~~~
.. literalinclude:: ..\..\samples\debugger_membp_singlestep.py
Ouput::
@@ -379,8 +382,27 @@ Ouput::
No more single step: exiting
:class:`windows.debug.FunctionBP`
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. literalinclude:: ..\..\samples\debug_functionbp.py
Ouput::
NtCreateFile of <\??\C:\Windows\syswow64\en-US\calc.exe.mui>: handle = 0xac
Handle manually found! typename=<File>, name=<\Device\HarddiskVolume2\Windows\SysWOW64\en-US\calc.exe.mui>
NtCreateFile of <\Device\DeviceApi\CMApi>: handle = 0x108
Handle manually found! typename=<File>, name=<\Device\DeviceApi>
NtCreateFile of <\??\C:\Windows\Fonts\staticcache.dat>: handle = 0x154
Handle manually found! typename=<File>, name=<\Device\HarddiskVolume2\Windows\Fonts\StaticCache.dat>
Exiting process
.. _sample_local_debugger:
:class:`LocalDebugger`
''''''''''''''''''''''