ExecCmd plug-in - Revision history

Afrow UK: /* Links */

2013-07-18T09:46:49Z

Links

â† Older revision		Revision as of 09:46, 18 July 2013
Line 2:		Line 2:

	== Links ==		== Links ==
			<p>'''''This plug-in is no longer updated and has been superseded by the [[ExecDos plug-in]].'''''</p>
	Download:<br>		Download:<br>
	<attach>ExecCmd.zip</attach><br>		<attach>ExecCmd.zip</attach><br>

192.55.195.113: /* "exec" DLL function */

2013-03-28T14:05:08Z

"exec" DLL function

â† Older revision		Revision as of 14:05, 28 March 2013
Line 18:		Line 18:
	: Executes console application.		: Executes console application.
	; ASYNC		; ASYNC
	: ~~Not waits~~ for process exit. Use 'wait' call if you want to get exit code. (/NOUNLOAD is mandatory!)		: Does not wait for process exit. Use 'wait' call if you want to get exit code. (/NOUNLOAD is mandatory!)
	; TEST		; TEST
	: Console window is visible with this key.		: Console window is visible with this key.
Line 24:		Line 24:
	: TOTAL execution time, milliseconds, for example /TIMEOUT=10000. Default is big enough. Short timeouts may cause app to be terminated.		: TOTAL execution time, milliseconds, for example /TIMEOUT=10000. Default is big enough. Short timeouts may cause app to be terminated.
	; application_to_run		; application_to_run
	: application to run. Further " after the executable are not allowed. Use ~~EcexDos~~ instead.		: application to run. Further " after the executable are not allowed. Use ExecDos instead.
	; stdin_string		; stdin_string
	: all that application can get from stdin		: all that application can get from stdin

37.24.49.252: /* Example */

2013-01-09T11:40:49Z

Example

â† Older revision		Revision as of 11:40, 9 January 2013
Line 55:		Line 55:
	" after the executable are not allowed. Use EcexDos instead:		" after the executable are not allowed. Use EcexDos instead:
	<highlight-nsis>		<highlight-nsis>
	;Does not work:		;Does not work (in /TEST mode a console window will pop up but the file will not be executed):
	ExecCmd::exec '"7za.exe" x "file.7z"'		ExecCmd::exec '"7za.exe" x "file.7z"'

37.24.49.252: /* Example */

2013-01-09T11:38:05Z

Example

â† Older revision		Revision as of 11:38, 9 January 2013
Line 51:		Line 51:
	Pop $0 ; return value - process exit code or error or STILL_ACTIVE (0x103).		Pop $0 ; return value - process exit code or error or STILL_ACTIVE (0x103).
	MessageBox MB_OK "Exit code $0"		MessageBox MB_OK "Exit code $0"
			</highlight-nsis>

			" after the executable are not allowed. Use EcexDos instead:
			<highlight-nsis>
			;Does not work:
			ExecCmd::exec '"7za.exe" x "file.7z"'

			;Does work:
			ExecCmd::exec '"7za.exe" x file.7z'
	</highlight-nsis>		</highlight-nsis>

37.24.49.252: /* "exec" DLL function */

2013-01-09T11:32:07Z

"exec" DLL function

â† Older revision		Revision as of 11:32, 9 January 2013
Line 24:		Line 24:
	: TOTAL execution time, milliseconds, for example /TIMEOUT=10000. Default is big enough. Short timeouts may cause app to be terminated.		: TOTAL execution time, milliseconds, for example /TIMEOUT=10000. Default is big enough. Short timeouts may cause app to be terminated.
	; application_to_run		; application_to_run
	: application to run.		: application to run. Further " after the executable are not allowed. Use EcexDos instead.
	; stdin_string		; stdin_string
	: all that application can get from stdin		: all that application can get from stdin

144.228.185.122 at 17:00, 3 July 2007

2007-07-03T17:00:25Z

