1JOSE-JWS-FMT(1)                                                JOSE-JWS-FMT(1)
2
3
4

NAME

6       jose-jws-fmt - Converts a JWS between serialization formats
7

SYNOPSIS

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

OVERVIEW

12       The jose jws fmt command converts a JWS into alternative serialization
13       formats. For example, it can:
14
15        1. Attach payload to a detached JWS.
16
17        2. Detach payload from a JWS.
18
19        3. Convert JWS Compact Serialization to JWS JSON Serialization.
20
21        4. Convert JWS JSON Serialization to JWS Compact Serialization.
22

OPTIONS

24       •   -i JSON, --input=JSON : Parse JWS from JSON
25
26       •   -i FILE, --input=FILE : Read JWS from FILE
27
28       •   -i -, --input=-: Read JWS from standard input
29
30       •   -I FILE, --detached=FILE : Read decoded payload from FILE
31
32       •   -I -, --detached=- : Read decoded payload from standard input
33
34       •   -o FILE, --output=FILE : Write JWS to FILE
35
36       •   -o -, --output=- : Write JWS to stdout (default)
37
38       •   -O FILE, --detach=FILE : Detach payload and decode to FILE
39
40       •   -O -, --detach=- : Detach payload and decode to standard output
41
42       •   -c, --compact : Output JWS using compact serialization
43

EXAMPLES

45       Attach payload to a detached JWS and emit JWS Compact Serialization:
46
47           $ jose jws fmt -i msg.jws -I msg.txt -o compact.jws -c
48
49       Detach payload from a JWS:
50
51           $ jose jws fmt -i msg.jws -o detached.jws -O msg.txt
52

AUTHOR

54       Nathaniel McCallum <npmccallum@redhat.com>
55

SEE ALSO

57       jose-jws-sig(1), jose-jws-ver(1)
58
59
60
61                                  07/20/2023                   JOSE-JWS-FMT(1)