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 @@
+ <varname>isn_suffix</varname> (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.") + + +
+
<varname>branchlabel</varname> (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 @@
+ + <function moreinfo="none">isn_query(["suffix"[,"service"]])</function> + + + 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. + + + <function moreinfo="none">isn_query</function> 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"); +... + + +
+ +
<function moreinfo="none">is_from_user_enum()</function> Checks if the user part of from URI