tpem.1 - plan9port - [fork] Plan 9 from user space
 (HTM) git clone git://src.adamsgaard.dk/plan9port
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       tpem.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)