Class SSHExec
- java.lang.Object
- 
- org.apache.tools.ant.ProjectComponent
- 
- org.apache.tools.ant.Task
- 
- org.apache.tools.ant.taskdefs.optional.ssh.SSHBase
- 
- org.apache.tools.ant.taskdefs.optional.ssh.SSHExec
 
 
 
 
- 
- All Implemented Interfaces:
- java.lang.Cloneable,- LogListener
 
 public class SSHExec extends SSHBase Executes a command on a remote machine via ssh.- Since:
- Ant 1.6 (created February 2, 2003)
 
- 
- 
Field Summary- 
Fields inherited from class org.apache.tools.ant.ProjectComponentdescription, location, project
 
- 
 - 
Constructor SummaryConstructors Constructor Description SSHExec()Constructor for SSHExecTask.
 - 
Method SummaryModifier and Type Method Description voidexecute()Execute the command on the remote host.voidsetAppend(boolean append)Determines if the output is appended to the file given insetOutput.voidsetCommand(java.lang.String command)Sets the command to execute on the remote host.voidsetCommandResource(java.lang.String f)Sets a commandResource from a filevoidsetErrAppend(boolean appenderr)Determines if the output is appended to the file given insetErrorOutput.voidsetErrorOutput(java.io.File output)If used, stores the erroutput of the command to the given file.voidsetErrorproperty(java.lang.String property)If set, the erroroutput of the command will be stored in the given property.voidsetInput(java.io.File input)If used, the content of the file is piped to the remote commandvoidsetInputProperty(java.lang.String inputProperty)If used, the content of the property is piped to the remote commandvoidsetInputString(java.lang.String inputString)If used, the string is piped to the remote command.voidsetOutput(java.io.File output)If used, stores the output of the command to the given file.voidsetOutputproperty(java.lang.String property)If set, the output of the command will be stored in the given property.voidsetResultproperty(java.lang.String property)If set, the exitcode of the command will be stored in the given property.voidsetSuppressSystemErr(boolean suppressSystemErr)If suppressSystemErr istrue, output will not be sent to System.err, if suppressSystemErr isfalse, normal behaviorvoidsetSuppressSystemOut(boolean suppressSystemOut)If suppressSystemOut istrue, output will not be sent to System.out, if suppressSystemOut isfalse, normal behaviorvoidsetTimeout(long timeout)The connection can be dropped after a specified number of milliseconds.voidsetUsePty(boolean b)Whether a pseudo-tty should be allocated.voidsetUseSystemIn(boolean useSystemIn)If set, input will be taken from System.in- 
Methods inherited from class org.apache.tools.ant.taskdefs.optional.ssh.SSHBasegetFailonerror, getHost, getPort, getServerAliveCountMax, getServerAliveIntervalSeconds, getUserInfo, getVerbose, init, openSession, setFailonerror, setHost, setKeyfile, setKnownhosts, setPassphrase, setPassword, setPort, setServerAliveCountMax, setServerAliveIntervalSeconds, setTrust, setUsername, setVerbose
 - 
Methods inherited from class org.apache.tools.ant.TaskbindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType
 - 
Methods inherited from class org.apache.tools.ant.ProjectComponentclone, getDescription, getLocation, getProject, setDescription, setLocation, setProject
 - 
Methods inherited from class java.lang.Objectequals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 - 
Methods inherited from interface org.apache.tools.ant.taskdefs.optional.ssh.LogListenerlog
 
- 
 
- 
- 
- 
Method Detail- 
setCommandpublic void setCommand(java.lang.String command) Sets the command to execute on the remote host.- Parameters:
- command- The new command value
 
 - 
setCommandResourcepublic void setCommandResource(java.lang.String f) Sets a commandResource from a file- Parameters:
- f- the value to use.
- Since:
- Ant 1.7.1
 
 - 
setTimeoutpublic void setTimeout(long timeout) The connection can be dropped after a specified number of milliseconds. This is sometimes useful when a connection may be flaky. Default is 0, which means "wait forever".- Parameters:
- timeout- The new timeout value in seconds
 
 - 
setOutputpublic void setOutput(java.io.File output) If used, stores the output of the command to the given file.- Parameters:
- output- The file to write to.
 
 - 
setErrorOutputpublic void setErrorOutput(java.io.File output) If used, stores the erroutput of the command to the given file.- Parameters:
- output- The file to write to.
- Since:
- Apache Ant 1.9.4
 
 - 
setInputpublic void setInput(java.io.File input) If used, the content of the file is piped to the remote command- Parameters:
- input- The file which provides the input data for the remote command
- Since:
- Ant 1.8.0
 
 - 
setInputPropertypublic void setInputProperty(java.lang.String inputProperty) If used, the content of the property is piped to the remote command- Parameters:
- inputProperty- The property which contains the input data for the remote command.
- Since:
- Ant 1.8.0
 
 - 
setInputStringpublic void setInputString(java.lang.String inputString) If used, the string is piped to the remote command.- Parameters:
- inputString- the input data for the remote command.
- Since:
- Ant 1.8.3
 
 - 
setAppendpublic void setAppend(boolean append) Determines if the output is appended to the file given insetOutput. Default is false, that is, overwrite the file.- Parameters:
- append- True to append to an existing file, false to overwrite.
 
 - 
setErrAppendpublic void setErrAppend(boolean appenderr) Determines if the output is appended to the file given insetErrorOutput. Default is false, that is, overwrite the file.- Parameters:
- appenderr- True to append to an existing file, false to overwrite.
- Since:
- Apache Ant 1.9.4
 
 - 
setOutputpropertypublic void setOutputproperty(java.lang.String property) If set, the output of the command will be stored in the given property.- Parameters:
- property- The name of the property in which the command output will be stored.
 
 - 
setErrorpropertypublic void setErrorproperty(java.lang.String property) If set, the erroroutput of the command will be stored in the given property.- Parameters:
- property- The name of the property in which the command erroroutput will be stored.
- Since:
- Apache Ant 1.9.4
 
 - 
setResultpropertypublic void setResultproperty(java.lang.String property) If set, the exitcode of the command will be stored in the given property.- Parameters:
- property- The name of the property in which the exitcode will be stored.
- Since:
- Apache Ant 1.9.4
 
 - 
setUsePtypublic void setUsePty(boolean b) Whether a pseudo-tty should be allocated.- Parameters:
- b- boolean
- Since:
- Apache Ant 1.8.3
 
 - 
setUseSystemInpublic void setUseSystemIn(boolean useSystemIn) If set, input will be taken from System.in- Parameters:
- useSystemIn- True to use System.in as InputStream, false otherwise
- Since:
- Apache Ant 1.9.4
 
 - 
setSuppressSystemOutpublic void setSuppressSystemOut(boolean suppressSystemOut) If suppressSystemOut istrue, output will not be sent to System.out, if suppressSystemOut isfalse, normal behavior- Parameters:
- suppressSystemOut- boolean
- Since:
- Ant 1.9.0
 
 - 
setSuppressSystemErrpublic void setSuppressSystemErr(boolean suppressSystemErr) If suppressSystemErr istrue, output will not be sent to System.err, if suppressSystemErr isfalse, normal behavior- Parameters:
- suppressSystemErr- boolean
- Since:
- Ant 1.9.4
 
 - 
executepublic void execute() throws BuildExceptionExecute the command on the remote host.- Overrides:
- executein class- Task
- Throws:
- BuildException- Most likely a network error or bad parameter.
 
 
- 
 
-