Class TBlockSocket

DescriptionHierarchyFieldsMethodsProperties

Unit

Declaration

type TBlockSocket = class(TObject)

Description

Basic IP object.

This is parent class for other class with protocol implementations. Do not use this class directly! Use TICMPBlockSocket, TRAWBlockSocket, TTCPBlockSocket or TUDPBlockSocket instead.

Hierarchy

Overview

Methods

Public constructor Create;
Public constructor CreateAlternate(Stub: string);
Public destructor Destroy; override;
Public procedure CreateSocket;
Public procedure CreateSocketByName(const Value: String);
Public procedure CloseSocket; virtual;
Public procedure AbortSocket; virtual;
Public procedure Bind(IP, Port: string);
Public procedure Connect(IP, Port: string); virtual;
Public procedure Listen; virtual;
Public function Accept: TSocket; virtual;
Public function SendBuffer(Buffer: Tmemory; Length: Integer): Integer; virtual;
Public procedure SendByte(Data: Byte); virtual;
Public procedure SendString(Data: AnsiString); virtual;
Public procedure SendInteger(Data: integer); virtual;
Public procedure SendBlock(const Data: AnsiString); virtual;
Public procedure SendStreamRaw(const Stream: TStream); virtual;
Public procedure SendStream(const Stream: TStream); virtual;
Public procedure SendStreamIndy(const Stream: TStream); virtual;
Public function RecvBuffer(Buffer: TMemory; Length: Integer): Integer; virtual;
Public function RecvBufferEx(Buffer: Tmemory; Len: Integer; Timeout: Integer): Integer; virtual;
Public function RecvBufferStr(Len: Integer; Timeout: Integer): AnsiString; virtual;
Public function RecvByte(Timeout: Integer): Byte; virtual;
Public function RecvInteger(Timeout: Integer): Integer; virtual;
Public function RecvString(Timeout: Integer): AnsiString; virtual;
Public function RecvTerminated(Timeout: Integer; const Terminator: AnsiString): AnsiString; virtual;
Public function RecvPacket(Timeout: Integer): AnsiString; virtual;
Public function RecvBlock(Timeout: Integer): AnsiString; virtual;
Public procedure RecvStreamRaw(const Stream: TStream; Timeout: Integer); virtual;
Public procedure RecvStreamSize(const Stream: TStream; Timeout: Integer; Size: Integer);
Public procedure RecvStream(const Stream: TStream; Timeout: Integer); virtual;
Public procedure RecvStreamIndy(const Stream: TStream; Timeout: Integer); virtual;
Public function PeekBuffer(Buffer: TMemory; Length: Integer): Integer; virtual;
Public function PeekByte(Timeout: Integer): Byte; virtual;
Public function WaitingData: Integer; virtual;
Public function WaitingDataEx: Integer;
Public procedure Purge;
Public procedure SetLinger(Enable: Boolean; Linger: Integer);
Public procedure GetSinLocal;
Public procedure GetSinRemote;
Public procedure GetSins;
Public procedure ResetLastError;
Public function SockCheck(SockResult: Integer): Integer; virtual;
Public procedure ExceptCheck;
Public function LocalName: string;
Public procedure ResolveNameToIP(Name: string; const IPList: TStrings);
Public function ResolveName(Name: string): string;
Public function ResolveIPToName(IP: string): string;
Public function ResolvePort(Port: string): Word;
Public procedure SetRemoteSin(IP, Port: string);
Public function GetLocalSinIP: string; virtual;
Public function GetRemoteSinIP: string; virtual;
Public function GetLocalSinPort: Integer; virtual;
Public function GetRemoteSinPort: Integer; virtual;
Public function CanRead(Timeout: Integer): Boolean; virtual;
Public function CanReadEx(Timeout: Integer): Boolean; virtual;
Public function CanWrite(Timeout: Integer): Boolean; virtual;
Public function SendBufferTo(Buffer: TMemory; Length: Integer): Integer; virtual;
Public function RecvBufferFrom(Buffer: TMemory; Length: Integer): Integer; virtual;
Public function GroupCanRead(const SocketList: TList; Timeout: Integer; const CanReadList: TList): Boolean;
Public procedure EnableReuse(Value: Boolean);
Public procedure SetTimeout(Timeout: Integer);
Public procedure SetSendTimeout(Timeout: Integer);
Public procedure SetRecvTimeout(Timeout: Integer);
Public function GetSocketType: integer; Virtual;
Public function GetSocketProtocol: integer; Virtual;
Published class function GetErrorDesc(ErrorCode: Integer): string;
Published function GetErrorDescEx: string; virtual;

