TNAT64(1)

πŸ¦‹ TNAT64 β€” the manual page, bestie edition

okay so first things first: this is tnat64(1), a lil General Commands Manual page, and it's about a shell wrapper. she's giving "I'm the middleman between your app and the library that actually does the work" energy and honestly? iconic. πŸ’…


✨ NAME ✨

tnat64 β€” a Shell wrapper that simplifies using the tnat64(8) library. What she does: transparently let an application connect to IPv4 hosts via NAT64 on IPv6-only systems, specifically when the application itself doesn't support IPv6. πŸ¦‹

No cap, that's the whole vibe: your app is stuck in IPv4 land, you're living in an IPv6-only world, and tnat64 is the bestie who translates. 🫢


🌸 SYNOPSIS 🌸

tnat64 [application [application's arguments]]
or tnat64 [on|off]
or tnat64

like. three moods. pick one. 😌


πŸ’– DESCRIPTION πŸ’–

tnat64 is a wrapper between the tnat64 library and the application what you would like to run through NAT64. ✨

that's it, that's the girl. she stands in the middle, holds the door open, and lets the NAT64 happen. 🌈


πŸŽ€ OPTIONS πŸŽ€

  • [application [application's arguments]] β€” run the application exactly as specified, with the environment (LD_PRELOAD) set such that tnat64(8) will transparently forward all connections to the NAT64 via IPv6. literally just hand her your app and its args and she handles the rest. πŸ’œ
  • [on|off] β€” this option adds or removes tnat64(8) from the LD_PRELOAD environment variable. When tnat64(8) is in this variable, all executed applications are automatically NAT64-ed. πŸͺ„
⚠️ okay so listen closely: if you want to use this function, you HAVE to source the shell script from yours, like this: "source /usr/bin/tnat64" or ". /usr/bin/tnat64" β€” do NOT just run it, it will not do the thing, and you will be sad. 😭

Example:

". tnat64 on" -- add the tnat64 lib to LD_PRELOAD
". tnat64 off" -- remove the tnat64 lib from LD_PRELOAD
  • [show|sh] β€” show the current value of the LD_PRELOAD variable. vibe check on your env, fr fr. πŸ”
  • <without any argument> β€” create a new shell with LD_PRELOAD including tnat64(8). main character energy: you get a whole fresh shell that's already NAT64-ed up. πŸ‘‘

πŸ‘‘ AUTHOR πŸ‘‘

This script was created by Tamas SZERB <toma@rulez.org> for the Debian package of tsocks. It (along with this manual page) have since been adapted into the main tsocks project and modified, and then modified to be used with tnat64. πŸ’–

so yeah β€” shoutout to Tamas, and shoutout to the glow-up journey: Debian tsocks ➑️ main tsocks ➑️ tnat64. ate. πŸ“


and that's the whole page, bestie!! this one came to you from the TNAT64 source, TNAT64(1), and no date was given on the original footer so we're just gonna say it's timeless, periodt. πŸ’…βœ¨πŸŒΈπŸ¦‹πŸŽ€