Debug plug-in - Revision history

Anders: Fixed commands legend

2019-05-25T19:03:44Z

Fixed commands legend

â† Older revision		Revision as of 19:03, 25 May 2019
Line 51:		Line 51:
	Commands:		Commands:

	* '''LM''' - List loaded modules.		* '''LM [Address]''' - List loaded modules.
	* '''~''' - List threads.		* '''~''' - List threads.
	* '''HWND <HWND>''' - Display window information.		* '''HWND <HWND>''' - Display window information.
Line 73:		Line 73:
	20190525 - Anders		20190525 - Anders
	* LM can display extra module information when given a module address.		* LM can display extra module information when given a module address.
	* d ~~commands~~ supports da and du.		* d command supports da and du types.
	* Displays additional HWND properties.		* Displays additional HWND properties.

Anders: v20190525

2019-05-25T19:02:03Z

v20190525

â† Older revision		Revision as of 19:02, 25 May 2019
Line 4:		Line 4:

	== Plugin Info ==		== Plugin Info ==
	* '''Version:''' ~~20190523~~ Alpha		* '''Version:''' 20190525 Alpha
	* '''Type:''' Runtime plug-in		* '''Type:''' Runtime plug-in
	* '''Character encoding:''' Ansi & Unicode		* '''Character encoding:''' Ansi & Unicode
Line 59:		Line 59:
	* '''.formats <Number>''' - Display a number in various formats.		* '''.formats <Number>''' - Display a number in various formats.
	* '''.dvalloc <Bytes>''' - Allocate bytes in the installer address space.		* '''.dvalloc <Bytes>''' - Allocate bytes in the installer address space.
	* '''d<b\|d\|p> <Address> [Count=1]''' - Display byte/dword/pointer at the specified address.		* '''d<b\|d\|p\|a\|u> <Address> [Count=1]''' - Display byte/dword/pointer at the specified address.

	Some of the commands supports the following pseudo-registers: $hWndNSIS, $PEB and $PID.		Some of the commands supports the following pseudo-registers: $hWndNSIS, $PEB and $PID.
Line 71:		Line 71:

	== History ==		== History ==
			20190525 - Anders
			* LM can display extra module information when given a module address.
			* d commands supports da and du.
			* Displays additional HWND properties.

	20190523 - Anders		20190523 - Anders
	* Added FillRegisters export.		* Added FillRegisters export.

Anders: v20190523

2019-05-23T17:48:02Z

v20190523

â† Older revision		Revision as of 17:48, 23 May 2019
Line 4:		Line 4:

	== Plugin Info ==		== Plugin Info ==
	* '''Version:''' ~~20190521~~ Alpha		* '''Version:''' 20190523 Alpha
	* '''Type:''' Runtime plug-in		* '''Type:''' Runtime plug-in
	* '''Character encoding:''' Ansi & Unicode		* '''Character encoding:''' Ansi & Unicode
Line 59:		Line 59:
	* '''.formats <Number>''' - Display a number in various formats.		* '''.formats <Number>''' - Display a number in various formats.
	* '''.dvalloc <Bytes>''' - Allocate bytes in the installer address space.		* '''.dvalloc <Bytes>''' - Allocate bytes in the installer address space.
	* '''d<b\|d\|p> <Address>''' - Display byte/dword/pointer at the specified address.		* '''d<b\|d\|p> <Address> [Count=1]''' - Display byte/dword/pointer at the specified address.

	Some of the commands supports the following pseudo-registers: $hWndNSIS, $~~peb~~ and $~~pid~~.		Some of the commands supports the following pseudo-registers: $hWndNSIS, $PEB and $PID.

	<highlight-nsis>		<highlight-nsis>
Line 68:		Line 68:
	FunctionEnd		FunctionEnd
	</highlight-nsis>		</highlight-nsis>


			== History ==
			20190523 - Anders
			* Added FillRegisters export.
			* d commands supports an optional count parameter.
			* HWND displays DPI value on Win10.
			* Fixed TEB probing crash on NT5.x.

			20190521 - Anders
			* Initial version.

Anders: Created page with "Category:Plugins {{PageAuthor|Anders}} == Plugin Info == * '''Version:''' 20190521 Alpha * '''Type:''' Runtime plug-in * '''Character encoding:''' Ansi & Unicode * '''Mi..."

2019-05-22T18:41:51Z

Created page with "Category:Plugins {{PageAuthor|Anders}} == Plugin Info == * '''Version:''' 20190521 Alpha * '''Type:''' Runtime plug-in * '''Character encoding:''' Ansi & Unicode * '''Mi..."

New page

[[Category:Plugins]]

{{PageAuthor|Anders}}

== Plugin Info ==
* '''Version:''' 20190521 Alpha
* '''Type:''' Runtime plug-in
* '''Character encoding:''' Ansi & Unicode
* '''Minimum OS:''' Win95/NT4
* '''Minimum NSIS Version:''' 2.45
* '''License:''' Freeware
* '''Download:''' <attach>Debug_plug-in.zip</attach>

== Description ==
This plug-in allows you to inspect and modify the installer state.

== Stack dialog ==

The stack dialog allows you to view and edit the stack. This is a modal dialog and works the same way as the [[DumpState_plug-in]].

[[File:Debug_plug-in_Stack.png]]

<highlight-nsis>
Function .onInit
Push "Stack Test"
Debug::Stack
FunctionEnd
</highlight-nsis>

== Watcher dialog ==

The watcher dialog shows a live view of the registers and installer state. This dialog lets you edit registers and state at any time but to avoid crashes you should only do this when the installer is idle.

[[File:Debug_plug-in_Watcher.png]]

<highlight-nsis>
Function .onInit
Debug::Watcher
FunctionEnd
</highlight-nsis>

== Command dialog ==

The command dialog is a WinDbg inspired terminal where you can enter simple commands.

[[File:Debug_plug-in_Command.png]]

Commands:

* '''LM''' - List loaded modules.
* '''~''' - List threads.
* '''HWND <HWND>''' - Display window information.
* '''q''' - Attempts to cancel and quit the installer.
* '''.cls''' - Clear the output window.
* '''.echo''' - Write to the output window.
* '''.formats <Number>''' - Display a number in various formats.
* '''.dvalloc <Bytes>''' - Allocate bytes in the installer address space.
* '''d<b|d|p> <Address>''' - Display byte/dword/pointer at the specified address.

Some of the commands supports the following pseudo-registers: $hWndNSIS, $peb and $pid.

<highlight-nsis>
Function .onInit
Debug::Command
FunctionEnd
</highlight-nsis>