telnet.h

Go to the documentation of this file.

/*
 * telnet.h
 *
 * TELNET Socket class.
 *
 * Portable Windows Library
 *
 * Copyright (c) 1993-2002 Equivalence Pty. Ltd.
 *
 * The contents of this file are subject to the Mozilla Public License
 * Version 1.0 (the "License"); you may not use this file except in
 * compliance with the License. You may obtain a copy of the License at
 * http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS"
 * basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
 * the License for the specific language governing rights and limitations
 * under the License.
 *
 * The Original Code is Portable Windows Library.
 *
 * The Initial Developer of the Original Code is Equivalence Pty. Ltd.
 *
 * Contributor(s): ______________________________________.
 */

#ifndef PTLIB_TELNET_H
#define PTLIB_TELNET_H

#ifdef P_USE_PRAGMA
#pragma interface
#endif

#include <ptlib/sockets.h>


class PTelnetSocket : public PTCPSocket
{
  PCLASSINFO(PTelnetSocket, PTCPSocket)

  public:
    PTelnetSocket();
    // Create an unopened TELNET socket.

    PTelnetSocket(
      const PString & address  
    );
    // Create an opened TELNET socket.


  // Overrides from class PChannel
    PBoolean Read(
      void * buf,   
      PINDEX len    
    );

    PBoolean Write(
      const void * buf, 
      PINDEX len        
    );

    virtual bool SetLocalEcho(
      bool localEcho
    );


    virtual PBoolean Connect(
      const PString & address   
    );


    virtual PBoolean Accept(
      PSocket & socket          
    );


    virtual void OnOutOfBand(
      const void * buf,   
      PINDEX len          
    );


  // New functions
    enum Command {
      IAC           = 255,    
      DONT          = 254,    
      DO            = 253,    
      WONT          = 252,    
      WILL          = 251,    
      SB            = 250,    
      GoAhead       = 249,    
      EraseLine     = 248,    
      EraseChar     = 247,    
      AreYouThere   = 246,    
      AbortOutput   = 245,    
      InterruptProcess = 244, 
      Break         = 243,    
      DataMark      = 242,    
      NOP           = 241,    
      SE            = 240,    
      EndOfReccord  = 239,    
      AbortProcess  = 238,    
      SuspendProcess= 237,    
      EndOfFile     = 236     
    };
    // Defined telnet commands codes

    PBoolean SendCommand(
      Command cmd,  
      int opt = 0  
    );


    enum Options {
      TransmitBinary      = 0,    
      EchoOption          = 1,    
      ReconnectOption     = 2,    
      SuppressGoAhead     = 3,    
      MessageSizeOption   = 4,    
      StatusOption        = 5,    
      TimingMark          = 6,    
      RCTEOption          = 7,    
      OutputLineWidth     = 8,    
      OutputPageSize      = 9,    
      CRDisposition       = 10,   
      HorizontalTabsStops = 11,   
      HorizTabDisposition = 12,   
      FormFeedDisposition = 13,   
      VerticalTabStops    = 14,   
      VertTabDisposition  = 15,   
      LineFeedDisposition = 16,   
      ExtendedASCII       = 17,   
      ForceLogout         = 18,   
      ByteMacroOption     = 19,   
      DataEntryTerminal   = 20,   
      SupDupProtocol      = 21,   
      SupDupOutput        = 22,   
      SendLocation        = 23,   
      TerminalType        = 24,   
      EndOfRecordOption   = 25,   
      TACACSUID           = 26,   
      OutputMark          = 27,   
      TerminalLocation    = 28,   
      Use3270RegimeOption = 29,   
      UseX3PADOption      = 30,   
      WindowSize          = 31,   
      TerminalSpeed       = 32,   
      FlowControl         = 33,   
      LineModeOption      = 34,   
      XDisplayLocation    = 35,   
      EnvironmentOption   = 36,   
      AuthenticateOption  = 37,   
      EncriptionOption    = 38,   
      EncryptionOption    = 38,   
      ExtendedOptionsList = 255,  
      MaxOptions
    };
    // Defined TELNET options.


    virtual PBoolean SendDo(
      BYTE option    
    );

    virtual PBoolean SendDont(
      BYTE option    
    );

    virtual PBoolean SendWill(
      BYTE option    
    );

    virtual PBoolean SendWont(
      BYTE option    
    );

    enum SubOptionCodes {
      SubOptionIs       = 0,  
      SubOptionSend     = 1,  
    };
    // Codes for sub option negotiation.

    PBoolean SendSubOption(
      BYTE code,          
      const BYTE * info,  
      PINDEX len,         
      int subCode = -1    
    );

    void SetOurOption(
      BYTE code,          
      PBoolean state = true   
    ) { m_option[code].weCan = state; }

    void SetTheirOption(
      BYTE code,          
      PBoolean state = true  
    ) { m_option[code].theyShould = state; }

    PBoolean IsOurOption(
      BYTE code    
    ) const { return m_option[code].ourState == OptionInfo::IsYes; }

    PBoolean IsTheirOption(
      BYTE code    
    ) const { return m_option[code].theirState == OptionInfo::IsYes; }

    void SetTerminalType(
      const PString & newType   
    );
    // Set the terminal type description string for TELNET protocol.

    const PString & GetTerminalType() const { return m_terminalType; }
    // Get the terminal type description string for TELNET protocol.

    void SetWindowSize(
      WORD width,   
      WORD height   
    );
    // Set the width and height of the Network Virtual Terminal window.

    void GetWindowSize(
      WORD & width,   
      WORD & height   
    ) const;
    // Get the width and height of the Network Virtual Terminal window.


  protected:
    void Construct();
    // Common construct code for TELNET socket channel.

    virtual void OnDo(
      BYTE option   
    );

    virtual void OnDont(
      BYTE option   
    );

    virtual void OnWill(
      BYTE option   
    );

    virtual void OnWont(
      BYTE option   
    );

    virtual void OnSubOption(
      BYTE code,          
      const BYTE * info,  
      PINDEX len          
    );


    virtual PBoolean OnCommand(
      BYTE code  
    );


  // Member variables.
    struct OptionInfo {
      enum {
        IsNo, IsYes, WantNo, WantNoQueued, WantYes, WantYesQueued
      };
      unsigned weCan:1;      // We can do the option if they want us to do.
      unsigned ourState:3;
      unsigned theyShould:1; // They should if they will.
      unsigned theirState:3;
    };
    
    OptionInfo m_option[MaxOptions];
    // Information on protocol options.

    PString m_terminalType;
    // Type of terminal connected to telnet socket, defaults to "UNKNOWN"

    WORD m_windowWidth, m_windowHeight;
    // Size of the "window" used by the NVT.


  private:
    // Internal states for the TELNET decoder
    enum State {
      StateNormal,
      StateCarriageReturn,
      StateIAC,
      StateDo,
      StateDont,
      StateWill,
      StateWont,
      StateSubNegotiations,
      StateEndNegotiations
    };

    State      m_state;         // Current state of incoming characters.
    PBYTEArray m_subOption;     // Storage for sub-negotiated options
    unsigned   m_synchronising;
};


#endif // PTLIB_TELNET_H


// End Of File ///////////////////////////////////////////////////////////////