%ents; ]>
20112012 Ericsson AB. All Rights Reserved. The contents of this file are subject to the Erlang Public License, Version 1.1, (the "License"); you may not use this file except in compliance with the License. You should have received a copy of the Erlang Public License along with this software. If not, it can be retrieved online at http://www.erlang.org/. Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License. diameter_sctp(3) Anders Svensson diameter_sctp.xml
diameter_sctp Diameter transport over SCTP.

This module implements diameter transport over SCTP using gen_sctp. It can be specified as the value of a transport_module option to &mod_add_transport; and implements the behaviour documented in &man_transport;.

start({Type, Ref}, Svc, [Opt]) -> {ok, Pid, [LAddr]} | {error, Reason} Start a transport process. Type = connect | accept Ref = &mod_transport_ref; Svc = #diameter_service{} Opt = {raddr, inet:ip_address()} | {rport, integer()} | term() Pid = pid() LAddr = inet:ip_address() Reason = term()

The start function required by &man_transport;.

The only diameter_sctp-specific argument is the options list. Options raddr and rport specify the remote address and port for a connecting transport and not valid for a listening transport: the former is required while latter defaults to 3868 if unspecified. More than one raddr option can be specified, in which case the connecting transport in question attempts each in sequence until an association is established. Remaining options are any accepted by gen_sctp:open/1, with the exception of options mode, binary, list, active and sctp_events. Note that options ip and port specify the local address 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 particular, one of these must be specified.) Option port defaults to 3868 for a listening transport and 0 for a connecting transport.

An insufficiently large receive buffer may result in a peer having to resend incoming messages: set the inet(3) option recbuf to increase the buffer size.

An insufficiently large send buffer may result in outgoing messages being discarded: set the inet(3) option sndbuf to increase 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.

SEE ALSO

&man_main;, &man_transport;, gen_sctp(3), inet(3)