summaryrefslogtreecommitdiff
path: root/xpp/utils/zt_registration
diff options
context:
space:
mode:
Diffstat (limited to 'xpp/utils/zt_registration')
-rwxr-xr-xxpp/utils/zt_registration53
1 files changed, 30 insertions, 23 deletions
diff --git a/xpp/utils/zt_registration b/xpp/utils/zt_registration
index fdcf33e..1b26f74 100755
--- a/xpp/utils/zt_registration
+++ b/xpp/utils/zt_registration
@@ -74,11 +74,16 @@ zt_registration [on|off]
=head1 DESCRIPTION
-Without parameters, show all connected XPDs sorted by physical connector order.
-Each one is show to be unregistered (off), or registered to a specific zaptel span
-(the span number is shown).
+Without parameters, show all connected XPDs sorted by serial number and
+physical connector order. Each one is show to be unregistered (off), or
+registered to a specific zaptel span (the span number is shown).
-All registerations/deregisterations are sorted by physical connector string.
+All registerations/deregisterations are sorted by serial number and
+(lacking that) physical connector string.
+
+Span registration should generally always succeed. Span unregistration may
+fail if channels from the span are in use by e.g. asterisk. In such a case
+you'll also see those channels as '(In use)' in the output of lszaptel(8).
=head2 Parameters
@@ -88,22 +93,27 @@ on -- registers all XPD's to zaptel.
=head2 Sample Output
- $ zt_registration
- XBUS-02 usb-0000:00:1d.7-3
- XBUS-02/XPD-00: on Span 9
- XBUS-02/XPD-10: on Span 10
- XBUS-02/XPD-20: on Span 11
- XBUS-02/XPD-30: on Span 12
- XBUS-01 usb-0000:00:1d.7-4
- XBUS-01/XPD-00: on Span 13
- XBUS-01/XPD-10: on Span 14
- XBUS-01/XPD-20: on Span 15
- XBUS-01/XPD-30: on Span 16
- XBUS-00 usb-0000:00:1d.7-5
- XBUS-00/XPD-00: on Span 17
- XBUS-00/XPD-10: on Span 18
- XBUS-00/XPD-20: on Span 19
- XBUS-00/XPD-30: on Span 20
+An example of the output of zt_registration for some registered
+Astribanks:
+
+ $ zt_registration
+ XBUS-02 [] usb-0000:00:1d.7-4
+ XBUS-00/XPD-00: on Span 1
+ XBUS-00/XPD-10: on Span 2
+ XBUS-00 [usb:00000126] usb-0000:00:1d.7-2
+ XBUS-02/XPD-00: on Span 3
+ XBUS-02/XPD-10: on Span 4
+ XBUS-02/XPD-20: on Span 5
+ XBUS-02/XPD-30: on Span 6
+ XBUS-01 [usb:00000128] usb-0000:00:1d.7-1
+ XBUS-01/XPD-00: on Span 7
+ XBUS-01/XPD-10: on Span 8
+ XBUS-01/XPD-20: on Span 9
+ XBUS-01/XPD-30: on Span 10
+
+In this example the XBUS-02 has an empty serial number and thus
+becomes the first Astribank. The other two are sorted according to their
+serial numbers.
=head1 FILES
@@ -117,7 +127,4 @@ registered. Writing to it 0 or 1 registers / unregisters the device.
This should allow you to register / unregister a specific XPD rather
than all of them.
-Unregistering an XPD will fail if the span is in use (has some channels
-that are in use by e.g. Asterisk).
-
=back