Delphi DLL

SSH Tunnel Listener Activity Log

Demonstrates the listener-log properties KeepAcceptLog, AcceptLog, and AcceptLogPath, which record the activity of the background listener thread started by BeginAccepting.

Note: The log paths are relative to the application's current working directory. Absolute paths may also be used.

Background: Because the listener runs on a background thread, an activity log is often the only practical way to see what it is doing — which connections it accepted and when. KeepAcceptLog must be enabled for the in-memory AcceptLog to be populated; AcceptLogPath is an independent file-based log that persists across the run. This log covers the listener specifically, as distinct from the TunnelLog that records the SSH tunnel threads.

Chilkat Delphi DLL Downloads

Download Chilkat for Delphi DLL

Delphi DLL

var
success: Boolean;
tunnel: HCkSshTunnel;
sshPort: Integer;
password: PWideChar;
listenPort: Integer;
waitForThreadExit: Boolean;

begin
success := False;

//  Demonstrates the SshTunnel listener-log properties KeepAcceptLog, AcceptLog, and AcceptLogPath.
//  
//  These log the activity of the background listener thread started by BeginAccepting.

tunnel := CkSshTunnel_Create();

//  Retain the listener activity log in memory so it can be read from the AcceptLog property.
CkSshTunnel_putKeepAcceptLog(tunnel,True);

//  Optionally also write the listener activity to a file (separate from the in-memory log).
CkSshTunnel_putAcceptLogPath(tunnel,'qa_output/accept.log');

CkSshTunnel_putDestHostname(tunnel,'db.internal.example.com');
CkSshTunnel_putDestPort(tunnel,5432);

sshPort := 22;
success := CkSshTunnel_Connect(tunnel,'ssh.example.com',sshPort);
if (success = False) then
  begin
    Memo1.Lines.Add(CkSshTunnel__lastErrorText(tunnel));
    Exit;
  end;

//  Normally you would not hard-code the password in source.  You should instead obtain it
//  from an interactive prompt, environment variable, or a secrets vault.
password := 'mySshPassword';

success := CkSshTunnel_AuthenticatePw(tunnel,'mySshLogin',password);
if (success = False) then
  begin
    Memo1.Lines.Add(CkSshTunnel__lastErrorText(tunnel));
    Exit;
  end;

listenPort := 1080;
success := CkSshTunnel_BeginAccepting(tunnel,listenPort);
if (success = False) then
  begin
    Memo1.Lines.Add(CkSshTunnel__lastErrorText(tunnel));
    Exit;
  end;

//  ... the listener accepts connections for a while ...

//  Read the accumulated in-memory listener log.
Memo1.Lines.Add(CkSshTunnel__acceptLog(tunnel));

waitForThreadExit := True;
success := CkSshTunnel_CloseTunnel(tunnel,waitForThreadExit);
if (success = False) then
  begin
    Memo1.Lines.Add(CkSshTunnel__lastErrorText(tunnel));
    Exit;
  end;

CkSshTunnel_Dispose(tunnel);