Initializing help system before first use

msgverify

msgverify


Purpose
Verify the digital signature of a document.
Synopsis
function msgverify(mdalg:string, key:string, fname:string, sgf:string):integer
function msgverify(key:string, fname:string, sgf:string):integer
Arguments
mdalg 
Name of the message digest algorithm to use
key 
Name of the public key file to use
fname 
File to verify
sgf 
Signature used for the verification
Return value
1 if the signature is valid, 0 if the verification failed and -1 in the case of an error.
Further information
1. This function verifies the digital signature of a document by comparing the message digest of the document with the information obtained by decrypting the provided signature with a given RSA public key. Typically this signature has been obtained with the function msgsign and the appropriate private key.
2. If no message digest algorithm is specified, the default algorithm defined by the control parameter ssl_digest is used. Note that the same algorithm has to be used for both signing and verifying.
3. If the key file name does not include an explicit path ( e.g. "somekey"), it is searched for in the default public keys directory located at getparam("ssl_dir")+"/pubkeys" instead of the current working directory. It is required to prefix the key file name with "./" in order to access a key file from the current directory ( e.g. "./somekey").
Related topics
Module