NBPLKUP(1)

📦
version 4.5.1 · 9 versions
, in ubuntu stonking

💖 NBPLKUP(1) — Netatalk AFP Fileserver Manual 💖

okay bestie, settle in, because nbplkup is literally the "who's out there on the AppleTalk network" detector and it's lowkey iconic ✨ (also hi, this is the manual page for the nbplkup command, lowercase, one word, no vowels, we love that for her)

🌸 NAME 🌸

nbplkup — go snooping for registered AppleTalk entities out there on the network 🦋

✨ SYNOPSIS ✨

nbplkup [-A address] [-D address] [-m Mac charset] [-r responses] [-s]
[-f | -l] [nbpname]

💅 DESCRIPTION 💅

nbplkup shows you up to responses entities that are registered on the AppleTalk network — and the default for responses is 1000, so yeah, she comes ready to party.

By default she looks up all the entities chilling in the local zone. But if you hand her an nbpname, the lookup gets filtered down to only the entities that match that name. main character selectivity, honestly.

Under the hood this uses the Name-Binding Protocol (NBP) to talk to the AppleTalk network. And your nbpname gets parsed by nbp_name(3), so go peep that page if you wanna know the full tea.

🎀 OPTIONS 🎀

  • -A address — use address as the local address to be used for the lookup. it's giving "actually, I'll be this one" 💁
  • -D address — use address as the destination address to send the lookup to.
  • -m Mac charset — interpret strings in the given Macintosh character set. If you don't specify one, nbplkup defaults to MacRoman. no cap.
  • -r responses — cap the number of responses at responses (default 1000). set your limit bestie.
  • -s — print the output in a script-friendly format: for each response, first the address is printed, then a single space, then the name and type, then a linefeed. that's it, that's the format, she's tidy 💅
  • -f — use a FwdReq operation for the lookup request instead of the default BrRq.
    • 🚫 Cannot be used with -l.
  • -l — use a LkUp operation for the lookup request instead of the default BrRq.
    • 🚫 Cannot be used with -f.
  • nbpname — the NBP name to use.

The nbpname is a string of the form obj:type@zone, where obj is the object name, type is the type of the object, and zone is the zone name. The obj and type can be arbitrary strings, but the zone must be a valid zone name. An = for the object or type matches anything, and an * for zone means the local zone. wildcard slay 🌈

📝 Notes 📝

A BrRq asks a router — by default the local atalkd instance — to propagate a lookup request across the entire AppleTalk internetwork. This is the default option because it's generally the most useful one. If in doubt: use a BrRq. fr fr.

A LkUp asks a node just about itself. You can use it to query what names are bound on a specific node, or — by specifying a broadcast destination — to simulate the kind of lookup that happens on a routerless network. she's introspective like that 🙈

A FwdReq asks a router to propagate the lookup to its directly connected networks that are members of the zone specified, but not to propagate it any further across the internetwork. Super useful on large internetworks, or when you're troubleshooting caches on refractory nodes 🔥

heads up: -f and -l are mutually exclusive, so pick a lane bestie, you literally cannot do both.

🌈 ENVIRONMENT VARIABLES 🌈

  • NBPLKUP — default nbpname for nbplkup, in format obj:type@zone

🍓 EXAMPLES 🍓

Find all devices of type LaserWriter in the local zone.

example% nbplkup :LaserWriter
               Petoskey:LaserWriter        7942.129:218
             Gloucester:LaserWriter        8200.188:186
                 Rahway:LaserWriter        7942.2:138
             517 Center:LaserWriter        7942.2:132
                  ionia:LaserWriter        7942.2:136
     Evil DEC from Hell:LaserWriter        7942.2:130
              Hamtramck:LaserWriter        7942.2:134
         Iron Mountain :LaserWriter        7942.128:250
example%

Find all devices of type netatalk in the local zone, providing script-friendly output.

example% nbplkup -s :netatalk
5.42:4 netatalk-build:netatalk
4.162:4 prometheus:netatalk
8.31:4 Tiryns:netatalk
example%

👑 SEE ALSO 👑

nbp_name(3), nbprgstr(1), nbpunrgstr(1), atalkd(8)

💜 AUTHOR 💜

Contributors to the Netatalk Project (https://netatalk.io/contributors)

okay that's the whole page, you ate that reading bestie 🫶 this was Netatalk 4.5.1, go forth and look up some entities 💖✨🎀

📦 where this page comes from