summaryrefslogtreecommitdiff
path: root/xpp/astribank_allow.8
blob: 66754321be6855670c18bf2003dcf9e6a38ca9bd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
.TH "ASTRIBANK_ALLOW" "8" "29 March 2009" "" ""

.SH NAME
astribank_allow \- License Xorcom Astribank (xpp) capabilities.
.SH SYNOPSIS
.B astribank_allow \-D \fIdevice-path\fR [ options ]

.B astribank_allow [\-h]

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

.B 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 \fBastribank_tool\fR 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.

.SH OPTIONS
.B \-D
.I device-path
.RS
Required. The device to read from/write to. This is
\fIbus_num\fR/\fIdevice_num\fR, where \fIbus_num\fR and \fIdevice_num\fR
are the first two numbers in the output of lsusb(8) or dahdi_hardware(8).
On older versions of this toolyou needed a complete path to the device,
which would be /dev/bus/usb/\fIbus_num\fR/\fIdevice_num\fR, or
/proc/bus/usb/\fIbus_num\fR/\fIdevice_num\fR.
.RE

.B \-w
.RS
Write capabilities to EEPROM, otherwise read capabilities
.RE

.B \-f \fIfilename\fR
.RS
License filename (stdin/stdout if not specified)
.RE

.B \-v
.RS
Increase verbosity. May be used multiple times.
.RE

.B \-d \fImask\fR
.RS
Set debug mask to \fImask\fR. Default is 0, 0xFF is "everything".
.RE

.B \-h
.RS
Displays usage message.
.RE

.SH SEE ALSO
fxload(8), lsusb(8), astribank_hexload(8), astribank_tool(8)

.SH AUTHOR
Alex Landau