blob: dc949392990807787c0c865f331875b1e1e9ca49 [file] [log] [blame]
Alexander Afanasyev151a8552014-04-11 00:54:43 -07001ndnsec-export
2=============
3
Alexander Afanasyev151a8552014-04-11 00:54:43 -07004Usage
5-----
6
7::
8
Junxiao Shi476200b2017-10-05 12:16:27 +00009 $ ndnsec-export [-h] [-o output] identity
Alexander Afanasyev151a8552014-04-11 00:54:43 -070010
11Description
12-----------
13
Junxiao Shi476200b2017-10-05 12:16:27 +000014``ndnsec-export`` exports the default certificate of an identity and its private key as a file. It
15will ask for a passphrase to encrypt the private key. The output file can be imported again with
16``ndnsec-import`` command.
Alexander Afanasyev151a8552014-04-11 00:54:43 -070017
18Options
19-------
20
Junxiao Shi476200b2017-10-05 12:16:27 +000021``-h``
22 Print a help message.
Alexander Afanasyev151a8552014-04-11 00:54:43 -070023
Junxiao Shi476200b2017-10-05 12:16:27 +000024``-o output``
25 Write to an output file instead of the standard output.
26
Alexander Afanasyev634a62b2018-06-15 16:55:26 -040027``-P passphrase``
28 Passphrase to use for the export. If not specified (or specified an empty passphrase), the
29 user is interactively asked to input the passphrase on the terminal. Note that specifying
30 passphrase via -P is insecure, as it can potentially end up in shell history, be visible in
31 ps output, etc.
32
Junxiao Shi476200b2017-10-05 12:16:27 +000033``identity``
34 The identity name.
Alexander Afanasyev151a8552014-04-11 00:54:43 -070035
36Examples
37--------
38
Junxiao Shi476200b2017-10-05 12:16:27 +000039Export an identity's default certificate and private key into a file:
Alexander Afanasyev151a8552014-04-11 00:54:43 -070040
41::
42
Junxiao Shi476200b2017-10-05 12:16:27 +000043 $ ndnsec-export -o alice.ndnkey /ndn/test/alice
Alexander Afanasyev151a8552014-04-11 00:54:43 -070044
Junxiao Shi476200b2017-10-05 12:16:27 +000045Export an identity's default certificate and private key to the standard output:
Alexander Afanasyev151a8552014-04-11 00:54:43 -070046
47::
48
49 $ ndnsec-export /ndn/test/alice