1ASTRIBANK_ALLOW(8)                                          ASTRIBANK_ALLOW(8)
2
3
4

NAME

6       astribank_allow - License Xorcom Astribank (xpp) capabilities.
7

SYNOPSIS

9       astribank_allow -D device-path [ options ]
10
11       astribank_allow [-h]
12
13

DESCRIPTION

15       Modern  Astribanks  (with  USB  product id's 116x) contain capabilities
16       that may be licensed.
17
18       astribank_allow is used to upload/download  the  licensing  information
19       to/from the device.
20
21       Uploading  a  valid license file to an Astribank, changes its capabili‐
22       ties.  The change becomes effective after a firmware reset  (either  by
23       powering  the  device  off and on again, or via the astribank_tool full
24       reset option).
25
26       Downloading license from the device, produces a valid license file  for
27       its  current  capabilities. This may be backed up, so the device may be
28       later restored to its previous capabilities.
29
30       The license file contains both a  human  readable  description  of  the
31       device capabilities for the end user and a hash of the licensing infor‐
32       mation used by Xorcom to generate/modify licensed capabilities.
33
34

OPTIONS

36       -D device-path
37              Required.  The  device  to   read   from/write   to.   This   is
38              bus_num/device_num,  where  bus_num and device_num are the first
39              two numbers in the output of lsusb(8) or dahdi_hardware(8).   On
40              older  versions  of  this tool you needed a complete path to the
41              device,  which  would  be  /dev/bus/usb/bus_num/device_num,   or
42              /proc/bus/usb/bus_num/device_num.
43
44       -w
45              Write capabilities to EEPROM, otherwise read capabilities
46
47       -f filename
48              License filename (stdin/stdout if not specified)
49
50       -m num
51              Choose  the  numeric  code of license markers to generate.  This
52              code select the type of BEGIN.../END... strings that delimit the
53              license body.
54
55              Valid  marker  codes are listed with the -h option.  The default
56              (and first) code is 1. Zero is illegal value.
57
58       -v
59              Increase verbosity. May be used multiple times.
60
61       -d mask
62              Set debug mask to mask. Default is 0, 0xFF is "everything".
63
64       -h
65              Displays usage message.
66
67

SEE ALSO

69       fxload(8), lsusb(8), astribank_hexload(8), astribank_tool(8)
70
71

AUTHOR

73       Alex Landau
74
75
76
77                                 29 March 2009              ASTRIBANK_ALLOW(8)
Impressum