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