aboutsummaryrefslogtreecommitdiffstats
path: root/lib/diameter/doc/src/diameter_compile.xml
blob: 5ca8126b836c4a100e5b57f666f77e506a9aa356 (plain) (blame)
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
<?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE comref SYSTEM "comref.dtd" [
  <!ENTITY % ents SYSTEM "diameter.ent" >
  %ents;
]>

<comref>
<header>
<copyright>
<year>2011</year><year>2012</year>
<holder>Ericsson AB. All Rights Reserved.</holder>
</copyright>
<legalnotice>

The program may be used and/or copied only with the written permission 
from Ericsson AB, or in accordance with the terms and conditions 
stipulated in the agreement/contract under which the program has been 
supplied.

</legalnotice>

<title>diameterc(1)</title>

<prepared></prepared>
<docno></docno>
<date></date>
<rev></rev>
<file>diameter_compile.xml</file>
</header>

<com>diameterc</com>
<comsummary><![CDATA[diameterc [<options>] <file>]]></comsummary>

<description>

<p>
The diameterc utility is used to compile diameter
<seealso marker="diameter_dict">dictionary files</seealso>
into Erlang source.
The resulting source implements the interface diameter requires
to encode and decode the dictionary's messages and AVP's.</p>

</description>

<section>
<title>USAGE</title>

<taglist>

<tag><![CDATA[diameterc [<options>] <file>]]></tag>
<item>
<p>
Compiles a single dictionary file. Valid options are as follows.</p>

<!-- Leave -h/d/v undocumented, except for the usage message from the
     utility itself. -->

<taglist>
<tag><![CDATA[-o <dir>]]></tag>
<item>
<p>
Specifies the directory into which the generated source should be written.
Defaults to the current working directory.</p>
</item>

<tag><![CDATA[-i <dir>]]></tag>
<item>
<p>
Specifies a directory to add to the code path.
Use to point at beam files compiled from inherited dictionaries,
<c>@inherits</c> in a dictionary file creating a beam dependency, not
an erl/hrl dependency.</p>

<p>
Multiple <c>-i</c> options can be specified.</p>
</item>

<tag><![CDATA[-E]]></tag>
<tag><![CDATA[-H]]></tag>
<item>
<p>
Supresses erl and hrl generation, respectively.</p>
</item>

<tag><![CDATA[--name <name>]]></tag>
<tag><![CDATA[--prefix <prefix>]]></tag>
<item>
<p>
Set <c>@name</c> and <c>@prefix</c> in the dictionary,
respectively.
Overrides any setting in the file itself.</p>
</item>

<tag><![CDATA[--inherits <dict>]]></tag>
<item>
<p>
Append an <c>@inherits</c> to the dictionary before compiling.
Specifying <c>'-'</c> as the dictionary has the effect of clearing any
previous inherits, causing them to be ignored.</p>

<p>
Multiple <c>--inherits</c> options can be specified.</p>
</item>

</taglist>

</item>
</taglist>

</section>

<!-- ===================================================================== -->

<section>
<title>EXIT STATUS</title>

<p>
Returns 0 on success, non-zero on failure.</p>

</section>

<!-- ===================================================================== -->

<section>
<title>SEE ALSO</title>

<p>
&man_dict;</p>

</section>

</comref>