GSMSMSSTORE(8)

📦
version 1.10+20120414.gita5e5ae9a · 5 versions
, in ubuntu noble, ubuntu questing

💖 gsmsmsstore — the manual page, but make it make sense 💖

okay so bestie, welcome to gsmsmsstore(8) from the System Manager's Manual section. this is the little icon that shuffles SMS messages in and out of your phone's SMS store, and i'm gonna walk you through it like we're texting at 2am. no cap. 🫶

✨ NAME ✨

gsmsmsstore — the SMS store manipulation program. that's it, that's the whole job. she stores, she retrieves, she slays. 💅

🦋 SYNOPSIS 🦋

gsmsmsstore [ -a ] [ --add ] [ -b baudrate ] [ --baudrate baudrate ]
            [ -c ] [ --copy ] [ -C service centre address ]
            [ --sca service centre address ]
            [ -d destination device or file ]
            [ --destination destination device or file ]
            [ -h ] [ --help ] [ -I init string ] [ --init init string ]
            [ -k ] [ --backup ] [ -l ] [ --list ]
            [ -s source device or file ] [ --source source device or file ]
            [ -t SMS store name ] [ --store SMS store name ]
            [ -v ] [ --version ] [ -V ] [ --verbose ] [ -x ] [ --delete ]
            [ -X ] [ --xonxoff ]
            { indices } [ phonenumber text ]

like… yes, that's a lot of brackets. she's high maintenance but she's worth it. 😭

🌸 DESCRIPTION 🌸

so what does she actually do? gsmsmsstore can:

  • store or retrieve SMS message entries that live in a GSM mobile phone's SMS store, moving them to or from a file 🎀
  • add SMS messages to a store
  • list the store's contents

and bonus: you can also add SMS submit messages to a store. versatile queen. 👑

here's the whole vibe of how it reads and writes:

gsmsmsstore reads entries from the source, which can be either a mobile phone (if you hand it a serial device file) or a file (if you hand it a file name). and listen — the source is never modified. hands off. 🙈 gsmsmsstore writes SMS messages to a destination file or device in the case of --copy, --backup, and --add.

the --list option doesn't change any file at all — she just lists the contents to standard output. no drama, no edits. ✨

now the requirements, because she has them:

  • --backup and --copy need both a source and a destination (file or device, respectively)
  • --list needs a source
  • --add and --delete need a destination file or device

and the cute little trick: if "-" is given as the parameter for the --source or --destination options, the SMS store is read from standard input and/or written to standard output, respectively. pipe girlies rise up. 🌈

⚠️ heads up: SMS message files are not human-readable. do not open them and expect poetry. it's giving binary. 💀

error messages get printed to the standard error output. and if the program terminates on error, the error code 1 is returned. noted. 📝

💅 OPTIONS 💅

  • -a, --add — Adds an SMS submit message with recipient address phonenumber and text text to the destination.
  • -b baudrate, --baudrate baudrate — The baud rate to use. The default baudrate is 38400.
  • -c, --copy — This causes the contents of the source to be copied to the destination. After this operation the destination has exactly the same contents as the source. If indices are given on the command line, only those SMS messages denoted by the indices are copied to the destination.
  • -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 destination, --destination destination — The destination device or file.
  • -h, --help — Prints an option summary.
  • -I init string, --init init string — Initialization string to send to the TA (default: "E0"). Note that the sequence "ATZ" is sent first.
  • -k, --backup — This causes those entries to be added from the source to the destination that are not already present in the destination. If indices are given on the command line, only those SMS messages denoted by the indices are backed up (ie. added) to the destination.
  • -l, --list — Prints out the entire contents of the source in human-readable form.
  • -s source, --source source — The source device or file.
  • -t SMS store name, --store SMS store name — The name of the SMS store to read from or write to. This information is only used for device sources and destinations. A commonly available message store is "SM" (SIM card).
  • -v, --version — Prints the program version.
  • -V, --verbose — Prints out a detailed progress report.
  • -x, --delete — Delete the SMS messages as denoted by the indices from the destination.
  • -X, --xonxoff — Uses software handshaking (XON/XOFF) for accessing the device.

🎀 EXAMPLES 🎀

okay real ones, here's how you actually run her. 🧚

this one lists all entries in the mobile phone connected to /dev/mobilephone to the standard output:

gsmsmsstore -b 19200 -s /dev/mobilephone -t SM -l

and this one adds entries 4, 7, and 10 from the device /dev/mobilephone to the file smsstore:

gsmsmsstore -s /dev/mobilephone -d /home/fred/smsstore
    -t SM -b 4 7 10

see? not scary. ate and left no crumbs. 🔥

🌟 AUTHOR 🌟

Peter Hofmann <software@pxh.de>

(legend behaviour, honestly.)

💀 BUGS 💀

Report bugs to software@pxh.de. Include a complete, self-contained example that will allow the bug to be reproduced, and say which version of gsmsmsstore you are using. fr fr, they need the receipts — a vague "it broke" will not get you anywhere bestie. 😭

Copyright © 1999 Peter Hofmann

gsmsmsstore 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.

gsmsmsstore 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.

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

💜 yes, that's the legal bit, and yes, you still have to read it. it's giving "read the group chat rules" energy.

🌈 SEE ALSO 🌈

gsminfo(7), gsmctl(1), gsmpb(1), gsmsendsms(1), gsmsmsd(8).

iykyk — go read those next, they're the rest of the friend group. 🦋

and that's the whole page!! this was gsmsmsstore v1.10, dated Sun Mar 31 18:20:52 UTC 2024, and honestly? iconic. go back up your SIM card. periodt. ✨💖🎀

📦 where this page comes from