---
name: "ippdoclint"
section: "1"
platform: "linux"
package: "ippsample-data"
version: "0.0~git20220607.72f89b3-1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/ippdoclint"
---

# ippdoclint(1)

check common document formats

## NAME

ippdoclint - check common document formats

## SYNOPSIS

**ippdoclint** \[ **--help** \] \[ **--version** \] \[ **-i** *input/format* \] \[ **-o** *name=value \[... name=value\]* \] \[ **-v** \] *filename*

## DESCRIPTION

**ippdoclint** checks the input file for format errors and reports the number of impressions (sides), sheets, and (input) pages in the file.

## OPTIONS

The following options are recognized by **ippdoclint:**

- **--help**

  Shows program help.

- **--version**

  Shows program version.

- **-i** *input/format*

  Specifies the MIME media type of the input file. Currently the "application/pdf" (PDF), "image/jpeg" (JPEG), "image/pwg-raster" (PWG Raster), and "image/urf" (Apple Raster) MIME media types are supported.

- **-o** *"name=value***\[...***name=value\]"*

  Specifies one or more named options for the conversion. Currently the "copies", "page-ranges", "print-color-mode", and "sides" options are supported. See the NAMED OPTIONS section for more information.

- **-v**

  Increases the verbosity for any diagnostics.

## NAMED OPTIONS

The following named options are supported:

- **copies**

  Specifies the number of copies that should be produced.

- **page-ranges**

  Selects a single range of pages to check. For example, the value "5-12" selects pages 5 through 12.

- **print-color-mode**

  Specifies the color mode as "auto" (automatic), "monochrome" (grayscale), or "color".

- **sides**

  Specifies whether to do 1-sided printing ("one-sided") or 2-sided printing ("two-sided-long-edge" for portrait and "two-sided-short-edge" for landscape).

## DIAGNOSTICS

**ippdoclint** sends all messages to the standard error. Each message is prefixed with "ERROR", "INFO", or "DEBUG" depending on the level of verbosity. **ippdoclint** also sends "STATE" and "ATTR" messages corresponding to IPP "job-state-reasons" keywords and Job Status attributes.

## EXIT STATUS

The **ippdoclint** program returns 0 if the input file is correctly formatted and 1 otherwise.

## ENVIRONMENT

**ippdoclint** recognizes the following environment variables:

- **CONTENT\_TYPE**

  Specifies the MIME media type of the input file.

- **IPP\_xxx**

  Specifies the value of the "xxx" Job Template attribute, where "xxx" is converted to uppercase. For example, the "copies" Job Template attribute is stored as the "IPP\_COPIES" environment variable.

- **IPP\_xxx\_DEFAULT**

  Specifies the default value of the corresponding "xxx-default" Printer Description attribute, where "xxx" is converted to uppercase. For example, the "copies-default" Printer Description attribute is stored as the "IPP\_COPIES\_DEFAULT" environment variable.

- **SERVER\_LOGLEVEL**

  Specifies the log level (verbosity) as "error", "info", or "debug".

## EXAMPLES

Check a PDF file:

```
    ippdoclint filename.pdf
```

Check a JPEG file:

```
    ippdoclint filename.jpg
```

## SEE ALSO

**ipptransform**(7), [**ipptransform3d**(7)](/ipptransform3d/7.md), PWG Internet Printing Protocol Workgroup (http://www.pwg.org/ipp)

## COPYRIGHT

Copyright © 2018-2019 by the IEEE-ISTO Printer Working Group.