NEEDRESTART(1)

🎀 needrestart(1) — User Commands 🎀

✨ NAME ✨

needrestart — needrestart

💖 DESCRIPTION 💖

okay so needrestart checks which daemons need to be restarted after library upgrades 🔥 like, you upgrade your libs and your running stuff is still clinging to the old versions 💀 needrestart finds those and tells you bestie 🫶

🌸 USAGE 🌸

Usage:

needrestart [-(v|q)] [-n] [-c <cfg>] [-r <mode>] [-f <fe>] [-u <ui>] [-(b|p|o)] [-x] [-kl]

• -v — be more verbose 📢
• -q — be quiet 🤫
• -m <mode> — set level of technical details 🧠
  • e — (e)asy mode 🌷
  • a — (a)dvanced mode 🤓
  • u — (u)buntu mode, used to customize the behaviour in the APT hook. See /usr/share/doc/README.Ubuntu. 🍓
• -n — set default answer to 'no' 🙅‍♀️
• -c <cfg> — config filename 📁
• -r <mode> — set restart mode 🔁
  • l — (l)ist only 📋
  • i — (i)nteractive restart 👆
  • a — (a)utomatically restart 🤖

ATTENTION: bestie, if needrestart is configured to run in interactive mode but is run non-interactive (i.e. unattended-upgrades) it will fall back to list only mode. no cap 🚨

• -b — enable batch mode: don't restart anything and produce machine-readable output 🦋
• -p — nagios plugin mode: makes output and exit codes nagios compatible 💜
• -o — OpenMetrics output mode 📊 this outputs info that OpenMetrics-compatible services can scrape. It implies batch mode. Combine it with any of -l, -k and -w to decide whether the metrics expose outdated libraries, kernel and microcode, respectively. Heads up: to list system-wide outdated libraries, needrestart needs to be run as root 👑. When listing outdated libraries, a gauge-type metric exposes the number of running processes with such outdated libraries. When exposing kernel or microcode metrics, each one exposes a StateSet-type metric which indicates the current status. Kernel and microcode will also each expose an additional Info-type metric which informs you of the versions of the current vs expected kernel or microcode. it's giving data nerd 🤓✨
• -f <fe> — override the debconf(7) frontend, sets the DEBIAN_FRONTEND environment variable to <fe> 🎀
• -t <seconds> — when checking running interpreter processes, allow process start times that are close to timestamps of files the interpreter uses, within this tolerance (default 2). The default of 2 seconds is best for checks of Linux hosts, since system limitations prevent more accurate measurements of process start times 🕰️ Values higher than 0 should prevent false positives but may, in extreme cases, cause false negatives. Values higher than 2 should not be necessary.
• -u <ui> — use preferred UI package (-u ? shows available packages) 🧚
• -x — automatically exit the GUI when there is no process selected by default ✨

By using one of the following options, only the specified checks are performed 💅

• -k — check for obsolete kernel 🫧
• -l — check for obsolete libraries 📚

🌈 ENVIRONMENT 🌈

The following environment variables can be used to override the config file options. Command line parameters always supersede them, periodt 💅

• NEEDRESTART_MODE — change the configured restart mode (see also the -r parameter): (l)ist only, (i)nteractive or (a)utomatically 🔁

When used with apt-get(8), needrestart supports these additional environment variables 🦋

• DEBIAN_FRONTEND — the debconf(7) frontend to use, which you can also set with the -f parameter 🎀
• NEEDRESTART_SUSPEND — if set to a non-empty value, the apt-get(8) hook will not run needrestart after installing or updating packages 🙈

👑 AUTHOR 👑

Thomas Liske <thomas@fiasko-nw.net> 🫶

🧾 COPYRIGHT 🧾

2013 - 2022 (C) Thomas Liske [http://fiasko-nw.net/~thomas/]

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. iykyk, it's open source and totally shareable 💜

🔗 UPSTREAM 🔗

https://github.com/liske/needrestart

---

bestie, that's the whole page 💖 needrestart, January 2015, NEEDRESTART(1) 🧚✨