ND...IST(1)

📦
version 0.9.0 · 2 versions
, in nixos 26.05

💅 ND...IST(1) — ndnsec-list, aka the og "who's even in my PIB" tool

okay so bestie, quick vibe check: this whole page lives in the ndn-cxx: NDN C++ library with eXperimental eXtensions manual, and the command is ndnsec-list 💖

✨ NAME ✨

ndnsec-list — lists every NDN identity, key, and certificate you've got hanging out in your PIB. that's it. that's the whole job. and it slays at it 🎀

🌸 SYNOPSIS 🌸

ndnsec list [-h] [-k] [-c] [-v|-vv|-vvv]

🦋 DESCRIPTION 🦋

so what this does is print out the names of all the entities stored in the Public Information Base (PIB) — identities, keys, certificates — up to whatever granularity level you ask for. think of it as a little family tree of your crypto stuff, and you get to pick how far down the tree it goes 🌈

by default you only see the identity names. and here's the cute part: the default entities get marked with an asterisk (*) right in front of their names. main character energy, honestly 👑

💜 OPTIONS 💜

  • -k, --key — also lists the key names for each identity. an asterisk (*) in front of a key name means "this is the default key of that identity" 🗝️
  • -c, --cert — also lists the certificate names for each key. lowkey implies -k <#cmdoption-k>. an asterisk (*) in front of a certificate name means "this is the default certificate of that key" 📜
  • -v, -vv, -vvv, --verbose — verbose output mode, and yes you can stack it up to three times to crank the verbosity: -v is equivalent to -k <#cmdoption-k>; -vv is equivalent to -c <#cmdoption-c>; and -vvv prints detailed information for each certificate. like, all the deets, no crumbs left 🕵️‍♀️

🔥 EXAMPLES 🔥

display all identity names in the PIB — the classic, the starter pack:

$ ndnsec list
* /ndn/edu/ucla/cs/yingdi
  /ndn/test/cathy
  /ndn/test/bob
  /ndn/test/alice

display all key names in the PIB — now we're getting into the branches:

$ ndnsec list -k
* /ndn/edu/ucla/cs/yingdi
  +->* /ndn/edu/ucla/cs/yingdi/ksk-1397247318867
  +->  /ndn/edu/ucla/cs/yingdi/ksk-1393811874052

  /ndn/test/cathy
  +->* /ndn/test/cathy/ksk-1394129695418

  /ndn/test/bob
  +->* /ndn/test/bob/ksk-1394129695308

  /ndn/test/alice
  +->* /ndn/test/alice/ksk-1394129695025

display all certificate names in the PIB — the full tree, the whole bloodline:

$ ndnsec list -c
* /ndn/edu/ucla/cs/yingdi
  +->* /ndn/edu/ucla/cs/yingdi/ksk-1397247318867
       +->* /ndn/edu/ucla/cs/yingdi/KEY/ksk-1397247318867/ID-CERT/%00%00%01ERn%1B%BE
  +->  /ndn/edu/ucla/cs/yingdi/ksk-1393811874052
       +->* /ndn/edu/ucla/cs/yingdi/KEY/ksk-1393811874052/ID-CERT/%FD%01D%85%A9a%DD

  /ndn/test/cathy
  +->* /ndn/test/cathy/ksk-1394129695418
       +->* /ndn/test/KEY/cathy/ksk-1394129695418/ID-CERT/%FD%01D%98%9A%F3J

  /ndn/test/bob
  +->* /ndn/test/bob/ksk-1394129695308
       +->* /ndn/test/KEY/bob/ksk-1394129695308/ID-CERT/%FD%01D%98%9A%F2%AE

  /ndn/test/alice
  +->* /ndn/test/alice/ksk-1394129695025
       +->* /ndn/test/KEY/alice/ksk-1394129695025/ID-CERT/%FD%01D%98%9A%F2%3F

🫶 SEE ALSO 🫶

go give these a read too, they're all in the same friend group:

ndnsec-cert-dump(1), ndnsec-cert-install(1), ndnsec-delete(1), ndnsec-get-default(1), ndnsec-key-gen(1), ndnsec-set-default(1)

Copyright © 2013-2024 Regents of the University of California.

ngl bestie, that's the whole page. go forth and list your entities 💀✨

🌸 okay so that's a wrap! this was 0.9.0 dated 1980-01-01 — yeah, the date is older than all of us, don't think about it too hard 🎀 ily, go check your PIB 💖

📦 where this page comes from