Original Symbian headers
Selected EUSER, Window Server, networking, graphics and device declarations
Loading...
Searching...
No Matches
es_sock.h File Reference
#include <e32base.h>
#include <nifvar.h>
#include <comms-infras/metacontainer.h>
#include <elements/sd_errors.h>
#include <comms-infras/es_parameterset.h>
#include <comms-infras/es_event.h>
#include <es_sock_internal.h>
#include <es_sock_partner.h>
#include <es_sock.inl>

Go to the source code of this file.

Classes

class  TSessionPref
 Hint to the Socket Server on what will be the principal usage of the connection. More...
 
class  TNifProgress
 Contains progress information on a dial-up connection. More...
 
class  TNifAgentInfo
 Contains information describing an agent. More...
 
struct  SSockAddr
 Socket address offsets. More...
 
class  TSockAddr
 Represents an end point address. More...
 
struct  TProtocolDesc
 Socket protocol information for use by clients. More...
 
class  RSocketServ
 Provides the Connect() function to create an IPC communication channel to the socket server. More...
 
class  RSocket
 Provides a client endpoint to a protocol. More...
 
class  TNameRecord
 Contains the results of name queries. More...
 
class  RHostResolver
 Provides an interface to host name resolution services, such as DNS, that may be provided by particular protocol modules. More...
 
class  RServiceResolver
 Provides an interface to resolver service names and ports. More...
 
class  RNetDatabase
 Provides an interface to network databases, such as LM-IAS with IrDA, that may be provided by particular protocol modules. More...
 
class  RConnection
 The management interface for a network connection or subconnection. More...
 
class  CSubConParameterSet
 Base class for all RSubConnection parameter sets. More...
 
class  CSubConGenericParameterSet
 Base class for generic RSubConnection parameter sets. More...
 
class  CSubConExtensionParameterSet
 Base class for extended RSubConnection parameter sets. More...
 
class  CSubConParameterFamily
 Container of RSubConnection parameter sets. More...
 
class  RSubConParameterBundle
 Container for (bundle of) SubConnection parameter families. More...
 
class  TNotificationEventBuf
 Buffer for Sub-connection event notiifcation. More...
 
class  CSubConNotificationEvent
 
class  TSubConnOpen
 
class  RSubConnection
 A Sub-Connection, a channel within a Connection. More...
 
struct  RSubConnection::TEventFilter
 
class  ByteOrder
 Reverses the byte order in 16 and 32-bit values. More...
 
class  BigEndian
 Inserts and extracts integers in big-endian format. More...
 
class  LittleEndian
 Inserts and extracts integers in little-endian format. More...
 
class  TAccessPointInfo
 Stores Access Point information. More...
 

Namespaces

namespace  ESock
 
namespace  ESockDebug
 

Typedefs

typedef TUint TSubConnectionUniqueId
 SubConnection Unique Id.
 
typedef TBuf8< KMaxSubConnectionEventSize > TSubConnectionNotificationBuf
 Buffer for notification of any change in the state of SubConnection.
 
typedef TPckgBuf< TNifProgress > TNifProgressBuf
 Buffer for Network Interface Progress.
 
typedef TBuf< 0x20 > TProtocolName
 Contains the name of a protocol in structure TProtocolDesc.
 
typedef TBuf< 0x20 > TServiceName
 Defines a descriptor to hold a service name string.
 
typedef TBuf< 0x100 > THostName
 Defines a descriptor to hold a host name string.
 
typedef TPckgBuf< TInt > TSockXfrLength
 Used in RSocket read and write calls to pass the length of data read and written.
 
typedef TPckgBuf< TNameRecord > TNameEntry
 Packages the TNameRecord class so that it can be passed between a client and the socket server.
 
typedef TPckgBuf< TInt > TPortNum
 Port number on service.
 

Enumerations

enum  TByteOrder { EBigEndian , ELittleEndian , EOtherByteOrder }
 Used in structure TProtocolDesc to describes the endianness of a protocol. More...
 

Functions

 _LIT8 (SOCKET_SERVER_MAIN_MODULE_NAME, "ESock_Main")
 Canonical names for the core ESOCKSVR modules.
 
 _LIT8 (SOCKET_SERVER_IP_MODULE_NAME, "ESock_IP")
 
 _LIT8 (SOCKET_SERVER_BT_MODULE_NAME, "ESock_Bt")
 
 _LIT8 (SOCKET_SERVER_IR_MODULE_NAME, "ESock_Ir")
 
 _LIT8 (SOCKET_SERVER_SMSWAP_MODULE_NAME, "ESock_SmsWap")
 

