From 401b81d9cf9667283cabea8d1d9b5926d9d77a9c Mon Sep 17 00:00:00 2001 From: Arnaud Maillet Date: Fri, 22 May 2009 16:02:00 +0200 Subject: Rename OfferStreamTube and AcceptStreamTube to Offer and Accept --- extensions/Channel_Type_Stream_Tube.xml | 92 ++++++++++++++++++++++++++------- 1 file changed, 74 insertions(+), 18 deletions(-) (limited to 'extensions') diff --git a/extensions/Channel_Type_Stream_Tube.xml b/extensions/Channel_Type_Stream_Tube.xml index 060cd0bb..eed8faf2 100644 --- a/extensions/Channel_Type_Stream_Tube.xml +++ b/extensions/Channel_Type_Stream_Tube.xml @@ -27,9 +27,9 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

When offering a stream tube, the initiating client creates a local listening socket and offers it to the recipient client using the - OfferStreamTube method. When a + Offer method. When a recipient accepts a stream tube using the - AcceptStreamTube method, the + Accept method, the recipient's connection manager creates a new local listening socket. Each time the recipient's client connects to this socket, the initiator's connection manager proxies this connection to the @@ -37,7 +37,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - + Offer a stream tube exporting the local socket specified. @@ -60,12 +60,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. when it connects. - - - A parameter for the access control type, to be interpreted as - specified in the documentation for the Socket_Access_Control enum. - - @@ -91,7 +85,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - + Accept a stream tube that's in the "local pending" state. The connection manager will attempt to open the tube. The tube remains in @@ -104,9 +98,14 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - - The type of access control the connection manager should apply to - the socket. + +

The type of access control the connection manager should apply to + the socket.

+ +

Note that if you plan to establish more than one connection + through the tube, the Socket_Access_Control_Port access control + can't be used as you can't connect more than once from the same + port.

@@ -137,17 +136,74 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. - + - Emitted on a stream tube when a participant opens a new connection - to its socket. + Emitted each time a participant opens a new connection to its socket. - + The handle of the participant who opened the new connection + + +

A parameter which can be used by the listening process to identify + the connection. Note that this parameter has a meaningful value + only in the Socket_Access_Control_Port and + Socket_Access_Control_Credentials cases. If a different + Socket_Access_Control has been choosed when offering the tube, this + parameter should be ignored.

+ +

In the Socket_Access_Control_Port case, the variant + contains a struct Socket_Address_IPv4 (or Socket_Address_IPv6) + containing the address from which the CM is connected to the client + application.

+ +

In the Socket_Access_Control_Credentials case, the variant + contains the byte (D-Bus signature 'y') that has been sent with + the credentials.

+ + + + + The unique ID associated with this connection. This ID will be used + to identifiy the connection when reporting errors with + ConnectionClosed. + + + + + + +

Emitted when the tube application connects to CM's socket.

+ + + + The unique ID associated with this connection. This ID will be used + to identifiy the connection when reporting errors with + ConnectionClosed. + + + + + + +

Emitted when a connection has been closed.

+ + + + The ID of the connection. + + + + + The name of a D-Bus error describing the error that occurred. + +