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. On modern UDEV-based
system this is usually /dev/bus/usb/bus_num/device_num, where
bus_num and device_num are the first two numbers in the output
of lsusb(8). On older systems that use usbfs, it is usually
/proc/bus/usb/bus_num/device_num.
-w
Write capabilities to EEPROM, otherwise read capabilities
-f filename
License filename (stdin/stdout if not specified)
-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