'\" t
.\"     Title: jose-jws-fmt
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.16
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "JOSE\-JWS\-FMT" "1" "" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
jose-jws-fmt \- Converts a JWS between serialization formats
.SH "SYNOPSIS"
.sp
\fBjose jws fmt\fP \-i JWS [\-I PAY] [\-o JWS] [\-O PAY] [\-c]
.SH "OVERVIEW"
.sp
The \fBjose jws fmt\fP command converts a JWS into alternative serialization
formats. For example, it can:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
Attach payload to a detached JWS.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 2." 4.2
.\}
Detach payload from a JWS.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 3." 4.2
.\}
Convert JWS Compact Serialization to JWS JSON Serialization.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 4." 4.2
.\}
Convert JWS JSON Serialization to JWS Compact Serialization.
.RE
.SH "OPTIONS"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-i\fP \fIJSON\fP, \fB\-\-input\fP=\fIJSON\fP :
Parse JWS from JSON
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-i\fP \fIFILE\fP, \fB\-\-input\fP=\fIFILE\fP :
Read JWS from FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-i\fP \-, \fB\-\-input\fP=\-:
Read JWS from standard input
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-I\fP \fIFILE\fP, \fB\-\-detached\fP=\fIFILE\fP :
Read decoded payload from FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-I\fP \-, \fB\-\-detached\fP=\- :
Read decoded payload from standard input
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-o\fP \fIFILE\fP, \fB\-\-output\fP=\fIFILE\fP :
Write JWS to FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-o\fP \-, \fB\-\-output\fP=\- :
Write JWS to stdout (default)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-O\fP \fIFILE\fP, \fB\-\-detach\fP=\fIFILE\fP :
Detach payload and decode to FILE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-O\fP \-, \fB\-\-detach\fP=\- :
Detach payload and decode to standard output
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fB\-c\fP, \fB\-\-compact\fP :
Output JWS using compact serialization
.RE
.SH "EXAMPLES"
.sp
Attach payload to a detached JWS and emit JWS Compact Serialization:
.sp
.if n .RS 4
.nf
.fam C
$ jose jws fmt \-i msg.jws \-I msg.txt \-o compact.jws \-c
.fam
.fi
.if n .RE
.sp
Detach payload from a JWS:
.sp
.if n .RS 4
.nf
.fam C
$ jose jws fmt \-i msg.jws \-o detached.jws \-O msg.txt
.fam
.fi
.if n .RE
.SH "AUTHOR"
.sp
Nathaniel McCallum \c
.MTO "npmccallum\(atredhat.com" "" ""
.SH "SEE ALSO"
.sp
.URL "jose\-jws\-sig.1.adoc" "\fBjose\-jws\-sig\fP(1)" ","
.URL "jose\-jws\-ver.1.adoc" "\fBjose\-jws\-ver\fP(1)" ""