From ed6395a69435354c9d3d5accbd3adbfc45d5becf Mon Sep 17 00:00:00 2001 From: Anders Svensson Date: Thu, 23 Jan 2014 09:20:46 +0100 Subject: Change interface for communicating outbound stream id to diameter_sctp The module uses the transport_data field of record diameter_packet to communicate the stream on which the an incoming message is received and on which an outgoing message should be sent, the previous interface being that both are communicated as a tuple of the form {stream, Id}. However, since diameter retains the value of an incoming request's transport_data unless the corresponding answer message specifies otherwise, the behaviour in this case is to send an answer on the outbound stream with the same identifier as the that of the inbound stream on which the request was received. If the inbound stream id is greater than or equal to the number of outbound streams then this is guaranteed to fail, causing the transport process in question to terminate. There is no relationship between inbound and outbound stream identifiers so diameter_sctp's imposition of one is simply wrong. Outbound stream ids are now communicated with a different tuple: {outstream, Id}, interpreted modulo the number of outbound streams. Thus, retention of an inbound request's transport_data has no effect on the selection of an outbound stream. The change in interface is not strictly backwards compatible because of the new atom for the outbound stream. However, as there is currently no documented way of obtaining the available number of outbound streams for a peer connection, there is no way for a client to have known the range of ids from which it could reliably have chosen with the previous interface, so any setting of the outbound stream has probably been unintentional. Not explicitly specifying an outbound stream now results in a round-robin selection. --- lib/diameter/doc/src/diameter_sctp.xml | 36 ++++++++++++++-------------------- 1 file changed, 15 insertions(+), 21 deletions(-) (limited to 'lib/diameter/doc/src') diff --git a/lib/diameter/doc/src/diameter_sctp.xml b/lib/diameter/doc/src/diameter_sctp.xml index 2be77e3dfd..021770b63a 100644 --- a/lib/diameter/doc/src/diameter_sctp.xml +++ b/lib/diameter/doc/src/diameter_sctp.xml @@ -15,7 +15,8 @@
-20112013 +2011 +2014 Ericsson AB. All Rights Reserved. @@ -113,7 +114,7 @@ and port respectively.

Multiple ip options can be specified for a multihomed peer. If none are specified then the values of Host-IP-Address -in the #diameter_service{} record are used. +in the diameter_service record are used. (In particular, one of these must be specified.) Option port defaults to 3868 for a listening transport and 0 for a connecting transport.

@@ -131,25 +132,18 @@ the buffer size.

-diameter_sctp uses the transport_data field of -the #diameter_packet{} record to communicate the stream on which an -inbound message has been received, or on which an outbound message -should be sent: the value will be of the form {stream, Id} -on an inbound message passed to a &app_handle_request; or -&app_handle_answer; callback. -For an outbound message, either undefined (explicitly or -by receiving the outbound message as a binary()) or a tuple -should be set in the return value of &app_handle_request; -(typically by retaining the value passed into this function) -or &app_prepare_request;. -The value undefined uses a "next outbound stream" id and -increments this modulo the total number outbound streams. -That is, successive values of undefined cycle through all -outbound streams.

- - - - +The transport_data field of record diameter_packet +is used to communicate the stream on which an inbound message +has been received, or on which an outbound message should be sent. +The value will be of the form {stream, Id} for an inbound +message passed to a &app_handle_request; or &app_handle_answer; +callback. +For an outbound message, {outstream, Id} in the return value of +&app_handle_request; or &app_prepare_retransmit; sets the outbound +stream, the stream id being interpreted modulo the number of outbound +streams. +Any other value, or not setting a value, causes successive such sends +to cycle though all outbound streams.

-- cgit v1.2.3