---
name: "astribank_allow"
section: "8"
platform: "linux"
package: "dahdi"
version: "1:3.1.0-2.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/astribank_allow"
---

# astribank\_allow(8)

License Xorcom Astribank (xpp) capabilities.

## 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)](/lsusb/8.md) or [dahdi\_hardware(8)](/dahdi_hardware/8.md). 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)](/fxload/8.md), [lsusb(8)](/lsusb/8.md), [astribank\_hexload(8)](/astribank_hexload/8.md), [astribank\_tool(8)](/astribank_tool/8.md)

## AUTHOR

Alex Landau