SMS Server Tools 3
Home
Future plans (some of them)
- Automatic outgoing binary and unicode message splitting to multipart.
- Built-in Wap Push message support.
- System check procedure to the startup.
- Error handler and reporting feature which can send message(s) to "administrative emergency" number.
- Configuration changes via administrative SMS.
- SMSC Large Account support. (Not coming very soon).
If you have any comments, ideas, needs or other things, please write them
to support website.
Coming to the next version
??.??.2007 3.1beta
Configuration file (smsd.conf):
- keep_filename and store_original_filename settings to select file naming convention
when files are moved between directories.
- It is possible to define an external script or program which is executed regularly within a given interval.
See an usage sample on How to run/use.
- Whitelist can specify a queue to be used with a list of numbers. See more details.
- If a modem needs some idle time after a PIN is entered, new setting pinsleeptime can be used to produce that.
This value is seconds.
- New setting: admin_to, destination number for administrative messages.
- New settings: message_limit, defines a maximum number of messages to be sent. message_count_clear defines
a period to automatically clear the message counter. This value is number of minutes.
- New setting: terminal = yes/no. Enables terminal mode like command line argument -t.
- New setting: filename_preview = number. Defines how many characters of message text is concatenated
to the name of messsage file. Currently works with incoming message files.
- New setting: blockafter = number. Defines number of errors which will cause modem to be blocked. Default value is 3.
See the How to configure for more details.
Outgoing message file:
- While smsd reads the message, all string length's are checked to prevent possible buffer overflows.
- SMSC setting is allowed only if there is a smsc set in the config file.
See the SMS file format for more details.
General:
- Execution order of checkhandler has changed: When the mainspooler finds a message file, checkhandler is
executed first before anything else is done. This allows checkhandler to make changes to the message file,
for example queue selecting or "nickname to phonenumber" replacing. The smsd can also be notified with
return code 2, if checkhandler has spooled a message by itself.
- Execution order of eventhandler has changed: eventhandler is executed after a file is moved to it's
final location. File will then have it's final directory and name, and the smsd does not do any prosessing
with a file after an eventhanler was called.
- When the modem is initialized and modem answers ERROR to some command, an errorsleeptime is spent
and a command is tried once again. If a program is going to terminate while the modem is initialized,
initializing is interrupted immediately.
- Concatenated id start's from the random value between 1 ... 255.
- When finding files from the spooler directories, the oldest file is selected.
- Modem is blocked only if sending has failed because of a modem related reason.
- "SMS sent" log information includes a message id and part information (while sending multipart messsages).
- Status report log information includes a message id and status value.
Bug fixes:
- SMSC setting in the message file did not work. However, usually this setting should not be used.
Version history
14.03.2007 3.0.6
General:
- New header Modem: devicename is automatically inserted to the SENT/FAILED message files.
- Message_id: n and Sent: timestamp headers are inserted to the message file before eventhandler is executed.
Download
20.02.2007 3.0.5
General:
- Termination handling is changed. Previously the main process sent SIGTERM to the whole process group.
With sh shell it was possible that incorrect processes were killed because they were running in the same process group.
Also processes started from the eventhandler received SIGTERM and eventhandler was terminated before the job was completelly done.
New version of smsd sends SIGTERM to the modem processes only. This allows smooth shutdown to the eventhandlers.
If there is some eventhandlers running while the smsd gets a termination signal, an information is written to the logfile
and main process will wait until all modem processes are terminated.
- If smsd is running on terminal (foreground), smsd shuts down when a terminal window is closed.
- Internal combine can now handle 16-bit message reference numbers too.
- Log line titles are now completely process based.
For example the "SMS received" message tells now which one process (=modem) received that SMS.
22.01.2007 3.0.4
Bug fixes:
- Incoming PDU was not handled correctly when there was no SMSC information in the PDU string.
Also note that in this case there will not be From_SMSC: field in the message file,
which should be notified by the event handler.
11.01.2007 3.0.3
The major change is done to daemonizing:
When smsd is started to background (which is default), it forks itself before running processes are created.
This solves some issues when the smsd is started from the sh shell.
It is no more necessary to use the & sign at the end of a starting command line.
There is a command line switch -t available to force smsd to run in terminal (foreground).
If logging or debugging messages are printed to the terminal, smsd runs in foreground by default.
There is also TERMINAL keyword available in the Makefile to force smsd to run in foreground.
The start-stop script sms3 is updated.
The smsd now removes possible infofile and *.LOCK files at startup,
it is no more necessary to take care of them in the script.
New script can be used with most operating systems.
See more details on How to run/use.
General:
- The smstools uses ISO character set in message files.
If a locale is set to UTF-8, smsd does not handle outgoing message files correctly.
There is sample scripts checkhandler-utf-8 and eventhandler-utf-8 in the scripts directory
to demonstrate how character set conversation can be made using checkhandler and eventhandler.
- While smsd reads the configuration, all string length's are checked to prevent possible buffer overflows.
- More checks are done at startup. Fatal errors while reading the config are written to the log and
starting the daemon is prevented. Executable permissions of eventhandler(s) are checked.
- Lockfile is detected by finding ".LOCK" from the end of filename instead of the whole string.
- A logfile setting can be made using the command line argument -l (ell).
This overrides the config file setting.
- If received SMS is status report, log line starts with "SMS received (Report)".
- It's no more necessary to define user=root to get smsd running as a root.
NOTE for Windows users: If you are running smsd as a Windows service, you need to update settings of cygrunsrv.
The smsd should be run in terminal mode and --neverexits option should not be used anymore.
See more details on instructions for Windows.
30.11.2006 3.0.2
General:
- The smsd can be defined to run without root priviledges.
- System check is performed at startup to avoid some potential problems with permissions of directory structure
and some other settings.
- If a config file cannot be read, the smsd does not stay running.
- Only the process id of a main process is written to the pid file.
- Some code cleaning is done to avoid compiler warnings on Solaris 10 (6/06 x86) with gcc.
- mypath setting is not used anymore.
Configuration file (smsd.conf):
- user = username and group = groupname settings to change priviledges for the smsd.
- infofile = filename and pidfile = filename settings to change file locations,
needed when the smsd is not running as a root.
These settings can be overridden by the command line arguments.
See the How to configure for details and
How to run/use for more details.
Bug fixes:
- Sample script mysmsd did not read status report correctly while storing it to the MySQL database.
14.11.2006 3.0.1
General:
- When syslog is used to logging, a modem name is presented in the log line.
- Outgoing PDU: Data Coding Scheme uses message class bits only when message is sent as an alert (flash).
- Some code has 'cleaned' to avoid compiler warning messages.
Bug fixes:
- Syslog call is now made using a format string.
- There was two compiler warnings (with gcc >= 4) because blacklist.c and whitelist.c missed prototypes of exit() function.
- Buffer used to store received PDU's was not initialized correctly.
This caused a runtime error while concatenating multipart messages on latest Ubuntu releases.
02.11.2006 3.0
Bug fixes:
- Blacklist and Whitelist handling: fixed incorrect log message when the file was not readable.
Also fixed the program termination in those cases.
- If write_to_modem failed, for example because the modem was not clear to send, put_command did not free
the memory used by regexp.
- While reading a configuration file there was stack misuse which caused device_list become empty while running on ubuntu 6.10.
25.09.2006 3.0beta
This version is based to the SMS Server Tools version 2.2.8.
Some of new features were previously published as an enhancements to the 2.x version.
Now these features are officially maintained in this new 3.x version of smstools.
New features:
Configuration file (smsd.conf):
- Received PDU's can be stored to the incoming message file. It's possible to select which kind of PDU's will be stored.
- Message validity time can be selected for default.
- Incoming Unicode message can be decoded internally.
- Incoming multipart message can be combined internally.
- Dual memory handler: it's possible to read messages from both memories (SIM and Mobile Equipment).
- Incoming PDU string can be read from the file. This is for testing purposes.
- Sending can be disabled. This is for testing purposes.
See the How to configure for more details.
Outgoing message file:
- Priority can be set to high. This also works while the Provider Queue is used.
- Message validity time can be selected for the message.
- It's possible to make a voice call with DTMF tones.
- Binary messages can be presented as a Hex in the message file. There is a Wap Push demo using this feature.
- After a message is sent, Message_id is stored to the file if a status report was requested.
See the SMS file format for more details.
General:
- A new sms3 script is available (in the scripts directory) as an alternative for the original sms script.
This new script handles some special issues, including a smoother shutdown, multiple instance prevention and force-stop ability.
- If a modem reading reaches timeout, it will be reported to the log file.
- If for some reason the file moving fails, destination lock is removed.
- While creating a log file, file access permissions are limited to 640 (-rw-r-----).
- Provider definition can now have 's' for short numbers. For example: "FINLAND = 358, s".
If this is not defined to any provider, outgoing message file must have a provider queue setting while sending to short number.
Bug fixes:
- In the outgoing message file the "UDH: yes/no" setting did not work correctly.
However using this setting is not necessary because this value defaults to true when it's needed.
- Short number preceeding with 's' caused number become empty and sending failed.