Telnet Class

Properties   Methods   Events   Configuration Settings   Errors  

The Telnet Class is used to communicate with servers implementing the TELNET protocol.

Class Name

IPWorks_Telnet

Procedural Interface

 ipworks_telnet_open();
 ipworks_telnet_close($res);
 ipworks_telnet_register_callback($res, $id, $function);
 ipworks_telnet_get_last_error($res);
 ipworks_telnet_get_last_error_code($res);
 ipworks_telnet_set($res, $id, $index, $value);
 ipworks_telnet_get($res, $id, $index);
 ipworks_telnet_do_config($res, $configurationstring);
 ipworks_telnet_do_connect($res, $host);
 ipworks_telnet_do_disconnect($res);
 ipworks_telnet_do_doevents($res);
 ipworks_telnet_do_reset($res);
 ipworks_telnet_do_send($res, $text);

Remarks

The Telnet Class supports both plaintext and SSL/TLS connections. When connecting over SSL/TLS the SSLServerAuthentication event allows you to check the server identity and other security attributes. The SSLStatus event provides information about the SSL handshake. Additional SSL related settings are also supported via the Config method.

The Telnet Class provides a simple interface to Telnet communications as specified by RFC 854. It allows sending of Telnet command codes to remote Telnet servers and it scans the input data for Telnet commands. Appropriate events are fired for received commands.

The connection interface is very similar to that of IPPort. The same properties and events are used for sending and receiving normal data, and the same property set is used for setting properties of the connection. The Telnet Class adds a number of properties like Command, DoOption, etc. which allow sending of Telnet commands to the other end. The respective events (Command, Do, etc.) are fired when the corresponding Telnet commands are received.