---

coreClass Class Reference

The Core Class The Core Class manages various jobs like connecting to the server and authentication. More...

#include <coreClass.h>

List of all members.

Public Methods
	coreClass ( ThreadArgs* targs )
	The constructor for coreClass. More...
	coreClass ( )
	The constructor for coreClass. More...
bool	connectNow ( void )
	Does every step neccessary to connect to a server. More...
bool	disconnectNow ( void )
	Disconnect from a server. More...
Buffer*	getBuffer ( int whichbuffer )
	Get the pointer to a specific buffer. More...
void	startQuartz ( unsigned int freq )
	Start the Quartz. More...
void	setUpdateFreq ( unsigned int freq )
	Change the Quartz' frequency. More...
Private Methods
bool	connectTo ( string dotsandnumbers )
	Initiates the connection to a server. More...
bool	handshake ( void )
	Does the handshake with the server. More...
bool	authenticate ( void )
	Does the authentication using username and password. More...
Private Attributes
string	username
	The username for the server. More...
string	password
	The password for the server. More...
string	realname
	The real name of the user. More...
int	mySocket
	The handler for the socket to the server. More...
string	serverAddress
	The address of the server. More...
int	serverPort
	The port of the server. More...
pthread_t	incomingThread
	The thread handler for the IncomingThread. More...
pthread_t	outgoingThread
	The thread handler for the OutgoingThread. More...
pthread_t	quartzThread
	The thread handler for the QuartzThread. More...
QuartzClass*	qObj
	The pointer to the object of the QuartzClass - to control the Quartz during runtime. More...
Buffer*	coreIn
	The buffer to read packages coming from the server. More...
Buffer*	coreOut
	The buffer to send packages to the server. More...

---

Detailed Description

The Core Class The Core Class manages various jobs like connecting to the server and authentication.

Author(s):

xandi

Date:

080400

Definition at line 48 of file coreClass.h.

{
    private:

        string username;            
        string password;            

        string realname;            

        int mySocket;               

        string serverAddress;       
        int serverPort;             

        pthread_t   incomingThread; 
        pthread_t   outgoingThread; 
        pthread_t   quartzThread;   

        QuartzClass* qObj;          

        Buffer*     coreIn;         
        Buffer*     coreOut;        

    public:


        coreClass           ( ThreadArgs* targs );


        coreClass           ( );


        bool connectNow     ( void );


        bool disconnectNow  ( void );



        Buffer* getBuffer   ( int whichbuffer );


        void startQuartz     ( unsigned int freq );

        void setUpdateFreq  ( unsigned int freq );

    private:

        bool connectTo      ( string dotsandnumbers );

        bool handshake      ( void );

        bool authenticate   ( void );

    }

---

Constructor & Destructor Documentation

coreClass::coreClass ( ThreadArgs * targs)

The constructor for coreClass.

Parameters:

targs

passing the arguments from main()

Definition at line 52 of file coreClass.cpp.

{
    fprintf(stderr,"[cC.constructor] parsing %d parameters\n",targs->argc);
    mySocket   = 0;
    serverPort = 0;
    qObj       = 0;
    coreIn     = 0;
    coreOut    = 0;

    if ( targs->argc >= 4 )
        {
        username        = targs->argv[1];
        password        = targs->argv[2];
        serverAddress   = targs->argv[3];

        fprintf(stderr,"\nUsername: %s", username.c_str() );
        fprintf(stderr,"\tPassword: %s\n", password.c_str());
        fprintf(stderr,"Serveraddress: %s\n",serverAddress.c_str() );

        if ( targs->argc >= 5 )
            {
            fprintf(stderr,"Too many arguments - *snip* :)\n");
            }
        }
    else
        {
        username        = "clonewar";
        password        = "idpman";
        serverAddress   = DEFAULT_HOST;
        }

    serverPort = DEFAULT_PORT;
    }

coreClass::coreClass ()

The constructor for coreClass.

Definition at line 97 of file coreClass.cpp.

