sq-toolbox-packet-split - Man Page

Split a message into packets

Synopsis

sq toolbox packet split [Options] FILE

Description

Split a message into packets.

Splitting a packet sequence into individual packets, then recombining them freely with `sq toolbox 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 toolbox packet join` to assemble the stream.

Alternatively, if a `--prefix` is given, the packets are written into individual files starting with the prefix, and can be reassembled with `sq toolbox packet join`.

The converse operation is `sq toolbox packet join`.

Options

Subcommand options

--binary

Emit binary data

--output=FILE

Write to FILE or stdout if omitted

--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 toolbox packet split --output=- juliet.pgp

Split a inline-signed message into individual packets written to individual files with the prefix 'packet'.

    sq toolbox packet split --prefix packet document.pgp

Then reassemble the message, transforming it into an old-style signed message with a prefix signature.

    sq toolbox packet join --output prefix-signature.pgp --label \
    message packet-2-Signature-Packet \

packet-1-Literal-Data-Packet

See Also

sq(1), sq-toolbox(1), sq-toolbox-packet(1).

For the full documentation see <https://book.sequoia-pgp.org>.

Version

0.39.0 (sequoia-openpgp 1.21.2)

Referenced By

sq-toolbox-packet(1).

0.39.0 Sequoia PGP