Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
qprint(1)		    General Commands Manual		     qprint(1)

NAME
       qprint -	encode / decode	file as	RFC 1521 MIME Quoted-Printable

SYNOPSIS
       qprint -d|-e [ options ]	[ infile [ outfile ] ]

DESCRIPTION
       The MIME	(Multipurpose Internet Mail Extensions)	specification RFC 1521
       and successors) defines a mechanism for encoding	text  consisting  pri-
       marily  of printable ASCII characters, but which	may contain characters
       (for example, accented letters in the ISO 8859 Latin-1  character  set)
       which  cannot be	encoded	as 7-bit ASCII or are non-printable characters
       which may confuse mail transfer agents.

       qprint is a command line	utility	which encodes  and  decodes  files  in
       this format.  It	can be used within a pipeline as an encoding or	decod-
       ing filter, and is most commonly	used in	this manner as part of an  au-
       tomated	mail  processing system.  With appropriate options, qprint 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 Base64 MIME
       encoding	is a better choice for such data.

OPTIONS
       -b, --binary
		   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.

       --copyright Print program copyright information.

       -d, --decode
		   Decodes the input, previously created by qprint, to recover
		   the original	input file.

       -e, --encode
		   Encodes the input into an output text file  containing  its
		   qprint encoding.

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

       -n, --noerrcheck
		   Suppress  error  checking  when decoding.  By default, upon
		   encountering	a non white space character which does not be-
		   long	 to  the  qprint set, or discovering the input file is
		   incorrectly padded to a multiple of four characters,	qprint
		   issues an error message and terminates processing with exit
		   status 1.  The -n option suppresses even  this  rudimentary
		   error checking; invalid characters are silently ignored and
		   the output truncated	to the last three valid	octets if  the
		   input is incorrectly	padded.

       -p ,--paranoid
		   Every character in the input	file will be encoded as	an es-
		   cape	sequence.  You must also specify the  -b  or  --binary
		   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 de-
		   signed for binary data such as Base64 is a much  more  eco-
		   nomical choice.

       -u, --help  Print how-to-call information.

       --version   Print program version information.

EXIT STATUS
       qprint  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.

FILES
       If no infile is specified or infile is a	 single	 ``-'',	 qprint	 reads
       from  standard  input;  if  no outfile is given,	or outfile is a	single
       ``-'', output is	sent to	standard output.  The  input  and  output  are
       processed  strictly  serially; consequently qprint may be used in pipe-
       lines.  The program can process files of	any size supported by the sys-
       tem containing text lines of arbitrary length.

BUGS
       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.

       Please report bugs and documentation errors to bugs@fourmilab.ch.

SEE ALSO
       base64(1), uuencode(1), RFC1521

AUTHOR
	    John Walker
	    http://www.fourmilab.ch/

       This  software  is in the public	domain.	 Permission to use, copy, mod-
       ify, and	distribute this	software and its documentation for any purpose
       and  without  fee is hereby granted, without any	conditions or restric-
       tions.  This software is	provided ``as is'' without express or  implied
       warranty.

       This is version 1.1 of qprint.  The current version of this program may
       be downloaded from http://www.fourmilab.ch/webtools/qprint.

4th Berkeley Distribution	  16 DEC 2014			     qprint(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | FILES | BUGS | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=qprint&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help