Provided by: gammu-smsd_1.37.0-1build1_amd64 bug


       gammu-smsd-run - documentation for RunOnReceive directive


       Gammu  SMSD  can be configured by RunOnReceive directive (see gammu-smsdrc for details) to
       run defined program after receiving every message. It can receive single message  or  more
       messages, which are parts of one multipart message.

       This  parameter  is  executed  through  shell,  so  you  might need to escape some special
       characters and you can include any number  of  parameters.  Additionally  parameters  with
       identifiers  of received messages are appended to the command line. The identifiers depend
       on used service backend, typically it is ID of inserted row for database backends or  file
       name for file based backends.

       Gammu  SMSD  waits  for the script to terminate. If you make some time consuming there, it
       will make SMSD not receive new messages. However to limit breakage  from  this  situation,
       the  waiting  time is limited to two minutes. After this time SMSD will continue in normal
       operation and might execute your script again.

          All input and output file descriptors are closed when this program is invoked,  so  you
          have to ensure to open files on your own.


       New in version 1.28.0.

       Program  is executed with environment which contains lot of information about the message.
       You can use it together with NULL service (see gammu-smsd-null)  to  implement  completely
       own processing of messages.

   Global variables
              Number of physical messages received.

              Number of decoded message parts.

   Per message variables
       The  variables  further  described  as  SMS_1_... are generated for each physical message,
       where 1 is replaced by current number of message.

              Class of message.

              Sender number.

              Message text. Text is not available for 8-bit binary messages.

   Per part variables
       The variables further described as DECODED_1_... are  generated  for  each  message  part,
       where  1 is replaced by current number of part. Set are only those variables whose content
       is present in the message.

              Decoded long message text.

              Sender of MMS indication message.

              title of MMS indication message.

              Address (URL) of MMS from MMS indication message.

              Size of MMS as specified in MMS indication message.


   Activating RunOnReceive
       To activate this feature you need to set RunOnReceive in the gammu-smsdrc.

          RunOnReceive = /path/to/

   Processing messages from the files backend
       Following script (if used as RunOnReceive handler) passes message data to  other  program.
       This works only with the gammu-smsd-files.

          for ID in "$@" ; do
              $PROGRAM < $INBOX/$ID

   Invoking commands based on message text
       Following  script  (if  used  as  RunOnReceive  handler)  executes given programs based on
       message text.


          # Check for sender number
          if [ "$SMS_1_NUMBER" != "+420123456789" ] ; then

          # Handle commands
          case "$SMS_1_TEXT" in
              "DMS A")
              "DMS B")

   Passing message text to program
       Following script (if used as RunOnReceive handler)  passes  message  text  and  sender  to
       external program.

          for i in `seq $SMS_MESSAGES` ; do
              eval "$PROGRAM \"\${SMS_${i}_NUMBER}\" \"\${SMS_${i}_TEXT}\""

   Passing MMS indication parameters to external program
       Following  script  (if  used  as  RunOnReceive  handler) will write information about each
       received MMS indication to the log file. Just replace echo command with your  own  program
       to do custom processing.

          if [ $DECODED_PARTS -eq 0 ] ; then
              # No decoded parts, nothing to process
          if [ "$DECODED_1_MMS_ADDRESS" ] ; then
              echo "$DECODED_1_MMS_ADDRESS" "$DECODED_1_MMS_SENDER" "$DECODED_1_MMS_TITLE" >> /tmp/smsd-mms.log

   Processing message text in Python
       Following  script (if used as RunOnReceive handler) written in Python will concatenate all
       text from received message:

          #!/usr/bin/env python
          from __future__ import print_function
          import os
          import sys

          numparts = int(os.environ['DECODED_PARTS'])

          # Are there any decoded parts?
          if numparts == 0:
              print('No decoded parts!')

          # Get all text parts
          text = ''
          for i in range(1, numparts + 1):
              varname = 'DECODED_%d_TEXT' % i
              if varname in os.environ:
                  text = text + os.environ[varname]

          # Do something with the text
          print('Number %s have sent text: %s' % (os.environ['SMS_1_NUMBER'], text))


       Michal Čihař <>


       2009-2015, Michal Čihař <>