NAME
gsmsmsstore - SMS store manipulation program
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 ]
DESCRIPTION
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
AUTHOR
Peter Hofmann <software@pxh.de>
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.
COPYRIGHT
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.
SEE ALSO
gsminfo(7), gsmctl(1), gsmpb(1), gsmsendsms(1), gsmsmsd(8).