license

license — activates the commercial license.

Synopsis

       
(license card_id license_key)
	

Parameters

card_id

The card ID.

license_key

A card-specific key required to activate the license.

Returns

OK, if card accessed successfully. In this case, the following messages may be printed to the standard output stream:

Warning: zero key read from board device.

(This message may indicate that the board has been improperly configured at the factory. Contact the supplier for help.)

License for board board Accepted.

Demo license for board board Accepted.

License for board board Rejected.

If the command failed (the card not is available or was not read), then the following error message is returned:

(error "license DR_ERR_CARD_IO_FAILURE (time)
 I/O failure(card_status) on card card")

The driver will not generally start up without a successful license command execution.

Description

This command enables the commercial license for the driver. Most drivers require a license to be enabled, otherwise they will fail to start. The license key is unique to the particular hardware installed and the operating system used, and must be determined by Cogent for each installation of the software. This command is normally executed from the configuration file.

Multiple license commands can be put in the configuration file, to cover multiple or alternate cards, or different OS's. Although licenses that are invalid will be rejected, the driver will start provided at least one license was accepted. The licenseFile command provides a better mechanism to manage multiple licenses.

Example

(license 0 1234-5678-9abcde-f012-3567-89ab)