diff options
author | tzafrir <tzafrir@5390a7c7-147a-4af0-8ec9-7488f05a26cb> | 2009-05-27 10:40:54 +0000 |
---|---|---|
committer | tzafrir <tzafrir@5390a7c7-147a-4af0-8ec9-7488f05a26cb> | 2009-05-27 10:40:54 +0000 |
commit | d96875f858a74e5b9cb85e565ccd3423ed8a0ccd (patch) | |
tree | b146ee879743e6243d0000e75c9c8e9334b87db4 | |
parent | 18c6813f2c788b603dab363b9138d65d24252167 (diff) |
* Actually install astribank_allow
* Which requires a man page
* And ignore some extra generated files while we're at it.
git-svn-id: http://svn.digium.com/svn/zaptel/branches/1.4@4643 5390a7c7-147a-4af0-8ec9-7488f05a26cb
-rw-r--r-- | kernel/xpp/utils/Makefile | 2 | ||||
-rw-r--r-- | kernel/xpp/utils/astribank_allow.8 | 70 |
2 files changed, 71 insertions, 1 deletions
diff --git a/kernel/xpp/utils/Makefile b/kernel/xpp/utils/Makefile index a2c2e71..f6707fc 100644 --- a/kernel/xpp/utils/Makefile +++ b/kernel/xpp/utils/Makefile @@ -78,7 +78,7 @@ TARGETS += fpga_load \ astribank_hexload \ astribank_allow \ test_parse -PROG_INSTALL += fpga_load astribank_tool astribank_hexload +PROG_INSTALL += fpga_load astribank_tool astribank_hexload astribank_allow endif ifneq (,$(PERLLIBDIR)) PROG_INSTALL += $(PERL_SCRIPTS) diff --git a/kernel/xpp/utils/astribank_allow.8 b/kernel/xpp/utils/astribank_allow.8 new file mode 100644 index 0000000..4a44528 --- /dev/null +++ b/kernel/xpp/utils/astribank_allow.8 @@ -0,0 +1,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. On modern UDEV-based system +this is usually /dev/bus/usb/\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). +On older systems that use usbfs, it is usually +/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 |