bionic (8) gsmsmsstore.8.gz

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