File: index.html

package info (click to toggle)
qprint 1.1.dfsg.2-2.1
  • links: PTS
  • area: main
  • in suites: bookworm, bullseye, sid
  • size: 592 kB
  • sloc: ansic: 715; sh: 152; makefile: 151
file content (240 lines) | stat: -rw-r--r-- 7,746 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<title>QPRINT: Encode and Decode Quoted-Printable Files</title>
<style type="text/css">
    body {
        margin-left: 15%;
        margin-right: 10%;
	background-color: #FFFFFF;
	color: #000000;
    }
    
    dt {
    	margin-top: 1ex;
    }
</style>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="keywords" content="qprint, encode, decode, utility, RFC 1521, MIME" />
<meta name="description" content="qprint: Encode and Decode Quoted-Printable Files" />
<meta name="author" content="John Walker" />
<meta name="robots" content="index" />
<meta name="robots" content="nofollow" />
</head>

<body>

<center>
<h1><img src="qprint.png" width="491" height="181"
    alt="qprint: Encode and Decode Quoted-Printable Files" /></h1>
</center>

<hr />

<p>

This page describes, in Unix manual page style,
a program
<a href="#Download">available for downloading</a> from this site
which encodes binary files in the "Quoted-Printable" format used by
MIME-encoded documents such as electronic mail messages with
embedded images and audio files.
</p>

<h3>NAME</h3>
<blockquote>
     <b>qprint</b> - encode and decode Quoted-Printable files
</blockquote>

<h3>SYNOPSIS</h3>
<blockquote>
     <tt>qprint</tt> [ <tt>-d</tt> /  <tt>-e</tt> ]
           [ <em>options</em> ] [ <em>infile</em> ] [ <em>outfile</em> ]
</blockquote>

<h3>DESCRIPTION</h3>

<p>
The MIME (Multipurpose Internet Mail Extensions) specification
(<a href="rfc1521.html">RFC 1521</a> and successors)
defines a mechanism for encoding text consisting primarily
of printable ASCII characters, but which may contain characters
(for example, accented letters in the ISO&nbsp;8859 Latin-1
character set) which cannot be encoded as 7-bit ASCII or
are non-printable characters which may confuse mail transfer
agents.
</p>

<p>
<b>qprint</b>
is a command line utility which encodes and decodes files in this format.
It can be used within a pipeline as an encoding or decoding filter,
and is most commonly used in this manner as part of an automated
mail processing system.  With appropriate options, <b>qprint</b>
can encode pure binary files, but it's a poor choice since it may
inflate the size of the file by as much as a factor of three.
The <a href="../base64/"><b>base64</b></a> MIME encoding is a
better choice for such data.
</p>

<h3>OPTIONS</h3>
<dl compact="compact">

<dt><b>-b</b>, <b>--binary</b></dt>
<dd>
Treat the input (when encoding) or output (when decoding) file
as pure binary, and process end of line sequences as binary
data.  Encoding and decoding a file with this option preserves
the exact sequence of bytes in the input, but does not perform
the translation of end of line sequences normally performed by
Quoted-Printable encoding.
</dd>

<dt><b>--copyright</b></dt>
<dd>
Print copyright information.
</dd>

<dt><b>-d</b>, <b>--decode</b></dt>
<dd>
Decodes the input, previously created by <b>qprint</b>, to recover the
original input file.
</dd>

<dt><b>-e</b>, <b>--encode</b></dt>
<dd>
Encodes the input into an output text file containing
its Quoted-Printable encoding.
</dd>

<dt><b>-i</b>, <b>--ebcdic</b></dt>
<dd>
Encode ASCII characters for which no equivalent exists in
the EBCDIC character set.  This renders files more portable
when transported to EBCDIC systems.
</dd>

<dt><b>-n</b>, <b>--noerrcheck</b></dt>
<dd>
Suppress error checking when decoding.  By default, if an
incorrectly encoded escape sequence is encountered, a
warning message is printed.  This option suppresses
the warning messages; the only indication that an
improperly encoded file was read will be the program
returning exit status 1 at the end of the input file.
In either case, incorrect escape sequences are discarded.
</dd>

