blob: de8e12f896ccb50e5884dbcd13b37e914953a4b9 [file] [log] [blame]
Lev Walkincfcf5532004-09-26 13:13:31 +00001
Lev Walkin92157292005-02-28 15:53:32 +00002GENERAL INFORMATION
3===================
4
Lev Walkincfcf5532004-09-26 13:13:31 +00005The X.509 (PKIX1) certificate decoder. Invoking `make` will compile the ASN.1
Lev Walkin1e318832005-02-28 15:37:08 +00006specifications from the rfc3280.txt in the above directory.
7
Lev Walkin92157292005-02-28 15:53:32 +00008x509dump USAGE
9==============
10
Lev Walkin0f2c2722006-09-16 03:42:13 +000011To use the x509dump, you'll have to prepare an X.509 certificate
12in DER encoding. The typical X.509 certificate will have a PEM format
13(DER encoded data wrapped in base64, wrapped in PEM "BEGIN" and "END" sections).
14The openssl x509 utility may be used to convert between PEM and DER.
Lev Walkin92157292005-02-28 15:53:32 +000015
16 EXAMPLE: Convert 'certificate.pem' into 'certificate.der':
17
18 openssl x509 -inform PEM -in certificate.pem \
19 -outform DER -out certificate.der
20
21After convertsion, the x509dump utility may be used to dump the contents
22of the DER-encoded X.509 certificate:
23
Lev Walkin5e2f23e2006-08-25 01:51:29 +000024 ./x509dump certificate.der # Print as XML (BASIC-XER)
Lev Walkin92157292005-02-28 15:53:32 +000025
26The full list of recognized command line options may be obtained with
27
28 > ./x509dump -h
Lev Walkin92157292005-02-28 15:53:32 +000029