Changes between Initial Version and Version 1 of dict_legacy_xml.fdx

Timestamp:

Dec 21, 2010, 3:15:17 PM (13 years ago)

Author:

Sebastien Decugis

Comment:

--

dict_legacy_xml.fdx

@@ +1 @@
+[[PageOutline(2-4)]]
+== Legacy XML dictionary files ==
+
+This {{{dict_legacy_xml.fdx}}} extension provides an easy way to define new objects in the dictionary, although this mechanism is both less powerful and less efficient than the native C definitions format, which should be preferred when possible.
+
+The original intent is to provide support for existing dictionary files coming from the OpenDiameter implementation. However, these files will probably not be re-usable "as-is" without a few modifications. The XML format expected by the extension is detailed in the remaining of this page.
+
+
+=== Configuration ===
+
+{{{dict_legacy_xml.fdx}}} configuration file is mandatory. The complete configuration documentation can be found in the source package: [source:freeDiameter/doc/dict_legacy_xml.conf.sample dict_legacy_xml.conf.sample].
+
+The configuration consists in a simple list of XML files that must be loaded. Each XML file that is referrenced from the configuration will be parsed and the definitions added to the global dictionary and usable from other extensions. Beware that conflicts are not allowed (for example two AVPs defined with the same code and flags but different names).
+
+
+=== Usage ===
+
+The DTD for XML format is provided for information here: [source:freeDiameter/contrib/dict_legacy/dictionary.dtd dictionary.dtd].
+
+Here is a complete example that defines the same objects as the [wiki:test_app.fdx] application:
+{{{
+#!xml
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE dictionary SYSTEM "dictionary.dtd">
+
+<dictionary>
+
+  <vendor id="999999" name="app_test vendor" />
+
+  <application id="16777215" name="app_test application" 
+               uri="http://www.freediameter.net">
+
+    <avp name="Test-AVP" code="16777215" vendor-id="999999" mandatory="must">
+      <type type-name="Integer32" />
+    </avp>
+
+    <command name="Test" code="16777214" pbit="1">
+      <requestrules>
+        <fixedrules>
+          <avprule name="Session-Id" minimum="1" maximum="1" />
+        </fixedrules>
+        <requiredrules>
+          <avprule name="Destination-Realm" minimum="1" maximum="1" />
+          <avprule name="Origin-Host" minimum="1" maximum="1" />
+          <avprule name="Origin-Realm" minimum="1" maximum="1" />
+          <avprule name="Test-AVP" minimum="1" maximum="1" />
+        </requiredrules>
+        <optionalrules>
+           <avprule name="Destination-Host" minimum="1" maximum="1" />
+       </optionalrules>
+      </requestrules>
+
+      <answerrules>
+        <fixedrules>
+          <avprule name="Session-Id" minimum="1" maximum="1" />
+        </fixedrules>
+        <requiredrules>
+          <avprule name="Result-Code" minimum="1" maximum="1" />
+          <avprule name="Origin-Host" minimum="1" maximum="1" />
+          <avprule name="Origin-Realm" minimum="1" maximum="1" />
+          <avprule name="Test-AVP" minimum="1" maximum="1" />
+        </requiredrules>
+      </answerrules>
+    </command>
+
+  </application>
+
+</dictionary>
+}}}
+
+=== Output ===
+
+This application does not produce any particular output, except for entries in the dictionary.
+
+=== Troubleshooting ===
+
+
+
+
+