Running Sample Applications
70
Getting Started Guide
The lsmod command verifies the kernel driver is installed. The qat_service command
reports the status of the device. Typical output is:
There is 1 acceleration device(s) in the system:
icp_dev0 - type=c2XXX, inst_id=0, bsf=00:0b:0, #accel=1, #engines=2,
state=up
Note:
If the module is not returned from the first command, refer to
for additional information on starting the Acceleration software.
The sample code is executed by installing the
cpa_sample_code
kernel object for kernel
space, or by launching the application for user space.
The application allows the kernel parameters listed below.
Table 10. Sample Code Parameters
Parameter
Description
signOfLife=v
Indicates shorter test run that verifies the acceleration software is working. This
parameter executes a subset of sample tests. Details are included in Section 10.1.2.1.
(default=0)
cyNumBuffers=w
Number of buffers submitted for each iteration. (default=20)
cySymLoops=x
Number of iterations of all symmetric code tests. (default=5000)
cyAsymLoops=y
Number of iterations of all asymmetric code tests. (default=5000)
runTests=1
Run symmetric code tests.
runTests=2
Run RSA test code.
runTests=4
Run DSA test code.
runTests=8
Run ECDSA test code.
runTests=32
Run Stateless Compression test. (Not supported)
runStateful=1
Run Stateful Compression test. (Not supported)
runTests=63
Run all tests. (default)
configFileVer
Version of configuration file. Can be 1 or 2 (default).
If you are using the original version 1 configuration file, use 1.
For configuration file details, see the Rangeley Software Programmer’s Guide.
wirelessFirmware
Wireless Firmware enabled. Can be 0 (default) or 1.
This parameter can only be used with the version 2 configuration file when wireless
instances are configured.
For configuration file details, see the Rangeley Software Programmer’s Guide.
10.1.2.1
signOfLife Tests
The signOfLife parameter is used to specify that a subset of the sample tests are executed
with smaller iteration counts. This provides a quick test to verify the acceleration software and
hardware are set up correctly.
