plan9port/man/man1/pem.1

66 lines
1.2 KiB
Groff
Raw Normal View History

2005-02-13 23:44:12 +00:00
.TH PEM 1
2005-02-13 22:02:06 +00:00
.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
2005-02-13 23:44:12 +00:00
.IR encode (3))
2005-02-13 22:02:06 +00:00
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
2005-02-13 23:44:12 +00:00
.IR rsa (1).
2005-02-13 22:02:06 +00:00
.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 \*9/src/cmd/auth
.SH "SEE ALSO
.IR rsa (1)