appc-adapters/appc-ssh-adapter/appc-ssh-adapter-api/src/main/java/org/openecomp/appc/adapter/ssh/SshConnection.java

   1 /*-
   2  * ============LICENSE_START=======================================================
   3  * openECOMP : APP-C
   4  * ================================================================================
   5  * Copyright (C) 2017 AT&T Intellectual Property. All rights
   6  *                                              reserved.
   7  * ================================================================================
   8  * Licensed under the Apache License, Version 2.0 (the "License");
   9  * you may not use this file except in compliance with the License.
  10  * You may obtain a copy of the License at
  11  *
  12  *      http://www.apache.org/licenses/LICENSE-2.0
  13  *
  14  * Unless required by applicable law or agreed to in writing, software
  15  * distributed under the License is distributed on an "AS IS" BASIS,
  16  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  17  * See the License for the specific language governing permissions and
  18  * limitations under the License.
  19  * ============LICENSE_END=========================================================
  20  */
  21
  22 package org.openecomp.appc.adapter.ssh;
  23
  24 import java.io.OutputStream;
  25
  26 /**
  27  * Provides utility method(s) to call commands on remote host via SSH.
  28  */
  29 public interface SshConnection {
  30
  31         /**
  32          * Connect to SSH server.
  33          */
  34         void connect();
  35
  36         /**
  37          * Disconnect from SSH server.
  38          */
  39         void disconnect();
  40
  41         /**
  42          * Exec remote command over SSH. Return command execution status.
  43          * Command output is written to out or err stream.
  44          *
  45          * @param cmd command to execute
  46          * @param out content of sysout will go to this stream
  47          * @param err content of syserr will go to this stream
  48          * @return command execution status
  49          */
  50         int execCommand(String cmd, OutputStream out, OutputStream err);
  51
  52         /**
  53          * Exec remote command over SSH with pseudo-tty. Return command execution status.
  54          * Command output is written to out stream only as pseudo-tty writes to one stream only.
  55          *
  56          * @param cmd command to execute
  57          * @param out content of sysout will go to this stream
  58          * @return command execution status
  59          */
  60         int execCommandWithPty(String cmd, OutputStream out);
  61
  62         /**
  63          * Set the command execution timeout
  64          * @param timeout time in milliseconds
  65      */
  66         void setExecTimeout(long timeout);
  67 }