UHSOCTL(1)

💅 NAME 💅

uhsoctl — connection utility for Option based devices.

okay so this is the General Commands Manual page for it, bestie — we’re folding that manual name in right here instead of copying the header line 🫶

---

✨ SYNOPSIS ✨

uhsoctl [-a apn] [-c cid] [-p pin] [-u username] [-k password] [-r path]
        [-f path] [-b | -n] interface
uhsoctl -d interface
uhsoctl -h

---

🌸 DESCRIPTION 🌸

okay so uhsoctl is a small connection utility for Option N.V. devices that are based on Options packet interface and uses proprietary AT_* calls to establish connections. The utility (tries to) configure both default route and name servers (/etc/resolv.conf).

By default, uhsoctl detaches from the terminal upon a successful connection, and a few command-line options exist that allow this behavior to be changed. slay for automation, honestly 💅

uhsoctl attempts to find a usable controlling serial port based on the provided network interface. If this fails, you might specify a serial port manually. no cap, sometimes you just gotta point it at the right thing yourself 🎀

---

🎀 OPTIONS 🎀

• -a apn — specify the APN to connect to. that’s the vibe check for where you’re connecting ✨
• -c cid — specify the CID (Context ID) to use. by default, CID 1 is used. if an APN has been configured once, it’s enough to specify the CID used for further accesses. lowkey efficient 💖
• -p pin — specify SIM PIN. gotta unlock the SIM, bestie 🔑
• -u username — specify username.
• -k password — specify username. yes, the page literally says Specify username. here too 💀 i am preserving the chaos exactly as it is.
• -r path — path to resolv.conf, default /etc/resolv.conf. use /dev/null to disable updating of name servers. iconic little off switch 🫶
• -f path — explicitly set the serial port to use as controlling terminal. might be needed if the automatic detection fails. backup plan behavior ✨
• -b — fork into background directly, before a connection has been established. main character energy: leave immediately 💅
• -n — never fork into background, run entirely in foreground. stay right here with me, no disappearing acts 🌸

---

🦋 EXAMPLES 🦋

connect to “apn.example.com” on interface “uhso0” and use PIN “1234” to enable the SIM card:

uhsoctl -a apn.example.com -p 1234 uhso0

disconnect from a previously established connection:

uhsoctl -d uhso0

---

🌈 SEE ALSO 🌈

• uhso(4) — device-level lore, iykyk 👑

---

xoxo, Debian — page dated August 12, 2009 💖🫶