Socket stream functions are used for socket stream operations. More...

Functions
EXTERNRT int	rtxStreamSocketAttach (OSCTXT *pctxt, OSRTSOCKET socket, OSUINT16 flags)
	Attaches the existing socket handle to the stream. More...

EXTERNRT int	rtxStreamSocketClose (OSCTXT *pctxt)
	This function closes a socket stream. More...

EXTERNRT int	rtxStreamSocketCreateWriter (OSCTXT pctxt, const char host, int port)
	This function opens a socket stream for writing. More...

EXTERNRT int	rtxStreamSocketSetOwnership (OSCTXT *pctxt, OSBOOL ownSocket)
	This function transfers ownership of the socket to or from the stream instance. More...

EXTERNRT int	rtxStreamSocketSetReadTimeout (OSCTXT *pctxt, OSUINT32 nsecs)
	This function sets the read timeout value to the given number of seconds. More...

Detailed Description

Socket stream functions are used for socket stream operations.

Function Documentation

EXTERNRT int rtxStreamSocketAttach	(	OSCTXT *	pctxt,
		OSRTSOCKET	socket,
		OSUINT16	flags
	)

Attaches the existing socket handle to the stream.

The socket should be already opened and connected. The 'flags' parameter specifies the access mode for the stream - input or output.

Parameters

pctxt	Pointer to a context structure variable that has been initialized for stream operations.
socket	The socket handle created by `rtxSocketCreate`.
flags	Specifies the access mode for the stream: OSRTSTRMF_INPUT = input (reading) stream; OSRTSTRMF_OUTPUT = output (writing) stream.

Returns: Completion status of operation: 0 = success, negative return value is error.

EXTERNRT int rtxStreamSocketClose ( OSCTXT * pctxt )

This function closes a socket stream.

Parameters

pctxt Pointer to a context structure variable that has been initialized for stream operations.

Returns: Completion status of operation: 0 = success, negative return value is error.

EXTERNRT int rtxStreamSocketCreateWriter	(	OSCTXT *	pctxt,
		const char *	host,
		int	port
	)

This function opens a socket stream for writing.

Parameters

pctxt	Pointer to a context structure variable that has been initialized for stream operations.
host	Name of host or IP address to which to connect.
port	Port number to which to connect.

Returns: Completion status of operation: 0 = success, negative return value is error.

EXTERNRT int rtxStreamSocketSetOwnership	(	OSCTXT *	pctxt,
		OSBOOL	ownSocket
	)

This function transfers ownership of the socket to or from the stream instance.

The socket will be closed and deleted when the stream is closed or goes out of scope. By default stream socket owns the socket.

Parameters

pctxt	Pointer to a context structure variable that has been initialized for stream operations.
ownSocket	Boolean value.

Returns: Completion status of operation: 0 = success, negative return value is error.

EXTERNRT int rtxStreamSocketSetReadTimeout	(	OSCTXT *	pctxt,
		OSUINT32	nsecs
	)

This function sets the read timeout value to the given number of seconds.

Any read operation attempted on the stream will timeout after this period of time if no data is received.

Parameters

pctxt	Pointer to a context structure variable that has been initialized for stream operations.
nsecs	Number of seconds to wait before timing out.

Returns: Completion status of operation: 0 = success, negative return value is error.