Subject: ANNOUNCE: Net::Telnet
From: Jay Rogers <[email-masked]>
Date: 23 Mar 1997 14:01:41 GMT
Newsgroups: comp.lang.perl.announce,comp.lang.perl.modules

Net::Telnet, version 3.00

    Copyright (c) 1997 Jay Rogers. All rights reserved.  This program
    is free software; you can redistribute it and/or modify it under
    the same terms as Perl itself.

  What's In It For You
  --------------------

   .  You'd like to communicate with another host or device via a
      TELNET port and you'd like some specialized routines to help you
      login and do other interactive things.

   .  You're not familiar with sockets and you want a simple way to
      make client connections to TCP services.

   .  You want to be able to specify your own time-out while
      connecting, reading, or writing.

   .  You're communicating with an interactive program at the other
      end of some socket or pipe and you want to wait for certain
      patterns to appear.

  Archive Location
  ----------------

    .  $CPAN/modules/by-module/Net/Net-Telnet-3.00.tar.gz

    .  To find a CPAN site near you see
       ftp://ftp.cis.ufl.edu/pub/perl/CPAN/SITES

  Prerequisite
  ------------

    .  Perl Version 5.002 or later

    .  Windows 95/NT requires Perl beta version 5.003_07 or later

    .  No modules are required that don't already come with a
       standard distribution of Perl.

  Description
  -----------

    Net::Telnet allows you to make client connections to a TCP port
    and do network I/O, especially with a port using the TELNET
    protocol.  Simple I/O methods such as print, get, and getline are
    provided.  More sophisticated interactive features are provided
    because connecting to a TELNET port ultimately means communicating
    with a program designed for human interaction.  Some interactive
    features include the ability to specify a timeout and to wait for
    patterns to appear in the input stream, such as the prompt from a
    command interpreter.

    This example prints who's logged-on to the remote host sparky:

        $sparky = new Net::Telnet (Host => "sparky",
                                   Timeout => 10,
                                   Prompt => '/[$%#>] $/');
        $sparky->login($username, $passwd);
        @lines = $sparky->cmd("/usr/bin/who");
        print @lines;
        $sparky->close;

    More examples are contained in the POD user documentation.

    This is an alpha version - meaning that the interface may change
    in future versions.  Contact me, Jay Rogers <[email-masked]>, if you
    find any bugs or have suggestions for improvement.

  Documentation
  -------------

    User documentation in POD format is contained in the module.
    Installing using "make" places a man page in the perl library
    under directory "man/man3".

  Installation
  ------------

    .  To install, cd to the directory containing the unpacked
       distribution and do one of the following:

        a.  Create a makefile by running Makefile.PL using the perl
            whose library you want to install into and then running
            make:

                perl Makefile.PL
                make test
                make install

        b.  To install into an alternate library, set the "prefix"
            argument where you want to install.  You can ignore any
            errors mentioning perllocal.pod.  For example:

                perl Makefile.PL prefix=~/local
                make test
                make install

        c.  Alternatively, you can just copy or move Telnet.pm
            from the distribution into a directory named Net in the
            Perl library.

--
Jay Rogers
[email-masked]
March 20, 1997