[Pkg-voip-commits] r10471 - /dahdi-tools/trunk/debian/README.Debian

[tzafrir at alioth.debian.org]

Author: tzafrir
Date: Mon May  5 09:16:31 2014
New Revision: 10471

URL: http://svn.debian.org/wsvn/pkg-voip/?sc=1&rev=10471
Log:
Update README: mainly on span assignments

Modified:
    dahdi-tools/trunk/debian/README.Debian

Modified: dahdi-tools/trunk/debian/README.Debian
URL: http://svn.debian.org/wsvn/pkg-voip/dahdi-tools/trunk/debian/README.Debian?rev=10471&op=diff
==============================================================================
--- dahdi-tools/trunk/debian/README.Debian	(original)
+++ dahdi-tools/trunk/debian/README.Debian	Mon May  5 09:16:31 2014
@@ -34,7 +34,7 @@
 --------------------
 DAHDI is capable of playing ring tone, buy tone etc. for a large variety of
 countries. This is done using the loadzone and defaultzone settings in 
-zaptel.conf.  A list of tone-zones supported by zaptel and libtonezone is 
+system.conf.  A list of tone-zones supported by DAHDI and libtonezone is 
 included in the file tonezones.txt in the documentation directory. 
 
 Example section of system.conf:
@@ -55,3 +55,35 @@
 Most of the dahdi utilities, e.g. dahdi_cfg, dahdi_test, dahdi_monitor
 and the dahdi-perl utilities are included in the package 'dahdi' that is
 built from the source package dahdi-tools.
+
+
+Automatic startup
+-----------------
+There is work in progress to start DAHDI devices automatically.
+See also http://docs.tzafrir.org.il/dahdi-tools/#_initialization and for
+the low-level description:
+http://docs.tzafrir.org.il/dahdi-linux/#_span_assignments
+
+The dahdi-linux package sets dahdi.auto_assigned_spans to 0 by default,
+but the dahdi-tools should have the required scriptary in place to make
+sure an upgrade will not break an existing system. That said, if your
+system has more than one DAHDI device, you should create a
+/etc/dahdi/assigned-spans.conf using 'dahdi_genconf assignedspan' (or
+manually) rather than relying on any other ordering mechanism.
+
+Much work has been put in place to make sure configurations
+work as before if there are no changes. It is still recommended to create
+a span-assignments file for your setup if you have more than one device:
+
+  dahdi_genconf assigedspans
+
+The udev hook scripts run two main hooks:
+* /usr/share/dahdi/dahdi_handle_device:
+      Run when a new DAHDI device is added or removed. Mainly to assign
+      spans.
+* /usr/share/dahdi/dahdi_config_span:
+      Run when a new DAHDI span is added or removed. Mainly to configure
+      the new spans.
+
+As you would expect, there are .d directories for the scripts and those
+are places for your hooks, if needed.