ipptool

versatile testing tool for IPP printers and servers

TLDR

Get printer attributes from an IPP printer

$ ipptool -tv [ipp://printer.local/ipp/print] get-printer-attributes.test

Run a test file against a printer

$ ipptool [ipp://printer.local/ipp/print] [test.ipp]

Submit a print job for testing

$ ipptool -f [document.pdf] [ipp://printer.local/ipp/print] print-job.test

Test with verbose output

$ ipptool -tv [ipp://printer.local/ipp/print] [test.ipp]

Run conformance tests

$ ipptool -tIv [ipp://printer.local/ipp/print] ipp-everywhere.test

SYNOPSIS

ipptool [-tv] [-f filename] [-d name=value] printer-uri testfile [... testfile]

ipptool is a versatile testing tool for IPP (Internet Printing Protocol) printers and servers. It sends IPP requests based on test files and validates responses, making it essential for printer conformance testing and debugging.Test files define IPP operations and expected responses using a simple text format. The tool comes with standard test files for common operations like getting printer attributes, submitting jobs, and IPP Everywhere conformance testing.

PARAMETERS

-t

Generate CUPS-style test report output.

-v

Verbose mode; display every request and response attribute.

-q

Quiet mode; suppress the normal summary output.

-l

Produce plain-text (list) output rather than the default report.

-c

Produce comma-separated (CSV) output.

-X

Produce Apple plist XML output.

-P FILE

In addition to the normal report, write machine-readable plist XML results to FILE.

-f FILENAME

File to use as document data for print-job tests.

-d name=value

Define a variable for use in test files (may be repeated).

-I

Ignore errors and continue with the next test rather than aborting.

-S

Use encryption (TLS/SSL) when connecting to the printer.

-T SECONDS

Request timeout in seconds.

-V VERSION

IPP version to advertise (1.0, 1.1, 2.0, 2.1, 2.2).

-4, -6

Force IPv4 or IPv6 connections respectively.

-C

Use HTTP/1.1 chunked transfer encoding for requests.

--help

Display help information.

CAVEATS

Requires knowledge of IPP protocol for creating custom test files. Some tests may modify printer state or produce actual printed output. The printer URI format varies by printer model and manufacturer.

HISTORY

ipptool is part of CUPS, developed by Michael Sweet. It evolved from earlier IPP testing tools to become the reference implementation for IPP conformance testing, used by printer manufacturers to validate IPP Everywhere compliance.