blob: bc4a316482cf1e62a7ba18911ae9e8c518e24b65 [file] [log] [blame]
Alexander Afanasyev151a8552014-04-11 00:54:43 -07001ndnsec-list
2===========
3
4``ndnsec-list`` is a tool to display entities stored in **Public Information Base (PIB)**, such as
5identities, keys, and certificates.
6
7Usage
8-----
9
10::
11
12 $ ndnsec-list [-h] [-KkCc]
13
14Description
15-----------
16
17``ndnsec-list`` lists names of all the entities according to the granularity specified in options
18(The default granularity is identity). The default entities will be marked with ``*`` in front of
19their names. For example:
20
21::
22
23 $ ndnsec list
24 * /ndn/edu/ucla/cs/yingdi
25 /ndn/test/cathy
26 /ndn/test/bob
27 /ndn/test/alice
28
29
30Options
31-------
32
33``-K, -k``
34 Display key names for each identity. The key name with ``*`` in front is the default key name of
35 the corresponding identity.
36
37``-C, -c``
38 Display certificate names for each key. The certificate name with ``*`` in front is the default
39 certificate name of the corresponding key.
40
41Examples
42--------
43
44Display all the key names in PIB.
45
46::
47
48 $ ndnsec-list -k
49 * /ndn/edu/ucla/cs/yingdi
50 +->* /ndn/edu/ucla/cs/yingdi/ksk-1397247318867
51 +-> /ndn/edu/ucla/cs/yingdi/ksk-1393811874052
52
53 /ndn/test/cathy
54 +->* /ndn/test/cathy/ksk-1394129695418
55
56 /ndn/test/bob
57 +->* /ndn/test/bob/ksk-1394129695308
58
59 /ndn/test/alice
60 +->* /ndn/test/alice/ksk-1394129695025
61
62Display all the certificate names in PIB.
63
64::
65
66 $ ndnsec-list -c
67 * /ndn/edu/ucla/cs/yingdi
68 +->* /ndn/edu/ucla/cs/yingdi/ksk-1397247318867
69 +->* /ndn/edu/ucla/cs/yingdi/KEY/ksk-1397247318867/ID-CERT/%00%00%01ERn%1B%BE
70 +-> /ndn/edu/ucla/cs/yingdi/ksk-1393811874052
71 +->* /ndn/edu/ucla/cs/yingdi/KEY/ksk-1393811874052/ID-CERT/%FD%01D%85%A9a%DD
72
73 /ndn/test/cathy
74 +->* /ndn/test/cathy/ksk-1394129695418
75 +->* /ndn/test/KEY/cathy/ksk-1394129695418/ID-CERT/%FD%01D%98%9A%F3J
76
77 /ndn/test/bob
78 +->* /ndn/test/bob/ksk-1394129695308
79 +->* /ndn/test/KEY/bob/ksk-1394129695308/ID-CERT/%FD%01D%98%9A%F2%AE
80
81 /ndn/test/alice
82 +->* /ndn/test/alice/ksk-1394129695025
83 +->* /ndn/test/KEY/alice/ksk-1394129695025/ID-CERT/%FD%01D%98%9A%F2%3F