.TH SQ 1 1.3.1 "Sequoia PGP" "User Commands"
.SH NAME
sq\-packet\-armor \- Convert binary to ASCII
.SH SYNOPSIS
.br
\fBsq packet armor\fR [\fIOPTIONS\fR] \fIFILE\fR
.SH DESCRIPTION
Convert binary to ASCII.
.PP
To make encrypted data easier to handle and transport, OpenPGP data can be transformed to an ASCII representation called ASCII Armor.  sq emits armored data by default, but this subcommand can be used to convert existing OpenPGP data to its ASCII\-encoded representation.
.PP
The converse operation is `sq packet dearmor`.
.PP


.SH OPTIONS
.SS "Subcommand options"
.TP
\fB\-\-label\fR=\fILABEL\fR
Select the kind of armor header
.IP
[default: \fBauto\fR]
.IP
[possible values: \fBauto\fR, \fBmessage\fR, \fBcert\fR, \fBkey\fR, \fBsig\fR, \fBfile\fR]
.TP
\fB\-\-output\fR=\fIFILE\fR
Write to FILE or stdout if omitted
.IP
[default: \fB\-\fR]
.TP
 \fIFILE\fR
Read from FILE or stdin if FILE is '\-'
.IP
[default: \fB\-\fR]
.SS "Global options"
See \fBsq\fR(1) for a description of the global options.
.SH EXAMPLES
.PP

.PP
Convert a binary OpenPGP message to an ASCII armored OpenPGP message.
.PP
.nf
.RS
sq packet armor message.bin
.RE
.PP
.fi

.PP
Convert a binary OpenPGP message to an ASCII armored OpenPGP message
explicitly choosing the armor label.
.PP
.nf
.RS
sq packet armor \-\-label=message message.bin
.RE
.fi
.SH "SEE ALSO"
.nh
\fBsq\fR(1), \fBsq\-packet\fR(1).
.hy
.PP
For the full documentation see <https://book.sequoia\-pgp.org/>.
.SH VERSION
1.3.1