ExecDos plug-in - Revision history

Faph: conda execute links

2015-10-30T18:10:15Z

conda execute links

â† Older revision		Revision as of 18:10, 30 October 2015
Line 5:		Line 5:
	<attach>ExecDos.zip</attach><br>		<attach>ExecDos.zip</attach><br>
	[http://forums.winamp.com/showthread.php?threadid=181442 Forum thread]		[http://forums.winamp.com/showthread.php?threadid=181442 Forum thread]

			Run with <code>conda execute</code> or install with <code>conda install</code> (see [[Conda]]).

	== Description ==		== Description ==

Bugmenot: /* Example */ formatting

2015-03-17T00:17:29Z

Example: formatting

â† Older revision		Revision as of 00:17, 17 March 2015
Line 116:		Line 116:
	</highlight-nsis>		</highlight-nsis>

	'''BAT files specifics.''' On some of Win98 systems where "Close on exit" option is not set for DOS apps it was found		'''BAT files specifics.''' On some of Win98 systems where "Close on exit" option is not set for DOS apps it was found that after '''batch''' execution was finished (and installer continue it's job) hidden window still remains in the system as "winoldapp". Following two lines solve the problem

	that after '''batch''' execution was finished (and installer continue it's job) hidden window still remains in the system as "winoldapp". Following two lines solve the problem
	<pre>		<pre>
	@echo off		@echo off

Bugmenot: /* "exec" function */ typos

2015-03-17T00:15:17Z

"exec" function: typos

â† Older revision		Revision as of 00:15, 17 March 2015
Line 25:		Line 25:
	: 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 to exit. Use 'wait' call if you want to get exit code. (/NOUNLOAD is mandatory!)
	; 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 31:		Line 31:
	: pushes output to stack instead of log_file (do not use log_file_name parameter with this option). May be confusing if few apps puts lines to stack in the async mode.		: pushes output to stack instead of log_file (do not use log_file_name parameter with this option). May be confusing if few apps puts lines to stack in the async mode.
	; DETAILED		; DETAILED
	: puts output to installer' DetailedView window.		: puts output to installer DetailedView window.
	; TOWINDOW		; TOWINDOW
	: adds output lines to target window. Edit, RichEdit, ListView and ListBox supported		: adds output lines to target window. Edit, RichEdit, ListView and ListBox supported
Line 37:		Line 37:
	: pushes output lines to installer stack and calls script function		: pushes output lines to installer stack and calls script function
	; DISABLEFSR		; DISABLEFSR
	:Added /DISABLEFSR switch to disable WOW64 file system redirection on Windows x64 for the internal ExecDos thread		: Added /DISABLEFSR switch to disable WOW64 file system redirection on Windows x64 for the internal ExecDos thread
	; application_to_run		; application_to_run
	: application to run.		: application to run.

Bugmenot: /* Description */ typos

2015-03-17T00:10:28Z

Description: typos

â† Older revision		Revision as of 00:10, 17 March 2015
Line 7:		Line 7:

	== Description ==		== Description ==
	Plug-in works with console applications - creates hidden child process with redirected i/o. ~~Compare~~ to nsExec has four add-ons:		Plug-in works with console applications - creates hidden child process with redirected i/o. Compared to nsExec, ExecDos has four add-ons:
	# string parameter that serves as stdin for running application - may be useful if you want to give login/password to running application;		# string parameter that serves as stdin for running application - may be useful if you want to give login/password to running application;
	# sync/async (background) process launch option - async is good for long running applications;		# sync/async (background) process launch option - async is good for long running applications;
	# it works out of section - for .onInit check outs;		# it works out of section - for .onInit check outs;
	# multithreading - allows to run a few applications at the same time.		# multithreading - allows to run a few applications at the same time.
	Plug-in can put application output to log file, 'detailed' installer window, any other text window, to installer stack or calls script function to handle every line. Maximum input (stdin) string size (i.e. plug-in second parameter) is up to ~~8kB~~ in the special NSIS build, 1 kB otherwise. The same with output lines length if target is not a file.<br>		Plug-in can put application output to log file, 'detailed' installer window, any other text window, to installer stack or calls script function to handle every line. Maximum input (stdin) string size (i.e. plug-in second parameter) is up to 8 kB in the special NSIS build, 1 kB otherwise. The same with output lines length if target is not a file.<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.

Bugmenot: /* Example */ typo

2014-08-06T20:57:17Z

Example: typo

â† Older revision		Revision as of 20:57, 6 August 2014
Line 118:		Line 118:
	'''BAT files specifics.''' On some of Win98 systems where "Close on exit" option is not set for DOS apps it was found		'''BAT files specifics.''' On some of Win98 systems where "Close on exit" option is not set for DOS apps it was found

	that after '''batch''' execution was finished (and installer continue it's job) hidden window still remains in the system		that after '''batch''' execution was finished (and installer continue it's job) hidden window still remains in the system as "winoldapp". Following two lines solve the problem

	as "winoldapp". Following two lines solve the problem
	<pre>		<pre>
	@echo off		@echo off

220.233.129.230: /* "exec" function */

2012-07-23T03:55:03Z

"exec" function

â† Older revision		Revision as of 03:55, 23 July 2012
Line 20:		Line 20:
	=== "exec" function ===		=== "exec" function ===
	<highlight-nsis>		<highlight-nsis>
	ExecDos::exec [/NOUNLOAD /ASYNC] [/TOSTACK \| /DETAILED \| /TOWINDOW \| /TOFUNC] [/TIMEOUT=xxx] \		ExecDos::exec [/NOUNLOAD /ASYNC] [/TOSTACK \| /DETAILED \| /TOWINDOW \| /TOFUNC \| /DISABLEFSR] [/TIMEOUT=xxx] \
	[/ENDFUNC=func] application_to_run [stdin_string] [log_file_name \| window \| function]		[/ENDFUNC=func] application_to_run [stdin_string] [log_file_name \| window \| function]
	</highlight-nsis>		</highlight-nsis>

220.233.129.230: /* "exec" function */

2012-07-23T03:54:23Z

"exec" function

â† Older revision		Revision as of 03:54, 23 July 2012
Line 36:		Line 36:
	; TOFUNC		; TOFUNC
	: pushes output lines to installer stack and calls script function		: pushes output lines to installer stack and calls script function
			; DISABLEFSR
			:Added /DISABLEFSR switch to disable WOW64 file system redirection on Windows x64 for the internal ExecDos thread
	; application_to_run		; application_to_run
	: application to run.		: application to run.

81.223.37.34: Added a /TOFUNC example

2010-08-05T13:46:49Z

Added a /TOFUNC example

@@ Line 94: / Line 94: @@
 MessageBox MB_OK "Exit code $0"
 Return # Exit Function / Section
 </highlight-nsis>

Afrow UK: /* "isdone" function */

2010-07-08T12:02:32Z

"isdone" function

â† Older revision		Revision as of 12:02, 8 July 2010
Line 54:		Line 54:

	=== "isdone" function ===		=== "isdone" function ===
	<highlight-nsis>ExecDos::isdone handle</highlight-nsis>		<highlight-nsis>ExecDos::isdone /NOUNLOAD handle</highlight-nsis>
	: checks thread is running. Returns 1 if application have exited, 0 if still running, -1 on error. /ASYNC mode only.		: checks thread is running. Returns 1 if application have exited, 0 if still running, -1 on error. /ASYNC mode only.
	; handle		; handle

Zinthose: /* Example */ Added /TOSTACK Example

2009-07-28T16:49:07Z

Example: Added /TOSTACK Example

@@ Line 75: / Line 75: @@
 Pop $0 # return value
 MessageBox MB_OK "Exit code $0"
 </highlight-nsis>