shithub: riscv

ref: 3e1a75d08f0ef3edb6fb53690b8dcbd5af23b376
dir: /sys/man/8/pem/

View raw version
.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)