NSSCACHE(1)

📦
version 0.49 · 2 versions
  • 0.49 · debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 0.42 · ubuntu jammy
, in debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NSSCACHE(1) 💖

okay so bestie, welcome to the manual page for nsscache, section 1 of the User Commands lineup — yes she's that girl, she's the one who keeps your local NSS cache in sync with an upstream data source, and honestly? iconic behaviour. 🌸

✨ NAME ✨

nsscache — synchronise a local NSS cache with an upstream data source 🦋

✨ SYNOPSIS ✨

nsscache [global options] command [command options]

✨ DESCRIPTION ✨

so here's the tea ☕ — nsscache synchronises a local NSS cache against a remote data source. and the whole point of this, the reason it's main character energy, is that it lets the administrator separate the network from the NSS lookup codepath. which means: better speed and better reliability for name services. no cap. 💅

✨ OPTIONS ✨

these are the global options — they change how the whole program behaves, not just one lil command:

  • -v, --verbose — turn on verbose output, she's chatty now 🗣️
  • -d, --debug — turn on debugging output, full detective mode 🔍
  • -c FILE, --config-file=FILE — read the configuration from FILE 📄
  • --version — show the program's version number and then dip ✌️
  • -h, --help — show this help message and exit 🫶

✨ COMMANDS ✨

🌈 update

performs an update of the configured caches from the configured sources. like, the actual doing-the-thing command. slay.

  • -f, --full — force a full update from the data source 🔥
  • --force — force the update, overriding any safeguards and checks that would otherwise prevent the update from occurring. for example: normally, empty results from the data source are ignored as bogus — this option tells the program to ignore its own intuition and use the empty map instead. she's overriding her gut feeling, be careful bestie 💀
  • -m MAPS, --map=MAPS — the NSS map to operate on; you can supply this multiple times 🗂️
  • -h, --help — show help for the update command

🌈 verify

perform verification of the built caches and validation of the system NSS configuration. vibe check on your setup, basically. ✅

  • -m MAPS, --map=MAPS — the NSS map to operate on; can be supplied multiple times 🗂️
  • -h, --help — show help for the verify command

🌈 status

show the last update time of each configured cache, plus other metrics — optionally in a machine-readable format. she's giving receipts. 📊

  • -m MAPS, --map=MAPS — the NSS map to operate on; can be supplied multiple times 🗂️
  • -h, --help — show help for the status command

🌈 repair

verify that the configuration is correct, that the source is reachable, and then perform a full synchronisation of the cache. she's here to fix things and look cute doing it 🛠️✨

  • -m MAPS, --map=MAPS — the NSS map to operate on; can be supplied multiple times 🗂️
  • -h, --help — show help for the repair command

🌈 help

shows online help for each command. when in doubt, ask for help, it's literally free 🫶

✨ SEE ALSO ✨

✨ FILES ✨

  • /etc/nsscache.conf — the system-wide configuration file 📁
  • /etc/nsswitch.conf — the system name service switch configuration file 📁

✨ AUTHOR ✨

written by Jamie Wilkinson (jaq@google.com) and Vasilios Hoffman (vasilios@google.com). 💜

the source code lives at https://github.com/google/nsscache — go say hi, she's open source 🫶

Copyright © 2007 Google, Inc.

this is free software; see the source for copying conditions. and there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. like, none. zero. not even a little one. 😭

and that's the whole page bestie!! this was nsscache version 0.49, dated 2023-06-03, and it lives in section NSSCACHE(1) of the manual. go forth and cache, you've got this 👑💖✨

📦 where this page comes from