jose/doc/ronn/jose-jwe-fmt.1

.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "JOSE\-JWE\-FMT" "1" "May 2017" "" ""
.
.SH "NAME"
\fBjose\-jwe\-fmt\fR \- Converts a JWE between serialization formats
.
.SH "SYNOPSIS"
\fBjose jwe fmt\fR \-i JWE [\-I CT] [\-o JWE] [\-O CT] [\-c]
.
.SH "OVERVIEW"
The \fBjose jwe fmt\fR command converts a JWE into alternative serialization formats\. For example, it can:
.
.IP "1." 4
Attach ciphertext to a detached JWE\.
.
.IP "2." 4
Detach ciphertext from a JWE\.
.
.IP "3." 4
Convert JWE Compact Serialization to JWE JSON Serialization\.
.
.IP "4." 4
Convert JWE JSON Serialization to JWE Compact Serialization\.
.
.IP "" 0
.
.SH "OPTIONS"
.
.TP
\fB\-i\fR \fIJSON\fR, \fB\-\-input\fR=\fIJSON\fR
Parse JWE from JSON
.
.TP
\fB\-i\fR \fIFILE\fR, \fB\-\-input\fR=\fIFILE\fR
Read JWE from FILE
.
.TP
\fB\-i\fR \-, \fB\-\-input\fR=\-
Read JWE from standard input
.
.TP
\fB\-I\fR \fIFILE\fR, \fB\-\-detached\fR=\fIFILE\fR
Read decoded ciphertext from FILE
.
.TP
\fB\-I\fR \-, \fB\-\-detached\fR=\-
Read decoded ciphertext from standard input
.
.TP
\fB\-o\fR \fIFILE\fR, \fB\-\-output\fR=\fIFILE\fR
Write JWE to FILE
.
.TP
\fB\-o\fR \-, \fB\-\-output\fR=\-
Write JWE to stdout (default)
.
.TP
\fB\-O\fR \fIFILE\fR, \fB\-\-detach\fR=\fIFILE\fR
Detach ciphertext and decode to FILE
.
.TP
\fB\-O\fR \-, \fB\-\-detach\fR=\-
Detach ciphertext and decode to standard output
.
.TP
\fB\-c\fR, \fB\-\-compact\fR
Output JWE using compact serialization
.
.SH "EXAMPLES"
Attach ciphertext to a detached JWE and emit JWE Compact Serialization:
.
.IP "" 4
.
.nf

$ jose jwe fmt \-i msg\.jwe \-I msg\.ct \-o compact\.jwe \-c
.
.fi
.
.IP "" 0
.
.P
Detach ciphertext from a JWE:
.
.IP "" 4
.
.nf

$ jose jwe fmt \-i msg\.jwe \-o detached\.jwe \-O detached\.ct
.
.fi
.
.IP "" 0
.
.SH "AUTHOR"
Nathaniel McCallum <npmccallum@redhat\.com>
.
.SH "SEE ALSO"
\fBjose\-jwe\-dec\fR(1), \fBjose\-jwe\-enc\fR(1)