Perl

Open an SSH Session Channel

Demonstrates the Chilkat Ssh.OpenSessionChannel method, which opens a new SSH session channel. It takes no arguments and returns the channel number, or -1 on failure. The transport must already be connected and authenticated.

Background: SSH multiplexes independent channels over one authenticated connection, and a session channel is the one used to run a command, start a shell, or invoke a subsystem. Opening the channel is only the container — nothing runs until you follow it with an exec, shell, or subsystem request. Always test for a negative return rather than assuming success.

Chilkat Perl Downloads

Download Chilkat for Perl

Chilkat2 Perl

use strict;
use warnings;
use Chilkat2;

# Demonstrates the Ssh.OpenSessionChannel method, which opens a new SSH session channel.  It
# takes no arguments and returns the channel number, or -1 on failure.  The transport must
# already be connected and authenticated.

my $ssh = Chilkat2::Ssh->new;

my $sshPort = 22;
my $success = $ssh->Connect('ssh.example.com', $sshPort);
if (!$success) {
    print $ssh->LastErrorText, "\n";
    exit;
}

# 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.
my $password = 'mySshPassword';

$success = $ssh->AuthenticatePw('mySshLogin', $password);
if (!$success) {
    print $ssh->LastErrorText, "\n";
    exit;
}

# Open a session channel.  A negative return value indicates failure.
my $channelNum = $ssh->OpenSessionChannel();
if ($channelNum < 0) {
    print $ssh->LastErrorText, "\n";
    exit;
}

print 'Opened session channel: ', $channelNum, "\n";

# Opening the channel does not start a shell or command -- send an exec, shell, or subsystem
# request next.

$ssh->Disconnect();