pbs_hostn(8B)

📦 version 23.06.06-unstable-2026-04, in nixos 26.05, nixpkgs unstable

💅 pbs_hostn(8B) — the hostname gossip session 💅

okay bestie, so this one lives in the PBS Professional section 8B of the manual, and it's genuinely one of my faves because it's so simple and so useful. Let me tell you everything ✨

🌸 NAME 🌸

pbs_hostn — reports the hostname and network address(es). that's it, that's the whole vibe 🫶

🦋 SYNOPSIS 🦋

pbs_hostn [ -v ] <hostname>
pbs_hostn --version

like, two whole modes. pick your fighter 💅

💖 DESCRIPTION 💖

so the pbs_hostn command takes a hostname and reports back the results of both the gethostbyname(3) and gethostbyaddr(3) system calls. yes, both. forward lookup AND reverse lookup, no cap 🔥

and here's the important part bestie — both the forward and reverse lookup of hostname and network addresses need to succeed in order for PBS to authenticate a host. both. if one flops, no auth, periodt 😭

running this command is literally the move when you're troubleshooting problems related to incorrect or non-standard network configuration — especially within clusters. cluster networking being weird? this is your girl 🧚

✨ OPTIONS ✨

  • -v — turns on verbose mode. more words, more info, more to love 💜
  • --version — the pbs_hostn command returns its PBS version information and exits. this option can only be used alone — no mixing, no matching, it's a solo act 👑

🎀 OPERANDS 🎀

  • hostname — the pbs_hostn command accepts a hostname operand either in short name form, or in fully qualified domain name (FQDN) form. either slaps, your choice 🍓

💀 STANDARD ERROR 💀

the pbs_hostn command writes a diagnostic message to standard error for each error occurrence. so if something goes wrong, it will tell you — one message per error, very thorough of her 🙈

🌈 EXIT STATUS 🌈

  • Zero — upon successful processing of all the operands presented to the pbs_hostn command. we love a clean exit 💚
  • Greater than zero — if the pbs_hostn command fails to process any operand. not the vibe, but at least you know 😤

👑 SEE ALSO 👑

  • pbs_server(8B) — go read that one next, bestie, iykyk 🫶

and that's the whole page, fr fr. this fine piece of documentation is from Local, dated 6 May 2020, and it's the pbs_hostn(8B) page itself. iconic, honestly. mwah 💋🌺

📦 where this page comes from