JOSE-JWS-FMT(1)                                                JOSE-JWS-FMT(1)

NAME
       jose-jws-fmt - Converts a JWS between serialization formats

SYNOPSIS
       jose jws fmt -i JWS [-I PAY] [-o JWS] [-O PAY] [-c]

OVERVIEW
       The jose jws fmt command converts a JWS into alternative serialization
       formats. For example, it can:

        1. Attach payload to a detached JWS.

        2. Detach payload from a JWS.

        3. Convert JWS Compact Serialization to JWS JSON Serialization.

        4. Convert JWS JSON Serialization to JWS Compact Serialization.

OPTIONS
       o   -i JSON, --input=JSON : Parse JWS from JSON

       o   -i FILE, --input=FILE : Read JWS from FILE

       o   -i -, --input=-: Read JWS from standard input

       o   -I FILE, --detached=FILE : Read decoded payload from FILE

       o   -I -, --detached=- : Read decoded payload from standard input

       o   -o FILE, --output=FILE : Write JWS to FILE

       o   -o -, --output=- : Write JWS to stdout (default)

       o   -O FILE, --detach=FILE : Detach payload and decode to FILE

       o   -O -, --detach=- : Detach payload and decode to standard output

       o   -c, --compact : Output JWS using compact serialization

EXAMPLES
       Attach payload to a detached JWS and emit JWS Compact Serialization:

           $ jose jws fmt -i msg.jws -I msg.txt -o compact.jws -c

       Detach payload from a JWS:

           $ jose jws fmt -i msg.jws -o detached.jws -O msg.txt

AUTHOR
       Nathaniel McCallum <npmccallum@redhat.com>

SEE ALSO
       jose-jws-sig(1), jose-jws-ver(1)

                                  11/01/2022                   JOSE-JWS-FMT(1)