Provided by: gsm-utils_1.10-9ubuntu1_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).