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