NAME

       gsmsendsms - SMS message sender utility

SYNOPSIS

       gsmsendsms  [  -b baudrate ] [ --baudrate baudrate ] [ -c concatenatedID ] [ --concatenate
       concatenatedID ] [ -C service centre address ] [ --sca  service  centre  address  ]  [  -d
       device ] [ --device device ] [ -h ] [ --help ] [ -I init string ] [ --init init string ] [
       -r ] [ --requeststat ] [ -t ] [ --test ] [ -v ] [  --version  ]  [  -X  ]  [  --xonxoff  ]
       phonenumber [ text ]

DESCRIPTION

       gsmsendsms sends SMS short messages using an GSM mobile phone.

       gsmsendsms  attaches itself to the device given on the command line (usually an GSM modem)
       using the specified baudrate.  If no device is given, the device /dev/mobilephone is used.
       If no baudrate is given, a default baud rate of 38400 is used.

       gsmsendsms  accepts  a  phone  number  (recipient  address)  and the short message text as
       parameters. The text may have a maximum length of 160 characters which is the maximum  SMS
       message  length.  The  GSM  default  alphabet  is  used  for  encoding.  ASCII and Latin-1
       characters that can not be encoded using the GSM default alphabet are converted to the GSM
       delta character (GSM code 16).

       Error  messages  are  printed  to the standard error output.  If the program terminates on
       error the error code 1 is returned.

OPTIONS

       -b baudrate, --baudrate baudrate
              The baud rate to use.

       -c concatenatedID, --concatenate concatenatedID
              If an ID is given, large SMSs are split into several, concatenated SMSs.  All  SMSs
              have  the  same  ID  and are numbered consecutively so that the receiving phone can
              assemble them in the correct order. IDs must  be  in  the  range  0..255.  Not  all
              receiving  phones  will  support  concatenated  SMSs  (and display them as separate
              SMSs), since all the numbering and ID information  is  carried  in  the  user  data
              header  element at the beginning of the SMS user data. This information may show up
              as garbage in such phones.

       -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 device, --device device
              The device to which the GSM modem is connected. The default is /dev/mobilephone.

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

       -r, --requeststat
              Request status reports for sent SMS.

       -t, --test
              If this option is given the text is converted to the GSM default alphabet and  back
              to  Latin-1.  This  option  can  be used to find out how ASCII or Latin-1 texts are
              converted to the GSM default alphabet. Characters that can not be converted to  the
              GSM  default  alphabet are reported as ASCII code 172 (Latin-1 boolean "not") after
              this double conversion. No SMS messages are sent, a connection to a mobile phone is
              not established.

       -v, --version
              Prints the program version.

       -X, --xonxoff
              Uses software handshaking (XON/XOFF) for accessing the device.

EXAMPLES

       The  following  two invocations of gsmsendsms each send the same SMS message to the number
       "1234":

       gsmsendsms -d /dev/ttyS2 -b 19200  1234 "This is a test."
       echo "This is a test." | gsmsendsms -d /dev/ttyS2 -b 19200  1234

FILES

       /dev/mobilephone
                     Default mobile phone device.

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 gsmsendsms you are using.

COPYRIGHT

       Copyright © 1999 Peter Hofmann

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

       gsmsendsms  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
       gsmsendsms; see the file COPYING.  If not, write to the Free Software Foundation, 675 Mass
       Ave, Cambridge, MA 02139, USA.

SEE ALSO

       gsminfo(7), gsmpb(1), gsmctl(1), gsmsmsd(8), gsmsmsstore(1).