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 'warn­ing', 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 'warn­ing', 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 addi­tional Checks with problems – sever­ity info

2

PDF is valid PDF/A-file, but addition­al Checks with problems – severity warning

3

PDF is valid PDF/A-file, but addition­al 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 --status

This command will also list the current licensing status of the software.