3-Heights™ PDF Security Shell - PDF Tools AG

3-Heights PDF Security Shell, Version 4.2 Page 34 of 35
July 8, 2013
6.3 General Switches
-v Verbose Mode
This option turns on the verbose mode. In the verbose mode, the steps performed by 3-Heights PDF
Security Shell are written to standard output.
Example: Enable verbose mode:
pdfsecure -v in.pdf out.pdf
Processing file in.pdf
Done.
-lk
Set License Key
Pass a license key to the application at runtime instead of installing it on the system.
6.4 Return Codes
All return codes other than “0” indicate an error in the processing.
Table: Return Codes
Value
Description
0 Success
1 PDF Input File could not be opened or invalid parameters
2 PDF Output File could not be created
3 Invalid option or option values were entered
4 PDF Input File is encrypted and password is incorrect or not provided
5 Cannot create signature
6 Cannot get response from OCSP or TSP
7 Input file contains invalid signatures (validation)
10 License error
Possible reasons for return code 5 are:
Cannot create a session (or CSP)
The certificate store is not available
The certificate cannot be found
The private key is not available
Incorrect signature length
Return code 6 can be considered as a warning, i.e. non-critical. It means the document was correctly
signed, but due to a HTTP missing connection to the OCSP or time server it does not contain either
revocation information or a time stamp.
PDF Tools AG – Premium PDF Technology