Defines the methods in the ACE_SPIPE_Stream abstraction. More...

#include <SPIPE_Stream.h>

Inheritance diagram for ACE_SPIPE_Stream:

[legend]

Collaboration diagram for ACE_SPIPE_Stream:

[legend]

Public Types
typedef ACE_SPIPE_Addr	PEER_ADDR

Public Member Functions
	ACE_SPIPE_Stream ()
	Default constructor.

int	get_remote_addr (ACE_SPIPE_Addr &remote_sap) const
	Obtain the address of whom we are connected with.

int	send_handle (ACE_HANDLE handle) const
	Send an open FD to another process.

int	recv_handle (ACE_HANDLE &handle) const
	Recv an open FD from another process.

int	recv_handle (strrecvfd &recvfd) const
	Recv an open FD from another process.

ssize_t	send_n (const void *buf, size_t len) const
	Send len bytes, keep trying until len are sent.

ssize_t	recv_n (void *buf, size_t len) const
	Recv len bytes, keep trying until len are received.

ssize_t	send (const void *buf, size_t len) const
	Send bytes via STREAM pipes using "band" mode.

ssize_t	recv (void *buf, size_t len) const
	Recv bytes via STREAM pipes using "band" mode.

ssize_t	send (const ACE_Str_Buf cntl, const ACE_Str_Buf data, int flags=0) const
	Send cntl and data via STREAM pipes.

ssize_t	recv (ACE_Str_Buf cntl, ACE_Str_Buf data, int *flags) const
	Recv cntl and data via STREAM pipes.

ssize_t	send (const ACE_Str_Buf cntl, const ACE_Str_Buf data, int band, int flags) const
	Send bytes via STREAM pipes using "band" mode.

ssize_t	recv (ACE_Str_Buf cntl, ACE_Str_Buf data, int band, int flags) const
	Recv bytes via STREAM pipes using "band" mode.

ssize_t	send (const iovec iov[], int len) const
	Send iovecs via the OS "gather-write" operation.

ssize_t	recv (iovec iov[], int len) const
	Recv iovecs via the OS "scatter-read" operation.

ssize_t	send (size_t len,...) const

ssize_t	recv (size_t len,...) const

ssize_t	send (const void buf, size_t len, ACE_OVERLAPPED overlapped) const
	Send len bytes via Win32 <WriteFile> using overlapped I/O.

ssize_t	recv (void buf, size_t len, ACE_OVERLAPPED overlapped) const
	Recv len bytes via Win32 <ReadFile> using overlapped I/O.

ssize_t	sendv (const iovec iov[], int len) const
	Send an <iovec> of size len to the stream.

ssize_t	sendv_n (const iovec iov[], int len) const

ssize_t	recvv_n (iovec iov[], int len) const
	Receive an <iovec> of size len from the stream.

void	dump () const
	Dump the state of an object.

Public Member Functions inherited from ACE_SPIPE
int	close ()
	Close down the SPIPE without removing the rendezvous point.

int	remove ()

int	get_local_addr (ACE_SPIPE_Addr &) const
	Return the local address of this endpoint.

int	disable (int signum) const

void	dump () const
	Dump the state of an object.

Public Member Functions inherited from ACE_IPC_SAP
int	control (int cmd, void *) const
	Interface for <ioctl>.

int	enable (int value) const

int	disable (int value) const

ACE_HANDLE	get_handle () const
	Get the underlying handle.

void	set_handle (ACE_HANDLE handle)
	Set the underlying handle.

void	dump () const
	Dump the state of an object.

Public Attributes
	ACE_ALLOC_HOOK_DECLARE
	Declare the dynamic allocation hooks.

Public Attributes inherited from ACE_SPIPE
	ACE_ALLOC_HOOK_DECLARE
	Declare the dynamic allocation hooks.

Public Attributes inherited from ACE_IPC_SAP
	ACE_ALLOC_HOOK_DECLARE
	Declare the dynamic allocation hooks.

Private Attributes
ACE_SPIPE_Addr	remote_addr_

