ipptool Options: CUPS Test Report and Exit Status

3rd chunk of `ipptool.man`

6c4a21e091e446412438b584353380d64e270c3e339dfabd0000000100000c63

        val) and -n (repeat-count) options.

       -c   Specifies  that  CSV (comma-separated values) output is desired in‐
            stead of the plain text output.

       -d name=value
            Defines the named variable.

       -f filename
            Defines the default request filename for tests.

       -h   Validate HTTP response headers.

       -i seconds
            Specifies that the (last) testfile should be repeated at the speci‐
            fied interval.  This option is incompatible with the -X (XML  plist
            output) option.

       -j   Specifies that ipptool will produce JSON output.

       -l   Specifies that plain text output is desired.

       -n repeat-count
            Specifies that the (last) testfile should be repeated the specified
            number  of  times.   This  option  is incompatible with the -X (XML
            plist output) option.

       -q   Be quiet and produce no output.

       -t   Specifies that CUPS test report output is desired  instead  of  the
            plain text output.

       -v   Specifies that all request and response attributes should be output
            in CUPS test mode (-t).  This is the default for XML output.

EXIT STATUS
       The  ipptool program returns 0 if all tests were successful and 1 other‐
       wise.

FILES
       The following standard files are available:

           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
       The ipptool program is unique to  CUPS  and  conforms  to  the  Internet
       Printing Protocol up to version 2.2.

EXAMPLES
       Get a list of completed jobs for "myprinter":

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

       Send email notifications to "user@example.com" when "myprinter" changes:

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

SEE ALSO
       ipptoolfile(5),    IANA   IPP   Registry   (https://www.iana.org/assign‐
       ments/ipp-registrations),  PWG  Internet  Printing  Protocol   Workgroup
       (https://www.pwg.org/ipp)         RFC         8011        (https://data‐
       tracker.ietf.org/doc/html/rfc8011),

COPYRIGHT
       Copyright © 2021‐2023 by OpenPrinting.

2021‐10‐20                            CUPS                           ipptool(1)

Title: ipptool Options: CUPS Test Report and Exit Status

Summary

This section provides a comprehensive list of `ipptool` options, covering various functionalities such as generating CUPS test reports, displaying request/response attributes, and specifying output formats like JSON and plain text. It also describes the program's exit status, standard files, conformance to the Internet Printing Protocol, usage examples, related documentation, and copyright information.