GAMMU-SMSDRC(5)

NAME

gammu-smsdrc - gammu-smsd(1) configuration file

SYNOPSIS
/etc/gammu-smsdrc

DESCRIPTION
gammu-smsd(1) reads configuration from a config file. It's location can be specified on command line, otherwise default path /etc/gammu-smsdrc is used. This file use ini file syntax, with comments being marked with both ; and #. Sections of config file are identified in square brackets line [this]. All key values are case insensitive. Configuration file of gammu-smsd consists of two sections - [gammu] and [smsd]. The [gammu] section is configuration of a phone connection and is same as described in gammurc(5) with the only exception that logfile is ignored and common logging for gammu library and SMS daemon is used. However the logformat directive still configures how much messages gammu emits. The [smsd] section configures SMS daemon itself, which are described in following subsections. First general parameters of SMS daemon are listed and then specific parameters for storage backends.

  General parameters of SMS daemon

Service
    SMSD service to use, one of FILES, MYSQL, PGSQL (depends on compiled in support for backends).

PIN PIN for SIM card. This is optional, but you should set it if your phone after power on requires PIN.

LogFile
    File where SMSD actions are being logged. You can also use special value "syslog" which will send all messages to syslog daemon. On Windows another special value "eventlog" exists, which will send logs to Windows Event Log. Default is to provide no logging.

CommTimeout
    How many seconds should SMSD wait after each read/write loop. Default is 30.

SendTimeout
    Shows how many seconds SMSD should wait for network answer during sending sms. If nothing happen during this time, sms will be resent. Default is 30.

ReceiveFrequency
    The number of seconds between testing for received SMSes, when the phone is busy sending SMSes. Normally a test for received SMSes is done every CommTimeout seconds and after each sent SMS. Default is 0 (not used).

CheckSecurity
    Whether to check if phone wants to enter PIN. Default is 1 (enabled).

ResetFrequency
    The number of seconds between performing a preventive soft reset in order to minimize the cases of hanging phones e.g. Nokia 5110 will sometimes freeze to a state when only after unmounting the battery the phone will be functional again. Default is 0 (not used).

DeliveryReport
    Whether delivery reports should be used, one of 'no', 'log', 'sms'. log - one line log entry,
    sms - store in inbox as a received SMS
    no - no delivery reports Default is 'no'.

DeliveryReportDelay
    Delay in seconds how long is still delivery report considered valid. This depends on brokeness of your network (delivery report should have same timestamp as sent message). Increase this if delivery reports are not paired with sent messages.

    Default is 10.

PhoneID
    String with info about phone used for sending/receiving. This can be useful if you want to run several SMS daemons.

RunOnReceive
    Executes a program after receiving message. The program will receive identifiers of received messages depending on used service backend (some backends might not support this feature).

DebugLevel
    Debug level for SMSD. The integer value should be sum of all flags you want to enable. 1 - enables basic debugging information
    2 - enables logging of SQL queries of service backends
    4 - enables logging of gammu debug information (has to be enabled also in gammu section) Generally to get as much debug information as possible, use 255. Default is 0, what should mean no extra information.

  Database backends options
Both MYSQL and PGSQL backends (see gammu-smsd-mysql(7), gammu-smsd-pgsql(7) for their documentation) supports same options for configuring connection to a database:

User
    User name used for connection to a database.

Password
    Password used for connection to a database.

PC  Database server address. It can also contain port or socket path after semicolon, for example localhost:/path/to/socket.

Database
    Name of database to use. Please note that you should create tables in this database before using gammu-smsd. SQL files for creating needed tables are included in documentation.

SkipSMSCNumber
    When you send sms from some SMS centere you can have delivery reports from other SMSC number. You can set here number of this SMSC used by you and Gammu will not check it's number during assigning reports to sent SMS.

  Files backend options
The FILES backend accepts following configuration options. See gammu-smsd-files(7) for more detailed service backend description. Please note that all path should contain trailing path separator (/ on Unix systems):

InboxPath
    Where the received SMSes are stored. Default is current directory.

OutboxPath
    Where SMSes to be sent should be placed. Default is current directory.

SentSMSPath
    Where the transmitted SMSes are placed, if same as OutBoxPath transmitted messages are deleted. Default is to delete transmitted messages.

ErrorSMSPath
    Where SMSes with error in transmission is placed. Default is same as SentSMSPath.

InboxFormat
    The format in which the SMS will be stored: 'detail', 'unicode', 'standard'. detail - format used for message backup by gammu(1)
    unicode - message text stored in unicode (UTF-16)
    standard - message text stored in system charset Default is 'unicode'.

TransmitFormat
    The format for transmitting the SMS: 'auto', 'unicode', '7bit'. Default is 'auto'.

EXAMPLE
There is more complete example available in Gammu documentation. Please note that for simplicity following examples do not include [gammu] section, you can look into gammurc(5) for some examples how it can look like. SMSD configuration file for FILES backend could look like:

    [smsd]
    Service = files
    PIN = 1234
    LogFile = syslog
    InboxPath = /var/spool/sms/inbox/
    OutboPpath = /var/spool/sms/outbox/
    SentSMSPath = /var/spool/sms/sent/
    ErrorSMSPath = /var/spool/sms/error/

If you want to use MYSQL backend, you will need something like this:

    [smsd]
    Service = mysql
    PIN = 1234
    LogFile = syslog
    User = smsd
    Password = smsd
    PC = localhost
    Database = smsd

SEE ALSO
gammu-smsd(1), gammu(1), gammurc(5) gammu-smsd-files(7), gammu-smsd-mysql(7), gammu-smsd-pgsql(7)

AUTHOR
gammu-smsd and this manual page were written by Michal Cihar <michal@cihar.com>.

COPYRIGHT
Copyright © 2009 Michal Cihar and other authors. License GPLv2: GNU GPL version 2 <http://www.gnu.org/licenses/old-licenses/gpl-2.0.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

REPORTING BUGS
Please report bugs to <http://bugs.cihar.com>.