OS Manuals

/usr/bin/ipptool

Perform internet printing protocol requests

From ipptool 2.4.20-r0 (os), captured 2026-11-05 by running ipptool --help (exit 1). permalink

Usage: ipptool [options] URI filename [ ... filenameN ]
Options:
--ippserver filename    Produce ippserver attribute file
--stop-after-include-error
                        Stop tests after a failed INCLUDE
--version               Show version
-4                      Connect using IPv4
-6                      Connect using IPv6
-C                      Send requests using chunking (default)
-E                      Test with encryption using HTTP Upgrade to TLS
-I                      Ignore errors
-L                      Send requests using content-length
-P filename.plist       Produce XML plist to a file and test report to standard output
-R                      Repeat tests on server-error-busy
-S                      Test with encryption using HTTPS
-T seconds              Set the receive/send timeout in seconds
-V version              Set default IPP version
-X                      Produce XML plist instead of plain text
-c                      Produce CSV output
-d name=value           Set named variable to value
-f filename             Set default request filename
-h                      Validate HTTP response headers
-i seconds              Repeat the last file with the given time interval
-l                      Produce plain text output
-n count                Repeat the last file the given number of times
-q                      Run silently
-t                      Produce a test report
-v                      Be verbose
Options (27)
OptionDescriptionSource
--ippserver filenameSpecifies that the test results should be written to the named ippserver attributes file.help + man
--stop-after-include-errorTells ipptool to stop if an error occurs in an included file.help + man
--versionShows the version of ipptool being used.help + man
-4Specifies that ipptool must connect to the printer or server using IPv4.help + man
-6Specifies that ipptool must connect to the printer or server using IPv6.help + man
-CSpecifies that requests should be sent using the HTTP/1.1 "Transfer-Encoding: chunked" header, which is required for conformance by all versions of IPP.help + man
-EForces TLS encryption when connecting to the server using the HTTP "Upgrade" header.help + man
-ISpecifies that ipptool will continue past errors.help + man
-LSpecifies that requests should be sent using the HTTP/1.0 "Content-Length:" header, which is required for conformance by all versions of IPP.help + man
-P filename.plistProduce XML plist to a file and test report to standard outputhelp
-RRepeat tests on server-error-busyhelp
-SForces (dedicated) TLS encryption when connecting to the server.help + man
-T secondsSet the receive/send timeout in secondshelp
-V versionSet default IPP versionhelp
-XSpecifies that XML (Apple plist) output is desired instead of the plain text report.help + man
-cSpecifies that CSV (comma-separated values) output is desired instead of the plain text output.help + man
-d name=valueSet named variable to valuehelp
-f filenameSet default request filenamehelp
-hValidate HTTP response headers.help + man
-i secondsRepeat the last file with the given time intervalhelp
-lSpecifies that plain text output is desired.help + man
-n countRepeat the last file the given number of timeshelp
-qBe quiet and produce no output.help + man
-tSpecifies that CUPS test report output is desired instead of the plain text output.help + man
-vSpecifies that all request and response attributes should be output in CUPS test mode (-t).help + man
--helpShows program help. (in the manual page but not in --help)man
-jSpecifies that ipptool will produce JSON output. (in the manual page but not in --help)man
Exit status (1) from the manual page
0all tests were successful and 1 otherwise
Examples (2) from the manual page, untested

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.