Fix escaping and some of the formattting (closes issue #10285)
[asterisk/asterisk.git] / doc / tex / dundi.tex
1 http://www.dundi.com
2 Mark Spencer, Digium, Inc.
3
4 DUNDi is essentially a trusted, peer-to-peer system for being able to
5 call any phone number from the Internet.  DUNDi works by creating a
6 network of nodes called the "DUNDi E.164 Trust Group" which are bound by
7 a common peering agreement known as the General Peering Agreement or
8 GPA.  The GPA legally binds the members of the Trust Group to provide
9 good-faith accurate information to the other nodes on the network, and
10 provides standards by which the community can insure the integrity of
11 the information on the nodes themselves.  Unlike ENUM or similar
12 systems, DUNDi is explicitly designed to preclude any necessity for a
13 single centralized system which could be a source of fees, regulation,
14 etc.
15
16 Much less dramatically, DUNDi can also be used within a private
17 enterprise to share a dialplan efficiently between multiple nodes,
18 without incurring a risk of a single point of failure.  In this way,
19 administrators can locally add extensions which become immediately
20 available to the other nodes in the system.
21
22 For more information visit http://www.dundi.com
23
24 \section{DUNDIQUERY and DUNDIRESULT}
25
26 The DUNDIQUERY and DUNDIRESULT dialplan functions will let you initiate
27 a DUNDi query from the dialplan, see how many results there are, and access
28 each one.  Here is some example usage:
29
30 \begin{verbatim}
31 exten => 1,1,Set(ID=${DUNDIQUERY(1|dundi_test|b)})
32 exten => 1,n,Set(NUM=${DUNDIRESULT(${ID}|getnum)})
33 exten => 1,n,NoOp(There are ${NUM} results)
34 exten => 1,n,Set(X=1) 
35 exten => 1,n,While($[${X} <= ${NUM}])
36 exten => 1,n,NoOp(Result ${X} is ${DUNDIRESULT(${ID}|${X})}) 
37 exten => 1,n,Set(X=$[${X} + 1])
38 exten => 1,n,EndWhile
39 \end{verbatim}
40