GSMSENDSMS(8)

💖 GSMSENDSMS — the SMS sender utility, bestie edition ✨

okay so this is a section 8 man page (system manager's manual, iykyk) for gsmsendsms, and honestly? she's iconic. she sends SMS messages through a GSM mobile phone like it's nothing. let's get into it 🫶

---

🌸 NAME 🌸

gsmsendsms — the SMS message sender utility. that's it, that's her whole job, and she does it flawlessly 💅

---

✨ SYNOPSIS ✨

gsmsendsms [ -b baudrate ] [ --baudrate baudrate ] [ -c concatenatedID ]
[ --concatenate concatenatedID ] [ -C service centre address ] [ --sca
service centre address ] [ -d device ] [ --device device ] [ -h ] [
--help ] [ -I init string ] [ --init init string ] [ -r ] [
--requeststat ] [ -t ] [ --test ] [ -v ] [ --version ] [ -X ] [
--xonxoff ] phonenumber [ text ]

---

🦋 DESCRIPTION 🦋

okay so gsmsendsms sends SMS short messages using a GSM mobile phone. main character behavior, fr fr 💅

she attaches herself to the device you give her on the command line (usually a GSM modem) using the baudrate you specified. no device? she defaults to /dev/mobilephone, no cap. no baudrate? default is 38400 and she's not sorry about it. ✨

then she takes a phone number (the recipient address) and the short message text as parameters. the text can be a maximum of 160 characters — that's the max SMS message length, bestie, don't push it 😭. the GSM default alphabet is what's used for encoding. and listen: ASCII and Latin-1 characters that can't be encoded with the GSM default alphabet get converted to the GSM delta character (GSM code 16). that's just how she rolls 🎀

error messages go to the standard error output. and if the program terminates on error, the error code 1 is returned. periodt. 💀

---

💅 OPTIONS 💅

so many little knobs and dials, she's so versatile 🧚

• -b baudrate, --baudrate baudrate — the baud rate to use. that's the vibe check for your connection speed ✨
• -c concatenatedID, --concatenate concatenatedID — if you give an ID, large SMSs get split into several, concatenated SMSs. all of them share the same ID and are numbered consecutively so the receiving phone can assemble them in the correct order. IDs must be in the range 0..255. ⚠️ not all receiving phones support concatenated SMSs (some will just show them as separate SMSs), because all the numbering and ID info is carried in the user data header element at the beginning of the SMS user data. and on those phones, that info may show up as garbage. you've been warned 🫠
• -C service centre address, --sca service centre address — sets the service centre address to use for all SUBMIT SMSs (may not work with some phones 🙈)
• -d device, --device device — the device to which the GSM modem is connected. the default is /dev/mobilephone 💖
• -h, --help — prints an option summary. your lil cheat sheet 🌸
• -I init string, --init init string — initialization string to send to the TA (default: "E0"). note that the sequence "ATZ" is sent first. just so you know 👑
• -r, --requeststat — request status reports for sent SMS. she's keeping receipts 💅
• -t, --test — if you give this option, the text is converted to the GSM default alphabet and back to Latin-1. super useful for finding out how ASCII or Latin-1 texts get converted to the GSM default alphabet! characters that can't be converted to the GSM default alphabet are reported as ASCII code 172 (Latin-1 boolean "not") after this double conversion. and nope, no SMS messages are sent and no connection to a mobile phone is established. it's purely a vibe check, nothing more 🌈
• -v, --version — prints the program version ⭐
• -X, --xonxoff — uses software handshaking (XON/XOFF) for accessing the device 🔥

---

🎀 EXAMPLES 🎀

these two invocations of gsmsendsms each send the same SMS message to the number "1234". look at her being flexible 💖

gsmsendsms -d /dev/ttyS2 -b 19200  1234 "This is a test."
echo "This is a test." | gsmsendsms -d /dev/ttyS2 -b 19200  1234

---

🍓 FILES 🍓

• /dev/mobilephone — default mobile phone device. the one she goes to when you don't tell her otherwise 🥺

---

💜 AUTHOR 💜

Peter Hofmann <software@pxh.de> — the legend, the icon, the moment 👑

---

💀 BUGS 💀

report bugs to software@pxh.de. include a complete, self-contained example that will let the bug be reproduced, and say which version of gsmsendsms you're using. help her help you, bestie 🙏

---

🌟 COPYRIGHT 🌟

Copyright © 1999 Peter Hofmann

gsmsendsms is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.

gsmsendsms is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. see the GNU Library General Public License for more details. (this part is serious, no jokes, read it fr fr 😤)

you should have received a copy of the GNU Library General Public License along with gsmsendsms; see the file COPYING. if not, write to the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.

---

👀 SEE ALSO 👀

gsminfo(7), gsmpb(1), gsmctl(1), gsmsmsd(8), gsmsmsstore(1) — go read them too, she's not the only queen in this family 💅

---

and that's the whole page, bestie!! 🫶 this was gsmsendsms v1.10, dated Sun Mar 31 18:20:52 UTC 2024. go send some texts, slay, and remember: 160 characters max, no cap 💖✨🎀