Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 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)