this function is a wrapper around getaddrinfo (for ipv6) More...

#include <Csocket.h>

Public Member Functions
	CGetAddrInfo (const CS_STRING &sHostname, Csock *pSock, CSSockAddr &csSockAddr)
	ctor More...

	~CGetAddrInfo ()

void	Init ()
	simply sets up m_cHints for use in process More...

int	Process ()
	the simplest part of the function, only calls getaddrinfo and uses only m_sHostname, m_pAddrRes, and m_cHints. More...

int	Finish ()
	finalizes and sets up csSockAddr (and pSock if not NULL), only needs to be called if Process returns 0, but can be called anyways if flow demands it More...

Detailed Description

this function is a wrapper around getaddrinfo (for ipv6)

in the event this code is using ipv6, it calls getaddrinfo, and it tries to start the connection on each iteration in the linked list returned by getaddrinfo. if pSock is not NULL the following behavior happens.

if pSock is a listener, or if the connect state is in a bind vhost state (to be used with bind) AI_PASSIVE is sent to getaddrinfo
if pSock is an outbound connection, AI_ADDRCONFIG and the connection is started from within this function. getaddrinfo might return multiple (possibly invalid depending on system configuration) ip addresses, so connect needs to try them all. A classic example of this is a hostname that resolves to both ipv4 and ipv6 ip's. You still need to call Connect (and ConnectSSL) to finish up the connection state

Process can be called in a thread, but Init and Finish must only be called from the parent once the thread is complete

Constructor & Destructor Documentation

◆ CGetAddrInfo()

CGetAddrInfo::CGetAddrInfo	(	const CS_STRING &	sHostname,
		Csock *	pSock,
		CSSockAddr &	csSockAddr
	)

ctor

Parameters

sHostname	the host to resolve
pSock	the sock being setup, this option can be NULL, if it is null csSockAddr is only setup
csSockAddr	the struct that sockaddr data is being copied to

◆ ~CGetAddrInfo()

CGetAddrInfo::~CGetAddrInfo ( )

Member Function Documentation

◆ Finish()

int CGetAddrInfo::Finish ( )

finalizes and sets up csSockAddr (and pSock if not NULL), only needs to be called if Process returns 0, but can be called anyways if flow demands it

◆ Init()

void CGetAddrInfo::Init ( )

simply sets up m_cHints for use in process

◆ Process()

int CGetAddrInfo::Process ( )

the simplest part of the function, only calls getaddrinfo and uses only m_sHostname, m_pAddrRes, and m_cHints.

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

Csocket.h

Public Member Functions