â† Older revision		Revision as of 17:00, 3 July 2007
Line 7:		Line 7:

	== Description ==		== Description ==
	Plug-in works with console applications - creates hidden child process with stdin from file (<stdin.txt) or sends stdin string to console window using WM_CHAR messages. Second method is more secure (for passwords) but not ~~works~~ on Win98 and earlier systems. On Win98 exit code (Pop value) may be not correct as well. Plug-in has sync and async (background) process launch option - async is good for long running applications and for few applications running at the same time. It works out of section - for .onInit check outs. Maximum input (stdin) string size (i.e. plug-in second parameter) is up to 8kB in the special NSIS build, 1 kB otherwise.<br>		Plug-in works with console applications - creates hidden child process with stdin from file (<stdin.txt) or sends stdin string to console window using WM_CHAR messages. Second method is more secure (for passwords) but does not work on Win98 and earlier systems. On Win98 exit code (Pop value) may be not correct as well. Plug-in has sync and async (background) process launch option - async is good for long running applications and for few applications running at the same time. It works out of section - for .onInit check outs. Maximum input (stdin) string size (i.e. plug-in second parameter) is up to 8kB in the special NSIS build, 1 kB otherwise.<br>
	'exec' return code depends on the execution mode: application exit code for sync mode and control thread handle for async one. Handle required for 'wait' - it helps to understand what application exit to wait for. If stack is not used between 'exec' and 'wait', both Pop after 'exec' and 'wait' parameter may be skipped - handle just sits in the stack.<br>		'exec' return code depends on the execution mode: application exit code for sync mode and control thread handle for async one. Handle required for 'wait' - it helps to understand what application exit to wait for. If stack is not used between 'exec' and 'wait', both Pop after 'exec' and 'wait' parameter may be skipped - handle just sits in the stack.<br>
	Plug-in adds 'ComSpec' env. variable with /C key at the beginnig of the command line, this may additionally limit command line length. Current version was tested on XP - 2003.		Plug-in adds 'ComSpec' env. variable with /C key at the beginnig of the command line, this may additionally limit command line length. Current version was tested on XP - 2003.

Takhir at 07:39, 9 March 2006

2006-03-09T07:39:21Z

â† Older revision		Revision as of 07:39, 9 March 2006
Line 7:		Line 7:

	== Description ==		== Description ==
	Plug-in works with console applications - creates hidden child process with stdin from file (<stdin.txt) or sends stdin string to console window using WM_CHAR messages. Second method is more secure (for passwords) but not works on Win98 and earlier systems. Plug-in has sync and async (background) process launch option - async is good for long running applications and for few applications running at the same time. It works out of section - for .onInit check outs. Maximum input (stdin) string size (i.e. plug-in second parameter) is up to 8kB in the special NSIS build, 1 kB otherwise.<br>		Plug-in works with console applications - creates hidden child process with stdin from file (<stdin.txt) or sends stdin string to console window using WM_CHAR messages. Second method is more secure (for passwords) but not works on Win98 and earlier systems. On Win98 exit code (Pop value) may be not correct as well. Plug-in has sync and async (background) process launch option - async is good for long running applications and for few applications running at the same time. It works out of section - for .onInit check outs. Maximum input (stdin) string size (i.e. plug-in second parameter) is up to 8kB in the special NSIS build, 1 kB otherwise.<br>
	'exec' return code depends on the execution mode: application exit code for sync mode and control thread handle for async one. Handle required for 'wait' - it helps to understand what application exit to wait for. If stack is not used between 'exec' and 'wait', both Pop after 'exec' and 'wait' parameter may be skipped - handle just sits in the stack.<br>		'exec' return code depends on the execution mode: application exit code for sync mode and control thread handle for async one. Handle required for 'wait' - it helps to understand what application exit to wait for. If stack is not used between 'exec' and 'wait', both Pop after 'exec' and 'wait' parameter may be skipped - handle just sits in the stack.<br>
	Plug-in adds 'ComSpec' env. variable with /C key at the beginnig of the command line, this may additionally limit command line length. Current version was tested on XP - 2003.		Plug-in adds 'ComSpec' env. variable with /C key at the beginnig of the command line, this may additionally limit command line length. Current version was tested on XP - 2003.

Takhir at 07:37, 9 March 2006

2006-03-09T07:37:09Z

â† Older revision		Revision as of 07:37, 9 March 2006
Line 7:		Line 7:

	== Description ==		== Description ==
	Plug-in works with console applications - creates hidden child process ~~and~~ sends stdin string to console window using WM_CHAR messages. Plug-in has sync and async (background) process launch option - async is good for long running applications and for few applications running at the same time. It works out of section - for .onInit check outs. Maximum input (stdin) string size (i.e. plug-in second parameter) is up to 8kB in the special NSIS build, 1 kB otherwise.<br>		Plug-in works with console applications - creates hidden child process with stdin from file (<stdin.txt) or sends stdin string to console window using WM_CHAR messages. Second method is more secure (for passwords) but not works on Win98 and earlier systems. Plug-in has sync and async (background) process launch option - async is good for long running applications and for few applications running at the same time. It works out of section - for .onInit check outs. Maximum input (stdin) string size (i.e. plug-in second parameter) is up to 8kB in the special NSIS build, 1 kB otherwise.<br>
	'exec' return code depends on the execution mode: application exit code for sync mode and control thread handle for async one. Handle required for 'wait' - it helps to understand what application exit to wait for. If stack is not used between 'exec' and 'wait', both Pop after 'exec' and 'wait' parameter may be skipped - handle just sits in the stack.<br>		'exec' return code depends on the execution mode: application exit code for sync mode and control thread handle for async one. Handle required for 'wait' - it helps to understand what application exit to wait for. If stack is not used between 'exec' and 'wait', both Pop after 'exec' and 'wait' parameter may be skipped - handle just sits in the stack.<br>
	Plug-in adds 'ComSpec' env. variable with /C key at the beginnig of the command line, this may additionally limit command line length. Current version was tested on XP - 2003.		Plug-in adds 'ComSpec' env. variable with /C key at the beginnig of the command line, this may additionally limit command line length. Current version was tested on XP - 2003.

