pem 1.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. .TH PEM 8
  2. .SH NAME
  3. pemdecode, pemencode \- encode files in Privacy Enhanced Mail (PEM) format
  4. .SH SYNOPSIS
  5. .PP
  6. .B auth/pemdecode
  7. .I section
  8. [
  9. .I file
  10. ]
  11. .PP
  12. .B auth/pemencode
  13. .I section
  14. [
  15. .I file
  16. ]
  17. .SH DESCRIPTION
  18. PEM is a textual encoding for binary data originally used by the
  19. Privacy Enhanced Mail program but now commonly used for
  20. other applications, notably TLS.
  21. PEM encodes data in base 64
  22. (see
  23. .IR encode (2))
  24. between lines of the form:
  25. .IP
  26. .EX
  27. -----BEGIN SECTION-----
  28. -----END SECTION-----
  29. .EE
  30. .LP
  31. where
  32. .B SECTION
  33. may be any string describing the encoded data.
  34. The most common use of PEM format on Plan 9 is for encoding
  35. X.509 certificates; see
  36. .IR rsa (8).
  37. .PP
  38. .I Pemdecode
  39. extracts the named
  40. .I section
  41. and writes the decoded data to standard output.
  42. .PP
  43. .I Pemencode
  44. encodes its standard input, labels it as a
  45. .IR section ,
  46. and writes it to standard output.
  47. .SH EXAMPLES
  48. Encode and decode a simple greeting:
  49. .IP
  50. .EX
  51. % echo hello world |
  52. auth/pemencode GREETING
  53. -----BEGIN GREETING-----
  54. aGVsbG8gd29ybGQK
  55. -----END GREETING-----
  56. % echo hello world |
  57. auth/pemencode GREETING |
  58. auth/pemdecode GREETING
  59. hello world
  60. %
  61. .EE
  62. .SH SOURCE
  63. .B /sys/src/cmd/auth
  64. .SH "SEE ALSO
  65. .IR rsa (8)