hostNameCache Class Reference

#include "hostNameCache.h"

Inheritance diagram for hostNameCache:

Collaboration diagram for hostNameCache:

Public Member Functions
	hostNameCache (const osiSockAddr &addr, ipAddrToAsciiEngine &engine)
	~hostNameCache ()
void	destroy ()
void	transactionComplete (const char *pHostName)
unsigned	getName (char *pBuf, unsigned bufLength) const
const char *	pointer () const
Public Member Functions inherited from ipAddrToAsciiCallBack
virtual void	show (unsigned level) const
virtual	~ipAddrToAsciiCallBack ()=0

Detailed Description

Definition at line 31 of file hostNameCache.h.

Constructor & Destructor Documentation

hostNameCache::hostNameCache	(	const osiSockAddr &	addr,
		ipAddrToAsciiEngine &	engine
	)

Definition at line 31 of file hostNameCache.cpp.

                                                             :
    dnsTransaction ( engine.createTransaction() ), nameLength ( 0 )
{
    sockAddrToDottedIP ( &addr.sa, hostNameBuf, sizeof ( hostNameBuf ) );
    hostNameBuf[ sizeof ( hostNameBuf ) - 1 ] = '\0';
    nameLength = strlen ( hostNameBuf );
    this->dnsTransaction.ipAddrToAscii ( addr, *this );
}

hostNameCache::~hostNameCache

(

)

Definition at line 46 of file hostNameCache.cpp.

{
    this->dnsTransaction.release ();
}

Member Function Documentation

void hostNameCache::destroy

(

)

Definition at line 41 of file hostNameCache.cpp.

{
    delete this;
}

unsigned hostNameCache::getName	(	char *	pBuf,
		unsigned	bufLength
	)		const

Definition at line 67 of file hostNameCache.cpp.

{
    if ( bufSize == 0u ) {
        return 0u;
    }
    epicsGuard < epicsMutex > guard ( this->mutex );
    if ( this->nameLength > 0u ) {
        if ( this->nameLength < bufSize ) {
            strcpy ( pBuf, this->hostNameBuf );
            return this->nameLength;
        }
        else {
            unsigned reducedSize = bufSize - 1u;
            strncpy ( pBuf, this->hostNameBuf, reducedSize );
            pBuf [ reducedSize ] = '\0';
            return reducedSize;
        }
    }
    else {
        osiSockAddr tmpAddr = this->dnsTransaction.address ();
        return sockAddrToDottedIP ( &tmpAddr.sa, pBuf, bufSize );
    }
}

const char * hostNameCache::pointer ( ) const

inline

Definition at line 46 of file hostNameCache.h.

{
    return this->hostNameBuf;
}

void hostNameCache::transactionComplete ( const char *  pHostName )

virtual

Implements ipAddrToAsciiCallBack.

Definition at line 51 of file hostNameCache.cpp.

{
    epicsGuard < epicsMutex > guard ( this->mutex );
    // a few legacy clients have a direct pointer to this buffer so we
    // set the entrire string to nill terminators before we start copying
    // in the name (this reduces the chance that another thread will see
    // garbage characters).
    size_t newNameLen = strlen ( pHostNameIn );
    if ( newNameLen > sizeof ( this->hostNameBuf ) - 1u ) {
        newNameLen = sizeof ( this->hostNameBuf ) - 1u;
    }
    strncpy ( this->hostNameBuf, "", sizeof ( this->hostNameBuf ) );
    strncpy ( this->hostNameBuf, pHostNameIn, sizeof ( this->hostNameBuf ) - 1 );
    this->nameLength = newNameLen;
}

---

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

• modules/ca/src/client/hostNameCache.h
• modules/ca/src/client/hostNameCache.cpp