← Back to branch summary

~ubuntu-branches/ubuntu/wily/cups/wily

« back to all changes in this revision

Viewing changes to man/ipptool.man

  • Committer: Package Import Robot
  • Author(s): Didier Raboud
  • Date: 2013-05-03 11:30:59 UTC
  • mfrom: (100.1.11 experimental)
  • Revision ID: package-import@ubuntu.com-20130503113059-u4vwqd3op51vu7o7
Update the patch adding libusb error handling to also discard its
errors in the counting of warning messages; this should make the
error-suite succeed in more cases.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/ipptool.man
13
13
.\"
14
14
.TH ipptool 1 "CUPS" "9 November 2010" "Apple Inc."
15
15
.SH NAME
16
 
ipptool - perform internet printing protocol requests
 
16
ipptool \- perform internet printing protocol requests
17
17
.SH SYNOPSIS
18
18
.B ipptool
19
 
[ -4 ] [ -6 ] [ -C ] [ -E ] [ -I ] [ -L ] [ -S ] [ -T
 
19
[ \-4 ] [ \-6 ] [ \-C ] [ \-E ] [ \-I ] [ \-L ] [ \-S ] [ \-T
20
20
.I seconds
21
 
] [ -V
 
21
] [ \-V
22
22
.I version
23
 
] [ -X ] [ -c ] [ -d
 
23
] [ \-X ] [ \-c ] [ \-d
24
24
.I name=value
25
 
] [ -f
 
25
] [ \-f
26
26
.I filename
27
 
] [ -i
 
27
] [ \-i
28
28
.I seconds
29
 
] [ -n
 
29
] [ \-n
30
30
.I repeat-count
31
 
] [ -q ] [ -t ] [ -v ]
 
31
] [ \-q ] [ \-t ] [ \-v ]
32
32
.I URI
33
33
.I filename
34
34
[
39
39
.SH OPTIONS
40
40
The following options are recognized by \fIipptool\fR:
41
41
.TP 5
42
 
-4
 
42
\-4
43
43
Specifies that \fIipptool\fR must connect to the printer or server using IPv4.
44
44
.TP 5
45
 
-6
 
45
\-6
46
46
Specifies that \fIipptool\fR must connect to the printer or server using IPv6.
47
47
.TP 5
48
 
-C
 
48
\-C
49
49
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. The default is to use "Transfer-Encoding: chunked" for requests with attached files and "Content-Length:" for requests without attached files.
50
50
.TP 5
51
 
-E
 
51
\-E
52
52
Forces TLS encryption when connecting to the server using the HTTP "Upgrade" header.
53
53
.TP 5
54
 
-I
 
54
\-I
55
55
Specifies that \fIipptool\fR will continue past errors.
56
56
.TP 5
57
 
-L
 
57
\-L
58
58
Specifies that requests should be sent using the HTTP/1.0 "Content-Length:" 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.
59
59
.TP 5
60
 
-S
 
60
\-S
61
61
Forces (dedicated) SSL encryption when connecting to the server.
62
62
.TP 5
63
 
-T seconds
 
63
\-T seconds
64
64
Specifies a timeout for IPP requests in seconds.
65
65
.TP 5
66
 
-V version
 
66
\-V version
67
67
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.
68
68
.TP 5
69
 
-X
 
69
\-X
70
70
Specifies that XML (Apple plist) output is desired instead of the plain text report. This option is incompatible with the \fI-i\fR (interval) and \fI-n\fR (repeat-count) options.
71
71
.TP 5
72
 
-c
 
72
\-c
73
73
Specifies that CSV (comma-separated values) output is desired instead of the plain text output.
74
74
.TP 5
75
 
-d name=value
 
75
\-d name=value
76
76
Defines the named variable.
77
77
.TP 5
78
 
-f filename
 
78
\-f filename
79
79
Defines the default request filename for tests.
80
80
.TP 5
81
 
-i seconds
 
81
\-i seconds
82
82
Specifies that the (last) file should be repeated at the specified interval. This option is incompatible with the \fI-X\fR (XML plist output) option.
83
83
.TP 5
84
 
-l
 
84
\-l
85
85
Specifies that plain text output is desired.
86
86
.TP 5
87
 
-n repeat-count
 
87
\-n repeat-count
88
88
Specifies that the (last) file should be repeated the specified number of times. This option is incompatible with the \fI-X\fR (XML plist output) option.
89
89
.TP 5
90
 
-t
 
90
\-t
91
91
Specifies that CUPS test report output is desired instead of the plain text output.
92
92
.TP 5
93
 
-v
 
93
\-v
94
94
Specifies that all request and response attributes should be output in CUPS test mode (\fI-t\fR). This is the default for XML output.
95
95
.SH COMPATIBILITY
96
96
The \fIipptool\fR program is unique to CUPS.
102
102
.LP
103
103
Send email notifications to "user@example.com" when "myprinter" changes:
104
104
.nf
105
 
    ipptool -d recipient=mailto:user@example.com \
 
105
    ipptool \-d recipient=mailto:user@example.com \
106
106
        ipp://localhost/printers/myprinter create-printer-subscription.test
107
107
.fi
108
108
.SH STANDARD FILES