ISOTPTUN(1)

πŸ“¦
version 2023.03 Β· 3 versions
, in ubuntu resolute, ubuntu stonking

πŸ’– ISOTPTUN(1) πŸ’–

okay bestie, sit down, hydrate, because today we're talking about isotptun β€” that's the manual page for isotptun version 2023.03-1build1, and honestly? it's giving tunnel girlie and I'm obsessed. 🫢


✨ NAME ✨

isotptun β€” the manual page for isotptun 2023.03-1build1, and yes she's iconic for having her own manpage, periodt. πŸ‘‘


🌸 SYNOPSIS 🌸

isotptun [options] <CAN interface>

that's it. that's the whole vibe. options go in, a CAN interface goes in, magic comes out. ✨


πŸ¦‹ DESCRIPTION πŸ¦‹

so like, isotptun is an IP over CAN ISO-TP (ISO15765-2) tunnel β€” a proof-of-concept, no cap. it's a whole experiment and it ate. πŸ’…

what it actually does: it creates a Linux tunnel netdevice called ctunX, and then it transfers the ethernet frames inside ISO15765-2 (unreliable) datagrams on CAN. yes, unreliable. she said "we move anyway." πŸ”₯


πŸŽ€ OPTIONS πŸŽ€

  • -s <can_id> β€” the source can_id, bestie. if you're using extended IDs, use 8 digits. don't be shy with the digits. πŸ“
  • -d <can_id> β€” the destination can_id. same rule: 8 digits for extended IDs. πŸ‘―
  • -n <name> β€” name of the created IP netdevice. default is 'ctun%d', because %d is the main character here. 🌟
  • -x <addr>[:<rxaddr>] β€” extended addressing, and optionally a separate rxaddr. the : is doing the heavy lifting, iykyk. βœ‚οΈ
  • -L <mtu>:<tx_dl>:<tx_flags> β€” link layer options for CAN FD. three colons-separated values, one slay. πŸš€
  • -p [tx]:[rx] β€” set and enable tx/rx padding bytes. both colons optional, just like your plans for the weekend. 🀷
  • -P <mode> β€” check rx padding for (l)ength, (c)ontent, or (a)ll. pick your fighter. πŸ₯Š
  • -t <time ns> β€” transmit time in nanosecs. nanoseconds!! we're precise in this house. ⏱️
  • -b <bs> β€” blocksize. 0 = off. off is a valid lifestyle. πŸ’€
  • -m <val> β€” STmin in ms/ns. see spec, bestie, I can't do everything for you. πŸ“–
  • -w <num> β€” max. wait frame transmissions. the limit is real. 🚧
  • -D β€” daemonize to background when the tun device is created. she needs her alone time. πŸŒ™
  • -h β€” half duplex mode. sharing is caring, but only one direction at a time. πŸ™ˆ
  • -v β€” verbose mode. prints symbols for tunneled msgs, so you can see everything and be nosy. πŸ”

πŸ’œ THE HEX THING πŸ’œ

CAN IDs and addresses are given and expected in hexadecimal values. that's not a suggestion, that's the law. 🚨

so for example, to create a point-to-point IP connection on CAN, you'd do:

ifconfig ctun0 123.123.123.1 pointopoint 123.123.123.2 up

look at her go. ctun0 said "I'm up" and meant it. 🌈

no cap, that ifconfig line is the whole plot twist. copy it exactly, don't freestyle the addresses. 😭


well bestie, that's the whole page πŸ’– sending you off with isotptun 2023.03-1build1, dated December 2025, manual section ISOTPTUN(1). go tunnel something cute, drink some water, and remember: hexadecimal is just numbers with extra sparkle. βœ¨πŸŽ€πŸ¦‹

πŸ“¦ where this page comes from