CFLib.org – Execute

Execute(name [, args] [, timeout] [, outputFile])

Last updated October 16, 2002

Download UDF

author

Raymond Camden
Send Email

Version: 1 | Requires: ColdFusion MX | Library: CFMLLib

Rated 1 time(s). Average Rating: 1.0

Description:
Mimics the cfexecute tag.

Return Values:
Returns a string.

Example:

view plain print about

<cfscript>
//x = execute("c:\winnt\system32\netstat.exe","-e",20);
//writeOutput("x is #htmlCodeFormat(x)#");
</cfscript>

<cfscript>
//x = execute("c:\winnt\system32\netstat.exe","-e",20);
//writeOutput("x is #htmlCodeFormat(x)#");
</cfscript>

Parameters:

Name	Description	Required
name	Program to execute.	Yes
args	Args to pass. Can be string or array.	No
timeout	Time to wait for program execution.	No
outputFile	File to save results.	No

Full UDF Source:

	
	
			
			
			
				
				view plain
				
				
				copy to clipboard
				
				
				
				
				print
				
				
				about
				ColdFISH is developed by Jason Delmore.  Source code and license information available at coldfish.riaforge.org.  Version 3.1.1
				
			<!---
 Mimics the cfexecute tag.
 Updated for CFMX var scope.
 
 @param name 	 Program to execute. (Required)
 @param args 	 Args to pass. Can be string or array. (Optional)
 @param timeout 	 Time to wait for program execution. (Optional)
 @param outputFile 	 File to save results. (Optional)
 @return Returns a string. 
 @author Raymond Camden (&#114;&#97;&#121;&#64;&#99;&#97;&#109;&#100;&#101;&#110;&#102;&#97;&#109;&#105;&#108;&#121;&#46;&#99;&#111;&#109;) 
 @version 1, October 16, 2002 
--->
<cffunction name="execute" output="false" returnType="string">
	<cfargument name="name" type="string" required="true">
	<cfargument name="args" type="any" required="false" default="">
	<cfargument name="timeout" type="string" required="false" default="0">
	<cfargument name="outputfile" type="string" required="false" default="">

	<cfset var result = "">
	
	<cfsavecontent variable="result">
		<cfif len(outputFile)>
			<cfexecute name="#name#" arguments="#args#" timeout="#timeout#" outputfile="#outputfile#"/>
		<cfelse>
			<cfexecute name="#name#" arguments="#args#" timeout="#timeout#"/>
		</cfif>
	</cfsavecontent>
	<cfreturn result>
</cffunction>
		<!---
 Mimics the cfexecute tag.
 Updated for CFMX var scope.
 
 @param name      Program to execute. (Required)
 @param args      Args to pass. Can be string or array. (Optional)
 @param timeout      Time to wait for program execution. (Optional)
 @param outputFile      File to save results. (Optional)
 @return Returns a string. 
 @author Raymond Camden (ray@camdenfamily.com) 
 @version 1, October 16, 2002 
--->
<cffunction name="execute" output="false" returnType="string">
    <cfargument name="name" type="string" required="true">
    <cfargument name="args" type="any" required="false" default="">
    <cfargument name="timeout" type="string" required="false" default="0">
    <cfargument name="outputfile" type="string" required="false" default="">

    <cfset var result = "">
    
    <cfsavecontent variable="result">
        <cfif len(outputFile)>
            <cfexecute name="#name#" arguments="#args#" timeout="#timeout#" outputfile="#outputfile#"/>
        <cfelse>
            <cfexecute name="#name#" arguments="#args#" timeout="#timeout#"/>
        </cfif>
    </cfsavecontent>
    <cfreturn result>
</cffunction>