ipptool(1)                       OpenPrinting                       ipptool(1)

<?><?><?> (NAME)
       ipptool - <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?> (IPP)

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       ipptool [ --help ] [ --ippserver filename ] [
       --stop-after-include-error ] [ --version ] [ -4 ] [ -6 ] [ -C ] [ -E ]
       [ -I ] [ -L ] [ -P filename.plist ] [ -S ] [ -T seconds ] [ -V version
       ] [ -X ] [ -c ] [ -d name=value ] [ -f filename ] [ -h ] [ -i seconds ]
       [ -j ] [ -n repeat-count ] [ -q ] [ -t ] [ -v ] printer-uri testfile [
       ...  testfile ]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> ipptool <?><?><?><?><?><?><?><?><?><?><?> IPP <?><?>
       <?><?> printer-uri <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?>/<?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?> testfile
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> (attributes) <?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.  <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> CSV <?><?> XML <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?>.  <?><?><?><?> testfile <?><?>
       ipptoolfile(5) <?><?><?> <?><?><?><?> <?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> ipptool
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>:

       --help
            <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?><?>.

       --ippserver filename
            <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?><?> (attributes) ippserver
            <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       --stop-after-include-error
            <?><?> ipptool <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
            <?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?> (included)<?> <?><?><?><?><?>
            <?><?><?>. <?><?> <?><?><?><?> <?><?><?><?> ipptool <?><?> <?><?>
            <?><?><?><?><?><?><?><?><?><?> INCLUDE <?><?>
            <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?>.

       --version
            <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> ipptool
            <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       -4   <?><?><?><?> <?><?><?><?><?><?> <?><?> ipptool <?><?><?><?> <?><?>
            <?><?><?><?><?><?><?> <?><?> IPv4 <?><?> <?><?><?><?><?> <?><?>
            <?><?><?><?> <?><?><?><?> <?><?><?>.

       -6   <?><?><?><?> <?><?><?><?><?><?> <?><?> ipptool <?><?><?><?> <?><?>
            <?><?><?><?><?><?><?> <?><?> IPv6 <?><?> <?><?><?><?><?> <?><?>
            <?><?><?><?> <?><?><?><?> <?><?><?>.

       -C   <?><?><?><?> <?><?><?><?><?><?> <?><?>
            <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
            <?><?><?><?><?><?><?> <?><?> <?><?><?> HTTP/1.1 <?><?>
            <?><?><?><?><?> "Transfer-Encoding: chunked" <?><?><?><?><?>
            <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
            <?><?><?><?><?> <?><?><?><?><?><?><?><?> IPP <?><?><?><?><?><?>
            <?><?><?>.  <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
            "Transfer-Encoding: chunked" <?> <?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> "Content-Length:"
            <?><?><?>.

       -E   <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
            <?><?><?><?><?><?><?> <?><?> <?><?><?> HTTP <?><?> <?><?><?><?><?>
            "Upgrade"<?> <?><?><?><?><?><?><?><?> TLS <?><?>
            <?><?><?><?><?><?> <?><?><?><?><?><?>.

       -I   <?><?><?><?> <?><?><?><?><?><?> <?><?> ipptool <?><?> <?><?><?><?>
            <?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
            <?><?><?>.

       -L   <?><?><?><?> <?><?><?><?><?><?> <?><?>
            <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
            <?><?><?><?><?><?><?> <?><?> <?><?><?> HTTP/1.0 <?><?>
            <?><?><?><?><?> "Content-Length:" <?><?><?><?><?> <?><?><?><?><?>
            <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?><?> IPP <?><?><?><?><?><?> <?><?><?>.
            <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
            "Transfer-Encoding: chunked" <?> <?><?><?><?>
            <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> "Content-Length:"
            <?><?><?>.

       -P filename.plist
            <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?> <?><?><?><?><?> (-t)<?> <?><?><?><?> <?><?>
            <?><?><?><?> XML (Apple plist) <?><?><?><?><?><?><?><?> <?><?><?>
            <?><?><?><?><?> <?><?><?>.  <?><?><?> <?><?><?><?><?> <?><?>
            <?><?><?><?><?><?><?><?><?> -i (<?><?><?><?><?> <?><?><?><?><?>)
            <?> -n (<?><?><?><?><?> <?><?><?><?><?>) <?><?><?><?><?><?><?><?>
            <?><?><?>.

       -S   <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> TLS <?><?>
            <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
            <?><?><?><?><?><?> <?><?><?><?><?><?>.

       -T seconds
            <?><?><?><?> <?><?><?><?><?> (<?><?><?><?><?><?><?><?>)
            <?><?><?><?><?><?><?><?><?><?><?> IPP <?><?> <?><?> <?><?><?>
            <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       -V version
            <?><?><?><?> <?><?><?><?><?><?><?> IPP <?><?><?><?>
            <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>:
            1.0<?> 1.1<?> 2.0<?> 2.1 <?><?> 2.2. <?><?><?> <?><?><?><?>
            <?><?><?><?><?> <?><?> <?><?><?><?> 1.1 <?><?><?><?><?><?><?>
            <?><?><?><?><?><?>.

       -X   <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> XML (Apple
            plist) <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
            <?><?><?><?> <?><?> <?><?><?> <?><?><?>.  <?><?><?>
            <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> -i
            (<?><?><?><?><?> <?><?><?><?><?>) <?> -n (<?><?><?><?><?>
            <?><?><?><?><?>) <?><?><?><?><?><?><?><?> <?><?><?>.

       -c   <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> CSV
            (<?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>)
            <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
            <?><?> <?><?><?> <?><?><?>.

       -d name=value
            <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?><?>.

       -f filename
            <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
            <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?>.

       -h   <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
            HTTP.

       -i seconds
            <?><?><?><?> <?><?><?><?><?><?> <?><?> (<?><?><?><?><?>) testfile
            <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.  <?><?><?>
            <?><?><?><?><?> <?><?> <?><?><?><?><?> -X (<?><?><?><?><?> XML
            plist) <?><?><?><?><?><?><?><?> <?><?><?>.

       -j   <?><?><?><?> <?><?><?><?><?><?> <?><?> ipptool <?><?><?><?><?>
            JSON <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       -l   <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?>.

       -n repeat-count
            <?><?><?><?> <?><?><?><?><?><?> <?><?> (<?><?><?><?><?>) testfile
            <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.  <?><?><?>
            <?><?><?><?><?> <?><?> <?><?><?><?><?> -X (<?><?><?><?><?> XML
            plist) <?><?><?><?><?><?><?><?> <?><?><?>.

       -q   <?><?><?><?><?><?> <?><?><?> <?><?><?> <?> <?><?><?>
            <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       -t   <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?> <?><?><?><?><?><?><?> CUPS <?><?><?><?><?><?>
            <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
            <?><?><?>.

       -v   <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
            <?><?><?><?><?><?><?><?><?> (attributes) <?><?><?><?><?><?><?> <?>
            <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
            <?><?><?><?><?><?><?> CUPS (-t) <?><?> <?><?><?><?><?> <?><?><?>
            <?><?><?><?>.  <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
            <?><?><?><?> <?><?><?><?><?> XML <?><?><?>.

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?><?><?><?><?> ipptool <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> 0 <?> <?><?> <?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?> 1 <?><?>
       <?><?><?><?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (FILES)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?>:

           color.jpg
           create-printer-subscription.test
           document-a4.pdf
           document-a4.ps
           document-letter.pdf
           document-letter.ps
           get-completed-jobs.test
           get-jobs.test
           get-notifications.test
           get-printer-attributes.test
           get-subscriptions.test
           gray.jpg
           ipp-1.1.test
           ipp-2.0.test
           ipp-2.1.test
           ipp-2.2.test
           ipp-everywhere.test
           onepage-a4.pdf
           onepage-a4.ps
           onepage-letter.pdf
           onepage-letter.ps
           print-job.test
           print-job-deflate.test
           print-job-gzip.test
           testfile.jpg
           testfile.pcl
           testfile.pdf
           testfile.ps
           testfile.txt
           validate-job.test

<?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> (CONFORMING TO)
       <?><?><?><?><?><?> ipptool <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       CUPS <?><?><?> <?> <?><?> <?><?><?><?> 2.2 <?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?><?> (Internet Printing Protocol)
       <?><?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <<myprinter>>:

           ipptool ipp://localhost/printers/myprinter get-completed-jobs.test

       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <<user@example.com>> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <<myprinter>>:

           ipptool -d recipient=mailto:user@example.com \
               ipp://localhost/printers/myprinter create-printer-subscription.test

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       ipptoolfile(5), <?><?><?><?><?><?><?><?><?><?><?> IPP <?><?> IANA
       (https://www.iana.org/assignments/ipp-registrations),
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> PWG (https://www.pwg.org/ipp), RFC 8011
       (https://datatracker.ietf.org/doc/html/rfc8011)

<?><?> <?><?><?> (COPYRIGHT)
       Copyright (C) 2020-2024 by OpenPrinting.

2021-10-20                           CUPS                           ipptool(1)