<dt><b>-p</b>, <b>--paranoid</b></dt>
<dd>
Every character in the input file will be encoded as an
escape sequence.  You must also specify the <b>-b</b> or
<b>--binary</b> option if you wish end of line sequences
to be escaped as well.  This option is a last resort when
there's no other way to transmit the file, but an encoding
explicitly designed for binary data such as
<a href="../base64/">Base64</a> is a much more economical
choice.
</dd>

<dt><b>-u</b>, <b>--help</b></dt>
<dd> Print how to call information and a summary of options.
</dd>

<dt><b>--version</b></dt>
<dd>Print program version information.
</dd>
</dl>

<h3>EXIT STATUS</h3>

<p>
<b>qprint</b> returns status 0 if processing was completed without
errors, 1 if an I/O error occurred or errors were detected in decoding
a file which indicate it is incorrect or incomplete, and 2 if
processing could not be performed at all due, for example, to a
nonexistent input file.
</p>

<h3><a name="files">FILES</a></h3>

<p>
If no <i>infile</i> is specified or <i>infile</i> is a single "-",
<b>qprint</b> reads from standard input; if no <i>outfile</i> is
given, or <i>outfile</i> is a single "-", output is sent to standard
output.  The input and output are processed strictly serially;
consequently <b>qprint</b> may be used in pipelines.  The program
can process files of any size supported by the system containing text
lines of arbitrary length.
</p>

<h3>BUGS</h3>

<p>
Encoding a file with a large percentage of non-ASCII characters
may dramatically increase its size.  This is inherent in the
design of Quoted-Printable encoding.
</p>

<h3>SEE ALSO</h3>
     <a href="../base64/"><b>base64</b></a>(1),
     <a href="rfc1521.html" target="_blank">RFC&nbsp;1521</a>

<h2><a name="Download" href="qprint-1.0.tar.gz"><img src="/images/icons/file.gif"
    alt="" align="middle" width="40" height="40" border="0" /></a>
    <a href="qprint-1.0.tar.gz">Download qprint-1.0.tar.gz</a> (Gzipped TAR archive)</h2>
<p>
The archive contains source code for the utility, a Makefile
for Unix systems, and a ready-to-run executable for 32-bit
Windows platforms.  Windows users may also download
<a href="qprint.zip"><b><tt>qprint.zip</tt></b></a>, a
ZIPped archive containing the Windows executable.
</p>

<h3><a href="qprint.pdf">Read <b>qprint</b> source code</a> (requires
    	<a href="http://www.adobe.com/acrobat/readstep.html" target="_blank">Acrobat Reader</a>)</h3>

<h3>AUTHOR</h3>
<address>
          <a href="/">John Walker</a><br />
          <a href="/">http://www.fourmilab.ch/</a>
</address>

<blockquote>
     This software is in the public domain.  Permission to use, copy,
     modify, and distribute this software and its documentation for
     any purpose and without fee is hereby granted, without any
     conditions or restrictions.  This software is provided "as is"
     without express or implied warranty.
</blockquote>

<p />
<hr />
<p />
<table align="right">
<tr><td align="center">
<form name="feedback" method="post" action="/cgi-bin/FeedbackForm.pl">
<input type="hidden" name="pagetitle" value="&lt;cite&gt;Qprint&lt;/cite&gt;" />
<input type="hidden" name="backlink" value="Back to &lt;cite&gt;Qprint&lt;/cite&gt;" />
<input type="submit" value=" Send Feedback " />
</form>
</td></tr>
<tr><td align="center">
    <a href="http://validator.w3.org/check?uri=referer"
       target="FourmilabValidation"><img
       src="/images/icons/valid-xhtml10.png"
       alt="Valid XHTML 1.0" height="31" width="88"
       border="0" /></a>
</td></tr>
</table>
<address>
by <a href="/">John Walker</a><br />
5th March 2001<br />
Version 1.0<br />
The latest version of this program is available from:<br />
<a href="http://www.fourmilab.ch/webtools/qprint/">http://www.fourmilab.ch/webtools/qprint/</a>.
</address>

</body>
</html>