.TH SQ 1 1.2.0 "Sequoia PGP" "User Commands"
.SH NAME
sq packet split \- Split a message into packets
.SH SYNOPSIS
.br
\fBsq packet split\fR [\fIOPTIONS\fR] \fIFILE\fR
.SH DESCRIPTION
Split a message into packets.
.PP
Splitting a packet sequence into individual packets, then recombining them freely with `sq packet join` is a great way to experiment with OpenPGP data.
.PP
By default, the packets are written to stdout as a sequence of ASCII armored blocks.  It is possible to edit this file directly (e.g., moving, adding, or removing packets), and then use `sq packet join` to assemble the stream.
.PP
Alternatively, if a `\-\-output\-prefix` is given, the packets are written into individual files starting with the prefix, and can be reassembled with `sq packet join`.
.PP
The converse operation is `sq packet join`.
.PP


.SH OPTIONS
.SS "Subcommand options"
.TP
\fB\-\-binary\fR
Emit binary data
.TP
\fB\-\-output\fR=\fIFILE\fR
Write to FILE or stdout if omitted
.TP
\fB\-\-output\-prefix\fR=\fIPREFIX\fR
Write packets to individual files starting with the given prefix.
.IP
The file names are formed by joining the prefix, the path of the packet in the source object (recall: packets can be nested), and a human\-readable packet type with dashes ('\-').

.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
Split a certificate into individual packets printed to stdout.
.PP
.nf
.RS
sq packet split \-\-output=\- juliet.pgp
.RE
.PP
.fi

.PP
Split a inline\-signed message into individual packets written to
individual files with the prefix 'packet'.
.PP
.nf
.RS
sq packet split \-\-output\-prefix packet document.pgp
.RE
.PP
.fi

.PP
Then reassemble the message, transforming it into an old\-style signed
message with a prefix signature.
.PP
.nf
.RS
sq packet join \-\-output prefix\-signature.pgp \-\-label message \\
.RE
.RS
.RS
packet\-2\-Signature\-Packet packet\-1\-Literal\-Data\-Packet
.RE
.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.2.0 (sequoia\-openpgp 1.22.0)