TelnetDebugger

Telnet debug service implementation.

Classes:

class

TelnetDebugger::Breakpoint

Private Types

enum

_Anonymous_ {
  Version = 2
  PasswordMaxLength = 32
  MaxCommandSize = 2048
}

enum

State {
  NotConnected 
  PasswordTry 
  Initialize 
  Connected 
}

Private Attributes

S32

mAcceptPort

NetSocket

mAcceptSocket

bool

mBreakOnNextStatement

Breakpoint *

mBreakpoints

S32

mCurPos

char

mDebuggerPassword [PasswordMaxLength+1]

NetSocket

mDebugSocket

char

mLineBuffer [MaxCommandSize]

bool

mProgramPaused

S32

mStackPopBreakIndex

S32

mState

bool

mWaitForClient

Private Functions

TelnetDebugger()

~TelnetDebugger()

void

addBreakpoint(const char * fileName, S32 line, bool clear, S32 passCount, const char * evalString)

void

addVariableBreakpoint(const char * varName, S32 passCount, const char * evalString)

void

checkDebugRecv()

void

debugBreakNext()

void

debugContinue()

void

debugStepIn()

void

debugStepOut()

void

debugStepOver()

void

dumpBreakableList(const char * fileName)

void

dumpFileList()

void

evaluateExpression(const char * tag, S32 frame, const char * evalBuffer)

Breakpoint **

findBreakpoint(StringTableEntry fileName, S32 lineNumber)

void

processLineBuffer(S32 )

void

removeAllBreakpoints()

void

removeBreakpoint(const char * fileName, S32 line)

void

removeBreakpointsFromCode(CodeBlock * code)

void

removeVariableBreakpoint(const char * varName)

void

sendBreak()

void

setBreakOnNextStatement(bool enabled)

Public Static Functions

void

create()

void

destroy()

Public Functions

void

addAllBreakpoints(CodeBlock * code)

void

breakProcess()

void

clearCodeBlockPointers(CodeBlock * code)

void

disconnect()

void

executionStopped(CodeBlock * code, U32 lineNumber)

bool

isConnected()

void

popStackFrame()

void

process()

void

processConsoleLine(const char * consoleLine)

void

pushStackFrame()

void

send(const char * s)

void

setDebugParameters(S32 port, const char * password, bool waitForClient)

Detailed Description

Telnet debug service implementation.

This is the C++ side of the built-in Torque debugger.

To use the debugger, use dbgSetParameters(port, password); in the console of the server to enable debugger connections. Then on some other system, start up the app (you don't have to start a game or connect to the server) and exec("common/debugger/debugger.tscript"); in the console. Then use the debugger GUI to connect to the server with the right port and password.

see:

http://www.planettribes.com/tribes2/editing.shtml for more thorough discussion.