Abort remaining checks

The “abort-remaining-checks” value appears for every setting. You can set up PDF CHECKER so that it stops its analysis of a given PDF document if it encounters a condition that you select. This saves processing time; PDF CHECKER abandons the current document if it finds a critical error. If you are running PDF CHECKER as a batch process, it will move on to scan the next PDF file in the directory.

Two conditions will cause the PDF CHECKER review process to stop processing immediately whether the “abort-remaining-checks” condition is turned on or not.

  • unable-to-open. The document has an invalid format and cannot be opened, or it is not really a PDF file, or the file is named in the command line statement but does not appear in the directory.
  • password-protected. The document requires a password to open and view, but the password was not provided with the command line statement.

Suppose you set the “abort-remaining-checks” value to “on” for the “contains-annots-without-normal-appearances” condition, like this:

        "contains-annots-without-normal-appearances": {
            "check": "on",
            "report-as-error": "off",
            "report-message": "Contains annotations without default normal appearances.
                               These may not be displayed correctly in all PDF viewers",
            "abort-remaining-checks": "on"

In this example, the first time PDF CHECKER finds annotations with non-normal appearances in a PDF document, it stops all further processing for that document. Since PDF CHECKER can run multi-threaded, however, and thus complete multiple checks at one time, the actual remaining checks that are not processed can vary, depending on when the abort signal is received. For example, one thread could be checking fonts in a PDF document while another is looking at images. The thread checking fonts might not be finished, or where it breaks off might vary from one PDF document to another, when PDF CHECKER abandons the PDF file. As a result, the output results might vary, too. The check that causes the process to abort is shown in the output report.