NsExec plug-in - Revision history

Anders: /* Usage */ Include pop since people seem to forget them

2022-02-25T18:53:48Z

Usage: Include pop since people seem to forget them

â† Older revision		Revision as of 18:53, 25 February 2022
Line 2:		Line 2:

	== Usage ==		== Usage ==
	<highlight-nsis>nsExec::Exec [/OEM] [/TIMEOUT=x] path</highlight-nsis>		<highlight-nsis>nsExec::Exec [/OEM] [/TIMEOUT=x] path
			Pop $ExitCode</highlight-nsis>

	or		or

	<highlight-nsis>nsExec::ExecToLog [/OEM] [/TIMEOUT=x] path</highlight-nsis>		<highlight-nsis>nsExec::ExecToLog [/OEM] [/TIMEOUT=x] path
			Pop $ExitCode</highlight-nsis>

	or		or

	<highlight-nsis>nsExec::ExecToStack [/OEM] [/TIMEOUT=x] path</highlight-nsis>		<highlight-nsis>nsExec::ExecToStack [/OEM] [/TIMEOUT=x] path
			Pop $ExitCode
			Pop $StdOutText</highlight-nsis>

	All functions are the same except ExecToLog will print the output to the log window and ExecToStack will push up to <code>${NSIS_MAX_STRLEN}</code> characters of output onto the stack after the return value.		All functions are the same except ExecToLog will print the output to the log window and ExecToStack will push up to <code>${NSIS_MAX_STRLEN}</code> characters of output onto the stack after the return value.
Line 20:		Line 24:
	To ensure that command are executed without problems on all windows versions, is recommended to use the following syntax:		To ensure that command are executed without problems on all windows versions, is recommended to use the following syntax:

	<highlight-nsis>nsExec::ExecToStack [OPTIONS] '"PATH" param1 param2 paramN'</highlight-nsis>		<highlight-nsis>nsExec::ExecToStack [OPTIONS] '"PATH" param1 param2 paramN'
			Pop $ExitCode</highlight-nsis>

	This way the application path may contain non [[:wikipedia:8.3 filename\|8.3 paths]] (with spaces)		This way the application path may contain non [[:wikipedia:8.3 filename\|8.3 paths]] (with spaces)

Bugmenot at 09:16, 12 May 2017

2017-05-12T09:16:26Z

â† Older revision		Revision as of 09:16, 12 May 2017
Line 1:		Line 1:

	nsExec will execute command-line based programs and capture the output without opening a dos box.		nsExec will execute command-line based programs and capture the output without opening a dos box.


	== Usage ==		== Usage ==

Bugmenot: /* Usage */

2017-05-12T09:15:46Z

Usage: <highlight-nsis>

â† Older revision		Revision as of 09:15, 12 May 2017
Line 4:		Line 4:

	== Usage ==		== Usage ==
			<highlight-nsis>nsExec::Exec [/OEM] [/TIMEOUT=x] path</highlight-nsis>
	nsExec::Exec [/OEM] [/TIMEOUT=x] path

	or		or

	nsExec::ExecToLog [/OEM] [/TIMEOUT=x] path		<highlight-nsis>nsExec::ExecToLog [/OEM] [/TIMEOUT=x] path</highlight-nsis>

	or		or

	nsExec::ExecToStack [/OEM] [/TIMEOUT=x] path		<highlight-nsis>nsExec::ExecToStack [/OEM] [/TIMEOUT=x] path</highlight-nsis>

	All functions are the same except ExecToLog will print the output to the log window and ExecToStack will push up to <code>${NSIS_MAX_STRLEN}</code> characters of output onto the stack after the return value.		All functions are the same except ExecToLog will print the output to the log window and ExecToStack will push up to <code>${NSIS_MAX_STRLEN}</code> characters of output onto the stack after the return value.
Line 23:		Line 22:
	To ensure that command are executed without problems on all windows versions, is recommended to use the following syntax:		To ensure that command are executed without problems on all windows versions, is recommended to use the following syntax:

	nsExec::ExecToStack [OPTIONS] '"PATH" param1 param2 paramN'		<highlight-nsis>nsExec::ExecToStack [OPTIONS] '"PATH" param1 param2 paramN'</highlight-nsis>

	This way the application path may contain non [[:wikipedia:8.3 filename\|8.3 paths]] (with spaces)		This way the application path may contain non [[:wikipedia:8.3 filename\|8.3 paths]] (with spaces)

Bugmenot: + Category:Plugins

2017-05-12T09:14:03Z

+ Category:Plugins

â† Older revision		Revision as of 09:14, 12 May 2017
Line 45:		Line 45:
	Copyright (c) 2002 Robert Rainwater<br/>		Copyright (c) 2002 Robert Rainwater<br/>
	Thanks to Justin Frankel and Amir Szekely		Thanks to Justin Frankel and Amir Szekely

			[[Category:Plugins]]

Bugmenot: /* Usage */ formatting

2016-10-24T10:50:06Z

