1
0

jose-jws-fmt.1.adoc 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. jose-jws-fmt(1)
  2. ===============
  3. :doctype: manpage
  4. == NAME
  5. jose-jws-fmt - Converts a JWS between serialization formats
  6. == SYNOPSIS
  7. *jose jws fmt* -i JWS [-I PAY] [-o JWS] [-O PAY] [-c]
  8. == OVERVIEW
  9. The *jose jws fmt* command converts a JWS into alternative serialization
  10. formats. For example, it can:
  11. 1. Attach payload to a detached JWS.
  12. 2. Detach payload from a JWS.
  13. 3. Convert JWS Compact Serialization to JWS JSON Serialization.
  14. 4. Convert JWS JSON Serialization to JWS Compact Serialization.
  15. == OPTIONS
  16. * *-i* _JSON_, *--input*=_JSON_ :
  17. Parse JWS from JSON
  18. * *-i* _FILE_, *--input*=_FILE_ :
  19. Read JWS from FILE
  20. * *-i* -, *--input*=-:
  21. Read JWS from standard input
  22. * *-I* _FILE_, *--detached*=_FILE_ :
  23. Read decoded payload from FILE
  24. * *-I* -, *--detached*=- :
  25. Read decoded payload from standard input
  26. * *-o* _FILE_, *--output*=_FILE_ :
  27. Write JWS to FILE
  28. * *-o* -, *--output*=- :
  29. Write JWS to stdout (default)
  30. * *-O* _FILE_, *--detach*=_FILE_ :
  31. Detach payload and decode to FILE
  32. * *-O* -, *--detach*=- :
  33. Detach payload and decode to standard output
  34. * *-c*, *--compact* :
  35. Output JWS using compact serialization
  36. == EXAMPLES
  37. Attach payload to a detached JWS and emit JWS Compact Serialization:
  38. $ jose jws fmt -i msg.jws -I msg.txt -o compact.jws -c
  39. Detach payload from a JWS:
  40. $ jose jws fmt -i msg.jws -o detached.jws -O msg.txt
  41. == AUTHOR
  42. Nathaniel McCallum <npmccallum@redhat.com>
  43. == SEE ALSO
  44. link:jose-jws-sig.1.adoc[*jose-jws-sig*(1)],
  45. link:jose-jws-ver.1.adoc[*jose-jws-ver*(1)]