Logo Search packages:      
Sourcecode: pwlib version File versions

PUDPSocket Class Reference

#include <udpsock.h>

Inheritance diagram for PUDPSocket:

PIPDatagramSocket PIPSocket PSocket PChannel PObject PSocksUDPSocket PSTUNUDPSocket

List of all members.

Detailed Description

A socket channel that uses the UDP transport on the Internet Protocol.

Definition at line 135 of file udpsock.h.

Miscellaneous functions

void AbortCommandString ()
virtual BOOL Close ()
BOOL SendCommandString (const PString &command)
BOOL SetBufferSize (PINDEX newSize)
enum  ShutdownValue { ShutdownRead = 0, ShutdownWrite = 1, ShutdownReadAndWrite = 2 }

Socket establishment functions

virtual BOOL Accept (PSocket &socket)
virtual BOOL Shutdown (ShutdownValue option)
enum  Reusability { CanReuseAddress, AddressIsExclusive }
 Flags to reuse of port numbers in Listen() function.

Comparison functions

virtual Comparison CompareObjectMemoryDirect (const PObject &obj) const
bool operator!= (const PObject &obj) const
bool operator< (const PObject &obj) const
bool operator<= (const PObject &obj) const
bool operator== (const PObject &obj) const
bool operator> (const PObject &obj) const
bool operator>= (const PObject &obj) const
enum  Comparison { LessThan = -1, EqualTo = 0, GreaterThan = 1 }

Run Time Type functions

virtual const char * GetClass (unsigned=0) const
virtual BOOL InternalIsDescendant (const char *clsName) const
BOOL IsClass (const char *cls) const
static const char * Class ()

Error functions