Usage: formatting

â† Older revision		Revision as of 10:50, 24 October 2016
Line 5:		Line 5:
	== Usage ==		== Usage ==

	nsExec::Exec [/OEM] [/TIMEOUT=x] path		nsExec::Exec [/OEM] [/TIMEOUT=x] path

	or		or

	nsExec::ExecToLog [/OEM] [/TIMEOUT=x] path		nsExec::ExecToLog [/OEM] [/TIMEOUT=x] path

	or		or

	nsExec::ExecToStack [/OEM] [/TIMEOUT=x] path		nsExec::ExecToStack [/OEM] [/TIMEOUT=x] path

	All functions are the same except ExecToLog will print the output to the log window and ExecToStack will push up to <code>${NSIS_MAX_STRLEN}</code> characters of output onto the stack after the return value.		All functions are the same except ExecToLog will print the output to the log window and ExecToStack will push up to <code>${NSIS_MAX_STRLEN}</code> characters of output onto the stack after the return value.
Line 23:		Line 23:
	To ensure that command are executed without problems on all windows versions, is recommended to use the following syntax:		To ensure that command are executed without problems on all windows versions, is recommended to use the following syntax:

	nsExec::ExecToStack [OPTIONS] '"PATH" param1 param2 paramN'		nsExec::ExecToStack [OPTIONS] '"PATH" param1 param2 paramN'

	This way the application path may contain non [[:wikipedia:8.3 filename\|8.3 paths]] (with spaces)		This way the application path may contain non [[:wikipedia:8.3 filename\|8.3 paths]] (with spaces)

Bugmenot: /* Return value */ example from http://nsis.sourceforge.net/Examples/nsExec/test.nsi

2016-10-24T10:49:21Z

Return value: example from http://nsis.sourceforge.net/Examples/nsExec/test.nsi

â† Older revision		Revision as of 10:49, 24 October 2016
Line 31:		Line 31:
	If nsExec is unable to execute the process, it will return "error" on the top of the stack, if the process timed out it will return "timeout", else it will return the return code from the executed process.		If nsExec is unable to execute the process, it will return "error" on the top of the stack, if the process timed out it will return "timeout", else it will return the return code from the executed process.

			<highlight-nsis>
			nsExec::ExecToStack '"${NSISDIR}\makensis.exe" /VERSION'
			Pop $0 # return value/error/timeout
			Pop $1 # printed text, up to ${NSIS_MAX_STRLEN}
			DetailPrint '"${NSISDIR}\makensis.exe" /VERSION printed: $1'
			DetailPrint ""
			DetailPrint " Return value: $0"
			DetailPrint ""
			</highlight-nsis>

	== Copyright info ==		== Copyright info ==

Bugmenot: /* Copyright Info */ typography

2016-10-24T10:23:34Z

â† Older revision		Revision as of 10:23, 24 October 2016
Line 32:		Line 32:


	== Copyright ~~Info~~ ==		== Copyright info ==

	Copyright (c) 2002 Robert Rainwater<br/>		Copyright (c) 2002 Robert Rainwater<br/>
	Thanks to Justin Frankel and Amir Szekely		Thanks to Justin Frankel and Amir Szekely

Bugmenot: Created page with " nsExec will execute command-line based programs and capture the output without opening a dos box. == Usage == nsExec::Exec [/OEM] [/TIMEOUT=x] path or nsExec::ExecTo..."

2016-10-24T10:20:28Z

Created page with " nsExec will execute command-line based programs and capture the output without opening a dos box. == Usage == nsExec::Exec [/OEM] [/TIMEOUT=x] path or nsExec::ExecTo..."

New page

nsExec will execute command-line based programs and capture the output without opening a dos box.

== Usage ==

nsExec::Exec [/OEM] [/TIMEOUT=x] path

or

nsExec::ExecToLog [/OEM] [/TIMEOUT=x] path

or

nsExec::ExecToStack [/OEM] [/TIMEOUT=x] path

All functions are the same except ExecToLog will print the output to the log window and ExecToStack will push up to <code>${NSIS_MAX_STRLEN}</code> characters of output onto the stack after the return value.

Use the <code>/OEM</code> switch to convert the output text from OEM to ANSI.

The timeout value is optional. The timeout is the time in milliseconds nsExec will wait for output. If output from the process is received, the timeout value is reset and it will again wait for more output using the timeout value. See [[#Return value|Return value]] for how to check if there was a timeout.

To ensure that command are executed without problems on all windows versions, is recommended to use the following syntax:

nsExec::ExecToStack [OPTIONS] '"PATH" param1 param2 paramN'

This way the application path may contain non [[:wikipedia:8.3 filename|8.3 paths]] (with spaces)

== Return value ==

If nsExec is unable to execute the process, it will return "error" on the top of the stack, if the process timed out it will return "timeout", else it will return the return code from the executed process.

== Copyright Info ==

Copyright (c) 2002 Robert Rainwater<br/>
Thanks to Justin Frankel and Amir Szekely