Variables

const TUint KConnectionUp = 7000
 Progress Notification to inform clients Connection is up This event has the same numerical values as KLinkLayerOpen which is deprecated.
 
const TUint KConnectionDown = 8000
 Progress Notification to inform clients Connection is up This event has the same numerical values as KLinkLayerClosed which is deprecated.
 
const TUint KESockDefaultMessageSlots =8
 Default number of message slots.
 
const TUint KMaxSubConnectionEventSize = 512
 Size of Maximum SubConnection event.
 
const TUint KUseEmbeddedUniqueId = 0
 
const TUint KConnProgressDefault = 0
 
const TUint KMaxSockAddrSize =0x20
 Maximum sockets address size.
 
const TUint KAFUnspec =0
 Default (unspecified) protocol module.
 
const TUint KSockStream =1
 Stream socket.
 
const TUint KSockDatagram =2
 Datagram socket.
 
const TUint KSockSeqPacket =3
 Datagrams with sequence numbers.
 
const TUint KSockRaw =4
 Raw socket.
 
const TInt KSOLSocket =1
 Generic socket options/commands.
 
const TInt KLevelUnspecified =0
 Unspecified level.
 
const TUint KSODebug =1
 Debugging enabled or disabled .
 
const TUint KSORecvBuf =2
 Socket receive buffer size.
 
const TUint KSOSendBuf =3
 Socket send buffer size.
 
const TUint KSONonBlockingIO =4
 Socket nonblocking mode.
 
const TUint KSOBlockingIO =5
 Socket blocking mode.
 
const TUint KSOSelectPoll =6
 Getting only: gets a bitmask of flags describing the read/write/exception status of the socket.
 
const TUint KSOReadBytesPending =7
 Getting only: retrieve the number of bytes currently available for reading.
 
const TUint KSOUrgentDataOffset =8
 Getting only: retrieve the urgent data offset (only for stream protocols that support urgent data).
 
const TUint KSOSelectLastError =9
 Getting only: retrieves the last error.
 
const TUint KSOEnableTransfer = 10
 Setting only.
 
const TUint KSODisableTransfer = 11
 Setting only.
 
const TInt KSocketBufSizeUndefined =0
 Use default buffer size.
 
const TInt KSocketDefaultBufferSize =4096
 Default buffer size.
 
const TUint KSocketInternalOptionBit =0x80000000
 
const TUint KIOctlSelect =1
 The aDesc parameter of RSocket::Ioctl() specifies a TUint containing a bitmask of Socket status constants.
 
const TUint KSockSelectRead =0x00000001
 Data is available to be read; for listening sockets, a connect is pending.
 
const TUint KSockSelectWrite =0x00000002
 Writing to the socket is not currently blocked by flow-control.
 
const TUint KSockSelectExcept =0x00000004
 An error has occurred.
 
const TUint KSockSelectReadContinuation = 0x01000000
 Include tail of prior read datagram as available data (ie indicates next read will be with read continuation)
 
const TUint KSockWriteUrgent =0x00000001
 The data to be sent is urgent and is given a higher priority than ordinary data in the send queue.
 
const TUint KSocketInternalWriteBit =0x80000000
 Must not be set for client requests.
 
const TUint KSockWriteSystemMask =0xFF000000
 The top 8 bits are reserved for system purposes; protocols must not define these bits.
 
const TUint KSockReadPeek =0x00000001
 Read data without consuming it, data remains in the receive queue.
 
const TUint KSocketInternalReadBit =0x80000000
 Must not be set for client requests.
 
const TUint KSockReadContinuation = 0x01000000
 Read from datagram in a stream-like fashion (not discarding tails).
 
const TUint KSIConnectionLess =0x00000001
 The protocol is connectionless.
 
const TUint KSIReliable =0x00000002
 The protocol is reliable.
 
const TUint KSIInOrder =0x00000004
 The protocol guarantees in-order delivery.
 
const TUint KSIMessageBased =0x00000008
 The protocol is message based.
 
const TUint KSIDatagram =KSIMessageBased
 The same as message based.
 
const TUint KSIStreamBased =0x00000010
 The protocol is stream based.
 
const TUint KSIPseudoStream =0x00000020
 The protocol supports a stream like interface but maintains datagram boundaries.
 
const TUint KSIUrgentData =0x00000040
 The protocol offers an expedited data service.
 
const TUint KSIConnectData =0x00000080
 The protocol can send user data on a connection request.
 
const TUint KSIDisconnectData =0x00000100
 The protocol can send user data on a disconnect request.
 