{
    mySocket   = 0;
    serverPort = 0;
    qObj       = 0;
    coreIn     = 0;
    coreOut    = 0;

    Config* tmpConfig = new Config ();

    tmpConfig->openConfig (CLIENT_CONFIG_FILE);

    if (tmpConfig->searchTag ("User")) {
    username = tmpConfig->getCharVariable ("Name");
    password = tmpConfig->getCharVariable ("Password");
    };
    if (tmpConfig->searchTag ("DefaultServer")) {
    serverAddress = tmpConfig->getCharVariable ("Adress");
    serverPort    = tmpConfig->getIntVariable ("Port");
    };

    if (username == "")       username      = "clonewar";
    if (password == "")       password      = "idpman";
    if (serverAddress == "")  serverAddress = DEFAULT_HOST;
    if (serverPort   == -111) serverPort    = DEFAULT_PORT;
}

---

Member Function Documentation

bool coreClass::authenticate ( void) [private]

Does the authentication using username and password.

Returns:

true on success, false on failure

See also:

username password

Definition at line 284 of file coreClass.cpp.

{
    packet* pak = new packet;
    bool check = false;

    fprintf (stderr, "[auth.debug] trying authentication using %s and %s...\n",username.c_str(),password.c_str());

    pak->h.header[0] = PROT_AUTHENTICATE;
    pak->h.header[1] = AUTH_PASSWORD;
    pak->h.header[2] = strlen (username.c_str());
    pak->h.header[3] = strlen (password.c_str());

    pak->data = username;
    pak->data+= password;

    coreOut->write ( pak );

    while ( coreIn->isEmpty () );

    pak = coreIn->read ();

    check  = ( ( pak->h.header[0] != PROT_AUTHENTICATE) || (pak->h.header[1] != AUTH_PASSWORD ) );
    check += !( pak->data == "Authentication successful !" );

//    qObj   = new QuartzClass ( coreOut, PROT_GET_ALL_CHANGED, 25 );
//    check += pthread_create ( &quartzThread, NULL, QuartzThread, qObj );

    delete pak;
    return check;
    }

bool coreClass::connectNow ( void)

Does every step neccessary to connect to a server.

Returns:

true on failure, false on success

Definition at line 138 of file coreClass.cpp.

{
    fprintf(stderr,"[cC.connectNow] \n");

    ComArgs inArgs;
    ComArgs outArgs;

    inArgs.buffer  = coreIn  = new Buffer ( );
    outArgs.buffer = coreOut = new Buffer ( );

    bool check = connectTo ( serverAddress );

    inArgs.socket  = mySocket;
    outArgs.socket = mySocket;

    check  = pthread_create ( &incomingThread, NULL, IncomingThread, &inArgs );
    check += pthread_create ( &outgoingThread, NULL, OutgoingThread, &outArgs );

    check += handshake ( );
    check += authenticate ( );

    return check;
    }

bool coreClass::connectTo ( string dotsandnumbers) [private]

Initiates the connection to a server.

Parameters:

dotsandnumbers

the ip of the server (and dns later)

Returns:

true on success, false on failure

See also:

serverAddress

Definition at line 196 of file coreClass.cpp.

{
    struct sockaddr_in address;
//    struct hostent*    host;

    fprintf(stderr,"[cC.connectTo] \n");
    address.sin_addr.s_addr = inet_addr (dotsandnumbers.c_str ());
    bzero ( & ( address.sin_zero ), 8 );


/*
    host = gethostbyname ( hostname );
    if (!host)
    return false;
    }; */

    if ((mySocket = socket (PF_INET, SOCK_STREAM, 0)) < 0) {
    return false;
    };

    address.sin_family = AF_INET;
    address.sin_port = htons (serverPort);

    if (connect (mySocket, (sockaddr *) &address, sizeof (address))) {
    return false;
    };

    return true;
    }

bool coreClass::disconnectNow ( void)

Disconnect from a server.

Returns:

true on failure, false on success

Definition at line 176 of file coreClass.cpp.

{
    fprintf(stderr,"Nooo, i don't let you, hahahaa!!\n");
    return 0;
    }

Buffer * coreClass::getBuffer ( int whichbuffer)

Get the pointer to a specific buffer.

Parameters:

whichbuffer

defines the buffer that shall be returned

Returns:

pointer on success, 0 on failure

Definition at line 318 of file coreClass.cpp.