Properties

Public property WSAData: TWSADATA read GetWsaData;
Public property FDset: TFDSet read FFDset;
Public property LocalSin: TVarSin read FLocalSin write FLocalSin;
Public property RemoteSin: TVarSin read FRemoteSin write FRemoteSin;
Public property Socket: TSocket read FSocket write SetSocket;
Public property LastError: Integer read FLastError;
Public property LastErrorDesc: string read FLastErrorDesc;
Public property LineBuffer: AnsiString read FBuffer write FBuffer;
Public property SizeRecvBuffer: Integer read GetSizeRecvBuffer write SetSizeRecvBuffer;
Public property SizeSendBuffer: Integer read GetSizeSendBuffer write SetSizeSendBuffer;
Public property NonBlockMode: Boolean read FNonBlockMode Write SetNonBlockMode;
Public property TTL: Integer read GetTTL Write SetTTL;
Public property IP6used: Boolean read FIP6used;
Public property RecvCounter: Integer read FRecvCounter;
Public property SendCounter: Integer read FSendCounter;
Published property Tag: Integer read FTag write FTag;
Published property RaiseExcept: Boolean read FRaiseExcept write FRaiseExcept;
Published property MaxLineLength: Integer read FMaxLineLength Write FMaxLineLength;
Published property MaxSendBandwidth: Integer read FMaxSendBandwidth Write FMaxSendBandwidth;
Published property MaxRecvBandwidth: Integer read FMaxRecvBandwidth Write FMaxRecvBandwidth;
Published property MaxBandwidth: Integer Write SetBandwidth;
Published property ConvertLineEnd: Boolean read FConvertLineEnd Write FConvertLineEnd;
Published property Family: TSocketFamily read FFamily Write SetFamily;
Published property PreferIP4: Boolean read FPreferIP4 Write FPreferIP4;
Published property InterPacketTimeout: Boolean read FInterPacketTimeout Write FInterPacketTimeout;
Published property SendMaxChunk: Integer read FSendMaxChunk Write FSendMaxChunk;
Published property StopFlag: Boolean read FStopFlag Write FStopFlag;
Published property NonblockSendTimeout: Integer read FNonblockSendTimeout Write FNonblockSendTimeout;
Published property OnStatus: THookSocketStatus read FOnStatus write FOnStatus;
Published property OnReadFilter: THookDataFilter read FOnReadFilter write FOnReadFilter;
Published property OnCreateSocket: THookCreateSocket read FOnCreateSocket write FOnCreateSocket;
Published property OnMonitor: THookMonitor read FOnMonitor write FOnMonitor;
Published property OnHeartbeat: THookHeartbeat read FOnHeartbeat write FOnHeartbeat;
Published property HeartbeatRate: integer read FHeartbeatRate Write FHeartbeatRate;
Published property Owner: TObject read FOwner Write FOwner;

Description

Methods

Public constructor Create;
 
Public constructor CreateAlternate(Stub: string);

Create object and load all necessary socket library. What library is loaded is described by STUB parameter. If STUB is empty string, then is loaded default libraries.

Public destructor Destroy; override;
 
Public procedure CreateSocket;

