Ips_Installscript() - VeriFone MX800 series Programmer's Manual

D D
EVICE RIVERS

iPS_InstallScript()

iPS_InstallScript()
74
M X 800 S P
ERIES ROGRAMMERS
This function authenticates and installs VeriShield Security Script files in the
system.
The function attempts to authenticate all .VSO files in the vss/ subdirectory in the
current user's home directory. Files must have been signed with a signer
certificate that has security script signing capabilities. The associated signature
file (.p7s) must reside in the same directory. The search for .VSO and .p7S
extension is not case sensitive.
Internally the system performs two attempts to authenticate each file. If after the
first attempt the file is not authenticated, the system searches the crt/
subdirectory in the current user's home directory for .CRT files. It tries to add each
certificate file to the system certificate tree. Then a second attempt to authenticate
the file is performed.
Upon successful authentication, the system changes the owner of the .vso file and
installs it in the unit. The change of owner prevents further modification of the file
(The user can still delete the file). The function performs several verifications on
the script file during the install process, such as the compatibility between the
version of the tool that generated the file and the version of the internal script
interpreter.
This function always returns 0. The application can call
iPS_GetScriptStatus() to check the installation of the script file.
Prototype
int iPS_InstallScript(void)
Return Values
0 Always
G
UIDE