|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" ipptool man page.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" Copyright 2010-2017 by Apple Inc.
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.\" These coded instructions, statements, and computer programs are the
|
|
Packit |
2fc92b |
.\" property of Apple Inc. and are protected by Federal copyright
|
|
Packit |
2fc92b |
.\" law. Distribution and use rights are outlined in the file "LICENSE.txt"
|
|
Packit |
2fc92b |
.\" which should have been included with this file. If this file is
|
|
Packit |
2fc92b |
.\" file is missing or damaged, see the license at "http://www.cups.org/".
|
|
Packit |
2fc92b |
.\"
|
|
Packit |
2fc92b |
.TH ipptool 1 "CUPS" "4 August 2017" "Apple Inc."
|
|
Packit |
2fc92b |
.SH NAME
|
|
Packit |
2fc92b |
ipptool \- perform internet printing protocol requests
|
|
Packit |
2fc92b |
.SH SYNOPSIS
|
|
Packit |
2fc92b |
.B ipptool
|
|
Packit |
2fc92b |
[
|
|
Packit |
2fc92b |
.B \-\-help
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-\-stop\-after\-include\-error
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-\-version
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-4
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-6
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-C
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-E
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-I
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-L
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-P
|
|
Packit |
2fc92b |
.I filename.plist
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-S
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-T
|
|
Packit |
2fc92b |
.I seconds
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-V
|
|
Packit |
2fc92b |
.I version
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-X
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-c
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-d
|
|
Packit |
2fc92b |
.I name=value
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-f
|
|
Packit |
2fc92b |
.I filename
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-h
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-i
|
|
Packit |
2fc92b |
.I seconds
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-n
|
|
Packit |
2fc92b |
.I repeat-count
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-q
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-t
|
|
Packit |
2fc92b |
] [
|
|
Packit |
2fc92b |
.B \-v ]
|
|
Packit |
2fc92b |
.I printer-uri
|
|
Packit |
2fc92b |
.I testfile
|
|
Packit |
2fc92b |
[ ...
|
|
Packit |
2fc92b |
.I testfile
|
|
Packit |
2fc92b |
]
|
|
Packit |
2fc92b |
.SH DESCRIPTION
|
|
Packit |
2fc92b |
.B ipptool
|
|
Packit |
2fc92b |
sends IPP requests to the specified
|
|
Packit |
2fc92b |
.I printer-uri
|
|
Packit |
2fc92b |
and tests and/or displays the results.
|
|
Packit |
2fc92b |
Each named
|
|
Packit |
2fc92b |
.I testfile
|
|
Packit |
2fc92b |
defines one or more requests, including the expected response status, attributes, and values.
|
|
Packit |
2fc92b |
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.
|
|
Packit |
2fc92b |
The
|
|
Packit |
2fc92b |
.I testfile
|
|
Packit |
2fc92b |
format is described in
|
|
Packit |
2fc92b |
.BR ipptoolfile (5).
|
|
Packit |
2fc92b |
.SH OPTIONS
|
|
Packit |
2fc92b |
The following options are recognized by
|
|
Packit |
2fc92b |
.B ipptool:
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-\-help
|
|
Packit |
2fc92b |
Shows program help.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-\-stop-after-include-error
|
|
Packit |
2fc92b |
Tells
|
|
Packit |
2fc92b |
.B ipptool
|
|
Packit |
2fc92b |
to stop if an error occurs in an included file. Normally
|
|
Packit |
2fc92b |
.B ipptool
|
|
Packit |
2fc92b |
will continue with subsequent tests after the INCLUDE directive.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-\-version
|
|
Packit |
2fc92b |
Shows the version of
|
|
Packit |
2fc92b |
.B ipptool
|
|
Packit |
2fc92b |
being used.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-4
|
|
Packit |
2fc92b |
Specifies that
|
|
Packit |
2fc92b |
.B ipptool
|
|
Packit |
2fc92b |
must connect to the printer or server using IPv4.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-6
|
|
Packit |
2fc92b |
Specifies that
|
|
Packit |
2fc92b |
.B ipptool
|
|
Packit |
2fc92b |
must connect to the printer or server using IPv6.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-C
|
|
Packit |
2fc92b |
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.
|
|
Packit |
2fc92b |
The default is to use "Transfer\-Encoding: chunked" for requests with attached files and "Content\-Length:" for requests without attached files.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-E
|
|
Packit |
2fc92b |
Forces TLS encryption when connecting to the server using the HTTP "Upgrade" header.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-I
|
|
Packit |
2fc92b |
Specifies that
|
|
Packit |
2fc92b |
.B ipptool
|
|
Packit |
2fc92b |
will continue past errors.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-L
|
|
Packit |
2fc92b |
Specifies that requests should be sent using the HTTP/1.0 "Content\-Length:" header, which is required for conformance by all versions of IPP.
|
|
Packit |
2fc92b |
The default is to use "Transfer\-Encoding: chunked" for requests with attached files and "Content\-Length:" for requests without attached files.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.BI \-P \ filename.plist
|
|
Packit |
2fc92b |
Specifies that the test results should be written to the named XML (Apple plist) file in addition to the regular test report (\fB\-t\fR).
|
|
Packit |
2fc92b |
This option is incompatible with the \fB\-i\fR (interval) and \fB\-n\fR (repeat\-count) options.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-S
|
|
Packit |
2fc92b |
Forces (dedicated) TLS encryption when connecting to the server.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.BI \-T \ seconds
|
|
Packit |
2fc92b |
Specifies a timeout for IPP requests in seconds.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.BI \-V \ version
|
|
Packit |
2fc92b |
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.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-X
|
|
Packit |
2fc92b |
Specifies that XML (Apple plist) output is desired instead of the plain text report.
|
|
Packit |
2fc92b |
This option is incompatible with the \fB\-i\fR (interval) and \fB\-n\fR (repeat\-count) options.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-c
|
|
Packit |
2fc92b |
Specifies that CSV (comma\-separated values) output is desired instead of the plain text output.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.BI \-d \ name=value
|
|
Packit |
2fc92b |
Defines the named variable.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.BI \-f \ filename
|
|
Packit |
2fc92b |
Defines the default request filename for tests.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-h
|
|
Packit |
2fc92b |
Validate HTTP response headers.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.BI \-i \ seconds
|
|
Packit |
2fc92b |
Specifies that the (last)
|
|
Packit |
2fc92b |
.I testfile
|
|
Packit |
2fc92b |
should be repeated at the specified interval.
|
|
Packit |
2fc92b |
This option is incompatible with the \fB\-X\fR (XML plist output) option.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-l
|
|
Packit |
2fc92b |
Specifies that plain text output is desired.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.BI \-n \ repeat\-count
|
|
Packit |
2fc92b |
Specifies that the (last)
|
|
Packit |
2fc92b |
.I testfile
|
|
Packit |
2fc92b |
should be repeated the specified number of times.
|
|
Packit |
2fc92b |
This option is incompatible with the \fI\-X\fR (XML plist output) option.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-q
|
|
Packit |
2fc92b |
Be quiet and produce no output.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-t
|
|
Packit |
2fc92b |
Specifies that CUPS test report output is desired instead of the plain text output.
|
|
Packit |
2fc92b |
.TP 5
|
|
Packit |
2fc92b |
.B \-v
|
|
Packit |
2fc92b |
Specifies that all request and response attributes should be output in CUPS test mode (\fB\-t\fR).
|
|
Packit |
2fc92b |
This is the default for XML output.
|
|
Packit |
2fc92b |
.SH EXIT STATUS
|
|
Packit |
2fc92b |
The
|
|
Packit |
2fc92b |
.B ipptool
|
|
Packit |
2fc92b |
program returns 0 if all tests were successful and 1 otherwise.
|
|
Packit |
2fc92b |
.SH FILES
|
|
Packit |
2fc92b |
The following standard files are available:
|
|
Packit |
2fc92b |
.nf
|
|
Packit |
2fc92b |
.I color.jpg
|
|
Packit |
2fc92b |
.I create\-printer\-subscription.test
|
|
Packit |
2fc92b |
.I document\-a4.pdf
|
|
Packit |
2fc92b |
.I document\-a4.ps
|
|
Packit |
2fc92b |
.I document\-letter.pdf
|
|
Packit |
2fc92b |
.I document\-letter.ps
|
|
Packit |
2fc92b |
.I get\-completed\-jobs.test
|
|
Packit |
2fc92b |
.I get\-jobs.test
|
|
Packit |
2fc92b |
.I get\-notifications.test
|
|
Packit |
2fc92b |
.I get\-printer\-attributes.test
|
|
Packit |
2fc92b |
.I get\-subscriptions.test
|
|
Packit |
2fc92b |
.I gray.jpg
|
|
Packit |
2fc92b |
.I ipp\-1.1.test
|
|
Packit |
2fc92b |
.I ipp\-2.0.test
|
|
Packit |
2fc92b |
.I ipp\-2.1.test
|
|
Packit |
2fc92b |
.I ipp\-2.2.test
|
|
Packit |
2fc92b |
.I ipp\-everywhere.test
|
|
Packit |
2fc92b |
.I onepage\-a4.pdf
|
|
Packit |
2fc92b |
.I onepage\-a4.ps
|
|
Packit |
2fc92b |
.I onepage\-letter.pdf
|
|
Packit |
2fc92b |
.I onepage\-letter.ps
|
|
Packit |
2fc92b |
.I print\-job.test
|
|
Packit |
2fc92b |
.I print\-job\-deflate.test
|
|
Packit |
2fc92b |
.I print\-job\-gzip.test
|
|
Packit |
2fc92b |
.I testfile.jpg
|
|
Packit |
2fc92b |
.I testfile.pcl
|
|
Packit |
2fc92b |
.I testfile.pdf
|
|
Packit |
2fc92b |
.I testfile.ps
|
|
Packit |
2fc92b |
.I testfile.txt
|
|
Packit |
2fc92b |
.I validate\-job.test
|
|
Packit |
2fc92b |
.fi
|
|
Packit |
2fc92b |
.SH CONFORMING TO
|
|
Packit |
2fc92b |
The
|
|
Packit |
2fc92b |
.B ipptool
|
|
Packit |
2fc92b |
program is unique to CUPS and conforms to the Internet Printing Protocol up to version 2.2.
|
|
Packit |
2fc92b |
.SH EXAMPLES
|
|
Packit |
2fc92b |
Get a list of completed jobs for "myprinter":
|
|
Packit |
2fc92b |
.nf
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
ipptool ipp://localhost/printers/myprinter get\-completed\-jobs.test
|
|
Packit |
2fc92b |
.fi
|
|
Packit |
2fc92b |
.LP
|
|
Packit |
2fc92b |
Send email notifications to "user@example.com" when "myprinter" changes:
|
|
Packit |
2fc92b |
.nf
|
|
Packit |
2fc92b |
|
|
Packit |
2fc92b |
ipptool \-d recipient=mailto:user@example.com \\
|
|
Packit |
2fc92b |
ipp://localhost/printers/myprinter create\-printer\-subscription.test
|
|
Packit |
2fc92b |
.fi
|
|
Packit |
2fc92b |
.SH SEE ALSO
|
|
Packit |
2fc92b |
.BR ipptoolfile (5),
|
|
Packit |
2fc92b |
IANA IPP Registry (http://www.iana.org/assignments/ipp\-registrations),
|
|
Packit |
2fc92b |
PWG Internet Printing Protocol Workgroup (http://www.pwg.org/ipp)
|
|
Packit |
2fc92b |
RFC 8011 (http://tools.ietf.org/html/rfc8011),
|
|
Packit |
2fc92b |
.SH COPYRIGHT
|
|
Packit |
2fc92b |
Copyright \[co] 2007-2017 by Apple Inc.
|