ipptool man page on ElementaryOS

Man page or keyword search:  
man Server   4994 pages
apropos Keyword Search (all sections)
Output format
ElementaryOS logo
[printable version]

ipptool(1)			  Apple Inc.			    ipptool(1)

NAME
       ipptool - perform internet printing protocol requests

SYNOPSIS
       ipptool	[ --help ] [ --stop-after-include-error ] [ --version ] [ -4 ]
       [ -6 ] [ -C ] [ -E ] [ -I ] [ -L ] [ -S ] [ -T seconds ] [ -V version ]
       [  -X  ]	 [  -c ] [ -d name=value ] [ -f filename ] [ -i seconds ] [ -n
       repeat-count ] [ -q ] [ -t ] [ -v ] URI filename [ ... filenameN ]

DESCRIPTION
       ipptool sends IPP requests to the specified URI and tests  and/or  dis‐
       plays  the  results.  Each  named  file	defines	 one or more requests,
       including the expected response status, attributes, and values.	Output
       is either a plain text, formatted text, CSV, or XML report on the stan‐
       dard output, with a non-zero exit status indicating that	 one  or  more
       tests have failed. The file format is described in ipptoolfile(5).

OPTIONS
       The following options are recognized by ipptool:

       --help
	    Shows program help.

       --stop-after-include-error
	    Tells ipptool to stop if an error occurs in an included file. Nor‐
	    mally ipptool  will	 continue  with	 subsequent  tests  after  the
	    INCLUDE directive.

       --version
	    Shows the version of ipptool being used.

       -4   Specifies that ipptool must connect to the printer or server using
	    IPv4.

       -6   Specifies that ipptool must connect to the printer or server using
	    IPv6.

       -C   Specifies  that requests should be sent using the HTTP/1.1 "Trans‐
	    fer-Encoding: chunked" header, which is required  for  conformance
	    by	all versions of IPP. The default is to use "Transfer-Encoding:
	    chunked" for requests with attached	 files	and  "Content-Length:"
	    for requests without attached files.

       -E   Forces TLS encryption when connecting to the server using the HTTP
	    "Upgrade" header.

       -I   Specifies that ipptool will continue past errors.

       -L   Specifies that requests should be sent using  the  HTTP/1.0	 "Con‐
	    tent-Length:"  header,  which  is  required for conformance by all
	    versions of IPP. The default is to use  "Transfer-Encoding:	 chun‐
	    ked"  for  requests	 with attached files and "Content-Length:" for
	    requests without attached files.

       -S   Forces (dedicated) SSL encryption when connecting to the server.

       -T seconds
	    Specifies a timeout for IPP requests in seconds.

       -V version
	    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.

       -X   Specifies  that XML (Apple plist) output is desired instead of the
	    plain text report. This option is incompatible with the -i (inter‐
	    val) and -n (repeat-count) options.

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

       -d name=value
	    Defines the named variable.

       -f filename
	    Defines the default request filename for tests.

       -i seconds
	    Specifies that the (last) file should be repeated at the specified
	    interval.  This option is incompatible with the -X (XML plist out‐
	    put) option.

       -l   Specifies that plain text output is desired.

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

       -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 out‐
	    put in CUPS test mode (-t). This is the default for XML output.

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

COMPATIBILITY
       The ipptool program is unique to CUPS.

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

STANDARD 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

SEE ALSO
       ipptoolfile(5), RFC 2911,
       http://localhost:631/help
       http://www.iana.org/assignments/ipp-registrations
       http://www.pwg.org/ipp

COPYRIGHT
       Copyright 2007-2014 by Apple Inc.

20 February 2014		     CUPS			    ipptool(1)
[top]

List of man pages available for ElementaryOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net