configure.html

GSM猫管理程序

With the smsd version >= 3.1 the checkhandler can also modify a message file.<br>
Exitcode 2 means that the checkhandler has moved a message to the spooler by itself.
</p>

<p>
<i><b>autosplit = number</b></i><br>
<font size="1">Default value: <i>3</i>.</font><br>
Controls if and how the program splits large text messages. 
The program does not split text messages with UDH.<br>
If splitting is disabled, binary messages requiring more than one part are not sent.<br>
<table border=1 bgcolor=lightgrey>
  <tr><td bgcolor=yellow>0</td><td>disabled</td></tr>
  <tr><td bgcolor=yellow>1</td><td>enabled, no part-number</td></tr>
  <tr><td bgcolor=yellow>2</td><td>enabled, text numbers</td></tr>
  <tr><td bgcolor=yellow>3</td><td>enabled, concatenated format (not supported by some phones)</td></tr>
</table>
</p>

<p>
<i><b>receive_before_send = yes/no</b></i><br>
<font size="1">Default value: <i>no</i>.</font><br>
Forces smsd to empty the first SIM card memory before sending SM.
This is a workaround for modems that cannot send SM with a full SIM card.
</p>

<p>
<i><b>store_received_pdu = number</b></i><br>
<font size="1">Default value: <i>1</i>.</font><br>
Available from version >= 3.0. Controls when the incoming PDU string(s) is stored to message file.
<table border=1 bgcolor=lightgrey>
  <tr><td bgcolor=yellow>0</td><td>no PDU's are stored</td></tr>
  <tr><td bgcolor=yellow>1</td><td>unsupported PDU's are stored</td></tr>
  <tr><td bgcolor=yellow>2</td><td>unsupported and PDU's with 8bit binary data or Unicode text are stored</td></tr>
  <tr><td bgcolor=yellow>3</td><td>all PDU's are stored</td></tr>
</table>
Header is "PDU: " and PDU's of a multipart message are stored from 1 to n order.
</p>

<p>
<i><b>validity = number</b></i><br>
<font size="1">Default value: <i>255</i>.</font><br>
Available from version >= 3.0. See <a href="fileformat.html">SMS file</a> for details of possible values.
</p>

<p>
<i><b>decode_unicode_text = yes/no</b></i><br>
<font size="1">Default value: <i>no</i>.</font><br>
Available from version >= 3.0. Controls when the incoming Unicode text is decoded internally.
</p>

<p>
<i><b>internal_combine = yes/no</b></i><br>
<font size="1">Default value: <i>no</i>.</font><br>
Available from version >= 3.0. Controls when the incoming multipart message is combined internally.
</p>

<p>
Next four settings are available from version >= 3.0.2:<br>
<i><b>user = username</b></i><br>
<font size="1">Default value: not in use.</font><br>
<i><b>group = groupname</b></i><br>
<font size="1">Default value: not in use.</font><br>
<br>
If the smsd is started by the root, these two settings can be used to switch smsd to run as an unpriviledged user.<br>
As of version >= 3.0.9, if <i>user</i> is set but <i>group</i> is unset, that user's normal groups (e.g. from
/etc/groups) are used.
This means you can allow other users on the system access to write messages to the outgoing spool without giving them 
direct access to the serial port.<br>
<br>
<i><b>infofile = filename</b></i><br>
<font size="1">Default value: <i>/var/run/smsd.working</i>.</font><br>
<i><b>pidfile = filename</b></i><br>
<font size="1">Default value: <i>/var/run/smsd.pid</i>.</font><br>
<br>
Location of <i>infofile</i> and <i>pidfile</i> can be changed with these settings. 
This is usually necessary if the smsd is running as an unpriviledged user.
If a sms3 script is used to start and stop the smsd, these settings should be defined in the script.
<br>
These four settings can be overridden by the command line argument(s):
<ul>
  <li>-ix set infofile to x</li>
  <li>-px set pidfile to x</li>
  <li>-ux set username to x</li>
  <li>-gx set groupname to x</li>
</ul>
See <a href="run.html">Running</a> for more information.
</p>

<p>
<i><b>keep_filename = yes/no</b></i><br>
<font size="1">Default value: <i>yes</i>.</font><br>
Available from version >= 3.1. If this is set to no, an unique filename is created each time
when a message file is moved from directory to another directory. This ensures that any previously sent message file
is not overwritten, even if the original filename was the same. Also if an user has created filename with space 
character, this creates a new name without spaces and therefore spaces can't effect to operation of an eventhandler.
</p>

<p>
<i><b>store_original_filename = yes/no</b></i><br>
<font size="1">Default value: <i>yes</i>.</font><br>
Available from version >= 3.1. Together with keep_filename this controls when the original 
filename is stored to message file when it's moved from outgoing directory to the spool.
</p>

<p>
<i><b>regular_run = filename</b></i><br>
<font size="1">Default value: not in use.</font><br>
<i><b>regular_run_interval = number</b></i><br>
<font size="1">Default value: <i>300</i>.</font><br>
Available from version >= 3.1. A regular_run is an external script or program which is run regularly while the smsd is running. 
A value regular_run_interval describes number of seconds between each run.<br>
See <a href="run.html">Running</a> for more information and sample usage.
</p>

<p>
<i><b>admin_to = phone number</b></i><br>
<font size="1">Default value: not in use.</font><br>
Available from version >= 3.1. Specifies a destination number for administrative messages created by smsd.
Messages are sent without using the filesystem.
</p>

<p>
<i><b>terminal = yes/no</b></i><br>
<font size="1">Default value: <i>no</i>.</font><br>
Available from version >= 3.1. Enables terminal mode like command line argument <i>-t</i>.
</p>

