gnokii-smsd - Man Page

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

Incoming sms are passed in format

Outgoing sms must be in format:

The name of file is unimportant but gnokii-gnokii-smsd.ignores all files with prefix "ERR.". If gnokii-gnokii-smsd.succesfully sends sms, it removes file from spool directory. If gnokii-gnokii-smsd.cannot send sms prepends 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 gnokii-gnokii-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 stdout. If you don't specify -c, sms sending will be disabled.

Available options:

-u, --user db_username

Specify user name.

-p, --password db_password

Specify user password.

-d, --db db_name

Specify database name for 'pq' and 'mysql' modules or full path to database file for 'sqlite' module (defaults to 'sms').

-c, --host db_hostname

Specify database server host name.

-s, --schema db_hostname

Specify database schema used by the PostgreSQL module (defaults to 'public').

-e, --encoding client_encoding

Specify client encoding for database connection.

-m, --module db_module

Specify which module to use for connection to DB server. Currently supported values are 'pq' for PostgreSQL, 'mysql' for MySQL, 'sqlite' for SQLite3 and 'file'. File module is not supported in Windows.

-l, --libdir path_to_db_module

Specify path to DB modules. If you specify pq module, gnokii-gnokii-smsd.searches in libdir for file libsmsd_pq.so (for mysql - libsmsd_mysql.so). Do not interchange these plugins with default SQL libraries from database distribution!

-f, --logfile file

If used, gnokii-gnokii-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 to rotate logs. If you use '-' as filename smsd will use standard output.

-t, --phone phone_number

You can run more instances of gnokii-smsd. One instance per phone. In this setup you must configure phone section in the config file. 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 gnokii-gnokii-smsd.without -t option it will use config from global section. If you run gnokii-gnokii-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 gnokii-gnokii-smsd.fills phone number for incoming sms's and in outbox it looks only for sms's with the specified phone number in column 'phone'. This behaviour gives you possibility to run one instance of gnokii-gnokii-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.

-b, --inbox memory_type

Where to look for new messages (defaults to IN for most Nokia phones and to SM for all other phones). For debugging or for unusual setups you can use another memory type supported by your phone (eg. IN for the Inbox, OU for the Outbox, AR for the Archive, TE for the Templates and F1,...,F20 for your own folders). Use gnokii --showsmsfolderstatus for a list of such memory types.

-0, --firstpos0

SMSD starts messages reading from position 1. If your phone stores sms's  from postion 0, use this option.

-v, --version

Shows gnokii-gnokii-smsd.version.

-h, --help

Shows short help.