{
    if ( whichbuffer == INCOMING )
        return coreIn;
    if ( whichbuffer == OUTGOING )
        return coreOut;

    fprintf(stderr,"[coreClass::getBuffer] you dumb! (sorry, but i had to say that ;)\n");
    return 0;
    }

bool coreClass::handshake ( void) [private]

Does the handshake with the server.

Returns:

true on success, false on failure

Definition at line 239 of file coreClass.cpp.

{
    packet* pak = new packet;
    bool check = false;

    fprintf(stderr,"[cC.handshake] \n");

    pak->h.header[0] = PROT_HANDSHAKE;
    pak->h.header[1] = HANDSHAKE_GREETING;
    pak->h.header[2] = VERSION_MAJOR;
    pak->h.header[3] = VERSION_MINOR;
    pak->h.header[4] = PATCH_LEVEL;

    pak->data = "MATRIX?";

    coreOut->write ( pak );

    while ( coreIn->isEmpty () );

    pak = coreIn->read ();

    check  = ( ( pak->h.header[0] != PROT_HANDSHAKE ) || ( pak->h.header[1] != HANDSHAKE_GREETING ) );
    check += ( ( pak->h.header[2] > VERSION_MAJOR ) || ( pak->h.header[3] > VERSION_MINOR ) );

    if (!check) fprintf(stderr,"[cC.handshake] successful!\n");

    delete pak;
    return check;
    }

void coreClass::setUpdateFreq ( unsigned int freq)

Change the Quartz' frequency.

Parameters:

freq	the frequency it shall send packages in

Definition at line 340 of file coreClass.cpp.

{
    if ( !framesPerSecond )
        {
        fprintf(stderr,"[cc.setUpdateFreq] who would do that??\n");
        exit (1);
        }

    if ( !qObj)
        {
        fprintf(stderr,"coreClass::setUpdateFreq - THIS FUNCTION MUST NOT BE CALLED BEFORE THE QUARTZTHREAD IS STARTED!!\n");
        exit(1);
        }
    qObj->setFrequency ( framesPerSecond );
    fprintf(stderr,"[cc.setUpdateFreq] %d frames per second mean update every %d microseconds\n",framesPerSecond,1000000/framesPerSecond);
    }

void coreClass::startQuartz ( unsigned int freq)

Start the Quartz.

Parameters:

freq	the frequency it shall send packages in

Definition at line 330 of file coreClass.cpp.

{
    qObj   = new QuartzClass ( coreOut, PROT_GET_ALL_CHANGED, freq );
    if ( pthread_create ( &quartzThread, NULL, QuartzThread, qObj ) )
        {
        cerr << "unable to start quartzthread..\n";
        exit(1);
        }
    }

---

Member Data Documentation

Buffer * coreClass::coreIn [private]

The buffer to read packages coming from the server.

Definition at line 68 of file coreClass.h.

Buffer * coreClass::coreOut [private]

The buffer to send packages to the server.

Definition at line 69 of file coreClass.h.

pthread_t coreClass::incomingThread [private]

The thread handler for the IncomingThread.

Definition at line 62 of file coreClass.h.

int coreClass::mySocket [private]

The handler for the socket to the server.

Definition at line 57 of file coreClass.h.

pthread_t coreClass::outgoingThread [private]

The thread handler for the OutgoingThread.

Definition at line 63 of file coreClass.h.

string coreClass::password [private]

The password for the server.

Definition at line 53 of file coreClass.h.

QuartzClass * coreClass::qObj [private]

The pointer to the object of the QuartzClass - to control the Quartz during runtime.

Definition at line 66 of file coreClass.h.

pthread_t coreClass::quartzThread [private]

The thread handler for the QuartzThread.

Definition at line 64 of file coreClass.h.

string coreClass::realname [private]

The real name of the user.

Definition at line 55 of file coreClass.h.

string coreClass::serverAddress [private]

The address of the server.

Definition at line 59 of file coreClass.h.

int coreClass::serverPort [private]

The port of the server.

Definition at line 60 of file coreClass.h.

string coreClass::username [private]

The username for the server.

Definition at line 52 of file coreClass.h.

---

The documentation for this class was generated from the following files:

• coreClass.h
• coreClass.cpp

---