NDN-...ERVER(1)

📦
version 24.07 · 2 versions
, in nixos 26.05

💅 NDN-...ERVER(1) — like, the ndn-autoconfig-server page, bestie

okay so this is a page from the Named Data Networking Forwarding Daemon (NFD) manual, and the star of the show is ndn-autoconfig-server. come sit, i'm gonna tell you everything ✨

🌸 NAME

ndn-autoconfig-server — the auto-configuration server for NDN. yes that's its whole job and it does it gorgeously 💖

🎀 SYNOPSIS

ndn-autoconfig-server [-h] [-V] [-p PREFIX]... FACEURI

that's it. that's the whole vibe. FACEURI is required, the rest is garnish 🍓

🦋 DESCRIPTION

so ndn-autoconfig-server is a daemon that implements the server half of stage 1 of the NDN hub discovery procedure Local hub discovery procedure <#ndn-hub-discovery-procedure>. main character energy only, no cap 👑

what it actually does (and this is the part ppl always ask about): it just sits there, waiting for Interests for

/localhop/ndn-autoconf/hub

and when one shows up, it satisfies it with a Data packet that contains a TLV-encoded FaceUri block. and the value of that block? it's the Uri for the HUB — and preferably it's a UDP tunnel. like, that's the cute choice, that's the one you want 💫

the arguments, one by one 🫶

  • <FACEURI> — the FaceUri for this NDN hub. that's it, that's the whole description, it's giving minimal and mysterious 🌈
  • -p <PREFIX> — a local prefix for which the local hub allows end applications to register prefixes (see Local hub prefix discovery <#local-prefix-discovery> for the full tea). and here's the slay part: you can supply more than one prefix, just stack that flag. all supplied prefixes get put into the local prefix discovery data exactly as described in Local hub prefix discovery <#local-prefix-discovery>. big caveat tho: if no prefix is specified, auto-config-server will not serve any local prefix discovery data. so like, if you wanted that feature... you have to ask for it 🙈
  • -h — print usage and exit. simple, iconic, zero notes 💅
  • -V — print version number and exit. also iconic ⭐

✨ OPTIONS ✨

okay let me just re-list these cleanly so your eyes can vibe check them:

  • -h — print usage and exit 📝
  • -V — print version number and exit 🏷️
  • -p <PREFIX> — stack a local prefix for local prefix discovery; repeatable; omit it entirely and no local prefix discovery data gets served, periodt 🎯
⚠️ fr fr, that last bit matters — no -p means no local prefix discovery data. don't come back later like "why isn't it working" 😭

💀 EXIT STATUS

  • 0 — no error. we ate, no crumbs 🔥
  • 1 — an unspecified error occurred. vague, unbothered, mysterious 🫠
  • 2 — malformed command line, e.g. an invalid, missing, or unknown argument. bestie... read the synopsis again 🎀
  • 4 — insufficient privileges. you need more power for this one 👑

🌟 EXAMPLES

like, the actual invocations, copied exactly, because these are sacred:

ndn-autoconfig-server tcp://spurs.cs.ucla.edu

and with a local prefix:

ndn-autoconfig-server -p /ndn/edu/ucla tcp://spurs.cs.ucla.edu

see how clean that is? -p first, then the FaceUri, and boom you're a hub 🌸

🔍 SEE ALSO

Copyright © 2014-2024 Named Data Networking Project.

okay that's the whole page!! 💖 ngl it's a short one but it's lowkey important. anyway — this was the NFD 24.07 version, dated 1980-01-01 (yes, that date is real, don't @ me 😭), and that's the sign-off bestie, mwah 🫶✨

📦 where this page comes from