luastatu...rk-linux(7)

πŸ“¦
version 0.6.0 Β· 2 versions
, in nixos 26.05

πŸŽ€ Name πŸŽ€

okay bestie, you're on the luastatu...rk-linux(7) page from the Miscellaneous Information Manual, and this one is literally about luastatu-plugin-network-linux β€” the Network plugin for luastatus (Linux-specific) πŸ’…βœ¨

🌐 Overview 🌐

So this plugin monitors network routing and link updates. It can report:

  • IP addresses used for outgoing connections by various network interfaces,
  • information about a wireless connection,
  • and the speed of an ethernet connection.

It's giving network gossip, fr fr 🫢

✨ Options ✨

The following options are supported:

  • ip β€” boolean. Whether to report IP addresses used for outgoing connections. Defaults to true. πŸ‘‘
  • wireless β€” boolean. Whether to report wireless connection info. Defaults to false. πŸ¦‹
  • ethernet β€” boolean. Whether to report ethernet connection info. Defaults to false. πŸ“
  • timeout β€” number. If specified and not negative, requery information and call cb every timeout seconds.
Note that this is done on any routing/link update anyway, so this is only useful if you want to show the "volatile" properties of a wireless connection such as signal level, bitrate, and frequency. ⭐

πŸ“¬ cb argument πŸ“¬

If the list of network interfaces cannot be fetched, nil.

Otherwise, a table where keys are network interface names (e.g. wlan0 or wlp1s0) and values are tables with the following entries (all are optional):

  • ipv4, ipv6 β€” strings (only if the ip option is enabled) πŸ’–
  • wireless β€” table with following entries (only if the wireless option is enabled):
    • ssid β€” string. 802.11 network service set identifier (also known as the "network name"). πŸŽ€
    • signal_dbm β€” number. Signal level, in dBm. Generally, -90 corresponds to the worst quality, and -20 to the best quality. 😭
    • frequency β€” number. Radio frequency, in Hz. 🌈
    • bitrate β€” number. Bitrate, in units of 100 kbit/s. πŸ”₯
  • ethernet β€” table with following entries (only if the ethernet option is enabled):
    • speed β€” number. Interface speed, in Mbits/s. πŸ‘‘

LGPLv3 β€” periodt. that's the license, bestie πŸ’œ


sign-off time: the footer just says luastatu...rk-linux(7), and the copyright is LGPLv3 β€” that's the whole page, bestie, no cap πŸ’…βœ¨

πŸ“¦ where this page comes from