If Family is not SF_Any, then create socket with type defined in Family property. If family is SF_Any, then do nothing! (socket is created automaticly when you know what type of socket you need to create. (i.e. inside Connect or Bind call.) When socket is created, then is aplyed all stored delayed socket options.

Public procedure CreateSocketByName(const Value: String);

It create socket. Address resolving of Value tells what type of socket is created. If Value is resolved as IPv4 IP, then is created IPv4 socket. If value is resolved as IPv6 address, then is created IPv6 socket.

Public procedure CloseSocket; virtual;

Destroy socket in use. This method is also automatically called from object destructor.

Public procedure AbortSocket; virtual;

Abort any work on Socket and destroy them.

Public procedure Bind(IP, Port: string);

Connects socket to local IP address and PORT. IP address may be numeric or symbolic ('192.168.74.50', 'cosi.nekde.cz', 'ff08::1'). The same for PORT - it may be number or mnemonic port ('23', 'telnet').

If port value is '0', system chooses itself and conects unused port in the range 1024 to 4096 (this depending by operating system!). Structure LocalSin is filled after calling this method.

Note: If you call this on non-created socket, then socket is created automaticly.

Warning: when you call : Bind('0.0.0.0','0'); then is nothing done! In this case is used implicit system bind instead.

Public procedure Connect(IP, Port: string); virtual;

Connects socket to remote IP address and PORT. The same rules as with Bind method are valid. The only exception is that PORT with 0 value will not be connected!

Structures LocalSin and RemoteSin will be filled with valid values.

When you call this on non-created socket, then socket is created automaticly. Type of created socket is by Family property. If is used SF_IP4, then is created socket for IPv4. If is used SF_IP6, then is created socket for IPv6. When you have family on SF_Any (default!), then type of created socket is determined by address resolving of destination address. (Not work properly on prilimitary winsock IPv6 support!)

Public procedure Listen; virtual;

Sets socket to receive mode for new incoming connections. It is necessary to use TBlockSocket.Bind function call before this method to select receiving port!

Public function Accept: TSocket; virtual;

Waits until new incoming connection comes. After it comes a new socket is automatically created (socket handler is returned by this function as result).

Public function SendBuffer(Buffer: Tmemory; Length: Integer): Integer; virtual;

Sends data of LENGTH from BUFFER address via connected socket. System automatically splits data to packets.

Public procedure SendByte(Data: Byte); virtual;

One data BYTE is sent via connected socket.

Public procedure SendString(Data: AnsiString); virtual;

Send data string via connected socket. Any terminator is not added! If you need send true string with CR-LF termination, you must add CR-LF characters to sended string! Because any termination is not added automaticly, you can use this function for sending any binary data in binary string.

Public procedure SendInteger(Data: integer); virtual;

Send integer as four bytes to socket.

Public procedure SendBlock(const Data: AnsiString); virtual;

Send data as one block to socket. Each block begin with 4 bytes with length of data in block. This 4 bytes is added automaticly by this function.

Public procedure SendStreamRaw(const Stream: TStream); virtual;

Send data from stream to socket.

Public procedure SendStream(const Stream: TStream); virtual;

Send content of stream to socket. It using SendBlock method

Public procedure SendStreamIndy(const Stream: TStream); virtual;

Send content of stream to socket. It using SendBlock method and this is compatible with streams in Indy library.

Public function RecvBuffer(Buffer: TMemory; Length: Integer): Integer; virtual;

Note: This is low-level receive function. You must be sure if data is waiting for read before call this function for avoid deadlock!

Waits until allocated buffer is filled by received data. Returns number of data received, which equals to LENGTH value under normal operation. If it is not equal the communication channel is possibly broken.

On stream oriented sockets if is received 0 bytes, it mean 'socket is closed!"

On datagram socket is readed first waiting datagram.

Public function RecvBufferEx(Buffer: Tmemory; Len: Integer; Timeout: Integer): Integer; virtual;

Note: This is high-level receive function. It using internal LineBuffer and you can combine this function freely with other high-level functions!

Method waits until data is received. If no data is received within TIMEOUT (in milliseconds) period, LastError is set to WSAETIMEDOUT. Methods serves for reading any size of data (i.e. one megabyte...). This method is preffered for reading from stream sockets (like TCP).

Public function RecvBufferStr(Len: Integer; Timeout: Integer): AnsiString; virtual;

Similar to RecvBufferEx, but readed data is stored in binary string, not in memory buffer.

Public function RecvByte(Timeout: Integer): Byte; virtual;

Note: This is high-level receive function. It using internal LineBuffer and you can combine this function freely with other high-level functions.

Waits until one data byte is received which is also returned as function result. If no data is received within TIMEOUT (in milliseconds)period, LastError is set to WSAETIMEDOUT and result have value 0.

Public function RecvInteger(Timeout: Integer): Integer; virtual;

Note: This is high-level receive function. It using internal LineBuffer and you can combine this function freely with other high-level functions.

Waits until one four bytes are received and return it as one Ineger Value. If no data is received within TIMEOUT (in milliseconds)period, LastError is set to WSAETIMEDOUT and result have value 0.

Public function RecvString(Timeout: Integer): AnsiString; virtual;

Note: This is high-level receive function. It using internal LineBuffer and you can combine this function freely with other high-level functions.

Method waits until data string is received. This string is terminated by CR-LF characters. The resulting string is returned without this termination (CR-LF)! If ConvertLineEnd is used, then CR-LF sequence may not be exactly CR-LF. See ConvertLineEnd description. If no data is received within TIMEOUT (in milliseconds) period, LastError is set to WSAETIMEDOUT. You may also specify maximum length of reading data by MaxLineLength property.

Public function RecvTerminated(Timeout: Integer; const Terminator: AnsiString): AnsiString; virtual;

Note: This is high-level receive function. It using internal LineBuffer and you can combine this function freely with other high-level functions.

Method waits until data string is received. This string is terminated by Terminator string. The resulting string is returned without this termination. If no data is received within TIMEOUT (in milliseconds) period, LastError is set to WSAETIMEDOUT. You may also specify maximum length of reading data by MaxLineLength property.

Public function RecvPacket(Timeout: Integer): AnsiString; virtual;

Note: This is high-level receive function. It using internal LineBuffer and you can combine this function freely with other high-level functions.

Method reads all data waiting for read. If no data is received within TIMEOUT (in milliseconds) period, LastError is set to WSAETIMEDOUT. Methods serves for reading unknown size of data. Because before call this function you don't know size of received data, returned data is stored in dynamic size binary string. This method is preffered for reading from stream sockets (like TCP). It is very goot for receiving datagrams too! (UDP protocol)

Public function RecvBlock(Timeout: Integer): AnsiString; virtual;

Read one block of data from socket. Each block begin with 4 bytes with length of data in block. This function read first 4 bytes for get lenght, then it wait for reported count of bytes.

Public procedure RecvStreamRaw(const Stream: TStream; Timeout: Integer); virtual;

Read all data from socket to stream until socket is closed (or any error occured.)

Public procedure RecvStreamSize(const Stream: TStream; Timeout: Integer; Size: Integer);

Read requested count of bytes from socket to stream.

Public procedure RecvStream(const Stream: TStream; Timeout: Integer); virtual;

Receive data to stream. It using RecvBlock method.

Public procedure RecvStreamIndy(const Stream: TStream; Timeout: Integer); virtual;

Receive data to stream. This function is compatible with similar function in Indy library. It using RecvBlock method.

Public function PeekBuffer(Buffer: TMemory; Length: Integer): Integer; virtual;

Same as RecvBuffer, but readed data stays in system input buffer. Warning: this function not respect data in LineBuffer! Is not recommended to use this function!

Public function PeekByte(Timeout: Integer): Byte; virtual;

Same as RecvByte, but readed data stays in input system buffer. Warning: this function not respect data in LineBuffer! Is not recommended to use this function!

Public function WaitingData: Integer; virtual;

On stream sockets it returns number of received bytes waiting for picking. 0 is returned when there is no such data. On datagram socket it returns length of the first waiting datagram. Returns 0 if no datagram is waiting.

Public function WaitingDataEx: Integer;

Same as WaitingData, but if exists some of data in LineBuffer, return their length instead.

Public procedure Purge;

Clear all waiting data for read from buffers.

Public procedure SetLinger(Enable: Boolean; Linger: Integer);

Sets linger. Enabled linger means that the system waits another LINGER (in milliseconds) time for delivery of sent data. This function is only for stream type of socket! (TCP)

Public procedure GetSinLocal;

Actualize values in LocalSin.

Public procedure GetSinRemote;

Actualize values in RemoteSin.

Public procedure GetSins;

Actualize values in LocalSin and RemoteSin.

Public procedure ResetLastError;

Reset LastError and LastErrorDesc to non-error state.

Public function SockCheck(SockResult: Integer): Integer; virtual;

If you "manually" call Socket API functions, forward their return code as parameter to this function, which evaluates it, eventually calls GetLastError and found error code returns and stores to LastError.

Public procedure ExceptCheck;

If LastError contains some error code and RaiseExcept property is True, raise adequate exception.

Public function LocalName: string;

Returns local computer name as numerical or symbolic value. It try get fully qualified domain name. Name is returned in the format acceptable by functions demanding IP as input parameter.

Public procedure ResolveNameToIP(Name: string; const IPList: TStrings);

Try resolve name to all possible IP address. i.e. If you pass as name result of LocalName method, you get all IP addresses used by local system.

Public function ResolveName(Name: string): string;

Try resolve name to primary IP address. i.e. If you pass as name result of LocalName method, you get primary IP addresses used by local system.

Public function ResolveIPToName(IP: string): string;

Try resolve IP to their primary domain name. If IP not have domain name, then is returned original IP.

Public function ResolvePort(Port: string): Word;

Try resolve symbolic port name to port number. (i.e. 'Echo' to 8)

Public procedure SetRemoteSin(IP, Port: string);

Set information about remote side socket. It is good for seting remote side for sending UDP packet, etc.

Public function GetLocalSinIP: string; virtual;

Picks IP socket address from LocalSin.

Public function GetRemoteSinIP: string; virtual;

Picks IP socket address from RemoteSin.

Public function GetLocalSinPort: Integer; virtual;

Picks socket PORT number from LocalSin.

Public function GetRemoteSinPort: Integer; virtual;

Picks socket PORT number from RemoteSin.

Public function CanRead(Timeout: Integer): Boolean; virtual;

Return True, if you can read any data from socket or is incoming connection on TCP based socket. Status is tested for time Timeout (in milliseconds). If value in Timeout is 0, status is only tested and continue. If value in Timeout is -1, run is breaked and waiting for read data maybe forever.

This function is need only on special cases, when you need use RecvBuffer function directly! read functioms what have timeout as calling parameter, calling this function internally.

Public function CanReadEx(Timeout: Integer): Boolean; virtual;

Same as CanRead, but additionally return True if is some data in LineBuffer.

Public function CanWrite(Timeout: Integer): Boolean; virtual;

Return True, if you can to socket write any data (not full sending buffer). Status is tested for time Timeout (in milliseconds). If value in Timeout is 0, status is only tested and continue. If value in Timeout is -1, run is breaked and waiting for write data maybe forever.

This function is need only on special cases!

Public function SendBufferTo(Buffer: TMemory; Length: Integer): Integer; virtual;

Same as SendBuffer, but send datagram to address from RemoteSin. Usefull for sending reply to datagram received by function RecvBufferFrom.

Public function RecvBufferFrom(Buffer: TMemory; Length: Integer): Integer; virtual;

Note: This is low-lever receive function. You must be sure if data is waiting for read before call this function for avoid deadlock!

Receives first waiting datagram to allocated buffer. If there is no waiting one, then waits until one comes. Returns length of datagram stored in BUFFER. If length exceeds buffer datagram is truncated. After this RemoteSin structure contains information about sender of UDP packet.

Public function GroupCanRead(const SocketList: TList; Timeout: Integer; const CanReadList: TList): Boolean;

This function is for check for incoming data on set of sockets. Whitch sockets is checked is decribed by SocketList Tlist with TBlockSocket objects. TList may have maximal number of objects defined by FD_SETSIZE constant. Return True, if you can from some socket read any data or is incoming connection on TCP based socket. Status is tested for time Timeout (in milliseconds). If value in Timeout is 0, status is only tested and continue. If value in Timeout is -1, run is breaked and waiting for read data maybe forever. If is returned True, CanReadList TList is filled by all TBlockSocket objects what waiting for read.

Public procedure EnableReuse(Value: Boolean);

By this method you may turn address reuse mode for local Bind. It is good specially for UDP protocol. Using this with TCP protocol is hazardous!

Public procedure SetTimeout(Timeout: Integer);

Try set timeout for all sending and receiving operations, if socket provider can do it. (It not supported by all socket providers!)

Public procedure SetSendTimeout(Timeout: Integer);

Try set timeout for all sending operations, if socket provider can do it. (It not supported by all socket providers!)

Public procedure SetRecvTimeout(Timeout: Integer);

Try set timeout for all receiving operations, if socket provider can do it. (It not supported by all socket providers!)

Public function GetSocketType: integer; Virtual;

Return value of socket type.

Public function GetSocketProtocol: integer; Virtual;

Return value of protocol type for socket creation.

Published class function GetErrorDesc(ErrorCode: Integer): string;

Return descriptive string for given error code. This is class function. You may call it without created object!

Published function GetErrorDescEx: string; virtual;

Return descriptive string for LastError.

Properties

Public property WSAData: TWSADATA read GetWsaData;

WSA structure with information about socket provider. On non-windows platforms this structure is simulated!

Public property FDset: TFDSet read FFDset;

FDset structure prepared for usage with this socket.

Public property LocalSin: TVarSin read FLocalSin write FLocalSin;

Structure describing local socket side.

Public property RemoteSin: TVarSin read FRemoteSin write FRemoteSin;

Structure describing remote socket side.

Public property Socket: TSocket read FSocket write SetSocket;

Socket handler. Suitable for "manual" calls to socket API or manual connection of socket to a previously created socket (i.e by Accept method on TCP socket)

Public property LastError: Integer read FLastError;

Last socket operation error code. Error codes are described in socket documentation. Human readable error description is stored in LastErrorDesc property.

Public property LastErrorDesc: string read FLastErrorDesc;

Human readable error description of LastError code.

Public property LineBuffer: AnsiString read FBuffer write FBuffer;

Buffer used by all high-level receiving functions. This buffer is used for optimized reading of data from socket. In normal cases you not need access to this buffer directly!

Public property SizeRecvBuffer: Integer read GetSizeRecvBuffer write SetSizeRecvBuffer;

Size of Winsock receive buffer. If it is not supported by socket provider, it return as size one kilobyte.

Public property SizeSendBuffer: Integer read GetSizeSendBuffer write SetSizeSendBuffer;

Size of Winsock send buffer. If it is not supported by socket provider, it return as size one kilobyte.

Public property NonBlockMode: Boolean read FNonBlockMode Write SetNonBlockMode;

If True, turn class to non-blocking mode. Not all functions are working properly in this mode, you must know exactly what you are doing! However when you have big experience with non-blocking programming, then you can optimise your program by non-block mode!

Public property TTL: Integer read GetTTL Write SetTTL;

Set Time-to-live value. (if system supporting it!)

Public property IP6used: Boolean read FIP6used;

If is True, then class in in IPv6 mode.

Public property RecvCounter: Integer read FRecvCounter;

Return count of received bytes on this socket from begin of current connection.

Public property SendCounter: Integer read FSendCounter;

Return count of sended bytes on this socket from begin of current connection.

Published property Tag: Integer read FTag write FTag;

this value is for free use.

Published property RaiseExcept: Boolean read FRaiseExcept write FRaiseExcept;

If True, winsock errors raises exception. Otherwise is setted LastError value only and you must check it from your program! Default value is False.

Published property MaxLineLength: Integer read FMaxLineLength Write FMaxLineLength;

Define maximum length in bytes of LineBuffer for high-level receiving functions. If this functions try to read more data then this limit, error is returned! If value is 0 (default), no limitation is used. This is very good protection for stupid attacks to your server by sending lot of data without proper terminator... until all your memory is allocated by LineBuffer!

Note: This maximum length is checked only in functions, what read unknown number of bytes! (like RecvString or RecvTerminated)

Published property MaxSendBandwidth: Integer read FMaxSendBandwidth Write FMaxSendBandwidth;

Define maximal bandwidth for all sending operations in bytes per second. If value is 0 (default), bandwidth limitation is not used.

Published property MaxRecvBandwidth: Integer read FMaxRecvBandwidth Write FMaxRecvBandwidth;

Define maximal bandwidth for all receiving operations in bytes per second. If value is 0 (default), bandwidth limitation is not used.

Published property MaxBandwidth: Integer Write SetBandwidth;

Define maximal bandwidth for all sending and receiving operations in bytes per second. If value is 0 (default), bandwidth limitation is not used.

Published property ConvertLineEnd: Boolean read FConvertLineEnd Write FConvertLineEnd;

Do a conversion of non-standard line terminators to CRLF. (Off by default) If True, then terminators like sigle CR, single LF or LFCR are converted to CRLF internally. This have effect only in RecvString method!

Published property Family: TSocketFamily read FFamily Write SetFamily;

Specified Family of this socket. When you are using Windows preliminary support for IPv6, then I recommend to set this property!

Published property PreferIP4: Boolean read FPreferIP4 Write FPreferIP4;

When resolving of domain name return both IPv4 and IPv6 addresses, then specify if is used IPv4 (dafault - True) or IPv6.

Published property InterPacketTimeout: Boolean read FInterPacketTimeout Write FInterPacketTimeout;

By default (True) is all timeouts used as timeout between two packets in reading operations. If you set this to False, then Timeouts is for overall reading operation!

Published property SendMaxChunk: Integer read FSendMaxChunk Write FSendMaxChunk;

All sended datas was splitted by this value.

Published property StopFlag: Boolean read FStopFlag Write FStopFlag;

By setting this property to True you can stop any communication. You can use this property for soft abort of communication.

Published property NonblockSendTimeout: Integer read FNonblockSendTimeout Write FNonblockSendTimeout;

Timeout for data sending by non-blocking socket mode.

Published property OnStatus: THookSocketStatus read FOnStatus write FOnStatus;

This event is called by various reasons. It is good for monitoring socket, create gauges for data transfers, etc.

Published property OnReadFilter: THookDataFilter read FOnReadFilter write FOnReadFilter;

this event is good for some internal thinks about filtering readed datas. It is used by telnet client by example.

Published property OnCreateSocket: THookCreateSocket read FOnCreateSocket write FOnCreateSocket;

This event is called after real socket creation for setting special socket options, because you not know when socket is created. (it is depended on Ipv4, IPv6 or automatic mode)

Published property OnMonitor: THookMonitor read FOnMonitor write FOnMonitor;

This event is good for monitoring content of readed or writed datas.

Published property OnHeartbeat: THookHeartbeat read FOnHeartbeat write FOnHeartbeat;

This event is good for calling your code during long socket operations. (Example, for refresing UI if class in not called within the thread.) Rate of heartbeats can be modified by HeartbeatRate property.

Published property HeartbeatRate: integer read FHeartbeatRate Write FHeartbeatRate;

Specify typical rate of OnHeartbeat event and StopFlag testing. Default value 0 disabling heartbeats! Value is in milliseconds. Real rate can be higher or smaller then this value, because it depending on real socket operations too! Note: Each heartbeat slowing socket processing.

Published property Owner: TObject read FOwner Write FOwner;

What class own this socket? Used by protocol implementation classes.


Generated by PasDoc 0.9.0 on 2012-04-23 21:38:56