# Ant User Manual

## Telnet

### Description

Task to automate a remote telnet session. The task uses nested <read> to indicate strings to wait for, and <write> tags to specify text to send.

If you do specify a userid and password, the system will assume a common unix prompt to wait on. This behavior can be easily over-ridden.

### Parameters

Attribute | Values | Required
--- | --- | ---
userid | the login id to use on the telnet server. | No
password | the login password to use on the telnet server. | No
server | the address of the remote telnet server. | Yes
port | the port number of the remote telnet server. Defaults to port 23. | No
initialCR | send a cr after connecting ("yes"). Defaults to "no". | No
timeout | set a default timeout to wait for a response. Specified in seconds. Default is no timeout. | No

### Examples

A simple example of connecting to a server and running a command. This assumes a prompt of "ogin:" for the userid, and a prompt of "assword:" for the password.

>     <telnet userid="bob" password="badpass" server="localhost">
>        <read>/home/bob</read>
>        <write>ls</write>
>        <read string="/home/bob"/>
>     </telnet>

This task can be rewritten as:

>     <telnet server="localhost">
>        <read>ogin:</read>
>        <write>bob</write>
>        <read>assword:</read>
>        <write>badpass</write>
>        <read>/home/bob</read>
>        <write>ls</write>
>        <read>/home/bob</read>
>     </telnet>

A timeout can be specified at the <telnet> level or at the <read> level. This will connect, issue a sleep command that is suppressed from displaying and wait 10 seconds before quitting.

>     <telnet userid="bob" password="badpass" server="localhost" timeout="20">
>        <read>/home/bob</read>
>        <write echo="false">sleep 15</write>
>        <read timeout="10">/home/bob</read>
>     </telnet>

The task can be used with other ports as well:

>     <telnet port="80" server="localhost" timeout="20">
>        <read/>
>        <write>GET / http/0.9</write>
>        <write/>
>        <read timeout="10">&lt;/HTML&gt;</read>
>     </telnet>

Copyright © 2000,2001 Apache Software Foundation. All rights Reserved.