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

NAME

       gsmsmsd - SMS message reception daemon

SYNOPSIS

       gsmsmsd  [  -a  action  ] [ --action action ] [ -b baudrate ] [ --baudrate baudrate ] [ -c
       concatenatedID ] [ --concatenate concatenatedID ] [ -C service centre address  ]  [  --sca
       service  centre  address  ] [ -d device ] [ --device device ] [ -D ] [ --direct ] [ -f ] [
       --flush ] [ -h ] [ --help ] [ -I  init  string  ]  [  --init  init  string  ]  [  -r  ]  [
       --requeststat ] [ -s spool directory ] [ --spool spool directory ] [ -t SMS store name ] [
       --store SMS store name ] [ -v ] [ --version ] [ -X ] [ --xonxoff ] { sms_type }

DESCRIPTION

       gsmsmsd reads new incoming SMS from the mobile phone and dispatches them to a user-defined
       action. Additionally it can send SMS message that it reads from a spooldir.

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

       If no action is given, the SMS message is printed to the standard output. If an action  is
       specified  the  action  is excecuted using the shell and the SMS message is written to the
       standard input of the action.

       gsmsmsd needs one empty storage slot for SMS messages in the mobile phone,  otherwise  SMS
       reception will not work. The SMS store to use for temporary storage of incoming SMS can be
       selected using the --store option, otherwise the ME default store is used.

       To terminate gsmsmsd cleanly (without losing SMS messages) one should send  either  SIGINT
       (CTRL-C on the command line) or SIGTERM to the process.

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

       sms_type may be any combination of:

       sms, no_sms
              Controls reception of normal SMS messages.

       cb, no_cb
              Controls reception of cell broadcast messages.

       stat, no_stat
              Controls reception of status reports.

       The default is sms, cb, and stat.

OPTIONS

       -a action, --action action
              The action to execute for each incoming SMS message. If no action is given the  SMS
              is written to the standard output.

       -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. This number is
              increased by one for every outgoing concatenated SMS and wraps  around  after  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.

       -D, --direct
              Enables direct routing of incoming SMS messages to the TE. This is not supported by
              many mobile phone/GSM modem  combinations.  Therefore,  the  default  is  to  store
              incoming SMS temporarily before processing them in the indicated store.

       -f, --flush
              This option causes gsmsmsd to flush (ie. read and erase) existing SMS messages from
              the SMS store selected by the --store option. The  action  given  by  the  --action
              option is executed on each of the flushed SMS. This option should be used to ensure
              that enough space is available in the SMS store for temporary storage  of  incoming
              SMS, otherwise incoming SMS might be ignored silently by the ME.

       -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. Note: This option  only  makes  sense  if  the
              phone  supports  routing  of status reports to the TE. Otherwise the status reports
              might show on the phone's display or get lost.

       -s spool directory, --spool spool directory
              This option sets the spool directory where gsmsmsd expects SMS  messages  to  send.
              The format of SMS files is very simple: The first line contains the phone number of
              the recipient. Everything else after the first line is interpreted as the SMS text.
              Please refer to gsmsendsms(1) for details on the SMS text character set and maximum
              length.  gsmsmsd polls the spool directory every 5 seconds. Sent SMS message  files
              are removed.

       -t SMS store name, --store SMS store name
              The  name  of  the SMS store to read from (for the --flush option) or write to (for
              temporary SMS storage). This option must be must be used in  conjunction  with  the
              --flush  option.  If  this option is omitted the ME uses it's default SMS store for
              temporary storage of incoming SMS. A commonly available message store is "SM"  (SIM
              card).

       -v, --version
              Prints the program version.

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

EXAMPLES

       The  following invocation of gsmsmsd sends each incoming SMS message as a mail to the user
       "smsadmin":

       gsmsmsd -d /dev/ttyS2 -b 19200 -a "mail smsadmin"

       This is the format of SMS deliver messages as output from gsmsmsd:

       ----------------------------------------------------------------
       Message type: SMS-DELIVER
       SC address: '491710762100'
       More messages to send: 1
       Reply path: 0
       User data header indicator: 0
       Status report indication: 0
       Originating address: '01805000102'
       Protocol identifier: 0x39
       Data coding scheme: default alphabet
       SC timestamp: 17.12.98 14:10:55(+0100)
       User data length: 159
       User data header: 0x
       User data: 'Nicht vergessen! Die XtraWeihnachtsverlosung lauft
       noch bis zum 24.12. Nutzen Sie jetzt Ihre Gewinnchance und faxen
       Sie Ihren Teiln.-Gutschein an 0180/5000 056'
       ----------------------------------------------------------------

       This is the format of SMS status report messages as output from gsmsmsd:

       ----------------------------------------------------------------
       Message type: SMS-STATUS-REPORT
       SC address: ''
       More messages to send: 0
       Status report qualifier: 0
       Message reference: 0
       Recipient address: ''
       SC timestamp: 00.00.00 00:00:00(+0000)
       Discharge time: 00.00.00 00:00:00(+0000)
       Status: 0x0 'Short message received by the SME'
       ----------------------------------------------------------------

       The following invocation of gsmsmsd flushes all existing messages from the "SM" SMS  store
       and looks in the "/tmp/spooldir" directory for SMS to send:

       gsmsmsd -d /dev/ttyS2 --spool /tmp/spooldir -f --store sm \
       --action 'mail smsadmin'

FILES

       /dev/mobilephone
                     Default mobile phone device.

AUTHOR

       Peter Hofmann <software@pxh.de>

BUGS

       Cell  broadcast  SMS message reception has not been tested, but it has been enabled in the
       gsmsmsd daemon.

       The mobile phone device is blocked when the gsmsmsd daemon is running, ie.  it  cannot  be
       used for data transfer or from the other programs of this suite (gsmpb, gsmsms).

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

COPYRIGHT

       Copyright © 1999 Peter Hofmann

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

       gsmsmsd 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
       gsmsmsd;  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), gsmsendsms(1), gsmsmsstore(1).