jose-jws-fmt(1)

jose-jws-fmt1

Converts a jws between serialization formats

Usage

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

• -i JSON, --input=JSON : Parse JWS from JSON

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

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

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

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

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

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

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

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

• -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

Releases

5 releases since Debian 10 (Buster); the text changed 3 times.

  1. 10–11
  2. 12
  3. 13
  4. Arch

--compact until Debian 11 (Bullseye); --detach until Debian 11 (Bullseye); --detached until Debian 11 (Bullseye); --input until Debian 11 (Bullseye); --output until Debian 11 (Bullseye); -I until Debian 11 (Bullseye); -O until Debian 11 (Bullseye); -c until Debian 11 (Bullseye); -i until Debian 11 (Bullseye); -o until Debian 11 (Bullseye).

Author

Nathaniel McCallum <[email protected]>

From jose 15-2 in Arch Linux 2026-11-07. Parsed by carta from the page's man source.