NAME

       astribank_allow - License Xorcom Astribank (xpp) capabilities.

SYNOPSIS

       astribank_allow -D device-path [ options ]

       astribank_allow [-h]

DESCRIPTION

       Modern Astribanks (with USB product id's 116x) contain capabilities that may be licensed.

       astribank_allow is used to upload/download the licensing information to/from the device.

       Uploading  a  valid  license  file  to an Astribank, changes its capabilities.  The change
       becomes effective after a firmware reset (either by powering the device off and on  again,
       or via the astribank_tool full reset option).

       Downloading  license  from  the  device,  produces  a  valid  license file for its current
       capabilities. This may be backed up, so the device may be later restored to  its  previous
       capabilities.

       The license file contains both a human readable description of the device capabilities for
       the end user and a hash of the licensing information used  by  Xorcom  to  generate/modify
       licensed capabilities.

OPTIONS

       -D device-path
              Required.  The  device  to  read  from/write  to. This is bus_num/device_num, where
              bus_num and device_num are the first two numbers  in  the  output  of  lsusb(8)  or
              dahdi_hardware(8).   On  older  versions of this tool you needed a complete path to
              the    device,    which    would     be     /dev/bus/usb/bus_num/device_num,     or
              /proc/bus/usb/bus_num/device_num.

       -w
              Write capabilities to EEPROM, otherwise read capabilities

       -f filename
              License filename (stdin/stdout if not specified)

       -m num
              Choose  the numeric code of license markers to generate.  This code select the type
              of BEGIN.../END... strings that delimit the license body.

              Valid marker codes are listed with the -h option.  The default (and first) code  is
              1. Zero is illegal value.

       -v
              Increase verbosity. May be used multiple times.

       -d mask
              Set debug mask to mask. Default is 0, 0xFF is "everything".

       -h
              Displays usage message.

SEE ALSO

       fxload(8), lsusb(8), astribank_hexload(8), astribank_tool(8)

AUTHOR

       Alex Landau

                                          29 March 2009                        ASTRIBANK_ALLOW(8)