Friends
class	ACE_SPIPE_Acceptor

class	ACE_SPIPE_Connector

Additional Inherited Members
Protected Member Functions inherited from ACE_SPIPE
	ACE_SPIPE ()
	Ensure that this class is an abstract base class.

Protected Member Functions inherited from ACE_IPC_SAP
	ACE_IPC_SAP ()
	Default constructor.

	~ACE_IPC_SAP ()
	Protected destructor.

Protected Attributes inherited from ACE_SPIPE
ACE_SPIPE_Addr	local_addr_
	Our local address.

Detailed Description

Defines the methods in the ACE_SPIPE_Stream abstraction.

buf is the buffer to write from or receive into. len is the number of bytes to transfer.

The "_n()" I/O methods keep looping until all the data has been transferred. These methods also work for sockets in non-blocking mode i.e., they keep looping on EWOULDBLOCK.

The return values for the "*_n()" methods match the return values from the non "_n()" methods and are specified as follows:

The number of bytes transferred is returned.
On error, -1 is returned, errno is set to appropriate error.
On EOF, 0 is returned, errno is irrelevant.

Methods with <iovec> parameter are I/O vector variants of the I/O operations.

The <send> and <revc> operations use "message" semantics rather than "bytestream" semantics.

Member Typedef Documentation

◆ PEER_ADDR

typedef ACE_SPIPE_Addr ACE_SPIPE_Stream::PEER_ADDR

Constructor & Destructor Documentation

◆ ACE_SPIPE_Stream()

ACE_SPIPE_Stream::ACE_SPIPE_Stream ( )

Default constructor.

Member Function Documentation

◆ dump()

void ACE_SPIPE_Stream::dump ( ) const

Dump the state of an object.

◆ get_remote_addr()

int ACE_SPIPE_Stream::get_remote_addr ( ACE_SPIPE_Addr & remote_sap ) const

inline

Obtain the address of whom we are connected with.

◆ recv() [1/6]

ssize_t ACE_SPIPE_Stream::recv	(	ACE_Str_Buf *	cntl,
		ACE_Str_Buf *	data,
		int *	band,
		int *	flags ) const

inline

Recv bytes via STREAM pipes using "band" mode.

◆ recv() [2/6]

ssize_t ACE_SPIPE_Stream::recv	(	ACE_Str_Buf *	cntl,
		ACE_Str_Buf *	data,
		int *	flags ) const

inline

Recv cntl and data via STREAM pipes.

◆ recv() [3/6]

ssize_t ACE_SPIPE_Stream::recv	(	iovec	iov[],
		int	len ) const

inline

Recv iovecs via the OS "scatter-read" operation.

◆ recv() [4/6]

ssize_t ACE_SPIPE_Stream::recv	(	size_t	len,
			... ) const

This is an interface to ::readv, that doesn't use the struct iovec explicitly. The ... can be passed as an arbitrary number of (char ptr, int len) tuples. However, the count N is the *total number of trailing arguments, not a couple of the number of tuple pairs!

◆ recv() [5/6]

ssize_t ACE_SPIPE_Stream::recv	(	void *	buf,
		size_t	len ) const

inline

Recv bytes via STREAM pipes using "band" mode.

◆ recv() [6/6]

ssize_t ACE_SPIPE_Stream::recv	(	void *	buf,
		size_t	len,
		ACE_OVERLAPPED *	overlapped ) const

inline

Recv len bytes via Win32 <ReadFile> using overlapped I/O.

◆ recv_handle() [1/2]

int ACE_SPIPE_Stream::recv_handle ( ACE_HANDLE & handle ) const

inline

Recv an open FD from another process.

◆ recv_handle() [2/2]

int ACE_SPIPE_Stream::recv_handle ( strrecvfd & recvfd ) const

inline

Recv an open FD from another process.

◆ recv_n()

ssize_t ACE_SPIPE_Stream::recv_n	(	void *	buf,
		size_t	len ) const

inline

Recv len bytes, keep trying until len are received.

