This class is a factory for starting off asynchronous reads on a UDP socket. More...

#include <POSIX_Asynch_IO.h>

Inheritance diagram for ACE_POSIX_Asynch_Read_Dgram:

[legend]

Collaboration diagram for ACE_POSIX_Asynch_Read_Dgram:

[legend]

Public Member Functions
	ACE_POSIX_Asynch_Read_Dgram (ACE_POSIX_Proactor *posix_proactor)
	Constructor.

virtual	~ACE_POSIX_Asynch_Read_Dgram ()

virtual ssize_t	recv (ACE_Message_Block message_block, size_t &number_of_bytes_recvd, int flags, int protocol_family, const void act, int priority, int signal_number)

Public Member Functions inherited from ACE_Asynch_Read_Dgram_Impl
virtual	~ACE_Asynch_Read_Dgram_Impl ()

Public Member Functions inherited from ACE_Asynch_Operation_Impl
virtual	~ACE_Asynch_Operation_Impl ()

Public Member Functions inherited from ACE_POSIX_Asynch_Operation
int	open (const ACE_Handler::Proxy_Ptr &handler_proxy, ACE_HANDLE handle, const void completion_key, ACE_Proactor proactor=0)

int	cancel ()
	Check the documentation for ACE_Asynch_Operation::cancel.

ACE_Proactor *	proactor () const
	Return the underlying proactor.

ACE_POSIX_Proactor *	posix_proactor () const
	Return the underlying Proactor implementation.

Protected Member Functions
	ACE_POSIX_Asynch_Read_Dgram ()
	Do-nothing constructor.

Protected Member Functions inherited from ACE_Asynch_Read_Dgram_Impl
	ACE_Asynch_Read_Dgram_Impl ()
	Do-nothing constructor.

Protected Member Functions inherited from ACE_Asynch_Operation_Impl
	ACE_Asynch_Operation_Impl ()
	Do-nothing constructor.

Protected Member Functions inherited from ACE_POSIX_Asynch_Operation
	ACE_POSIX_Asynch_Operation (ACE_POSIX_Proactor *posix_proactor)
	Constructor.

virtual	~ACE_POSIX_Asynch_Operation ()
	Destructor.

Additional Inherited Members
Protected Attributes inherited from ACE_POSIX_Asynch_Operation
ACE_POSIX_Proactor *	posix_proactor_

ACE_Proactor *	proactor_
	Proactor that this Asynch IO will be registered with.

ACE_Handler::Proxy_Ptr	handler_proxy_
	Handler that will receive the callback.

ACE_HANDLE	handle_
	I/O handle used for reading.

Detailed Description

This class is a factory for starting off asynchronous reads on a UDP socket.

Once <open> is called, multiple asynchronous <read>s can be started using this class. An ACE_Asynch_Read_Dgram::Result will be passed back to the <handler> when the asynchronous reads completes through the <ACE_Handler::handle_read_stream> callback.

Constructor & Destructor Documentation

◆ ACE_POSIX_Asynch_Read_Dgram() [1/2]

ACE_POSIX_Asynch_Read_Dgram::ACE_POSIX_Asynch_Read_Dgram ( ACE_POSIX_Proactor * posix_proactor )

Constructor.

◆ ~ACE_POSIX_Asynch_Read_Dgram()

ACE_POSIX_Asynch_Read_Dgram::~ACE_POSIX_Asynch_Read_Dgram ( )

virtual

◆ ACE_POSIX_Asynch_Read_Dgram() [2/2]

ACE_POSIX_Asynch_Read_Dgram::ACE_POSIX_Asynch_Read_Dgram ( )

protected

Do-nothing constructor.

Member Function Documentation

◆ recv()

ssize_t ACE_POSIX_Asynch_Read_Dgram::recv	(	ACE_Message_Block *	message_block,
		size_t &	number_of_bytes_recvd,
		int	flags,
		int	protocol_family,
		const void *	act,
		int	priority,
		int	signal_number )

virtual

This method queues an asynchronous read. Up to message_block->total_size() bytes will be read and stored in the message_block beginning at its write pointer. The message_block write pointer will be updated to reflect any added bytes if the read operation is successful completed. Priority of the operation is specified by priority. On POSIX4-Unix, this is supported. Works like <nice> in Unix. Negative values are not allowed. 0 means priority of the operation same as the process priority. 1 means priority of the operation is one less than process. signal_number argument is a no-op on non-POSIX4 systems.

Note: Unlike the Windows version of this facility, no indication of immediate success can be returned, and number_of_bytes_read is never used.

flags Not used.
protocol_family Not used.
Return values

0 The IO will complete asynchronously.

-1 There was an error; see errno to get the error code.

Implements ACE_Asynch_Read_Dgram_Impl.

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

0	The IO will complete asynchronously.
-1	There was an error; see `errno` to get the error code.

Public Member Functions

Protected Member Functions