gsmsmsstore8

Usage

Overview

gsmsmsstore can store or retrieve SMS messages entries residing in a GSM mobile phone's SMS store to or from a file, add SMS messages to a store, or list the store's contents. Additionally, it is possible to add SMS submit messages to a store.

gsmsmsstore reads entries from the source which can be a mobile phone (if a serial device file is given) or a file (if a file name is given). The source is never modified. gsmsmsstore writes SMS messages to a destination file or device in the case of --copy, --backup, and --add.

The --list option does not change any file but just lists the contents to standard output.

The --backup and --copy options require both source and destination files or devices. The --list option requires a source. The --add and --delete options require a destination file or device.

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.

SMS message files are not human-readable.

Error messages are printed to the standard error output. If the program terminates on error the error code 1 is returned.

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

The following command lists all entries in the mobile phone connected to /dev/mobilephone to the standard output:

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

The following 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