Man Linux: Main Page and Category List

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