CANBUSLOAD(1)

💖 CANBUSLOAD(1) 💖

okay bestie, pull up a chair, we're looking at canbusload from the User Commands corner of the manual, and honestly? she's iconic. this whole page is your little group chat with the CAN bus.

---

✨ NAME ✨

canbusload — manual page for canbusload 2023.03-1build1

like, that's literally her. that's the girl. 💅

---

🌸 SYNOPSIS 🌸

canbusload [options] <CAN interface>+

yes queen, hit her with options and then as many CAN interfaces as your heart desires (there's a limit, we'll get there, don't worry 🫶).

---

🦋 DESCRIPTION 🦋

canbusload — monitor CAN bus load.

she watches the bus. she reports the load. that's the whole vibe. it's giving observant. it's giving main character energy.

(use CTRL-C to terminate canbusload)

like, press Ctrl+C when you're done, bestie. she will not leave on her own. she's committed. 😭

---

💅 OPTIONS 💅

• -t — shows the current time on the first line ⏰
• -c — colorizes the lines 🌈 (yes, aesthetic matters, this is not optional behavior for a tool that's this cute)
• -b — shows a bargraph, in 5% resolution 📊
• -r — redraws the terminal — similar to top 🔄
• -i — ignores bitstuffing when calculating bandwidth 🙈
• -e — exact calculation of the stuffed bits ✨

---

🧚 the interfaces, bestie 🧚

you can specify up to 16 CAN interfaces, and the bitrate is mandatory. drop them on the command line in this exact form:

<ifname>@<bitrate>[,<dbitrate>]

the bitrate is mandatory because — and this is the whole point — she needs to know the CAN bus bitrate to calculate the bus load percentage based on the received CAN frames. no bitrate, no percentage. periodt.

heads up: due to the bitstuffing estimation, the calculated busload may exceed 100%. that's not a bug, that's just what the estimation does. no cap. 💀

for each interface you give her, the data is presented in one line, and that line contains:

• (interface)
• (received CAN frames)
• (used bits total)
• (used bits for payload)

four lil slots. one line per interface. iconic layout honestly. 👑

---

🌟 EXAMPLES 🌟

user$> canbusload can0@100000 can1@500000 can2@500000 can3@500000 -r -t -b -c

canbusload 2014-02-01 21:13:16 (worst case bitstuffing)

can0@100000
       805   74491  36656  74% |XXXXXXXXXXXXXX......|

can1@500000
       796   75140  37728  15% |XXX.................|

can2@500000
       0       0      0   0% |....................|

can3@500000
       47    4633   2424   0% |....................|

look at her go 🥹 can0 is AT 74%, absolutely carrying the team. can2 said "not today" and delivered a perfect zero. we love a balanced cast of characters. 🎀

and notice the header line says (worst case bitstuffing) — because that's the default flavor of estimation here. iykyk.

---

💜 a lil sign-off 💜

this page lives under canbusload 2023.03-1build1, and it was dated December 2025. so she's current, she's maintained, she's thriving. go watch some buses, bestie. slay. 🦋✨

CANBUSLOAD(1) — that's the whole thing. bye pookie!! 💖