inetcat(1)

📦
version 2.1.1 · 2 versions
, in alpine 3.24, arch rolling, debian trixie, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 inetcat(1) — the General Commands Manual girlies' edition 💖

okay so bestie, welcome to inetcat, straight outta the General Commands Manual. she's a tiny little tool with a huge job and honestly? she ate. let's get into it 🫶

✨ NAME ✨

inetcat — Opens a read/write interface via STDIN/STDOUT to a TCP port on a usbmux device

like. that's the whole vibe. a lil tunnel to a port on your usbmux device and you talk to it through STDIN/STDOUT. iconic 💅

🌸 SYNOPSIS 🌸

inetcat [OPTIONS] <DEVICE_TCP_PORT>

that's it. that's the whole shape of it. one port, some options, no drama ✨

🦋 DESCRIPTION 🦋

so inetcat is a simple netcat-like tool, fr fr. what it does is it lets you open a read/write interface to a TCP port on a usbmux device, and then it exposes that whole thing through STDIN/STDOUT. so like, you talk to it, it talks to the device, everybody's connected. main character behaviour only 👑

🎀 OPTIONS 🎀

  • -u, --udid UDID — Target specific device by UDID. ngl this is important: if you do NOT specify this option, inetcat will connect to the first device found. like, whoever shows up first. no thoughts, head empty 🙈
  • -n, --network — Connect to network device. for this to work the device needs to have WiFi sync enabled and needs to be paired with this computer. also heads up bestie: a device might close connections at any time to save power, that's just how it is 😭. this option will make inetcat connect to network attached devices only, unless -l is passed too (see below 👇).
  • -l, --local — Connect to USB device. this is the default if no option is passed, so if you're just vibing, this is already what's happening. and if you use it together with -n, inetcat will first attempt a connection to a device attached via USB, and if that's not available, attempt to reach a device via network. like a lil fallback chain, obsessed 🌈
  • -h, --help — Prints usage information. the classic. the icon.
  • -d, --debug — Increase debug level. more -d, more info, more chaos, your call 🔥

⭐ EXAMPLE ⭐

Use ssh ProxyCommand to connect to a jailbroken iOS device via SSH:

$ ssh -oProxyCommand="inetcat 22" root@localhost

Used in SSH config file to connect to iOS Device:

$ cat ~/.ssh/config Host myiphone
  User root
  ProxyCommand "icat 22 UDID_of_my_iphone" $ ssh myiphone

💜 AUTHOR 💜

Adrien Guinet

give them their flowers, they wrote the whole thing 🌸

🌟 SEE ALSO 🌟

🌈 ON THE WEB 🌈

k that's the whole page bestie, no cap, every option is in there, nothing skipped, go connect to something 💖

and that's a wrap!! this was the inetcat(1) page from the General Commands Manual — no version number, no date stamped on it, so consider this your cute lil sign-off instead. slay, stay hydrated, and remember: -l is the default 🫶✨🎀

📦 where this page comes from