smsd(8)

NAME
smsd - daemon for handling incoming and outgoing SMSes using libgnokii

SYNOPSIS
smsd [OPTIONS]

DESCRIPTION

The SMSD (SMS daemon) program is intended for receiving and sending SMSes.

The program is designed to use modules (plugins) to work with an SQL server. Currently are supported PostgreSQL, MySQL and a special module 'file' which is designed to work without an SQL database (see below for special instructions for the file module). See option --module. SMSD uses an SQL server as a repository for SMSes. You must create a database (default name is 'sms') with tables defined in sms.tables.{module}.sql files. Table 'inbox' is for received SMSes:

    number
        phone number from which is sms received

    smsdate
        date set by SMS center

    insertdate
        date SMS was inserted into table

    text
        SMS text

    phone
        number of phone to use. If you use smsd without -t option you can ignore this column. See -t option below.

    processed
        smsd sets this always to FALSE. You can use it for another program which will parse SMSes.

When the phone receives an SMS, SMSD moves it into 'inbox' table and removes the SMS from the phone.

Table 'outbox' is for outgoing SMSes. SMSD periodicaly looks into this table and searches for lines with attribute 'processed' set to FALSE. If it find such SMS, it will send SMS to 'number':

    number
        recipient's phone number

    processed_date
        date of processing SMS.

    insertdate
        date of inserting SMS in table

    text
        SMS text

    phone
        number of phone to use. If you use smsd without -t option you must not fill this column. See -t option below.

    processed
        new SMS must have this attribut set to FALSE. SMSD will send this SMS and will update 'processed' to TRUE.

    error
        This attribute contains return value of gn_sms_send() function. For explanation of numeric values see <gnokii/error.h> in gnokii source.

    dreport
        request for delivery report per message. Possible values are 0 for no delivery report, 1 for delivery report.

SMSD is multi threaded program. If you list processes you will see more then one instance of smsd.

  THE FILE MODULE

This module doesn't need an SQL server to work. For incoming messages it work in a way that it calls a program giving phone number, date as parameter and the message text on stdin. In the smsd directory there is as example file action. It shows sms data to stdout. If you want something usefull you must write your own action. For outgoing messages you can set spool directory where smsd looks regularly.

Incoming sms are passed in format
    action number date < sms

Outgoing sms must be in format:
    number
    text

The name of file is unimportant but smsd ignores all files with prefix "ERR.". If smsd succesfuly sends sms, it removes file from spool directory. If smsd cannot sends sms prepend file with "ERR." prefix and ignores it. If you use -m file, -u (--user) and -c (--host) will have other meaning. -u is for action (action must be executable) -c is for spool directory where smsd looks for smses. Smsd must have read and write permissions to this directory.

-p, -d parameters have no meaning when -m file is used.

If you don't specify -u, default action is to print sms to stdin. If you don't specify -c, sms sending will be disabled.

  OPTIONS

Available options:

-u, --user db_username
    Specify user name.

-p, --password db_password
    Specify user password.

-d, --db db_name
    Specify database name.

-c, --host db_hostname
    Specify database server host name.

-m, --module db_module
    Specify which module to use for connection to DB server. Currently supported are pq for PostgreSQL and mysql for MySQL.

-l, --libdir path_to_db_module
    Specify path to DB modules. If you specify pq module, smsd searches in libdir for file libpq.so (for mysql - libmysql.so). Do not interchange this plugins with default SQL libraries from database distribution!

-f, --logfile file
    If used, smsd will monitor sms traffic to file "file". File is reopened and closed for every message so you can simply rename or delete it if you want rotate logs. If you use '-' as filename smsd will use standard output.

-t, --phone phone_number
    You can run more instances of smsd. One instance per phone. In this setup you must configure phone section in gnokiirc. For example:
    [global]
    port = /dev/ttyS0
    model = 6110
    initlength = default
    connection = serial
    bindir = /usr/local/sbin/
    use_locking = no
    serial_baudrate = 38400
    smsc_timeout = 10
    [phone_1]
    port = /dev/ttyS0
    model = 6110
    initlength = default
    connection = serial
    bindir = /usr/local/sbin/
    use_locking = no
    serial_baudrate = 38400
    [phone_2]
    port = /dev/ttyS1
    model = AT
    initlength = default
    connection = serial
    bindir = /usr/local/sbin/
    use_locking = no
    serial_baudrate = 38400
    smsc_timeout = 10 In this setup if you run smsd without -t option it will use config from global section. If you run smsd with -t 1 it will use config from phone_1 and likewise with -t 2 uses phone_2. In case of use -t option smsd fill phone number for incoming sms's and in outbox it looks only for sms's with the specified phone number in column of smsd for every phone you have at the same time.

-i, --interval interval
    Polling interval for incoming sms's in seconds. Default is 1 second.

-s, --maxsms number
    When phone driver doesn't support sms status it is possible to specify number of sms's supported by phone. Default is 10. If driver support sms status this option is ignored.

-v, --version
    Shows smsd version.

-h, --help
    Shows short help.

DIAGNOSTICS
Various error messages are printed to STDERR.

BUGS

None reported.

AUTHOR
SMSD was written by Jan Derfinak and contributed by other people. See also Docs/CREDITS from the Gnokii sources.

COPYING
This program is distributed under the GNU Public License.

SEE ALSO
gnokii