◆ recvv_n()

ssize_t ACE_SPIPE_Stream::recvv_n	(	iovec	iov[],
		int	len ) const

inline

Receive an <iovec> of size len from the stream.

◆ send() [1/6]

ssize_t ACE_SPIPE_Stream::send	(	const ACE_Str_Buf *	cntl,
		const ACE_Str_Buf *	data,
		int	band,
		int	flags ) const

inline

Send bytes via STREAM pipes using "band" mode.

◆ send() [2/6]

ssize_t ACE_SPIPE_Stream::send	(	const ACE_Str_Buf *	cntl,
		const ACE_Str_Buf *	data,
		int	flags = 0 ) const

inline

Send cntl and data via STREAM pipes.

◆ send() [3/6]

ssize_t ACE_SPIPE_Stream::send	(	const iovec	iov[],
		int	len ) const

inline

Send iovecs via the OS "gather-write" operation.

◆ send() [4/6]

ssize_t ACE_SPIPE_Stream::send	(	const void *	buf,
		size_t	len ) const

inline

Send bytes via STREAM pipes using "band" mode.

◆ send() [5/6]

ssize_t ACE_SPIPE_Stream::send	(	const void *	buf,
		size_t	len,
		ACE_OVERLAPPED *	overlapped ) const

inline

Send len bytes via Win32 <WriteFile> using overlapped I/O.

◆ send() [6/6]

ssize_t ACE_SPIPE_Stream::send	(	size_t	len,
			... ) const

Send N char ptrs and int lengths. Note that the char *'s precede the ints (basically, an varargs version of writev). The count N is the *total number of trailing arguments, not a couple of the number of tuple pairs!

◆ send_handle()

int ACE_SPIPE_Stream::send_handle ( ACE_HANDLE handle ) const

inline

Send an open FD to another process.

◆ send_n()

ssize_t ACE_SPIPE_Stream::send_n	(	const void *	buf,
		size_t	len ) const

inline

Send len bytes, keep trying until len are sent.

◆ sendv()

ssize_t ACE_SPIPE_Stream::sendv	(	const iovec	iov[],
		int	len ) const

inline

Send an <iovec> of size len to the stream.

◆ sendv_n()

ssize_t ACE_SPIPE_Stream::sendv_n	(	const iovec	iov[],
		int	len ) const

inline

Send an <iovec> of size len to the stream. Will block until all bytes are sent or an error occurs.

Friends And Related Symbol Documentation

◆ ACE_SPIPE_Acceptor

friend class ACE_SPIPE_Acceptor

friend

◆ ACE_SPIPE_Connector

friend class ACE_SPIPE_Connector

friend

Member Data Documentation

◆ ACE_ALLOC_HOOK_DECLARE

ACE_SPIPE_Stream::ACE_ALLOC_HOOK_DECLARE

Declare the dynamic allocation hooks.

◆ remote_addr_

ACE_SPIPE_Addr ACE_SPIPE_Stream::remote_addr_

private

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

Public Types

Public Member Functions

Public Attributes

Private Attributes

Friends

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ PEER_ADDR

Constructor & Destructor Documentation

◆ ACE_SPIPE_Stream()

Member Function Documentation

◆ dump()

◆ get_remote_addr()

◆ recv() [1/6]

◆ recv() [2/6]

◆ recv() [3/6]

◆ recv() [4/6]

◆ recv() [5/6]

◆ recv() [6/6]

◆ recv_handle() [1/2]

◆ recv_handle() [2/2]

◆ recv_n()

◆ recvv_n()

◆ send() [1/6]

◆ send() [2/6]

◆ send() [3/6]

◆ send() [4/6]

◆ send() [5/6]

◆ send() [6/6]

◆ send_handle()

◆ send_n()

◆ sendv()

◆ sendv_n()

Friends And Related Symbol Documentation

◆ ACE_SPIPE_Acceptor

◆ ACE_SPIPE_Connector

Member Data Documentation

◆ ACE_ALLOC_HOOK_DECLARE

◆ remote_addr_