Sample code for 30+ languages & platforms
Delphi ActiveX

SSH ReceiveUntilMatchN

Demonstrates how to call the SSH ChannelReceiveUntilMatchN method.

Chilkat Delphi ActiveX Downloads

Delphi ActiveX
uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Chilkat_TLB;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Integer;
ssh: TChilkatSsh;
saPrompts: TCkStringArray;
cmdOutput: WideString;
hostname: WideString;
port: Integer;
channelNum: Integer;
termType: WideString;
widthInChars: Integer;
heightInChars: Integer;
pixWidth: Integer;
pixHeight: Integer;
caseSensitiveMatch: Integer;
pollTimeoutMs: Integer;
n: Integer;

begin
success := 0;

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

ssh := TChilkatSsh.Create(Self);

// For the sake of the example, pretend the remote shell prompt
// will be any of the following:
saPrompts := TCkStringArray.Create(Self);

saPrompts.Append('~$');
saPrompts.Append('mars#');
saPrompts.Append('jupiter%');
saPrompts.Append('chilkat$');
saPrompts.Append('admin>');

// Connect to an SSH server:
// Hostname may be an IP address or hostname:
hostname := 'www.some-ssh-server.com';
port := 22;

success := ssh.Connect(hostname,port);
if (success <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

// Wait a max of 10 seconds when reading responses..
ssh.IdleTimeoutMs := 10000;

// Authenticate using login/password:
success := ssh.AuthenticatePw('myLogin','myPassword');
if (success <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

// Open a session channel.  (It is possible to have multiple
// session channels open simultaneously.)
channelNum := ssh.OpenSessionChannel();
if (channelNum < 0) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

termType := 'dumb';
widthInChars := 120;
heightInChars := 40;
// Use 0 for pixWidth and pixHeight when the dimensions
// are set in number-of-chars.
pixWidth := 0;
pixHeight := 0;
success := ssh.SendReqPty(channelNum,termType,widthInChars,heightInChars,pixWidth,pixHeight);
if (success <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

// Start a shell on the channel:
success := ssh.SendReqShell(channelNum);
if (success <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

//  Run the 1st command in the remote shell, which will be to
//  "cd" to a subdirectory.
success := ssh.ChannelSendString(channelNum,'cd workspace' + #10,'utf-8');
if (success <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

// Retrieve the output to the next prompt:
caseSensitiveMatch := 1;
success := ssh.ChannelReceiveUntilMatchN(channelNum,saPrompts.ControlInterface,'utf-8',caseSensitiveMatch);
if (success <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

//  Display what we've received so far.  This clears
//  the internal receive buffer, which is important.
//  After we send the command, we'll be reading until
//  the next command prompt.  If the command prompt
//  is already in the internal receive buffer, it'll think it's
//  already finished...
cmdOutput := ssh.GetReceivedText(channelNum,'utf-8');
if (ssh.LastMethodSuccess <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;
Memo1.Lines.Add(cmdOutput);

//  Run the 2nd command in the remote shell, which will be
//  to "ls" the directory.
success := ssh.ChannelSendString(channelNum,'ls' + #10,'utf-8');
if (success <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

// Retrieve and display the output.
success := ssh.ChannelReceiveUntilMatchN(channelNum,saPrompts.ControlInterface,'utf-8',caseSensitiveMatch);
if (success <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

cmdOutput := ssh.GetReceivedText(channelNum,'utf-8');
if (ssh.LastMethodSuccess <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;
Memo1.Lines.Add(cmdOutput);

//  Start the final command in the remote shell.  This example
//  will send a "ls -l" command to retrieve the long format directory listing.
success := ssh.ChannelSendString(channelNum,'ls -l' + #10,'utf-8');
if (success <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

// Send an EOF.  This tells the server that no more data will 
// be sent on this channel.  The channel remains open, and
// the SSH client may still receive output on this channel.
success := ssh.ChannelSendEof(channelNum);
if (success <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

// Read whatever output may already be available on the
// SSH connection.  ChannelReadAndPoll returns the number of bytes
// that are available in the channel's internal buffer that
// are ready to be "picked up" by calling GetReceivedText
// or GetReceivedData.
// A return value of -1 indicates failure.
// A return value of -2 indicates a failure via timeout.

// The ChannelReadAndPoll method waits
// for data to arrive on the connection usingi the IdleTimeoutMs
// property setting.  Once the first data arrives, it continues
// reading but instead uses the pollTimeoutMs passed in the 2nd argument:
// A return value of -2 indicates a timeout where no data is received.
pollTimeoutMs := 2000;
n := ssh.ChannelReadAndPoll(channelNum,pollTimeoutMs);
if (n < 0) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

// Close the channel:
success := ssh.ChannelSendClose(channelNum);
if (success <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

// Perhaps we did not receive all of the commands output.
// To make sure,  call ChannelReceiveToClose to accumulate any remaining
// output until the server's corresponding "channel close" is received.
success := ssh.ChannelReceiveToClose(channelNum);
if (success <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;

cmdOutput := ssh.GetReceivedText(channelNum,'utf-8');
if (ssh.LastMethodSuccess <> 1) then
  begin
    Memo1.Lines.Add(ssh.LastErrorText);
    Exit;
  end;
Memo1.Lines.Add(cmdOutput);

// Disconnect
ssh.Disconnect();
end;