diff -r a3ac912f2857 -r b63f281afe6b opensips/modules/enum/doc/enum_admin.xml
--- a/opensips/modules/enum/doc/enum_admin.xml Mon Jan 18 19:47:23 2010 +0100
+++ b/opensips/modules/enum/doc/enum_admin.xml Mon Jan 18 19:59:51 2010 +0100
@@ -75,6 +75,24 @@
and -1 if not.
+ In addition to standard ENUM, support for ISN (ITAD Subscriber
+ Numbers) is provided as well. To allow ISN lookups to resolve,
+ a different formatting algorithm is expected by the DNS server.
+ Whereas a ENUM NAPTR record expects a DNS query of the form
+ 9.8.7.6.5.4.3.2.1., ISN method expects a DNS query of
+ the form 6.5.1212.. That is, a valid ISN number includes
+ a prefix of '56' in the example. The rest of the number is a
+ ITAD (Internet Telephony Administrative Domain) as defined
+ in RFCs 3872 and 2871, and as allocated by the IANA in
+ http://www.iana.org/assignments/trip-parameters. The ITAD is
+ left intact and not refersed as ENUM requires. To learn more
+ about ISN please refer to documents at www.freenum.org.
+
+
+ To complete a ISN lookup on the user part of the Request-URI,
+ isn_query() is used instead of enum_query().
+
+
Enum module also implements is_from_user_enum function.
This function does an enum lookup on the from user and
returns true if found, false otherwise.
@@ -153,6 +171,22 @@
+ isn_suffix (string)
+
+ The domain suffix to be used for isn_query() lookups. Can
+ be overridden by a parameter to isn_query.
+
+
+ Default value is freenum.org.
+
+
+ Setting isn_suffix module parameter
+
+modparam("enum", "isn_suffix", "freenum.org.")
+
+
+
+
branchlabel (string)
This parameter determines which label i_enum_query() will use
@@ -162,7 +196,7 @@
Default value is "i"
- Setting brachlabel module parameter
+ Setting branchlabel module parameter
modparam("enum", "branchlabel", "i")
@@ -353,6 +387,53 @@
+
+ isn_query(["suffix"[,"service"]])
+
+
+ The function performs a ISN query and rewrites the Request-URI with
+ the result of the query. See for more
+ information.
+
+ Meaning of the parameters is as follows:
+
+
+ suffix - Suffix to be appended to the
+ domain name.
+
+
+
+ service - Service string to be used in
+ the service field.
+
+
+
+
+ This function can be used from REQUEST_ROUTE.
+
+
+ See ftp://www.ietf.org/rfc/rfc3872.txt and
+ ftp://www.ietf.org/rfc/rfc2871.txt for information
+ regarding the ITAD part of the ISN string.
+
+
+ isn_query usage
+
+...
+# search for "e2u+sip" in freenum.org
+isn_query("freenum.org.");
+...
+# search for "e2u+sip" in default tree (configured as parameter)
+isn_query();
+...
+# search for "e2u+voice:sip" in freenum.org
+isn_query("freenum.org.","voice");
+...
+
+
+
+
+
is_from_user_enum()
Checks if the user part of from URI