Results (Return codes - Error codes - Reason codes)
Return codes and their usage
All return codes below 100 indicate a successful operation.
When executing kfpx Profiles
0 |
No hit, no Fixups executed |
1 |
At least one hit with severity 'info', no Fixups executed |
2 |
At least one hit with severity 'warning', no Fixups executed |
3 |
At least one hit with severity 'error', no Fixups executed |
5 |
No hit, Fixups have been executed |
6 |
At least one hit with severity 'info', Fixups have been executed |
7 |
At least one hit with severity 'warning', Fixups have been executed |
8 |
At least one hit with severity 'error', Fixups have been executed; Fixup failed |
When executing in pdfa mode
0 |
PDF is valid PDF/A-file, additional Checks without problems |
1 |
PDF is valid PDF/A-file, but additional Checks with problems – severity info |
2 |
PDF is valid PDF/A-file, but additional Checks with problems – severity warning |
3 |
PDF is valid PDF/A-file, but additional Checks with problems – severity error |
4 |
PDF is not a valid PDF/A-file |
When executing an e-mail conversion
|
0 |
Successful conversion to PDF/A |
|
2 |
PDF is valid PDF/A file, but some attachments of the converted e-mail are missing |
|
4 |
E-mail was converted to PDF, but is not a valid PDF/A-file |
When executing the compare action
|
0 |
Compared PDFs are equal |
|
1 |
Compared PDFs have differences |
Other commands or actions
|
0 |
Successful operation |
Errors
100 |
Not serialized (no valid serialization found or keycode expired) |
101 |
Command line parameter error |
102 |
Command line syntax error (illegal command) |
103 |
Unknown error (internal error) |
104 |
A file could not be opened |
105 |
An encrypted PDF file could not be opened for writing |
106 |
A file could not be saved |
| 107 |
File is damaged and needs repair |
| Error codes above 128 are NOT Windows (only Linux or Mac) | |
| 130 | Processing is aborted due to user cancel |
| 132 | Illegal instruction |
| 134 | Abnormal termination (e.g. out-of-memory) |
| 136 | Floating point exception (e.g. div-by-zero) |
| 137 | Kill (e.g. explicitly sent by user or by the system) |
| 138 | BUS error (e.g. bad memory access) |
| 139 | Segmentation violation (e.g. invalid memory reference) |
| Cells from 134-139 on Mac/Linux indicate an error (crash) of the environmental system. Please report such cases together with the details and files to [email protected] | |
| 141 | Broken pipe (e.g. used for interprocess communication) |
| 142 | Execution is cancelled after timeout |
| 143 | Termination request (e.g. explictely sent by user or by the system) |
| 145 | Child process died (e.g. used for interprocess communication) |
| 159 | Bad system call (e.g. a system call that is not supported by the kernel) |
- Note: On a Windows computer the return code may be accessed by using the system variable errorlevel, on a Linux/MacOS computer $? can be used.
Errors for distributed processing
110 |
Action is not distributable |
111 |
No Dispatcher was found |
112 |
No Satellite was found or is ready for execution |
Reason codes
1000 |
Unknown reason |
1001 |
A parameter is wrong |
1002 |
A requested file could not be found |
1003 |
A requested folder could not be found |
1004 |
A requested folder is a file |
1005 |
A requested file is a folder |
1006 |
30 days trial period expired |
1007 |
Time limited keycode expired |
1008 |
Invalid activation |
1009 |
PDF does not contain ICC profiles |
1010 |
A file could not be opened |
1011 |
An encrypted PDF file could not be opened for writing |
1012 |
A file could not be saved |
| 1013 |
File is damaged and needs repair |
Listing of all possible codes on the command line
All Return codes and Reason codes can also be listed on the CLI, using the following command:
pdfaPilot --statusThis command will also list the current licensing status of the software.