diff options
author | russell <russell@f38db490-d61c-443f-a65b-d21fe96a405b> | 2007-03-15 22:25:12 +0000 |
---|---|---|
committer | russell <russell@f38db490-d61c-443f-a65b-d21fe96a405b> | 2007-03-15 22:25:12 +0000 |
commit | 3bc7e211a435c49aa70ad227799bd7b0c40356a1 (patch) | |
tree | d8e5262f1e1a9faad716b36f59a6b3fe65c288bd /doc/extconfig.txt | |
parent | a63acaa328b9937677f3f5c4d861889a6e369034 (diff) |
Merge changes from svn/asterisk/team/russell/LaTeX_docs.
* Convert most of the doc directory into a single LaTeX formatted document
so that we can generate a PDF, HTML, or other formats from this
information.
* Add a CLI command to dump the application documentation into LaTeX format
which will only be include if the configure script is run with
--enable-dev-mode.
* The PDF turned out to be close to 1 MB, so it is not included. However, you
can simply run "make asterisk.pdf" to generate it yourself. We may include
it in release tarballs or have automatically generated ones on the web site,
but that has yet to be decided.
git-svn-id: http://svn.digium.com/svn/asterisk/branches/1.4@58931 f38db490-d61c-443f-a65b-d21fe96a405b
Diffstat (limited to 'doc/extconfig.txt')
-rw-r--r-- | doc/extconfig.txt | 91 |
1 files changed, 0 insertions, 91 deletions
diff --git a/doc/extconfig.txt b/doc/extconfig.txt deleted file mode 100644 index 0a95997ce..000000000 --- a/doc/extconfig.txt +++ /dev/null @@ -1,91 +0,0 @@ -Asterisk external configuration -=============================== - -The Asterisk external configuration engine is the result of work by -Anthony Minessale II, Mark Spencer and Constantine Filin. - -It is designed to provide a flexible, seamless integration between -Asterisk's internal configuration structure and external SQL other other -databases (maybe even LDAP one day). - -The external configuration engine is the basis for the ARA, the -Asterisk Realtime Architecture (see doc/realtime.txt for more -information). - -* Configuration - -External configuration is configured in /etc/asterisk/extconfig.conf -allowing you to map any configuration file (static mappings) to -be pulled from the database, or to map special runtime entries which -permit the dynamic creation of objects, entities, peers, etc. without -the necessity of a reload. - -Generally speaking, the columns in your tables should line up with the -fields you would specify in the given entity declaration. If an entry -would appear more than once, in the column it should be separated by a -semicolon. For example, an entity that looks like: - -[foo] -host=dynamic -secret=bar -context=default -context=local - -could be stored in a table like this: - -+------+--------+-------+--------------+----------+-----+-----------+ -| name | host | secret| context | ipaddr | port| regseconds| -+------+--------+-------+--------------+----------+-----+-----------+ -| foo | dynamic| bar | default;local| 127.0.0.1| 4569| 1096954152| -+------+--------+-------+--------------+----------+-----+-----------+ - -Note that for use with IAX or SIP, the table will also need the "name", -"ipaddr", "port", "regseconds" columns. If you wanted to be able to -configure the callerid, you could just add a callerid column to the -table, for example. - -A SIP table would look more like this: - -+------+--------+-------+----------+-----+------------+----------+ -| name | host | secret| ipaddr | port| regseconds | username | -+------+--------+-------+----------+-----+------------+----------+ -| foo | dynamic| bar | 127.0.0.1| 4569| 1096954152 | 1234 | -+------+--------+-------+----------+-----+------------+----------+ - -in order to store appropriate parameters required for SIP. - -In addition to this, if you add a field named "regserver" to the -SIP peers table and have the system name set in asterisk.conf, -Asterisk will store the system name that the user registered on in -the database. This can be used to direct calls to go through the server -that holds the registration (for NAT traversal purposes). - -A Voicemail table would look more like this: - -+----------+---------+----------+----------+-----------+---------------+ -| uniqueid | mailbox | context | password |email | fullname | -+----------+---------+----------+----------+-----------+---------------+ -| 1 | 1234 | default | 4242 | a@b.com | Joe Schmoe | -+----------+---------+----------+----------+-----------+---------------+ - -The uniqueid should be unique to each voicemail user and can be -autoincrement. It need not have any relation to the mailbox or context. - -An extension table would look more like this: - -+----------+---------+----------+-------+-----------+ -| context | exten | priority | app | appdata | -+----------+---------+----------+-------+-----------+ -| default | 1234 | 1 | Dial | Zap/1 | -+----------+---------+----------+-------+-----------+ - -In the dialplan you just use the Realtime switch: - -[foo] -switch => Realtime - -or: - -[bar] -switch => Realtime/bar@extensions - |