msgverify
| msgverify | 
  Purpose
 
  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
 
 
