1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
%%
%% %CopyrightBegin%
%%
%% Copyright Ericsson AB 2010-2013. 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.
%%
%% %CopyrightEnd%
%%
-ifndef(diameter_hrl).
-define(diameter_hrl, true).
%% RFC 3588, 2.4:
-define(DIAMETER_APP_ID_COMMON, 0).
-define(DIAMETER_APP_ID_ACCOUNTING, 3).
-define(DIAMETER_APP_ID_RELAY, 16#FFFFFFFF).
%% Corresponding dictionaries. These macros are deprecated now that
%% there is an RFC6733 whose dictionaries are not strictly backwards
%% compatible. The RFC 6733 common and accounting dictionaries are
%% diameter_gen_base_rfc6733 and diameter_gen_acct_rfc6733
%% respectively.
-define(DIAMETER_DICT_COMMON, diameter_gen_base_rfc3588).
-define(DIAMETER_DICT_ACCOUNTING, diameter_gen_base_accounting).
-define(DIAMETER_DICT_RELAY, diameter_gen_relay).
%% Events sent to processes that have subscribed with
%% diameter:subscribe/1.
%%
-record(diameter_event,
{service, %% name
info}). %% tuple()
%% diameter_packet records are passed through the encode/decode
%% interface supplied by a dictionary module configured on a Diameter
%% application. For an incoming message the bin field contains the
%% received binary and the header, avps, msg and errors fields the
%% result of decoding.
-record(diameter_packet,
{header, %% #diameter_header{}
avps, %% deep list() of #diameter_avp{}
msg, %% fully decoded message
bin, %% binary received/sent over the wire
errors = [],%% list() of Result-Code | {Result-Code, #diameter_avp{}}
transport_data}).
-record(diameter_header,
{version, %% 8-bit unsigned
length, %% 24-bit unsigned
cmd_code, %% 8-bit unsigned
application_id, %% 24-bit unsigned
hop_by_hop_id, %% 32-bit unsigned
end_to_end_id, %% 32-bit unsigned
is_request, %% boolean() R flag
is_proxiable, %% boolean() P flag
is_error, %% boolean() E flag
is_retransmitted}). %% boolean() T flag
-record(diameter_avp,
{code, %% 32-bit unsigned
vendor_id, %% 32-bit unsigned
is_mandatory = false, %% boolean() M flag
need_encryption = false, %% boolean() P flag
data, %% encoded binary()
name, %% atom() AVP name
value, %% decoded term() decoded | undefined
type, %% atom() type name,
index}). %% non_neg_integer() | undefined
%% A diameter_caps record corresponds to capabilities configuration on
%% diameter:start_service/2. In application callbacks is identifies
%% the peer connection for which the callback is taking place, and in
%% this case each field is a 2-tuple specifying the host (ie. local)
%% and peer (ie. remote) values, host values having been configured
%% and peer values having been received at capabilities exchange.
-record(diameter_caps,
{origin_host, %% 'DiameterIdentity'()
origin_realm, %% 'DiameterIdentity'()
host_ip_address = [], %% ['Address'()]
vendor_id, %% 'Unsigned32'()
product_name, %% 'OctetString'()
origin_state_id = [], %% ['Unsigned32'()]
supported_vendor_id = [], %% ['Unsigned32'()]
auth_application_id = [], %% ['Unsigned32'()]
inband_security_id = [], %% ['Unsigned32'()]
acct_application_id = [], %% ['Unsigned32'()]
vendor_specific_application_id = [], %% ['Grouped'()]
firmware_revision = [], %% ['Unsigned32()]
avp = []}).
%% AVP's of type DiameterURI are encoded as a diameter_uri record.
%% Note that AVP's of type IPFilterRule and QoSFilterRule are currently
%% encoded simply as OctetString's.
-record(diameter_uri,
{type, %% aaa | aaas
fqdn, %% string()
port = 3868, %% non_neg_integer(),
transport = sctp, %% | tcp,
protocol = diameter}). %% | radius | 'tacacs+'
%% A diameter_callback record can be specified as an application
%% module in order to selectively receive callbacks or alter their
%% form.
-record(diameter_callback,
{peer_up,
peer_down,
pick_peer,
prepare_request,
prepare_retransmit,
handle_request,
handle_answer,
handle_error,
default,
extra = []}).
%% The diameter service and diameter_apps records are only passed
%% through the transport interface when starting a transport process,
%% although typically a transport implementation will (and probably
%% should) only be interested host_ip_address.
-record(diameter_service,
{pid,
capabilities, %% #diameter_caps{}
applications = []}). %% [#diameter_app{}]
-record(diameter_app,
{alias, %% option 'alias'
dictionary, %% option 'dictionary', module()
module, %% [Mod | Args] callback module() and extra args
init_state, %% option 'state', initial callback state
id, %% 32-bit unsigned application identifier = Dict:id()
mutable = false, %% boolean(), do traffic callbacks modify state?
options = [{answer_errors, report}, %% | callback | discard
{request_errors, answer_3xxx}]}). %% | callback
-endif. %% -ifdef(diameter_hrl).
|