<p>
<i><b>filename_preview = number</b></i><br>
<font size="1">Default value: not in use.</font><br>
Available from version >= 3.1. Defines how many characters of message text is concatenated to the name of a messsage file.
Currently works with incoming message files. Characters used are a...z, A...Z, 0...9, - and period.
All other characters are replaced with _'s.
</p>

<p>
<i><b>incoming_utf8 = yes/no</b></i><br>
<font size="1">Default value: <i>no</i>.</font><br>
Available from version >= 3.0.9. With this setting messages using ISO or GSM alphabet are stored using UTF-8 character set.
</p>

<p>
<i><b>log_charconv = yes/no</b></i><br>
<font size="1">Default value: <i>no</i>.</font><br>
Available from version >= 3.0.9.
With this setting a details of character set conversions (outgoing UTF-8 to ISO conversion and incoming GSM/ISO to
UTF-8 conversion) is printed to the log.
If smsd is compiled using DEBUGMSG definition, details are also printed to the console.
Logging feature can be useful if you have some troubles with characters and like to know what exactly happens inside the smsd.
</p>

<p>
<i><b>store_sent_pdu = number</b></i><br>
<font size="1">Default value: <i>1</i>.</font><br>
Available from version >= 3.0.9. Controls when the outgoing PDU string(s) is stored to message file.
<table border=1 bgcolor=lightgrey>
  <tr><td bgcolor=yellow>0</td><td>no PDU's are stored</td></tr>
  <tr><td bgcolor=yellow>1</td><td>failed (to send) PDU's are stored</td></tr>
  <tr><td bgcolor=yellow>2</td><td>failed and PDU's with 8bit binary data or Unicode text are stored</td></tr>
  <tr><td bgcolor=yellow>3</td><td>all PDU's are stored</td></tr>
</table>
Header is "PDU: " and PDU's of a multipart message are stored from 1 to n order.
</p>

<p>
<i><b>os_cygwin = yes/no</b></i><br>
<font size="1">Default value: <i>no</i>.</font><br>
Available from version >= 3.0.10.
Defines if smsd is running on Cygwin environment.
This is needed if outgoing file permissions should be checked and changed by the smsd.
</p>

<p>
<i><b>saved = directory</b></i><br>
<font size="1">Default value: not in use.</font><br>
Available from version >= 3.1. Path of the Saved Folder.
If defined, smsd will store concatenation storage's to this directory (otherwise incoming directory is used).
At startup check existing concatenation storages are moved from incoming directory to saved directory.
Zero sized files are ignored.
If both directories has a storage file with data, fatal error is produced and the smsd does not start.
</p>

<p>
<i><b>datetime = format string</b></i><br>
<font size="1">Default value: compatible with previous versions.</font><br>
Available from version >= 3.1. Specifies a format for timestamps.
See <i>man strftime</i> for usage details.
</p>

<p>
<i><b>phonecalls = directory</b></i><br>
<font size="1">Default value: empty, incoming directory is used.</font><br>
Available from version >= 3.1. Defines where <i>phonecalls</i> data is stored.
</p>

<p>
<i><b>language_file = filename</b></i><br>
<font size="1">Default value: not in use.</font><br>
Available from version >= 3.1. 
Message files can be written using localized headers.
See the <a href="localizing.html">localizing</a> for details.
</p>

<br>
<a name="modem"><h3>Modem settings</h3></a>

<p>
<b>[modem name]</b><br>
Begin of a modem settings block. The modem name must be the same as in the devices= line in the global part.
</p>

<p>
<i><b>pre_init = yes/no</b></i><br>
<font size="1">Default value: <i>yes</i>.</font><br>
Available from version >= 3.0.8. Specifies is an "echo off" and "CMEE=1" commands are sent to the modem
before anything else is done.
</p>

<p>
<i><b>init = modem command</b></i><br>
<font size="1">Default value: not in use.</font><br>
Specifies a modem initialisation command. Most modems do not need any init string. 
See the manual of your modem for more details of modem commands.
</p>

<p>
<i><b>init2 = modem command</b></i><br>
<font size="1">Default value: not in use.</font><br>
Specifies a second modem initialisation command. Most users do not need this.
</p>

<p>
<i><b>device = name of serial port</b></i><br>
<font size="1">Default value: empty.</font><br>
Specifies the device name of the serial port to the modem.
Linux example: /dev/ttyS0. Windows example: /dev/com1. Solaris example: /dev/cuaa.
</p>

<p>
<i><b>incoming = no/yes/high or 0/1/2</b></i><br>
<font size="1">Default value: <i>no</i>.</font><br>
Specifies if the program should read incoming SM from this modem. 
"Yes" or "1" means that smsd receives with less priority. 
The value "high" or "2" means that smsd receives with high priority.  
"No" or "0" means that smsd does not receive messages.
</p>

<p>
<i><b>memory_start = number</b></i><br>
<font size="1">Default value: <i>1</i>.</font><br>
Tells the first memory space number for received messages. 
This is normally 1, Vodafone Mobile Connect Card starts with 0.
</p>

<p>
<i><b>queues = list of queue names</b></i><br>
<font size="1">Default value: not in use.</font><br>
Specifies the Provider Queues that this modem shall serve. 
Use the same provider names as in [queues] and [provider]. 
If you do not use the provider-sorting feature, then leave this line out.
</p>

<p>
<i><b>pin = 4 digit number</b></i><br>
<font size="1">Default value: not in use.</font><br>
Specifies the PIN number of the SIM card inside the modem. 
Delete this line, if your computer does not need to enter a PIN.
See also <i>pinsleeptime</i>.