3 <!-- SECTION: Man Pages -->
5 <link rel=
"stylesheet" type=
"text/css" href=
"../cups-printable.css">
6 <title>ipptool(
1)
</title>
9 <h1 class=
"title">ipptool(
1)
</h1>
10 <h2 class=
"title"><a name=
"NAME">Name
</a></h2>
11 ipptool - perform internet printing protocol requests
12 <h2 class=
"title"><a name=
"SYNOPSIS">Synopsis
</a></h2>
20 <b>--stop-after-include-error
</b>
75 <h2 class=
"title"><a name=
"DESCRIPTION">Description
</a></h2>
77 sends IPP requests to the specified
79 and tests and/or displays the results.
82 defines one or more requests, including the expected response status, attributes, and values.
83 Output is either a plain text, formatted text, CSV, or XML report on the standard output, with a non-zero exit status indicating that one or more tests have failed.
86 format is described in
87 <a href=
"man-ipptoolfile.html?TOPIC=Man+Pages"><b>ipptoolfile
</b>(
5).
</a>
88 <h2 class=
"title"><a name=
"OPTIONS">Options
</a></h2>
89 The following options are recognized by
93 <dd style=
"margin-left: 5.0em">Shows program help.
94 <dt><b>--ippserver
</b><i>filename
</i>
95 <dd style=
"margin-left: 5.0em">Specifies that the test results should be written to the named
98 <dt><b>--stop-after-include-error
</b>
99 <dd style=
"margin-left: 5.0em">Tells
101 to stop if an error occurs in an included file. Normally
103 will continue with subsequent tests after the INCLUDE directive.
105 <dd style=
"margin-left: 5.0em">Shows the version of
109 <dd style=
"margin-left: 5.0em">Specifies that
111 must connect to the printer or server using IPv4.
113 <dd style=
"margin-left: 5.0em">Specifies that
115 must connect to the printer or server using IPv6.
117 <dd style=
"margin-left: 5.0em">Specifies that requests should be sent using the HTTP/
1.1 "Transfer-Encoding: chunked" header, which is required for conformance by all versions of IPP.
118 The default is to use
"Transfer-Encoding: chunked" for requests with attached files and
"Content-Length:" for requests without attached files.
120 <dd style=
"margin-left: 5.0em">Forces TLS encryption when connecting to the server using the HTTP
"Upgrade" header.
122 <dd style=
"margin-left: 5.0em">Specifies that
124 will continue past errors.
126 <dd style=
"margin-left: 5.0em">Specifies that requests should be sent using the HTTP/
1.0 "Content-Length:" header, which is required for conformance by all versions of IPP.
127 The default is to use
"Transfer-Encoding: chunked" for requests with attached files and
"Content-Length:" for requests without attached files.
128 <dt><b>-P
</b><i> filename.plist
</i>
129 <dd style=
"margin-left: 5.0em">Specifies that the test results should be written to the named XML (Apple plist) file in addition to the regular test report (
<b>-t
</b>).
130 This option is incompatible with the
<b>-i
</b> (interval) and
<b>-n
</b> (repeat-count) options.
132 <dd style=
"margin-left: 5.0em">Forces (dedicated) TLS encryption when connecting to the server.
133 <dt><b>-T
</b><i> seconds
</i>
134 <dd style=
"margin-left: 5.0em">Specifies a timeout for IPP requests in seconds.
135 <dt><b>-V
</b><i> version
</i>
136 <dd style=
"margin-left: 5.0em">Specifies the default IPP version to use:
1.0,
1.1,
2.0,
2.1, or
2.2. If not specified, version
1.1 is used.
138 <dd style=
"margin-left: 5.0em">Specifies that XML (Apple plist) output is desired instead of the plain text report.
139 This option is incompatible with the
<b>-i
</b> (interval) and
<b>-n
</b> (repeat-count) options.
141 <dd style=
"margin-left: 5.0em">Specifies that CSV (comma-separated values) output is desired instead of the plain text output.
142 <dt><b>-d
</b><i> name=value
</i>
143 <dd style=
"margin-left: 5.0em">Defines the named variable.
144 <dt><b>-f
</b><i> filename
</i>
145 <dd style=
"margin-left: 5.0em">Defines the default request filename for tests.
147 <dd style=
"margin-left: 5.0em">Validate HTTP response headers.
148 <dt><b>-i
</b><i> seconds
</i>
149 <dd style=
"margin-left: 5.0em">Specifies that the (last)
151 should be repeated at the specified interval.
152 This option is incompatible with the
<b>-X
</b> (XML plist output) option.
154 <dd style=
"margin-left: 5.0em">Specifies that plain text output is desired.
155 <dt><b>-n
</b><i> repeat-count
</i>
156 <dd style=
"margin-left: 5.0em">Specifies that the (last)
158 should be repeated the specified number of times.
159 This option is incompatible with the
<i>-X
</i> (XML plist output) option.
161 <dd style=
"margin-left: 5.0em">Be quiet and produce no output.
163 <dd style=
"margin-left: 5.0em">Specifies that CUPS test report output is desired instead of the plain text output.
165 <dd style=
"margin-left: 5.0em">Specifies that all request and response attributes should be output in CUPS test mode (
<b>-t
</b>).
166 This is the default for XML output.
168 <h2 class=
"title"><a name=
"EXIT_STATUS">Exit Status
</a></h2>
171 program returns
0 if all tests were successful and
1 otherwise.
172 <h2 class=
"title"><a name=
"FILES">Files
</a></h2>
173 The following standard files are available:
176 <i>create-printer-subscription.test
</i>
177 <i>document-a4.pdf
</i>
178 <i>document-a4.ps
</i>
179 <i>document-letter.pdf
</i>
180 <i>document-letter.ps
</i>
181 <i>get-completed-jobs.test
</i>
183 <i>get-notifications.test
</i>
184 <i>get-printer-attributes.test
</i>
185 <i>get-subscriptions.test
</i>
191 <i>ipp-everywhere.test
</i>
192 <i>onepage-a4.pdf
</i>
194 <i>onepage-letter.pdf
</i>
195 <i>onepage-letter.ps
</i>
196 <i>print-job.test
</i>
197 <i>print-job-deflate.test
</i>
198 <i>print-job-gzip.test
</i>
204 <i>validate-job.test
</i>
206 <h2 class=
"title"><a name=
"CONFORMING_TO">Conforming To
</a></h2>
209 program is unique to CUPS and conforms to the Internet Printing Protocol up to version
2.2.
210 <h2 class=
"title"><a name=
"EXAMPLES">Examples
</a></h2>
211 Get a list of completed jobs for
"myprinter":
214 ipptool ipp://localhost/printers/myprinter get-completed-jobs.test
216 <p>Send email notifications to
"user@example.com" when
"myprinter" changes:
219 ipptool -d recipient=mailto:user@example.com \
220 ipp://localhost/printers/myprinter create-printer-subscription.test
222 <h2 class=
"title"><a name=
"SEE_ALSO">See Also
</a></h2>
223 <a href=
"man-ipptoolfile.html?TOPIC=Man+Pages"><b>ipptoolfile
</b>(
5),
</a>
224 IANA IPP Registry (
<a href=
"http://www.iana.org/assignments/ipp\-registrations)">http://www.iana.org/assignments/ipp\-registrations)
</a>,
225 PWG Internet Printing Protocol Workgroup (
<a href=
"http://www.pwg.org/ipp">http://www.pwg.org/ipp
</a>)
226 RFC
8011 (
<a href=
"http://tools.ietf.org/html/rfc8011)">http://tools.ietf.org/html/rfc8011)
</a>,
227 <h2 class=
"title"><a name=
"COPYRIGHT">Copyright
</a></h2>
228 Copyright
© 2007-
2018 by Apple Inc.