NAME

Net::Appliance::Session::Transport::Telnet - Connections using TELNET

VERSION

version 2.103641

SYNOPSIS

$s = Net::Appliance::Session->new(
   Host      => 'hostname.example',
   Transport => 'Telnet',
);

$s->connect(
   Name     => $username, # required if logging in
   Password => $password, # required if logging in
);

DESCRIPTION

This package makes use of the native Telnet support in Net::Telnet, in order to establish a connection to a remote host.

CONFIGURATION

This module hooks into Net::Appliance::Session via its connect() method. Parameters are supplied to connect() in a hash of named arguments.

Prerequisites

Before calling connect() you must have set the Host key in your Net::Appliance::Session object, either via the named parameter to new() or the host() object method inherited from Net::Telnet.

Required Parameters

Name

If log-in is enabled (i.e. you have not disabled this via do_login()), and the remote host requests a username, then you must supply a username in the Name parameter value. The username will be stored for possible later use by begin_privileged().

Password

If log-in is enabled (i.e. you have not disabled this via do_login()) then you must supply a password in the Password parameter value. The password will be stored for possible later use by begin_privileged().

Optional Parameters

Timeout

This passes a value through to open() in Net::Telnet, to override the default connect timeout value of 10 seconds.

$s->connect(
   Name     => $username,
   Password => $password,
   Timeout  => 30,
);

The default operation is to time out after 10 seconds.

AUTHOR

Oliver Gorwits <oliver@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by University of Oxford.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.