pem.1 (1190B)
1 .TH PEM 1 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 .MR encode (3) ) 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 .MR rsa (1) . 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 \*9/src/cmd/auth 64 .SH "SEE ALSO 65 .MR rsa (1)