Rechercher une page de manuel
gnokii-smsd
Langue: en
Version: 96636 (fedora - 25/11/07)
Section: 8 (Commandes administrateur)
NAME
gnokii-smsd - daemon for handling incoming and outgoing SMSes using libgnokiiSYNOPSIS
gnokii-smsd [OPTIONS]DESCRIPTION
The GNOKII-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. GNOKII-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 gnokii-smsd without -t option you can ignore this column. See -t option below.
- processed
- gnokii-smsd sets this always to FALSE. You can use it for another program which will parse SMSes.
When the phone receives an SMS, GNOKII-SMSD moves it into 'inbox' table and removes the SMS from the phone.
Table 'outbox' is for outgoing SMSes. GNOKII-SMSD periodically looks into this table and searches for lines with attribute 'processed' set to FALSE. If it finds 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 gnokii-smsd without -t option you must not fill this column. See -t option below.
- processed
- new SMS must have this attribute set to FALSE. GNOKII-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.
- not_before
- sms will not be sent before this time (default 00:00:00).
- not_after
- sms will not be sent after this time (default 23:59:59).
GNOKII-SMSD is multi threaded program. If you list processes you will see more than one instance of gnokii-smsd.
THE FILE MODULE
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-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. Foroutgoingmessagesyoucansetspooldirectorywheregnokii-smsdlooks 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 gnokii-smsd ignores all files with prefix "ERR.". If gnokii-smsd succesfully sends sms, it removes file from spool directory. If 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-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.
- -s, --schema db_hostname
- Specify database schema.
- -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, gnokii-smsd searches in libdir for file libpq.so (for mysql - libmysql.so). Do not interchange these plugins with default SQL libraries from database distribution!
- -f, --logfile file
- If used, 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 gnokii-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 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 gnokii-smsd without -t option it will use config from global section. If you run 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-smsd fills phone number for incoming sms's and in outbox it looks only for sms's with the specified phone number in column of gnokii-smsd for every phone you have at the same time.
- [global]
- -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. For the memory_type you usually use SM for the SIM card and ME for the phone memory. The exception are the phones supported by nk7110 (Nokia 7110/6210/6250) and nk6510 (Nokia 6310/6510/8310) drivers. For these you should use IN for the Inbox, OU for the Outbox, AR for the Archive, TE for the Templates and F1, F2, ... for your own folders.
- -v, --version
- Shows gnokii-smsd version.
- -h, --help
- Shows short help.
DIAGNOSTICS
Various error messages are printed to STDERR.BUGS
None reported.
AUTHOR
GNOKII-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
gnokiiContenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre