ref: 0fa3ff0598bfee59d64b88eb78e8d68c1c823e05
dir: /sys/man/8/pem/
.TH PEM 8 .SH NAME pemdecode, pemencode \- encode files in Privacy Enhanced Mail (PEM) format .SH SYNOPSIS .PP .B auth/pemdecode .I section [ .I file ] .PP .B auth/pemencode .I section [ .I file ] .SH DESCRIPTION PEM is a textual encoding for binary data originally used by the Privacy Enhanced Mail program but now commonly used for other applications, notably TLS. PEM encodes data in base 64 (see .IR encode (2)) between lines of the form: .IP .EX -----BEGIN SECTION----- -----END SECTION----- .EE .LP where .B SECTION may be any string describing the encoded data. The most common use of PEM format on Plan 9 is for encoding X.509 certificates; see .IR rsa (8). .PP .I Pemdecode extracts the named .I section and writes the decoded data to standard output. .PP .I Pemencode encodes its standard input, labels it as a .IR section , and writes it to standard output. .SH EXAMPLES Encode and decode a simple greeting: .IP .EX % echo hello world | auth/pemencode GREETING -----BEGIN GREETING----- aGVsbG8gd29ybGQK -----END GREETING----- % echo hello world | auth/pemencode GREETING | auth/pemdecode GREETING hello world % .EE .SH SOURCE .B /sys/src/cmd/auth .SH "SEE ALSO .IR rsa (8)