pki: Add --dn command to extract the subject DN of a certificate
[strongswan.git] / src / pki / man / pki---dn.1.in
1 .TH "PKI \-\-DN" 1 "2015-08-06" "@PACKAGE_VERSION@" "strongSwan"
2 .
3 .SH "NAME"
4 .
5 pki \-\-dn \- Extract the subject DN of an X.509 certificate
6 .
7 .SH "SYNOPSIS"
8 .
9 .SY pki\ \-\-dn
10 .OP \-\-in file
11 .OP \-\-format format
12 .OP \-\-debug level
13 .YS
14 .
15 .SY pki\ \-\-dn
16 .BI \-\-options\~ file
17 .YS
18 .
19 .SY "pki \-\-dn"
20 .B \-h
21 |
22 .B \-\-help
23 .YS
24 .
25 .SH "DESCRIPTION"
26 .
27 This sub-command of
28 .BR pki (1)
29 extracts the ASN.1-encoded subject DistinguishedName (DN) of an X.509
30 certificate and exports it in different formats.  This may be useful when
31 strongSwan's identity parser is unable to produce the correct binary encoding
32 from a string.
33 .
34 .SH "OPTIONS"
35 .
36 .TP
37 .B "\-h, \-\-help"
38 Print usage information with a summary of the available options.
39 .TP
40 .BI "\-v, \-\-debug " level
41 Set debug level, default: 1.
42 .TP
43 .BI "\-+, \-\-options " file
44 Read command line options from \fIfile\fR.
45 .TP
46 .BI "\-i, \-\-in " file
47 Input file. If not given the input is read from \fISTDIN\fR.
48 .TP
49 .BI "\-t, \-\-format " format
50 Output format. One of \fIconfig\fR (strongSwan configuration compatible),
51 \fIhex\fR (hexadecimal encoding, no prefix), \fIbase64\fR (Base64 encoding,
52 no prefix), \fIbin\fR (raw binary data), defaults to \fIconfig\fR.
53 .
54 .SH "SEE ALSO"
55 .
56 .BR pki (1)