const TUint KSIBroadcast =0x00000200
 The protocol supports broadcast addresses.
 
const TUint KSIMultiPoint =0x00000400
 The protocol supports point to multi-point connections.
 
const TUint KSIQOS =0x00000800
 The protocol supports a quality of service metric.
 
const TUint KSIWriteOnly =0x00001000
 The protocol is write only.
 
const TUint KSIReadOnly =0x00002000
 The protocol is read only.
 
const TUint KSIGracefulClose =0x00004000
 The protocol supports graceful close.
 
const TUint KSICanReconnect =0x00008000
 The same socket can be reconnected if it disconnects (for whatever reason).
 
const TUint KSIPeekData =0x00010000
 Protocol supports peeking (looking at the data without removing it from the protocol).
 
const TUint KSIRequiresOwnerInfo =0x00020000
 Protocol is to be informed of the identity of the client (i.e.
 
const TUint KSIReserved =0xFFFC0000
 
const TUint KNSNameResolution =0x00000001
 Protocol supports resolving human readable entity names into network addresses (like DNS).
 
const TUint KNSHierarchicalNaming =0x00000002
 Network naming is hierarchical.
 
const TUint KNSHeirarchicalNaming =KNSHierarchicalNaming
 
const TUint KNSRemoteDiscovery =0x00000004
 Addressing is dynamic and should be attempted every time before connecting (like IrDA).
 
const TUint KNSServiceResolution =0x00000008
 Protocol supports service name to port number resolution.
 
const TUint KNSNameRegistration =0x00000010
 Protocol supports additions to the name database.
 
const TUint KNSServiceRegistration =0x00000020
 Protocol supports additions to the service database.
 
const TUint KNSDynamicAddressing =0x00000040
 Addressing is dynamic - i.e.
 
const TUint KNSInfoDatabase =0x00000080
 Protocol has another database which is defined by the protocol.
 
const TUint KNSRequiresConnectionStartup =0x00000100
 Protocol may request Socket Server to startup a connection on its behalf (via the KErrCompletion error code) Note that this value has no meaningful interpretation on the client side.
 
const TUint KNSReserved =0xFFFFFE00
 
const TUint KSocketNoSecurity =0x00000000
 No security.
 
const TUint KSecureSockets =0x00000001
 Secure Sockets Layer.
 
const TInt KSocketMessageSizeIsStream =0
 Reads and writes can be of any size: the data is treated as a stream.
 
const TInt KSocketMessageSizeUndefined =1
 Depends on lower layer or is dynamic.
 
const TInt KSocketMessageSizeNoLimit =-1
 Data is packet-oriented but packets can be of any size (i.e.
 
const TUint KUndefinedSockType =0xFFFFFFFF
 Undefined socket type.
 
const TUint KUndefinedProtocol =0xFFFFFFFE
 Undefined socket type.
 
const TUint KUndefinedAddressFamily = 0
 Undefined address family.
 
const TInt KErrWouldBlock =-1000
 This error is returned from operations on non-blocking sockets that cannot be completed immediately, for example receive when no data is queued for reading.
 
const TInt KErrConnectionTerminated =-17210
 socket errors
 
const TInt KErrCannotFindProtocol = Den::KErrPlayerNotFound
 
const TInt KErrTierNotFound = -17212
 
const TInt KErrConnectionContention = -17213
 
const TInt KErrProtocolNotReady = -17214
 The protocol requested for the socket was recognised but was not able to be used.
 
const TUint KConnectionTypeDefault = 0x0800
 Default connection type.
 
const TInt32 KSubConnParamsInterfaceUid = 0x10204303
 
const TInt32 KSubConnEventInterfaceUid = 0x10204305
 
const TInt32 KSubConnGenericParamsImplUid = 0x10204304
 
const TInt32 KSubConnGenericEventsImplUid = 0x10204306
 
const TUint32 KSubConGlobalFamily = 0
 
const TUint32 KSubConQoSFamily = 1
 
const TUint32 KSubConAuthorisationFamily = 2
 
const TUint32 KSubConnCallDescrParamsFamily = 3
 
const TUint32 KSubConnContextDescrParamsFamily = 4
 
const TUint32 KSubConIPAddressInfoFamily = 5
 
const TInt32 KProtocolExtensionFamily = 6
 
const TInt32 KFlowParametersFamily = 7
 
const TInt KNotificationEventMaxSize = 2048
 

Detailed Description

API status
Published to all clients. Released API.

Definition in file es_sock.h.

Typedef Documentation

◆ THostName

typedef TBuf<0x100> THostName

Defines a descriptor to hold a host name string.

Definition at line 658 of file es_sock.h.

◆ TNameEntry

Packages the TNameRecord class so that it can be passed between a client and the socket server.

API status
Published to all clients. Released API.

Definition at line 969 of file es_sock.h.

◆ TNifProgressBuf

Buffer for Network Interface Progress.

API status
Published to all clients. Released API.

Definition at line 206 of file es_sock.h.

◆ TPortNum

typedef TPckgBuf<TInt> TPortNum

Port number on service.

API status
Published to all clients. Released API.

Definition at line 1033 of file es_sock.h.

◆ TProtocolName

typedef TBuf<0x20> TProtocolName

Contains the name of a protocol in structure TProtocolDesc.

API status
Published to all clients. Released API.

Definition at line 654 of file es_sock.h.

◆ TServiceName

typedef TBuf<0x20> TServiceName

Defines a descriptor to hold a service name string.

Definition at line 656 of file es_sock.h.

◆ TSockXfrLength

typedef TPckgBuf<TInt> TSockXfrLength

Used in RSocket read and write calls to pass the length of data read and written.

API status
Published to all clients. Released API.

Definition at line 756 of file es_sock.h.

◆ TSubConnectionNotificationBuf

Buffer for notification of any change in the state of SubConnection.

THIS API IS TO BE DEPRECATED

API status
Published to platform partners. Released API.

Definition at line 130 of file es_sock.h.

◆ TSubConnectionUniqueId

typedef TUint TSubConnectionUniqueId

SubConnection Unique Id.

THIS API IS TO BE DEPRECATED

API status
Published to platform partners. Released API.

Definition at line 119 of file es_sock.h.

Enumeration Type Documentation

◆ TByteOrder

enum TByteOrder

Used in structure TProtocolDesc to describes the endianness of a protocol.

API status
Published to all clients. Released API.
Enumerator
EBigEndian 

Big endian.

ELittleEndian 

Little endian.

EOtherByteOrder 

Other byte order.

Definition at line 477 of file es_sock.h.

Function Documentation

◆ _LIT8() [1/5]

_LIT8 ( SOCKET_SERVER_BT_MODULE_NAME  ,
"ESock_Bt"   
)

◆ _LIT8() [2/5]

_LIT8 ( SOCKET_SERVER_IP_MODULE_NAME  ,
"ESock_IP"   
)

◆ _LIT8() [3/5]

_LIT8 ( SOCKET_SERVER_IR_MODULE_NAME  ,
"ESock_Ir"   
)

◆ _LIT8() [4/5]

_LIT8 ( SOCKET_SERVER_MAIN_MODULE_NAME  ,
"ESock_Main"   
)

Canonical names for the core ESOCKSVR modules.

◆ _LIT8() [5/5]

_LIT8 ( SOCKET_SERVER_SMSWAP_MODULE_NAME  ,
"ESock_SmsWap"   
)

Variable Documentation

◆ KAFUnspec

const TUint KAFUnspec =0

Default (unspecified) protocol module.

API status
Published to all clients. Released API.

Definition at line 282 of file es_sock.h.

◆ KConnectionDown

const TUint KConnectionDown = 8000

Progress Notification to inform clients Connection is up This event has the same numerical values as KLinkLayerClosed which is deprecated.

API status
Published to all clients. Released API.

Definition at line 84 of file es_sock.h.

◆ KConnectionTypeDefault

const TUint KConnectionTypeDefault = 0x0800

Default connection type.

API status
Published to all clients. Released API.

Definition at line 1099 of file es_sock.h.

◆ KConnectionUp

const TUint KConnectionUp = 7000

Progress Notification to inform clients Connection is up This event has the same numerical values as KLinkLayerOpen which is deprecated.

API status
Published to all clients. Released API.

Definition at line 73 of file es_sock.h.

◆ KConnProgressDefault

const TUint KConnProgressDefault = 0

Definition at line 134 of file es_sock.h.

◆ KErrCannotFindProtocol

const TInt KErrCannotFindProtocol = Den::KErrPlayerNotFound

Definition at line 732 of file es_sock.h.

◆ KErrConnectionContention

const TInt KErrConnectionContention = -17213

Definition at line 734 of file es_sock.h.

◆ KErrConnectionTerminated

const TInt KErrConnectionTerminated =-17210

socket errors

The value -17210 is taken from the range allocated for Esock (beginning at -17200) A gap has been left between the currently existing vals and this one.

API status
Published to all clients. Released API.

Definition at line 730 of file es_sock.h.

◆ KErrProtocolNotReady

const TInt KErrProtocolNotReady = -17214

The protocol requested for the socket was recognised but was not able to be used.

This can happen with protocols that require specific settings to have been prepared prior to the socket being opened.

API status
Published to all clients. Released API.

Definition at line 745 of file es_sock.h.

◆ KErrTierNotFound

const TInt KErrTierNotFound = -17212

Definition at line 733 of file es_sock.h.

◆ KErrWouldBlock

const TInt KErrWouldBlock =-1000

This error is returned from operations on non-blocking sockets that cannot be completed immediately, for example receive when no data is queued for reading.

It is a non-fatal error, and the operation should be retried later.

API status
Published to all clients. Released API.

Definition at line 718 of file es_sock.h.

◆ KESockDefaultMessageSlots

const TUint KESockDefaultMessageSlots =8

Default number of message slots.

API status
Published to all clients. Released API.

Definition at line 95 of file es_sock.h.

◆ KFlowParametersFamily

const TInt32 KFlowParametersFamily = 7

Definition at line 1374 of file es_sock.h.

◆ KIOctlSelect

const TUint KIOctlSelect =1

The aDesc parameter of RSocket::Ioctl() specifies a TUint containing a bitmask of Socket status constants.

The completion status will be the subset of those conditions which is now true for the socket.

Used through RSocket::Ioctl(), with aLevel set to KSOLSocket.

See also
KSOSelectPoll parameter to RSocket::GetOpt(), which allows the current select state of the socket to be read synchronously, and KSOSelectLastError, which returns the error code.

Definition at line 422 of file es_sock.h.

◆ KLevelUnspecified

const TInt KLevelUnspecified =0

Unspecified level.

Definition at line 310 of file es_sock.h.

◆ KMaxSockAddrSize

const TUint KMaxSockAddrSize =0x20

Maximum sockets address size.

API status
Published to all clients. Released API.

Definition at line 234 of file es_sock.h.

◆ KMaxSubConnectionEventSize

const TUint KMaxSubConnectionEventSize = 512

Size of Maximum SubConnection event.

Note
If you allocate this on the heap, remember to delete through the pointer to the buffer and not any pointers to the events held inside it if you change this value, you will alter the function signature and break the .def file
API status
Published to all clients. Released API.

Definition at line 108 of file es_sock.h.

◆ KNotificationEventMaxSize

const TInt KNotificationEventMaxSize = 2048

Definition at line 1508 of file es_sock.h.

◆ KNSDynamicAddressing

const TUint KNSDynamicAddressing =0x00000040

Addressing is dynamic - i.e.

name to address mapping may change (like IrDA which randomly chooses machine addresses.)

Definition at line 575 of file es_sock.h.

◆ KNSHeirarchicalNaming

const TUint KNSHeirarchicalNaming =KNSHierarchicalNaming
Deprecated:
Use KNSHierarchicalNaming instead.

Definition at line 562 of file es_sock.h.

◆ KNSHierarchicalNaming

const TUint KNSHierarchicalNaming =0x00000002

Network naming is hierarchical.

Definition at line 560 of file es_sock.h.

◆ KNSInfoDatabase

const TUint KNSInfoDatabase =0x00000080

Protocol has another database which is defined by the protocol.

Definition at line 577 of file es_sock.h.

◆ KNSNameRegistration

const TUint KNSNameRegistration =0x00000010

Protocol supports additions to the name database.

Definition at line 570 of file es_sock.h.

◆ KNSNameResolution

const TUint KNSNameResolution =0x00000001

Protocol supports resolving human readable entity names into network addresses (like DNS).

API status
Published to all clients. Released API.

Definition at line 558 of file es_sock.h.

◆ KNSRemoteDiscovery

const TUint KNSRemoteDiscovery =0x00000004

Addressing is dynamic and should be attempted every time before connecting (like IrDA).

Definition at line 565 of file es_sock.h.

◆ KNSRequiresConnectionStartup

const TUint KNSRequiresConnectionStartup =0x00000100

Protocol may request Socket Server to startup a connection on its behalf (via the KErrCompletion error code) Note that this value has no meaningful interpretation on the client side.

Definition at line 582 of file es_sock.h.

◆ KNSReserved

const TUint KNSReserved =0xFFFFFE00
API status
Internal technology API.

Definition at line 588 of file es_sock.h.

◆ KNSServiceRegistration

const TUint KNSServiceRegistration =0x00000020

Protocol supports additions to the service database.

Definition at line 572 of file es_sock.h.

◆ KNSServiceResolution

const TUint KNSServiceResolution =0x00000008

Protocol supports service name to port number resolution.

(For example, you can look up TCP to get port 48.)

Definition at line 568 of file es_sock.h.

◆ KProtocolExtensionFamily

const TInt32 KProtocolExtensionFamily = 6

Definition at line 1373 of file es_sock.h.

◆ KSecureSockets

const TUint KSecureSockets =0x00000001

Secure Sockets Layer.

See also
CSecureSocket

Definition at line 603 of file es_sock.h.

◆ KSIBroadcast

const TUint KSIBroadcast =0x00000200

The protocol supports broadcast addresses.

Definition at line 518 of file es_sock.h.

◆ KSICanReconnect

const TUint KSICanReconnect =0x00008000

The same socket can be reconnected if it disconnects (for whatever reason).

Definition at line 530 of file es_sock.h.

◆ KSIConnectData

const TUint KSIConnectData =0x00000080

The protocol can send user data on a connection request.

Definition at line 514 of file es_sock.h.

◆ KSIConnectionLess

const TUint KSIConnectionLess =0x00000001

The protocol is connectionless.

API status
Published to all clients. Released API.

Definition at line 498 of file es_sock.h.

◆ KSIDatagram

const TUint KSIDatagram =KSIMessageBased

The same as message based.

Definition at line 506 of file es_sock.h.

◆ KSIDisconnectData

const TUint KSIDisconnectData =0x00000100

The protocol can send user data on a disconnect request.

Definition at line 516 of file es_sock.h.

◆ KSIGracefulClose

const TUint KSIGracefulClose =0x00004000

The protocol supports graceful close.

Definition at line 528 of file es_sock.h.

◆ KSIInOrder

const TUint KSIInOrder =0x00000004

The protocol guarantees in-order delivery.

Definition at line 502 of file es_sock.h.

◆ KSIMessageBased

const TUint KSIMessageBased =0x00000008

The protocol is message based.

Definition at line 504 of file es_sock.h.

◆ KSIMultiPoint

const TUint KSIMultiPoint =0x00000400

The protocol supports point to multi-point connections.

Definition at line 520 of file es_sock.h.

◆ KSIPeekData

const TUint KSIPeekData =0x00010000

Protocol supports peeking (looking at the data without removing it from the protocol).

Definition at line 533 of file es_sock.h.

◆ KSIPseudoStream

const TUint KSIPseudoStream =0x00000020

The protocol supports a stream like interface but maintains datagram boundaries.

Definition at line 510 of file es_sock.h.

◆ KSIQOS

const TUint KSIQOS =0x00000800

The protocol supports a quality of service metric.

Definition at line 522 of file es_sock.h.

◆ KSIReadOnly

const TUint KSIReadOnly =0x00002000

The protocol is read only.

Definition at line 526 of file es_sock.h.

◆ KSIReliable

const TUint KSIReliable =0x00000002

The protocol is reliable.

Definition at line 500 of file es_sock.h.

◆ KSIRequiresOwnerInfo

const TUint KSIRequiresOwnerInfo =0x00020000

Protocol is to be informed of the identity of the client (i.e.

process ID, thread ID and UID) of each SAP (i.e. Socket Service Provider) created. Note that this value has no meaningful interpretation on the client side.

See also
KSoOwnerInfo and TSoOwnerInfo

Definition at line 538 of file es_sock.h.

◆ KSIReserved

const TUint KSIReserved =0xFFFC0000
API status
Internal technology API.

Definition at line 544 of file es_sock.h.

◆ KSIStreamBased

const TUint KSIStreamBased =0x00000010

The protocol is stream based.

Definition at line 508 of file es_sock.h.

◆ KSIUrgentData

const TUint KSIUrgentData =0x00000040

The protocol offers an expedited data service.

Definition at line 512 of file es_sock.h.

◆ KSIWriteOnly

const TUint KSIWriteOnly =0x00001000

The protocol is write only.

Definition at line 524 of file es_sock.h.

◆ KSOBlockingIO

const TUint KSOBlockingIO =5

Socket blocking mode.

To set, no values are required. For getting, values are:

(TInt)0. Disabled

(TInt)1. Enabled

Definition at line 362 of file es_sock.h.

◆ KSockDatagram

const TUint KSockDatagram =2

Datagram socket.

Definition at line 293 of file es_sock.h.

◆ KSocketBufSizeUndefined

const TInt KSocketBufSizeUndefined =0

Use default buffer size.

Definition at line 405 of file es_sock.h.

◆ KSocketDefaultBufferSize

const TInt KSocketDefaultBufferSize =4096

Default buffer size.

Definition at line 407 of file es_sock.h.

◆ KSocketInternalOptionBit

const TUint KSocketInternalOptionBit =0x80000000

Definition at line 410 of file es_sock.h.

◆ KSocketInternalReadBit

const TUint KSocketInternalReadBit =0x80000000

Must not be set for client requests.

Definition at line 466 of file es_sock.h.

◆ KSocketInternalWriteBit

const TUint KSocketInternalWriteBit =0x80000000

Must not be set for client requests.

Definition at line 451 of file es_sock.h.

◆ KSocketMessageSizeIsStream

const TInt KSocketMessageSizeIsStream =0

Reads and writes can be of any size: the data is treated as a stream.

API status
Published to all clients. Released API.

Definition at line 614 of file es_sock.h.

◆ KSocketMessageSizeNoLimit

const TInt KSocketMessageSizeNoLimit =-1

Data is packet-oriented but packets can be of any size (i.e.

the remote end must specify a Read of the same size as your Write, but there is no limit on this size.)

Definition at line 620 of file es_sock.h.

◆ KSocketMessageSizeUndefined

const TInt KSocketMessageSizeUndefined =1

Depends on lower layer or is dynamic.

Definition at line 616 of file es_sock.h.

◆ KSocketNoSecurity

const TUint KSocketNoSecurity =0x00000000

No security.

API status
Published to all clients. Released API.

Definition at line 599 of file es_sock.h.

◆ KSockRaw

const TUint KSockRaw =4

Raw socket.

Definition at line 297 of file es_sock.h.

◆ KSockReadContinuation

const TUint KSockReadContinuation = 0x01000000

Read from datagram in a stream-like fashion (not discarding tails).

Definition at line 468 of file es_sock.h.

◆ KSockReadPeek

const TUint KSockReadPeek =0x00000001

Read data without consuming it, data remains in the receive queue.

KSockReadPeek may only be provided as a flag to Recv() if the protocol's information flag is marked with KSIPeekData, otherwise Recv() will return with KErrNotSupported.

API status
Published to all clients. Released API.

Definition at line 464 of file es_sock.h.

◆ KSockSelectExcept

const TUint KSockSelectExcept =0x00000004

An error has occurred.

Definition at line 436 of file es_sock.h.

◆ KSockSelectRead

const TUint KSockSelectRead =0x00000001

Data is available to be read; for listening sockets, a connect is pending.

API status
Published to all clients. Released API.

Definition at line 432 of file es_sock.h.

◆ KSockSelectReadContinuation

const TUint KSockSelectReadContinuation = 0x01000000

Include tail of prior read datagram as available data (ie indicates next read will be with read continuation)

Definition at line 438 of file es_sock.h.

◆ KSockSelectWrite

const TUint KSockSelectWrite =0x00000002

Writing to the socket is not currently blocked by flow-control.

Definition at line 434 of file es_sock.h.

◆ KSockSeqPacket

const TUint KSockSeqPacket =3

Datagrams with sequence numbers.

Definition at line 295 of file es_sock.h.

◆ KSockStream

const TUint KSockStream =1

Stream socket.

API status
Published to all clients. Released API.

Definition at line 291 of file es_sock.h.

◆ KSockWriteSystemMask

const TUint KSockWriteSystemMask =0xFF000000

The top 8 bits are reserved for system purposes; protocols must not define these bits.

Definition at line 453 of file es_sock.h.

◆ KSockWriteUrgent

const TUint KSockWriteUrgent =0x00000001

The data to be sent is urgent and is given a higher priority than ordinary data in the send queue.

KSockWriteUrgent may only be provided as a flag to Send() if the protocol's information flag is marked with KSIUrgentData, otherwise Send() will return with KErrNotSupported. AKA: Out of band or unit data.

API status
Published to all clients. Released API.

Definition at line 449 of file es_sock.h.

◆ KSODebug

const TUint KSODebug =1

Debugging enabled or disabled .

Values are:

(TInt)0. Disabled

(TInt)1. Enabled

API status
Published to all clients. Released API.

Definition at line 337 of file es_sock.h.

◆ KSODisableTransfer

const TUint KSODisableTransfer = 11

Setting only.

Disables a socket's possibility to be transferred. No option required.

API status
Published to all clients. Released API.

Definition at line 400 of file es_sock.h.

◆ KSOEnableTransfer

const TUint KSOEnableTransfer = 10

Setting only.

Enables socket to be transferred to the process with given capabilities. The capabilities set should be supplied as TPckgBuf<TSecurityPolicy>. Each RSocket::Transfer() call must be enabled by setting this option.

API status
Published to all clients. Released API.

Definition at line 391 of file es_sock.h.

◆ KSOLSocket

const TInt KSOLSocket =1

Generic socket options/commands.

API status
Published to all clients. Released API.

Definition at line 308 of file es_sock.h.

◆ KSONonBlockingIO

const TUint KSONonBlockingIO =4

Socket nonblocking mode.

To set, no option values are required. For getting, values are:

(TInt)0. Disabled

(TInt)1. Enabled

Definition at line 356 of file es_sock.h.

◆ KSOReadBytesPending

const TUint KSOReadBytesPending =7

Getting only: retrieve the number of bytes currently available for reading.

Value is a TInt.

Definition at line 369 of file es_sock.h.

◆ KSORecvBuf

const TUint KSORecvBuf =2

Socket receive buffer size.

Values are:

KSocketBufSizeUndefined

1 to KMaxTUint: explicit buffer size, supplied as a TPckgBuf<TUint>

Definition at line 343 of file es_sock.h.

◆ KSOSelectLastError

const TUint KSOSelectLastError =9

Getting only: retrieves the last error.

Errors are normally reported by the called method and behaviour is protocol dependent. KSOSelectLastError does not return such errors. Value is a TInt.

Definition at line 379 of file es_sock.h.

◆ KSOSelectPoll

const TUint KSOSelectPoll =6

Getting only: gets a bitmask of flags describing the read/write/exception status of the socket.

Value is a TInt containing a bitmask of socket status (KSockSelectExcept etc.) constants.

Definition at line 366 of file es_sock.h.

◆ KSOSendBuf

const TUint KSOSendBuf =3

Socket send buffer size.

Values are:

KSocketBufSizeUndefined

1 to KMaxTUint: explicit buffer size, supplied as a TPckgBuf<TUint>

Definition at line 349 of file es_sock.h.

◆ KSOUrgentDataOffset

const TUint KSOUrgentDataOffset =8

Getting only: retrieve the urgent data offset (only for stream protocols that support urgent data).

Value is a TInt.

Definition at line 373 of file es_sock.h.

◆ KSubConAuthorisationFamily

const TUint32 KSubConAuthorisationFamily = 2

Definition at line 1367 of file es_sock.h.

◆ KSubConGlobalFamily

const TUint32 KSubConGlobalFamily = 0

Definition at line 1365 of file es_sock.h.

◆ KSubConIPAddressInfoFamily

const TUint32 KSubConIPAddressInfoFamily = 5

Definition at line 1371 of file es_sock.h.

◆ KSubConnCallDescrParamsFamily

const TUint32 KSubConnCallDescrParamsFamily = 3

Definition at line 1368 of file es_sock.h.

◆ KSubConnContextDescrParamsFamily

const TUint32 KSubConnContextDescrParamsFamily = 4

Definition at line 1369 of file es_sock.h.

◆ KSubConnEventInterfaceUid

const TInt32 KSubConnEventInterfaceUid = 0x10204305

Definition at line 1360 of file es_sock.h.

◆ KSubConnGenericEventsImplUid

const TInt32 KSubConnGenericEventsImplUid = 0x10204306

Definition at line 1363 of file es_sock.h.

◆ KSubConnGenericParamsImplUid

const TInt32 KSubConnGenericParamsImplUid = 0x10204304

Definition at line 1362 of file es_sock.h.

◆ KSubConnParamsInterfaceUid

const TInt32 KSubConnParamsInterfaceUid = 0x10204303

Definition at line 1359 of file es_sock.h.

◆ KSubConQoSFamily

const TUint32 KSubConQoSFamily = 1

Definition at line 1366 of file es_sock.h.

◆ KUndefinedAddressFamily

const TUint KUndefinedAddressFamily = 0

Undefined address family.

API status
Published to platform partners. Released API.

Definition at line 646 of file es_sock.h.

◆ KUndefinedProtocol

const TUint KUndefinedProtocol =0xFFFFFFFE

Undefined socket type.

Undefined Protocol

API status
Released API.

Definition at line 638 of file es_sock.h.

◆ KUndefinedSockType

const TUint KUndefinedSockType =0xFFFFFFFF

Undefined socket type.

API status
Published to all clients. Released API.

Definition at line 629 of file es_sock.h.

◆ KUseEmbeddedUniqueId

const TUint KUseEmbeddedUniqueId = 0

Definition at line 132 of file es_sock.h.