sq-packet-split1
Split a message into packets
Usage
sq packet
split
[OPTIONS]
FILE
Overview
Split a message into packets.
Splitting a packet sequence into individual packets, then recombining them freely with `sq packet join` is a great way to experiment with OpenPGP data.
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.
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`.
The converse operation is `sq packet join`.
Options
Subcommand options
-
--binary -
Emit binary data
-
--output=FILE -
Write to FILE or stdout if omitted
-
--output-prefix=PREFIX -
Write packets to individual files starting with the given prefix.
-
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 ('-').
- FILE
-
Read from FILE or stdin if FILE is '-'
-
[default:
-]
Global options
See sq(1) for a description of the global options.
Examples
Split a certificate into individual packets printed to stdout.
sq packet split --output=- juliet.pgp
Split a inline-signed message into individual packets written to individual files with the prefix 'packet'.
sq packet split --output-prefix packet document.pgp
Then reassemble the message, transforming it into an old-style signed message with a prefix signature.
sq packet join --output prefix-signature.pgp --label message \ packet-2-Signature-Packet packet-1-Literal-Data-Packet
Version
1.4.1
Releases
4 releases since Debian 11 (Bullseye); the text changed 3 times.
--binary since Debian 13 (Trixie);
--output since Debian 13 (Trixie);
--output-prefix since Debian 13 (Trixie).
--help until Debian 12 (Bookworm);
--prefix until Debian 12 (Bookworm);
-h until Debian 12 (Bookworm);
-p until Debian 12 (Bookworm).