Click here to Skip to main content
11,645,499 members (81,374 online)
Click here to Skip to main content

Quick tool : A minimalistic Telnet library

, 6 Jun 2007 CPOL 259.9K 24.6K 126
Rate this:
Please Sign up or sign in to vote.
Send commands to your servers from your programs using the Telnet protocol

Introduction

This article provides a minimalistic Telnet interface. Possible applications of this class include :

  • A Telnet console
  • A Windows GUI around some UNIX commands that need to be executed on a server
  • A program that executes scripts (scripted telnet)
This example offers both a minimal console, and a possibility to use a script, using file piping.

Background

A little while ago one of my clients had the problem that a person who was managing a system using UNIX scripts (HP-UX) was leaving the company. This person was not to be replaced by a new employee, so his functions would have to be done by several other persons.

When estimating the cost of teaching the other people how to use UNIX, we made some calculations, and found a much cheaper solution: we built a simple Windows program that contained a GUI for every script used.

The user simply has to press some buttons, select some values and press the "Start" button. When the user presses the start button the UNIX commands are built using the parameters from the GUI, and sent to the server using Telnet.

Since I remember spending quite a few hours figuring out the minimal implementation of the Telnet protocol, I decided to do a simple rewrite for the users of codeproject.

Using the code

The class is actually quite simple to use. Please take a look at the example code :

//create a new telnet connection to hostname "gobelijn" on port "23"
TelnetConnection tc = new TelnetConnection("gobelijn", 23);

//login with user "root",password "rootpassword", using a timeout of 100ms, 
//and show server output
string s = tc.Login("root", "rootpassword",100);
Console.Write(s);

// server output should end with "$" or ">", otherwise the connection failed
string prompt = s.TrimEnd();
prompt = s.Substring(prompt.Length -1,1);
if (prompt != "$" && prompt != ">" )
    throw new Exception("Connection failed");

prompt = "";

// while connected
while (tc.IsConnected && prompt.Trim() != "exit" )
{
    // display server output
    Console.Write(tc.Read());

    // send client input to server
    prompt = Console.ReadLine();
    tc.WriteLine(prompt);

    // display server output
    Console.Write(tc.Read());
}

Console.WriteLine("***DISCONNECTED");
Console.ReadLine();

I suppose this is self-explanatory, isn't it ? Create the Telnet connection, login, send the login output to the screen, and while connected send serveroutput to the screen, read a command from the commandline, and again, send the serveroutput to the screen.
If the command is "exit" then the loop needs to finish.

Instead of reading the input from the console, the input can also be piped from a script: if the script was named telnetstuff.txt then execute the script as follows :

MinimalisticTelnet < telnetstuff.txt > output.txt

The result will be inside the file output.txt. Currently the servername, port, username and password is hardcoded, but it should be a piece of cake to change this into command line parameters.

How does it work

The TelnetConnection parses every byte received from the TcpClient, and if a byte series is a Telnet option request (DO, DONT, WILL, WONT), the client simply responds that the option is not available by sending (DONT, WONT) in return.

The only exception to these responses is the command SGA: suppress go ahead, since this command allows async traffic.

Points of Interest

The TelnetConnection.Read function assumes that if there is no data available for more then TimeOutMs milliseconds, the output is complete.

The login works by parsing the server output after the initial connection. It will look for a colon ":" in the screen output, and will send username and password after the colon.

To check if the connection succeeded, I look for whether the serveroutput ends with a "$" or a ">". If your Telnet server has another prompt, please replace this.

Votes & Comments

The votes & comments on my previous article gave me the motivation to publish a new article, so please keep your votes & comments coming !!

History

  • 2007-06-06: First version

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Tom Janssens
Founder Core bvba
Belgium Belgium
Tom Janssens, owner of Core, a software and consultancy company.
Father of two sons named Quinten & Matisse, and married to a beautiful woman named Liesbeth.

Blog: http://tojans.me
Github: http://github.com/ToJans
Twitter: http://twitter.com/ToJans
LinkedIn: http://www.linkedin.com/in/tomjanssens

You may also be interested in...

