java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.Task
org.apache.tools.ant.taskdefs.optional.ssh.SSHBase
All Implemented Interfaces:
Cloneable, LogListener
Direct Known Subclasses:
Scp, SSHExec, SSHSession

public abstract class SSHBase extends Task implements LogListener
Base class for Ant tasks using jsch.
Since:
Ant 1.6
  • Constructor Details

    • SSHBase

      public SSHBase()
      Constructor for SSHBase.
  • Method Details

    • setHost

      public void setHost(String host)
      Remote host, either DNS name or IP.
      Parameters:
      host - The new host value
    • getHost

      public String getHost()
      Get the host.
      Returns:
      the host
    • setFailonerror

      public void setFailonerror(boolean failure)
      Set the failonerror flag. Default is true
      Parameters:
      failure - if true throw a build exception when a failure occurs, otherwise just log the failure and continue
    • getFailonerror

      public boolean getFailonerror()
      Get the failonerror flag.
      Returns:
      the failonerror flag
    • setVerbose

      public void setVerbose(boolean verbose)
      Set the verbose flag.
      Parameters:
      verbose - if true output more verbose logging
      Since:
      Ant 1.6.2
    • getVerbose

      public boolean getVerbose()
      Get the verbose flag.
      Returns:
      the verbose flag
      Since:
      Ant 1.6.2
    • getSshConfig

      public String getSshConfig()
      Get the OpenSSH config file (~/.ssh/config).
      Returns:
      the OpenSSH config file
      Since:
      Ant 1.10.8
    • setSshConfig

      public void setSshConfig(String sshConfig)
      Set the OpenSSH config file (~/.ssh/config).
      Parameters:
      sshConfig - the OpenSSH config file
      Since:
      Ant 1.10.8
    • setServerAliveCountMax

      public void setServerAliveCountMax(int countMax)
      Set the serverAliveCountMax value.
      Parameters:
      countMax - int
      Since:
      Ant 1.9.7
    • getServerAliveCountMax

      public int getServerAliveCountMax()
      Get the serverAliveCountMax value.
      Returns:
      the serverAliveCountMax value
      Since:
      Ant 1.9.7
    • setServerAliveIntervalSeconds

      public void setServerAliveIntervalSeconds(int interval)
      Set the serverAliveIntervalSeconds value in seconds.
      Parameters:
      interval - int
      Since:
      Ant 1.9.7
    • getServerAliveIntervalSeconds

      public int getServerAliveIntervalSeconds()
      Get the serverAliveIntervalSeconds value in seconds.
      Returns:
      the serverAliveIntervalSeconds value in seconds
      Since:
      Ant 1.9.7
    • setUsername

      public void setUsername(String username)
      Username known to remote host.
      Parameters:
      username - The new username value
    • setPassword

      public void setPassword(String password)
      Sets the password for the user.
      Parameters:
      password - The new password value
    • setKeyfile

      public void setKeyfile(String keyfile)
      Sets the keyfile for the user.
      Parameters:
      keyfile - The new keyfile value
    • setPassphrase

      public void setPassphrase(String passphrase)
      Sets the passphrase for the users key.
      Parameters:
      passphrase - The new passphrase value
    • setKnownhosts

      public void setKnownhosts(String knownHosts)
      Sets the path to the file that has the identities of all known hosts. This is used by SSH protocol to validate the identity of the host. The default is ${user.home}/.ssh/known_hosts.
      Parameters:
      knownHosts - a path to the known hosts file.
    • setTrust

      public void setTrust(boolean yesOrNo)
      Setting this to true trusts hosts whose identity is unknown.
      Parameters:
      yesOrNo - if true trust the identity of unknown hosts.
    • setPort

      public void setPort(int port)
      Changes the port used to connect to the remote host.
      Parameters:
      port - port number of remote host.
    • getPort

      public int getPort()
      Get the port attribute.
      Returns:
      the port
    • addConfiguredAdditionalConfig

      public void addConfiguredAdditionalConfig(Environment.Variable v)
    • init

      public void init() throws BuildException
      Initialize the task. This initializes the known hosts and sets the default port.
      Overrides:
      init in class Task
      Throws:
      BuildException - on error
    • loadSshConfig

      protected void loadSshConfig() throws BuildException
      Load the SSH configuration file.
      Throws:
      BuildException - on error
    • openSession

      protected com.jcraft.jsch.Session openSession() throws com.jcraft.jsch.JSchException
      Open an ssh session.
      Returns:
      the opened session
      Throws:
      com.jcraft.jsch.JSchException - on error
    • getUserInfo

      protected SSHUserInfo getUserInfo()
      Get the user information.
      Returns:
      the user information