Ipp_Diag() - VeriFone MX800 series Programmer's Manual

ipp_diag()

This function executes various IPP diagnostics. The application can use this
function to check information on the IPP firmware as well as perform 1DES test
encryptions.
Prototype
return = ipp_diag(test_type, result, master_key);
int return, test_type, master_key;
char *result;
Parameters
Type of test that the user wants to perform:
test_type
0
1
2
3
4
Pointer to a buffer sufficient enough to hold the results. It must
result
be at least 17 bytes for tests 0-2 and at least 150 bytes for
tests 3-4.
Master key slot # to use when performing test #3.
master_key
DUKPT engine to use when performing test #4.
Return Values
0 Success
-1 Error
The result buffer will contain the following, according to the test_type
specified:
Table 20
Test_type Result buffer
0 Buffer contains checksum
1 Serial number if present
2 Version number
3-4 Refer to the Remarks section of ipp_read().
ROM Checksum Test
Serial Number Test
ROM Version Number Test
Master/Session Encryption Test
DUKPT Encryption Test
X
M
IPP L
EGACY
800 S P G
ERIES ROGRAMMERS
L
IBRARY
ipp_diag()
225
UIDE