diff options
author | Tzafrir Cohen <tzafrir.cohen@xorcom.com> | 2009-09-27 11:49:40 +0000 |
---|---|---|
committer | Tzafrir Cohen <tzafrir.cohen@xorcom.com> | 2009-09-27 11:49:40 +0000 |
commit | 3d9bd0d3e77a9ea779a75722b652f4484a0b11a9 (patch) | |
tree | 5adbab6ac41c79a78d5392efa6e503ba49f7e78b /xpp/twinstar | |
parent | d3313d948cb9f677717767311888a7289f100d3e (diff) |
xpp: install twinstar by default; Add a man page
Add a man page to twinstar (as perl POD) and get it installed by
default.
git-svn-id: http://svn.asterisk.org/svn/dahdi/tools/trunk@7219 a0bf4364-ded3-4de4-8d8a-66a801d63aff
Diffstat (limited to 'xpp/twinstar')
-rwxr-xr-x | xpp/twinstar | 102 |
1 files changed, 102 insertions, 0 deletions
diff --git a/xpp/twinstar b/xpp/twinstar index fc37a1f..328b398 100755 --- a/xpp/twinstar +++ b/xpp/twinstar @@ -19,6 +19,14 @@ use Dahdi::Xpp; use Dahdi::Xpp::Xbus; use Dahdi::Xpp::Mpp; +$Getopt::Std::STANDARD_HELP_VERSION = 1; +$main::VERSION = '$Id$'; + +sub HELP_MESSAGE() { + eval(usage()); + return 0; +} + sub usage { die "Usage: $0 {status|jump|enable-wd|disable-wd|ports}\n"; } @@ -161,3 +169,97 @@ if($ARGV[0] eq 'status') { } __END__ + +=head1 NAME + +twinstar - Control the Twinstar feature of a Xorcom Astribank + +=head1 SYNOPSIS + +twinstar {status|jump|enable-wd|disable-wd|ports} + +=head1 DESCRIPTION + +B<twinstar> is a tool to control the Twinstar (dual USB port) of a +Xorcom Astribank. There is a single and mandatory argument which is the +command to run. That command operates on all the Astribanks connected to +the system. + +Technically all the commands are implemented using Dahdi::Xpp::Mpp which +in turn uses astribank_tool. Thus using thus tool will require root +permissions or otherwise read/write permissions to the USB device. + +The twinstar may be in I<watchdog mode>, which means that it will jump +to the remote host if it loses contact with the local host. This can +happen if the machine is powered down or hangs or even if the xpp +drivers are unloaded. Which is why the standard twinstar scripts put the +Astribanks in twinstar mode on startup and remove it on normal shutdown. + +An Astribank will only just to the other host (either if asked +explicitly or by the watchdog) only if there is a different Astribank +connected to the other port and running. Which is why all of this has no +effect on systems that don't need this functionality. + +The command are: + +=head2 status + +Shows the current status of all Astribanks. Note that it only shows +Astribanks whose current active USB port is the one connected to this +computer. + +Example output: + + DEVICE PORT WATCHDOG POWER0 POWER1 + usb:001/010 0 on yes yes + usb:001/011 0 on yes yes + +For each Astribank on the system that has Twinstar support we get: + +=over 4 + +=item Device + +The address of the device. This is the bus address, e.g. the address you +see in lsusb / dahdi_hardware. + +=item Port + +The active USB port on the Astribank. This should be always '0' on the +master and always 1 on the slave. + +=item Watchdog + +I<on> if the watchdog is triggered in the Atribank or I<off> otherwise. + +=item Power0, Power1 + +Shows which ports of this Astribank are connected to a USB port of a +running computer. This only shows whether or not the USB host provides +power. + +=back + +=head2 ports + +Shows the same 'Port' column of the B<status> command. + +=head2 jump + +Command all the Astribanks to jump to the other port. This works +regardless the watchdog mode is enabled or not. But requires that there +is power on the other port. + +=head2 enable-wd + +Enables watchdog mode. + +=head2 disable-wd + +Disables watchdog mode. + +=head1 FILES + +B<twinstar> mostly uses astribank_tool which in turn mostly uses USB +files under /dev/bus/usb . + |