Takhir at 07:32, 25 January 2006

2006-01-25T07:32:25Z

â† Older revision		Revision as of 07:32, 25 January 2006
Line 8:		Line 8:
	== Description ==		== Description ==
	Plug-in works with console applications - creates hidden child process and sends stdin string to console window using WM_CHAR messages. Plug-in has sync and async (background) process launch option - async is good for long running applications and for few applications running at the same time. It works out of section - for .onInit check outs. Maximum input (stdin) string size (i.e. plug-in second parameter) is up to 8kB in the special NSIS build, 1 kB otherwise.<br>		Plug-in works with console applications - creates hidden child process and sends stdin string to console window using WM_CHAR messages. Plug-in has sync and async (background) process launch option - async is good for long running applications and for few applications running at the same time. It works out of section - for .onInit check outs. Maximum input (stdin) string size (i.e. plug-in second parameter) is up to 8kB in the special NSIS build, 1 kB otherwise.<br>
	'exec' return code depends on the execution mode: application exit code for sync mode and control thread handle for async one. Handle required for 'wait' - it helps to understand what application exit to wait for. If stack is not used between 'exec' and 'wait', both Pop after 'exec' and 'wait' parameter may be skipped - handle just sits in the stack.		'exec' return code depends on the execution mode: application exit code for sync mode and control thread handle for async one. Handle required for 'wait' - it helps to understand what application exit to wait for. If stack is not used between 'exec' and 'wait', both Pop after 'exec' and 'wait' parameter may be skipped - handle just sits in the stack.<br>
			Plug-in adds 'ComSpec' env. variable with /C key at the beginnig of the command line, this may additionally limit command line length. Current version was tested on XP - 2003.

	== Syntax ==		== Syntax ==
	=== "exec" DLL function ===		=== "exec" DLL function ===
	<highlight-nsis>		<highlight-nsis>
	ExecCmd::exec [/NOUNLOAD /ASYNC] [/TIMEOUT=xxx] application_to_run stdin_string		ExecCmd::exec [/NOUNLOAD /ASYNC] [/TEST] [/TIMEOUT=xxx] application_to_run stdin_string
	</highlight-nsis>		</highlight-nsis>
	: Executes console application.		: Executes console application.
	; ASYNC		; ASYNC
	: Not waits for process exit. Use 'wait' call if you want to get exit code. (/NOUNLOAD is mandatory!)		: Not waits for process exit. Use 'wait' call if you want to get exit code. (/NOUNLOAD is mandatory!)
			; TEST
			: Console window is visible with this key.
	; TIMEOUT		; TIMEOUT
	: TOTAL execution time, milliseconds, for example /TIMEOUT=10000. Default is big enough. Short timeouts may cause app to be terminated.		: TOTAL execution time, milliseconds, for example /TIMEOUT=10000. Default is big enough. Short timeouts may cause app to be terminated.
Line 34:		Line 37:
	Async execution with stdout to file:		Async execution with stdout to file:
	<highlight-nsis>		<highlight-nsis>
	~~ReadEnvStr $0 "ComSpec"~~
	ExecCmd::exec /NOUNLOAD /ASYNC /TIMEOUT=2000 \		ExecCmd::exec /NOUNLOAD /ASYNC /TIMEOUT=2000 \
	'~~$0 /C~~ "$EXEDIR\consApp.exe" >ExecCmd.log' "test_login$\r$\ntest_pwd$\r$\n"		'"$EXEDIR\consApp.exe" >ExecCmd.log' "test_login$\r$\ntest_pwd$\r$\n"
	Pop $0 # thread handle for wait		Pop $0 # thread handle for wait
	# you can add some installation code here to execute while application is running.		# you can add some installation code here to execute while application is running.

Takhir at 12:25, 24 January 2006

2006-01-24T12:25:44Z

â† Older revision		Revision as of 12:25, 24 January 2006
Line 26:		Line 26:

	=== "wait" DLL function ===		=== "wait" DLL function ===
	<highlight-nsis>~~ExecDos~~::wait handle</highlight-nsis>		<highlight-nsis>ExecCmd::wait handle</highlight-nsis>
	: Waits for process exit.		: Waits for process exit.
	; handle		; handle