NETCONSOLE-SETUP(8)

📦
version 0.3.1 · 4 versions
, in debian bookworm, ubuntu noble

💖 NETCONSOLE-SETUP 💖

okay bestie, welcome to netconsole-setup(8) — it's a page from netconsole-setup's Manual and it is genuinely so useful, i'm obsessed. sit down, grab a strawberry 🍓, let's get into it.

✨ NAME ✨

netconsole-setup — dynamically configure Linux netconsole, no cap 🎀

🌸 SYNOPSIS 🌸

netconsole-setup [[+][target-port]@]target-host ...

🦋 DESCRIPTION 🦋

so like, netconsole is a Linux kernel module, right? and what it does is it sends all kernel log messages over the network to another computer. literally all of them. 📡

the way it was designed… it wanted to be as instantaneous as possible, because its whole thing is enabling the logging of even the most critical kernel bugs. like when stuff is going so wrong that you need the receipts anyway. 💀

and get this — it works from IRQ contexts</> as well, and it does not enable interrupts while sending packets. icon behaviour honestly. 👑

but because of those unique needs, only these are supported, periodt:

  • IP networks
  • UDP packets
  • Ethernet devices

now, netconsole-setup is the bestie that makes configuring netconsole easy — it just takes the target hostname or IP address, that's it. it figures out all the needed configuration values from the running network device (like network interface, target IP and MAC address) so you don't have to. 🧚

you can specify multiple target hosts too. and each host can be prefixed with a target port and a plus sign to enable extended console support. slay.

💅 OPTIONS 💅

  • + — if present, enable extended console support for this host ✨
  • target-port — port for logging agent (kernel default is port 6666)
  • target-host — hostname or IP address for logging agent

🌈 EXAMPLES 🌈

this one sends all kernel log messages to host loghost. classic.
netconsole-setup loghost
and this one sends all kernel log messages to host loghost on port 4444 using the extended console support. fancy fr fr.
netconsole-setup +4444@loghost
two hosts at once?? main character energy. this sends all kernel log messages to host loghost1 on the default port and to host loghost2 on port 4444.
netconsole-setup loghost1 4444@loghost2

👑 AUTHOR 👑

Benjamin Drung <benjamin.drung@cloud.ionos.com> — wrote the whole thing, we love him for it 🫶

and that's the tea, bestie 💖 this page is from netconsole-setup, dated 2018-10-30, living in section NETCONSOLE-SETUP(8) of your friendly neighbourhood manual. go log some kernels, you got this. 💜🦋✨

📦 where this page comes from