Comments and Discussions

 
QuestionAdditional help Pin
Collin Meaney15-Jun-15 11:24
memberCollin Meaney15-Jun-15 11:24 
QuestionThis throws an exception when trying to connect with the tcp socket Pin
Member 1085520730-May-14 8:51
memberMember 1085520730-May-14 8:51 
QuestionSending commands to Cisco switch? Pin
Member 1078158729-Apr-14 4:41
memberMember 1078158729-Apr-14 4:41 
QuestionTelnet over Telnet session Pin
GabrielBarros26-Mar-14 9:15
memberGabrielBarros26-Mar-14 9:15 
GeneralMy vote of 5 Pin
rcole1173-Jan-14 5:52
memberrcole1173-Jan-14 5:52 
QuestionA minimalistic Telnet library is not working for web application Pin
wskumar28-Nov-13 11:05
memberwskumar28-Nov-13 11:05 
QuestionMissing when Read output Multiline " ---more--------" Pin
Kieu Gol24-Nov-13 7:19
memberKieu Gol24-Nov-13 7:19 
GeneralSimple and Straight Forward Pin
Richard Osafo24-Oct-13 3:48
memberRichard Osafo24-Oct-13 3:48 
Questiontset: unknown terminal type network Terminal type? Pin
superselector11-Aug-13 22:40
membersuperselector11-Aug-13 22:40 
QuestionThanks Tom, you deserve well the five star rating. Pin
Jane-Jane Doe29-Jul-13 23:35
memberJane-Jane Doe29-Jul-13 23:35 
AnswerRe: Thanks Tom, you deserve well the five star rating. Pin
Tom Janssens29-Jul-13 23:38
memberTom Janssens29-Jul-13 23:38 
Questionhelp me . Pin
student_milworm14-Jul-13 21:52
memberstudent_milworm14-Jul-13 21:52 
QuestionVery easy to use! Pin
alexdhu1-Jul-13 6:02
memberalexdhu1-Jul-13 6:02 
GeneralMy vote of 5 Pin
Jon Sagara6-Jun-13 4:51
memberJon Sagara6-Jun-13 4:51 
GeneralRe: My vote of 5 Pin
Tom Janssens1-Jul-13 20:38
memberTom Janssens1-Jul-13 20:38 
QuestionIssue with login Pin
TadejP8124-May-13 9:50
memberTadejP8124-May-13 9:50 
QuestionCannot download Pin
itiwcsingkaww22-May-13 15:28
memberitiwcsingkaww22-May-13 15:28 
Questionhow to i get a serial number of a device using the ip address through telnet using this code Pin
jinnah201328-Apr-13 8:24
memberjinnah201328-Apr-13 8:24 
QuestionThanks and a little Question Pin
Member 999687125-Apr-13 5:29
memberMember 999687125-Apr-13 5:29 
QuestionThank You. Pin
Member 999795118-Apr-13 17:19
memberMember 999795118-Apr-13 17:19 
AnswerRe: Thank You. Pin
Tom Janssens18-Apr-13 20:53
memberTom Janssens18-Apr-13 20:53 
QuestionReading more than one line at a time Pin
slopesandsam9-Apr-13 19:45
memberslopesandsam9-Apr-13 19:45 
AnswerRe: Reading more than one line at a time Pin
Tom Janssens9-Apr-13 20:46
memberTom Janssens9-Apr-13 20:46 
GeneralRe: Reading more than one line at a time Pin
slopesandsam9-Apr-13 20:54
memberslopesandsam9-Apr-13 20:54 
GeneralMy vote of 5 Pin
nieljake18-Jan-13 5:08
membernieljake18-Jan-13 5:08 
BugBuggy Pin
Member 96668847-Dec-12 14:32
memberMember 96668847-Dec-12 14:32 
QuestionUnable to login Pin
rogerknit7-Nov-12 18:12
memberrogerknit7-Nov-12 18:12 
AnswerRe: Unable to login Pin
Tom Janssens7-Nov-12 20:04
memberTom Janssens7-Nov-12 20:04 
I would assume you need to increment timeout?

QuestionLogin problem Pin
Luis Velarde5-Sep-12 13:38
memberLuis Velarde5-Sep-12 13:38 
AnswerRe: Login problem Pin
Luis Velarde6-Sep-12 5:03
memberLuis Velarde6-Sep-12 5:03 
GeneralRe: Login problem Pin
Tom Janssens6-Sep-12 6:38
memberTom Janssens6-Sep-12 6:38 
AnswerRe: Login problem Pin
Kieu Gol24-Nov-13 7:22
memberKieu Gol24-Nov-13 7:22 
QuestionTab Key Pin
prithumit28-Aug-12 3:40
memberprithumit28-Aug-12 3:40 
AnswerRe: Tab Key Pin
Tom Janssens28-Aug-12 4:11
memberTom Janssens28-Aug-12 4:11 
AnswerRe: Tab Key Pin
EgyptianRobot28-Aug-12 4:47
memberEgyptianRobot28-Aug-12 4:47 
QuestionCannot retrieve all the result data Pin
Phea Daravuth14-Jun-12 23:08
memberPhea Daravuth14-Jun-12 23:08 
AnswerRe: Cannot retrieve all the result data Pin
Tom Janssens15-Jun-12 0:46
memberTom Janssens15-Jun-12 0:46 
Questionusing dot notation for TelnetConnection parameter Pin
garaber16-May-12 16:09
membergaraber16-May-12 16:09 
AnswerRe: using dot notation for TelnetConnection parameter Pin
garaber16-May-12 16:19
membergaraber16-May-12 16:19 
GeneralRe: using dot notation for TelnetConnection parameter Pin
Tom Janssens17-May-12 20:21
memberTom Janssens17-May-12 20:21 
QuestionLittle Change for write function with new lines - Login now Ok! Pin
renatoosx8-Nov-11 2:13
memberrenatoosx8-Nov-11 2:13 
QuestionParse problem at login Pin
sleepyman30-Jun-11 0:48
membersleepyman30-Jun-11 0:48 
AnswerRe: Parse problem at login Pin
Tom Janssens30-Jun-11 1:57
memberTom Janssens30-Jun-11 1:57 
GeneralRe: Parse problem at login Pin
sleepyman30-Jun-11 6:35
membersleepyman30-Jun-11 6:35 
GeneralRe: Parse problem at login Pin
Tom Janssens30-Jun-11 23:44
memberTom Janssens30-Jun-11 23:44 
QuestionProblem executing telnet commands Pin
sleepyman27-Jun-11 20:01
membersleepyman27-Jun-11 20:01 
AnswerRe: Problem executing telnet commands Pin
Tom Janssens27-Jun-11 20:51
memberTom Janssens27-Jun-11 20:51 
GeneralRe: Problem executing telnet commands [modified] Pin
sleepyman27-Jun-11 21:39
membersleepyman27-Jun-11 21:39 
GeneralProblem Pin
fares121-May-11 3:58
memberfares121-May-11 3:58 
GeneralRe: Problem Pin
Tom Janssens22-May-11 2:57
memberTom Janssens22-May-11 2:57 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.150731.1 | Last Updated 6 Jun 2007
Article Copyright 2007 by Tom Janssens
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid