Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
config:services.ini [2010/02/22 22:22] – Links to config:startup_ini changed to config:sbbs.ini digitalmanconfig:services.ini [2022/03/14 19:57] (current) – [See Also] tags Andre
Line 1: Line 1:
-====== services.ini ======+====== Services Configuration ======
  
-This [[sbbs.ini|INI]] file controls which Synchronet [[service:|services]] will be used.+The Services Initialization file (''services.ini'') controls which Synchronet [[service:|Services]] will be available on which TCP and UDP ports. This file is located in the ''[[dir:ctrl]]'' directory. 
 + 
 +===== Filename ===== 
 + 
 +The default base filename of the initialization file is ''[[dir:ctrl]]/services.ini''. This filename overridden by setting the ''iniFileName'' key in the ''[services]'' section of the ''[[dir:ctrl]]/[[sbbs.ini]]'' file. 
 + 
 +The standard host/platform variations of the initialization filenames are also supported. See [[INI_files#filenaming|INI Filenaming]] for details. 
 + 
 +===== Defaults ===== 
 + 
 +Download or view the default ''services.ini'' file here: ''[[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/*checkout*/ctrl/services.ini|services.ini]]'' 
 + 
 +===== Sections ===== 
 + 
 +The [[ini files#root section]] may contain keys which will determine the default value of keys which may be over-ridden in each service's section. 
 + 
 +Every other section in the file is a service section with the name of the service specified as the section. Example: ''[MyService]'' 
 + 
 +===== Common Keys ===== 
 + 
 +These keys may be specified in the [[ini files#root section]] where they will determine the default value for the same key in each service section. Additionally, these keys be specified within in each service section if the default value is not acceptable for that service. 
 + 
 +^Key          ^Default Value                      ^Possible Values                     ^Description      ^ 
 +|''LogLevel''     |''[[sbbs.ini]]->[Services]'' |See [[INI Files#Enumerated Values]] |Minimum severity for log entries | 
 +|''StackSize''    |''0''                              |0+                                  |Number of bytes to use for service thread (0=automatic)| 
 +|''MaxClients''   |''0''                              |0+                                  |Maximum number of simultaneous clients allowed (0=unlimited)| 
 +|''ListenBacklog''|''5''                              |1+                                  |The maximum length of the queue of pending connections| 
 +|''Options''      |''0''                      |''UDP|STATIC|LOOP|NATIVE|FULL_ACCEPT|TLS''|The common ''Options'' [[ini files#bit-field values]] are also supported (TLS support added in 3.17)| 
 + 
 +===== Service Keys ===== 
 + 
 +In addition to the [[#common keys]], each service section may include some or all of the following keys: 
 + 
 +^Key          ^Default Value                      ^Possible Values                     ^Description      ^ 
 +|''Enabled''  |''true''                           |''true'' or ''false''               |Set to ''false'' to temporarily disable this service| 
 +|''Protocol'' |''[//service name//]''             |Any                                 |The name of the protocol serviced by this service| 
 +|''Interface''|''[[sbbs.ini]]->[Services]''|IP address list or blank             |Comma separated list of <IP address>:<port> pairs of the network interface to bind to.  If the port is left out, the port in the ''Port'' key is used.  For IPv6 addresses, it needs to be enclosed in square brackets [ ] if a port is specified (ie: [::]:6667) ''0.0.0.0,::'' would listen on all IPv4 and IPv6 addresses using the port specified in the ''Port'' key.  ''0.0.0.0,::,192.168.0.1:7000,[fd0b:71d1:a7f3::1]:7000'' would bind to ports specified in the ''Port'' key for all interfaces and also port 7000 on the internal networks. | 
 +|''Command''  |                                   |Any valid command-line              |The command-line to execute to start this service| 
 +|''Port''     |Default for ''Protocol''           |''1''-''65535''                     |TCP or UDP port number serviced by this service| 
 +|''Host''                                       |Any valid hostname                  |Hostname for which this service should be executed| 
 +|''NotHost''  |                                   |Any valid hostname                  |Hostname for which this service should not be executed| 
 +|''JavaScript*'' |''[[sbbs.ini]]->[Services]'' | See [[JavaScript]] for details | 
 + 
 +===== See Also ===== 
 +  * [[:config:|Configuration]] 
 +  * [[:service:|Services]] 
 + 
 + 
 +{{tag>configuration general_config ini}}
  
config/services.ini.1266906148.txt · Last modified: 2010/02/22 22:22 by digitalman
Back to top
CC Attribution 4.0 International
Driven by DokuWiki Recent changes RSS feed Valid CSS Valid XHTML 1.0