Provided by: gsm-utils_1.10+20120414.gita5e5ae9a-0.3_i386 bug

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