📄 configure.html
字号:
<html> <head> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> <META NAME="Title" CONTENT="SMS Server Tools"> <META NAME="Robots" CONTENT="INDEX,FOLLOW"> <META NAME="Language" CONTENT="English"> <title>SMS Server Tools 3</title><STYLE type="text/css">h3 { background-color: #DCDCFE;}blockquote { background-color: #FFD; font-size: 90%; padding:5pt; padding-top:1pt; margin-bottom:5pt; border-style: outset; border-color: #aaaa99; border-width: 0.05pt 2pt 2pt 0.05pt;}blockquote p:first-letter { font-size: 110%; font-weight: bold; color: red;}</STYLE> </head> <body><h2><font color=blue>SMS Server Tools 3</font></h2><a href="index.html">Home</a><h3>Configuring</h3><!-- START --><p><blockquote><p>Please note that the <a href="book.html" target="_blank">book</a> describes this topic with more details.</p></blockquote><p>The config file is /etc/smsd.conf. You may specify another file using the option -c. During installation an easy example file will be copied to <b>smstools3/examples</b> directory.<p>The config file has the following structure:<p><ul><table border=1 bgcolor=lightgrey><tr><TD> <font face="Courier New, Courier, monospace"> <a href="#global">some global settings</a><br> <br> <a href="#modem">[first modem name]</a><br> ...<br> <a href="#modem">[second modem name]</a><br> ...<br> <a href="#modem">[third modem name]</a><br> ...<br> and so on </font></TD></tr></table></ul><p>Configuring the <a href="configure2.html">provider-sorting</a> is shown in different document.<p>In case of yes/no settings, you can use the following keywords:<p><ul><b>yes , no<br>true , false<br>on , off<br>1 , 0<br></b></ul><p>After version >= 3.1 also "no" values should be typed correctly, "no" is no more a default.<p>In case of lists, you need to use the comma character to separate items. Example: modem1, modem2, modem3<p>After version >= 3.1 multiple different values can be defined for each setting.If smsd is started with command line argument -a (ask), settings with multiple choices are prompted andsuitable value can be selected for a run. For example:<br><ul><b>devices = ? GSM1 | GSM1, GSM2, GSM3 | GSM88, GMS99</b></ul>A question mark tells that more than one value is defined.Possible values are separated using pipe.In this example the smsd will prompt:<br><ul><b>Value for "global devices" (Enter for the first value, 0 to exit):<br>1) GSM1<br>2) GSM1, GSM2, GSM3<br>3) GSM88, GMS99<br>4) Other<br>Select 1 to 4:<br></b></ul>When smsd is started without -a, first value is always choosen.<p><a name="global"><h3>Global part</h3></a><p>The global part begins at the top of the config file.<p><i><b>devices = names</b></i><br><font size="1">Default value: empty.</font><br>List of names of your modems, maximum 64 devices. This limit is changeable.</p><p><i><b>outgoing = directory</b></i><br><font size="1">Default value: <i>/var/spool/sms/outgoing</i>.</font><br>Path of the Outgoing Queue folder.</p><p><i><b>checked = directory</b></i><br><font size="1">Default value: <i>/var/spool/sms/checked</i>.</font><br>Path of the default Queue directory in case you do not use provider-sorting.</p><p><i><b>failed = directory</b></i><br><font size="1">Default value: not in use.</font><br>Path of the Failed Folder. Delete this line if you do not want to keep failed files.</p><p><i><b>incoming = directory</b></i><br><font size="1">Default value: <i>/var/spool/sms/incoming</i>.</font><br>Path of the Incoming Folder.</p><p><i><b>report = directory</b></i><br><font size="1">Default value: not in use.</font><br>Available from version >= 3.1. Path of the Report Folder.Without this setting status report messages are stored to the Incoming Folder.</p><p><i><b>sent = directory</b></i><br><font size="1">Default value: not in use.</font><br>Path of the Sent Folder. Delete this line, if you do not want to keep copies of each sent message file.</p><p><i><b>logfile = filename</b></i><br><font size="1">Default value: empty.</font><br>Name of the log file. Delete this line, if you want to use the syslog for logging. You can use "1" to write to the console (stdout). <br>This setting can be overridden by the <i>-l</i> (ell) command line argument.</p><p><i><b>loglevel = number</b></i><br><font size="1">Default value: <i>4</i> for logfile, <i>7</i> for syslog.</font><br>Sets the verbosity of your log file.</p><p>This affects also syslog. If you want all messages in syslog, you need to set it to "7" (or higher) here and "*" in the config file of syslog. If you want less messages, you can reduce it here or in the config file of syslog, both will work.<p><table border=1 bgcolor=lightgrey> <tr> <td>debug</td><td bgcolor=yellow>7</td><td>All AT-Commands and modem answers and other detailed informations useful for debugging</td> </tr> <tr> <td>info</td><td bgcolor=yellow>6</td><td>Information what is going on at the moment. Not detailled enough for debugging but maybe interesting.</td> </tr> <tr> <td>notice</td><td bgcolor=yellow>5</td><td>Information when a message was received or sent and when something not normal happens but program still works fine (for example wrong destination number in SMS file).</td> </tr> <tr> <td>warning</td><td bgcolor=yellow>4</td><td>Warning when the program has a problem sending a single short message.</td> </tr> <tr> <td>error</td><td bgcolor=yellow>3</td><td>Error message when the program has temporary problem (for example modem answered with ERROR during initialization or a file can not be accessed).</td> </tr> <tr> <td>critical</td><td bgcolor=yellow>2</td><td>Error message when the program has a permament problem (for example sending failed many times or wrong permissions to a queue).</td> </tr></table>The numbers in this table are taken from Linux. Probably all operating systems use the same numbers.<br>After version >= 3.1 a value can be defined as a word, like LOG_INFO, INFO or info.</p><p><i><b>alarmhandler = filename</b></i><br><font size="1">Default value: not in use.</font><br>You can specify here an external program that is started whenever an alarm occurs.<br>After version >= 3.1 a value can be defined as a word, like LOG_INFO, INFO or info.</p><p><i><b>alarmlevel = number</b></i><br><font size="1">Default value: <i>LOG_WARNING</i>.</font><br>Specifies what levels start an alarmhandler. You can use value between 2 and 5.</p><p><i><b>delaytime = number</b></i><br><font size="1">Default value: <i>10</i>.</font><br>Smsd sleep so many seconds when it has nothing to do. </p><p><i><b>errorsleeptime = number</b></i><br><font size="1">Default value: <i>10</i>.</font><br>A modem sleeps so many seconds when it answers a command with ERROR.</p><p><i><b>blocktime = number</b></i><br><font size="1">Default value: <i>3600</i>.</font><br>A modem is not used so many seconds when it seems to be out of order.</p><p><i><b>blockafter = number</b></i><br><font size="1">Default value: <i>3</i>.</font><br>Available from version >= 3.0.9.A modem is blocked after n number of errors while <b>sending</b> messages.A successfull sending will reset this counter.</p><p><i><b>eventhandler = filename</b></i><br><font size="1">Default value: not in use.</font><br>Specifies an external program or script that will execute whenever a message was sent, received or failed.<br>(If your locale is UTF-8, you can use this script to convert received messages from smsd's internal format (ISO) to UTF-8.See scripts/eventhandler-utf-8 for code sample.)<br>After version >= 3.0.9 there is <i>incoming_utf8 = yes</i> setting available.Using this setting the external conversion is not required.</p><p><i><b>stats = directory</b></i><br><font size="1">Default value: not in use.</font><br>Specifies the directory where smsd stores statistic files. The directoy must exist before you start smsd. If not given, then the program does not write statistic files.</p><p><i><b>stats_interval = number</b></i><br><font size="1">Default value: <i>3600</i>.</font><br>Smsd writes statistics files every n seconds.</p><p><i><b>stats_no_zeroes = yes/no</b></i><br><font size="1">Default value: <i>no</i>.</font><br>Smsd does not write statistic files when no message was sent or received (Zero-Counters) if this is set to yes.</p><p><i><b>blacklist = filename</b></i><br><font size="1">Default value: not in use.</font><br>Name of the blacklist file.</p><p><i><b>whitelist = filename</b></i><br><font size="1">Default value: not in use.</font><br>Name of the whitelist file. The black list takes precedence before the white list. See <a href="blacklist.html">Blacklist and Whitelist</a> for more details and sample usage.</p><p><i><b>checkhandler = filename</b></i><br><font size="1">Default value: not in use.</font><br>External program that checks if a message file is valid. (This script can also be used to convert message file from UTF-8 to ISO format, which is internal format used in smsd.See scripts/checkhandler-utf-8 for sample code.)<br>After version >= 3.0.9 the smsd converts messages automatically from UTF-8 to ISO, if it is necessary.<br>If the checkhandler return a non-zero (other than 2) exitcode the message will not be sent.<br>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -