.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH dump 1 "July 2022" "sq 0.26.0" "Sequoia Manual"
.SH NAME
dump \- Lists packets
.SH SYNOPSIS
\fBdump\fR [\fB\-o\fR|\fB\-\-output\fR] [\fB\-\-session\-key\fR] [\fB\-\-mpis\fR] [\fB\-x\fR|\fB\-\-hex\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIFILE\fR] 
.SH DESCRIPTION
.PP
Lists packets
.PP
Creates a human\-readable description of the packet sequence.
Additionally, it can print cryptographic artifacts, and print the raw
octet stream similar to hexdump(1), annotating specifically which
bytes are parsed into OpenPGP values.
.PP
To inspect encrypted messages, either supply the session key, or see
"sq decrypt \-\-dump" or "sq packet decrypt".
.SH OPTIONS
.TP
\fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
Writes to FILE or stdout if omitted
.TP
\fB\-\-session\-key\fR=\fISESSION\-KEY\fR
Decrypts an encrypted message using SESSION\-KEY
.TP
\fB\-\-mpis\fR
Prints cryptographic artifacts
.TP
\fB\-x\fR, \fB\-\-hex\fR
Prints a hexdump
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help information
.TP
[\fIFILE\fR]
Reads from FILE or stdin if omitted
.SH EXAMPLES
 Prints the packets of a certificate
.PP
.nf
.RS
 sq packet dump juliet.pgp
.RE
.fi
.PP
 Prints cryptographic artifacts of a certificate
.PP
.nf
.RS
 sq packet dump \-\-mpis juliet.pgp
.RE
.fi
.PP
 Prints a hexdump of a certificate
.PP
.nf
.RS
 sq packet dump \-\-hex juliet.pgp
.RE
.fi
.PP
 Prints the packets of an encrypted message
.PP
.nf
.RS
 sq packet dump \-\-session\-key AAAABBBBCCCC... ciphertext.pgp
.RE
.fi
.SH "SEE ALSO"
For the full documentation see <https://docs.sequoia\-pgp.org/sq/>.
.PP
sq(1)
sq\-armor(1)
sq\-autocrypt(1)
sq\-certify(1)
sq\-dearmor(1)
sq\-decrypt(1)
sq\-encrypt(1)
sq\-inspect(1)
sq\-key(1)
sq\-keyring(1)
sq\-keyserver(1)
sq\-packet(1)
sq\-packet\-decrypt(1)
sq\-packet\-join(1)
sq\-packet\-split(1)
sq\-revoke(1)
sq\-sign(1)
sq\-verify(1)
sq\-wkd(1)