Errors GetErrorCode (ErrorGroup group=NumErrorGroups) const
int GetErrorNumber (ErrorGroup group=NumErrorGroups) const
virtual PString GetErrorText (ErrorGroup group=NumErrorGroups) const
static PString GetErrorText (Errors lastError, int osError=0)
enum  ErrorGroup { LastReadError, LastWriteError, LastGeneralError, NumErrorGroups }
enum  Errors {
  NoError, NotFound, FileExists, DiskFull,
  AccessDenied, DeviceInUse, BadParameter, NoMemory,
  NotOpen, Timeout, Interrupted, BufferTooSmall,
  Miscellaneous, ProtocolFailure, NumNormalisedErrors

New functions for class

void GetLastReceiveAddress (Address &address, WORD &port)
void GetSendAddress (Address &address, WORD &port)
virtual BOOL ModifyQoSSpec (PQoS *qos)
void SetSendAddress (const Address &address, WORD port)
static void EnableGQoS ()
static BOOL SupportQoS (const PIPSocket::Address &address)

Port/Service database functions

WORD GetPort () const
virtual WORD GetPortByService (const PString &service) const
PString GetService () const
virtual PString GetServiceByPort (WORD port) const
void SetPort (const PString &service)
void SetPort (WORD port)
static PString GetNameByProtocol (WORD proto)
static WORD GetPortByService (const char *protocol, const PString &service)
static WORD GetProtocolByName (const PString &name)
static PString GetServiceByPort (const char *protocol, WORD port)

I/O functions

virtual void PrintOn (ostream &strm) const
virtual void ReadFrom (istream &strm)
ostream & operator<< (ostream &strm, const PObject &obj)
istream & operator>> (istream &strm, PObject &obj)

Scattered read/write functions

virtual BOOL Read (const VectorOfSlice &slices)
virtual BOOL Write (const VectorOfSlice &slices)
typedef std::vector< SliceVectorOfSlice

Public Types

enum  PXBlockType { PXReadBlock, PXWriteBlock, PXAcceptBlock, PXConnectBlock }

Public Member Functions

virtual BOOL Connect (const Address &iface, WORD localPort, const Address &addr)
virtual BOOL Connect (const Address &iface, const Address &addr)
virtual BOOL Connect (WORD localPort, const Address &addr)
virtual BOOL Connect (const Address &addr)
PIPSocket::Address GetLastReceiveToAddress () const
virtual BOOL GetLocalAddress (Address &addr, WORD &port)
virtual BOOL GetLocalAddress (Address &addr)
PString GetLocalHostName ()
virtual PString GetName () const
virtual BOOL GetPeerAddress (Address &addr, WORD &port)
virtual BOOL GetPeerAddress (Address &addr)
PString GetPeerHostName ()
virtual BOOL Listen (const Address &bind, unsigned queueSize=5, WORD port=0, Reusability reuse=AddressIsExclusive)
virtual BOOL Listen (unsigned queueSize=5, WORD port=0, Reusability reuse=AddressIsExclusive)
 PLIST (InterfaceTable, InterfaceEntry)
 PLIST (RouteTable, RouteEntry)
virtual BOOL ReadFrom (void *buf, PINDEX len, Address &addr, WORD &port)
BOOL SetCaptureReceiveToAddress ()
virtual BOOL WriteTo (const void *buf, PINDEX len, const Address &addr, WORD port)
Miscellaneous functions
virtual PObjectClone () const
Overrides from class PObject
virtual Comparison Compare (const PObject &obj) const
virtual PINDEX HashFunction () const
Overrides from class PSocket
BOOL Connect (const PString &address)
BOOL Read (void *buf, PINDEX len)
BOOL Write (const void *buf, PINDEX len)
Information functions
virtual PChannelGetBaseReadChannel () const
virtual PChannelGetBaseWriteChannel () const
int GetHandle () const
virtual BOOL IsOpen () const
Reading functions
virtual PINDEX GetLastReadCount () const
PTimeInterval GetReadTimeout () const
virtual void OnReadComplete (void *buf, PINDEX len)
virtual BOOL ReadAsync (void *buf, PINDEX len)
BOOL ReadBlock (void *buf, PINDEX len)
virtual int ReadChar ()
PString ReadString (PINDEX len)
void SetReadTimeout (const PTimeInterval &time)
Writing functions
virtual PINDEX GetLastWriteCount () const
PTimeInterval GetWriteTimeout () const
virtual void OnWriteComplete (const void *buf, PINDEX len)
void SetWriteTimeout (const PTimeInterval &time)
virtual BOOL WriteAsync (const void *buf, PINDEX len)
BOOL WriteChar (int c)
BOOL WriteString (const PString &str)
Socket options functions
BOOL GetOption (int option, void *valuePtr, PINDEX valueSize, int level=SOL_SOCKET)
BOOL GetOption (int option, int &value, int level=SOL_SOCKET)
BOOL SetOption (int option, const void *valuePtr, PINDEX valueSize, int level=SOL_SOCKET)
BOOL SetOption (int option, int value, int level=SOL_SOCKET)
 PUDPSocket (const PString &address, const PString &service)
 PUDPSocket (const PString &address, WORD port)
 PUDPSocket (const PString &service, PQoS *qos=NULL)
 PUDPSocket (PQoS *qos, WORD port=0)
 PUDPSocket (WORD port=0)

Static Public Member Functions

static void ClearNameCache ()
static BOOL ConvertOSError (int libcReturnValue, Errors &lastError, int &osError)
static int GetDefaultIpAddressFamily ()
static PIPSocket::Address GetDefaultIpAny ()
static BOOL GetGatewayAddress (Address &addr)
static PString GetGatewayInterface ()
static BOOL GetHostAddress (const PString &hostname, Address &addr)
static BOOL GetHostAddress (Address &addr)
static PStringArray GetHostAliases (const Address &addr)
static PStringArray GetHostAliases (const PString &hostname)
static PString GetHostName (const Address &addr)
static PString GetHostName (const PString &hostname)
static PString GetHostName ()
static BOOL GetInterfaceTable (InterfaceTable &table)
static BOOL GetNetworkInterface (PIPSocket::Address &addr)
static BOOL GetRouteTable (RouteTable &table)
static BOOL IsLocalHost (const PString &hostname)
static void SetDefaultIpAddressFamily (int ipAdressFamily)
static void SetDefaultIpAddressFamilyV4 ()
Integer conversion functions
static DWORD Host2Net (DWORD v)
 Convert from host to network byte order.
static WORD Host2Net (WORD v)
 Convert from host to network byte order.
static DWORD Net2Host (DWORD v)
 Convert from network to host byte order.
static WORD Net2Host (WORD v)
 Convert from network to host byte order.
Multiple socket selection functions
static Errors Select (SelectList &read, SelectList &write, SelectList &except, const PTimeInterval &timeout)
static Errors Select (SelectList &read, SelectList &write, SelectList &except)
static Errors Select (SelectList &read, SelectList &write, const PTimeInterval &timeout)
static Errors Select (SelectList &read, SelectList &write)
static Errors Select (SelectList &read, const PTimeInterval &timeout)
static Errors Select (SelectList &read)
static int Select (PSocket &sock1, PSocket &sock2, const PTimeInterval &timeout)
static int Select (PSocket &sock1, PSocket &sock2)

Protected Member Functions

virtual BOOL ApplyQoS ()
virtual BOOL ConvertOSError (int libcReturnValue, ErrorGroup group=LastGeneralError)
virtual const char * GetProtocolName () const
virtual BOOL OpenSocket (int ipAdressFamily)
virtual BOOL OpenSocket ()
virtual int OpenSocketGQOS (int af, int type, int proto)
BOOL os_accept (PSocket &listener, struct sockaddr *addr, PINDEX *size)
int os_close ()
BOOL os_connect (struct sockaddr *sin, PINDEX size)
BOOL os_recvfrom (void *buf, PINDEX len, int flags, struct sockaddr *from, PINDEX *fromlen)
BOOL os_sendto (const void *buf, PINDEX len, int flags, struct sockaddr *to, PINDEX tolen)
int os_socket (int af, int type, int proto)
int PXClose ()
BOOL PXSetIOBlock (PXBlockType type, const PTimeInterval &timeout)
int ReadCharWithTimeout (PTimeInterval &timeout)
BOOL ReceiveCommandString (int nextChar, const PString &reply, PINDEX &pos, PINDEX start)
BOOL SetErrorValues (Errors errorCode, int osError, ErrorGroup group=LastGeneralError)

Protected Attributes

PString channelName
Errors lastErrorCode [NumErrorGroups+1]
 The platform independant error code.
int lastErrorNumber [NumErrorGroups+1]
 The operating system error number (eg as returned by errno).
PINDEX lastReadCount
 Number of byte last read by the Read() function.
Address lastReceiveAddress
WORD lastReceivePort
PINDEX lastWriteCount
 Number of byte last written by the Write() function.
int os_handle
 The operating system file handle return by standard open() function.
WORD port
 Port to be used by the socket when opening the channel.
PXBlockType px_lastBlockType
PMutex px_selectMutex
PMutex px_threadMutex
PMutex px_writeMutex
PQoS qosSpec
PTimeInterval readTimeout
 Timeout for read operations.
Address sendAddress
WORD sendPort
PTimeInterval writeTimeout
 Timeout for write operations.

Private Member Functions

 PCLASSINFO (PUDPSocket, PIPDatagramSocket)

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

Generated by  Doxygen 1.6.0   Back to index