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, currently available as beta
18.05.2007 3.1beta6
(these changes are also made to the 3.0.7)
General:
- If smsd is compiled without a support for status monitor, command line option -s is not useable.
Bug fixes:
- Incorrectly written message file without an empty line between the header part and text part caused
modem process to scratch if there was previously sent a message with less header lines or message
text containing an empty line.
Download
26.04.2007 3.1beta5
General:
- Installation / uninstallation: path of executables can now be defined in the Makefile.
- Startup check: permission check for executable scripts is changed.
Previously this check required mode 750 for scripts.
Now owner and group settings are examined and permission is checked like a shell does.
Download
16.04.2007 3.1beta4
Configuration file (smsd.conf):
- New setting for a modem: outgoing = yes/no.
With no a modem does not handle any outgoing message(s).
- Numbers for the provider sorting can be given in the grouped format.
Bug fixes:
- Provider sorting with # and * characters in the begin of a destination number is fixed.
Download
10.04.2007 3.1beta3
General:
- Some modem(s), probably because of the firmware bug, gives an "OK" answer while trying to read
a message from the empty memory space. This causes an additional five seconds delay to the process,
because an "ERROR" answer is expected. New version of smsd accepts both messages without any
additional delay.
- Very simple communication feature is included in this version.
If you need to communicate with a device, but do not have any terminal program available,
you can start the smsd with a communicate option -C devicename,
for example smsd -C GSM1.
This runs smsd in terminal mode which can be breaked with Ctrl-C.
Configuration file (smsd.conf):
- New setting report = directory.
In the global section this can be used to define where status report files are stored.
By default they are stored to the Incoming Folder.
- Each provider can now have up to 64 numbers defined.
- Queue, provider and device/queues settings are checked.
If there is too much definitions, an error message is displayed and the daemon does not start.
Outgoing message file:
- To: number is accepted in the grouped format, like 358 12 345 6789.
The number can also contain * and # character(s).
Bug fixes:
- Smsd.conf setting incoming_utf8 was read incorrectly. A value 1 worked, but yes did not.
- Storage for startup error strings was not initialized properly.
Download
17.03.2007 3.1beta2
Configuration file (smsd.conf):
- New setting: incoming_utf8 = yes/no.
Incoming message files with ISO or GSM alphabet can be saved using UTF-8 character set.
Default is no.
NOTE: use incoming_utf8 = 1 until the next version is released.
Outgoing message file:
- When an alphabet is ISO or GSM, smsd can also read files stored using the UTF-8 character set.
General:
- Smsd processes are listening SIGCONT signal to break an idle loops.
When the mainspooler has moved a file to the outgoing folder, SIGCONT is sent to all modem processes.
This causes a new message to be immediately handled and sent.
This is especially important when a delaytime is long (for a modem and directory polling).
- When a message is sent successfully, possible previous errors with a modem are forgotten.
- Logging of character set conversation problems is changed from LOG_INFO to LOG_NOTICE.
Log lines have now name of a modem.
Download
15.03.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.
Download
Version history
18.05.2007 3.0.7
General:
- If smsd is compiled without a support for status monitor, command line option -s is not useable.
Bug fixes:
- Incorrectly written message file without an empty line between the header part and text part caused
modem process to scratch if there was previously sent a message with less header lines or message
text containing an empty line.
Download
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.
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.
End Of History