Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revisionBoth sides next revision
config:sbbs.ini [2018/03/01 12:21] – old revision restored digital manconfig:sbbs.ini [2019/01/05 15:44] – [[BBS]] Added clarifications and missing settings from [BBS] section digital man
Line 180: Line 180:
  
 In addition to the keys listed in the ''[Global]'' section, the ''[BBS]'' section can contain the following keys with the specified default values: In addition to the keys listed in the ''[Global]'' section, the ''[BBS]'' section can contain the following keys with the specified default values:
 +
 +=== AutoStart ===
 +
 +Default: ''true''
 +
 +Automatically startup the [[server:Terminal]] Server when Synchronet starts up.
  
 === TelnetInterface === === TelnetInterface ===
Line 185: Line 191:
 Default: value of ''[Global] Interface'' Default: value of ''[Global] Interface''
  
-The IPv4 and/or IPv6 address of the network interfaces to listen for incoming [[server:terminal#Telnet]] connections on (''0'' for //any// interface).+The IPv4 and/or IPv6 addresses of the network interfaces to listen on for incoming Telnet connections on (''0'' for //any// IPv4 interface, and ''::'' for any IPv6 interface)).
  
 === TelnetPort === === TelnetPort ===
Line 191: Line 197:
 Default: ''23'' Default: ''23''
  
-The TCP port number on which to listen for incoming [[server:terminal#Telnet]] connections.+The TCP port number on which to listen for incoming Telnet connections.
  
 === RLoginInterface === === RLoginInterface ===
Line 197: Line 203:
 Default: value of ''[Global] Interface'' Default: value of ''[Global] Interface''
  
-The IPv4 and/or IPv6 address of the network interfaces to listen for incoming [[server:terminal#RLogin]] connections on (''0'' for //any// interface).+The IPv4 and/or IPv6 addresses of the network interfaces to listen on for incoming RLogin connections on (''0'' for //any// interface).
  
 === RLoginPort === === RLoginPort ===
Line 203: Line 209:
 Default: ''513'' Default: ''513''
  
-The TCP port number on which to listen for incoming [[server:terminal#RLogin]] connections.+The TCP port number on which to listen for incoming RLogin connections.
  
 === SSHInterface === === SSHInterface ===
Line 209: Line 215:
 Default: value of ''[Global] Interface'' Default: value of ''[Global] Interface''
  
-The IPv4 and/or IPv6 address of the network interfaces to listen for incoming Secure Shell ([[server:terminal#SSH]]) connections on (''0'' for //any// interface).+The IPv4 and/or IPv6 address of the network interfaces to listen for incoming Secure Shell (SSH) connections on (''0'' for //any// interface).
  
 === SSHPort === === SSHPort ===
Line 215: Line 221:
 Default: ''22'' Default: ''22''
  
-The TCP port number on which to listen for incoming Secure Shell ([[server:terminal#SSH]]) connections.+The TCP port number on which to listen for incoming Secure Shell (SSH) connections. 
 + 
 +=== SSHConnectTimeout === 
 + 
 +Default: ''10'' (seconds) 
 + 
 +The maximum amount of time allowed for a SecureShell (SSH) connection negotiation to complete. 
 + 
 +=== Pet40Port === 
 + 
 +Default: ''64'' 
 + 
 +If a connection is made to the [[:server:Terminal]] server, via any supported protocol, on this TCP port number, the terminal will be assumed to be a 40-column CBM/PETSCII (non-ANSI) terminal (e.g. Commodore 64). Setting this port number does not cause the server to //listen// on this port, so if you desire to support CBM/PETSCII terminal-connections, you will also need to add this port number to the ''TelnetInterface'' list (for example). 
 + 
 +=== Pet80Port === 
 + 
 +Default: ''128'' 
 + 
 +If a connection is made to the [[:server:Terminal]] server, via any supported protocol, on this TCP port number, the terminal will be assumed to be an 80-column CBM/PETSCII (non-ANSIterminal (e.g. Commodore 128). Setting this port number does not cause the server to //listen// on this port, so if you desire to support CBM/PETSCII terminal-connections, you will also need to add this port number to the ''TelnetInterface'' list (for example).
  
 === FirstNode === === FirstNode ===
Line 221: Line 245:
 Default: ''1'' Default: ''1''
  
-The number of the first terminal server node serviced by this instance of Synchronet.+The number of the first terminal server node serviced by this instance of Synchronet. The minimum value for this settings is ''1'' and the maximum is ''255''
 + 
 +Normally, this value should be left at ''1''. If the sysop wanted to run multiple instances of Synchronet, all sharing the same [[:dir:|directory tree]] and data files, then multiple ''sbbs.ini'' files would be used (with host-unique [[ini_files#filenaming]]) and unique (non-overlapping) node ranges specified with the ''FirstNode'' and ''LastNode'' values in each.
  
 === LastNode === === LastNode ===
Line 227: Line 253:
 Default: ''4'' Default: ''4''
  
-The number of the last terminal server node serviced by this instance of Synchronet.+The number of the last terminal server node serviced by this instance of Synchronet. The minimum value for this settings is ''1'' and the maximum is ''255''. If this setting's value is higher than the total number of nodes configured for the BBS (i.e. in SCFG->Nodes), then it will be automatically adjusted at run time during Terminal Server startup with a logged notice: 
 +  Specified last_node (x) > sys_nodes (y), auto-corrected
  
 === MaxConcurrentConnections === === MaxConcurrentConnections ===
Line 233: Line 260:
 Default: ''0'' Default: ''0''
  
-If set to a non-zero number, this will limit the number of concurrent connections to the [[server:Terminal]] Server from a common host/client IP address. Exempt hosts are not connection-limited by this setting. This setting added in Synchronet v3.17.+If set to a non-zero number, this will limit the number of concurrent connections to the [[server:Terminal]] Server from a common host/client IP address. [[config:ipfilter_exempt.cfg|Exempt hosts]] are not connection-limited by this setting. This setting was added in Synchronet v3.17.
  
 === OutbufHighwaterMark === === OutbufHighwaterMark ===
  
-Default: ''0'' or ''1024'' +Default: ''0'' or ''1024'' (bytes)
  
 === OutbufDrainTimeout === === OutbufDrainTimeout ===
  
-Default: ''10''+Default: ''10'' (milliseconds) 
 + 
 +=== SemFileCheckFrequency === 
 + 
 +Default: value of ''[Global] SemFileCheckFrequency'' 
 + 
 +=== TempDirectory === 
 + 
 +Default: value of ''[Global] TempDirectory'' 
 + 
 +=== HostName === 
 + 
 +Default: value of ''[Global] HostName''
  
 === ExternalTermANSI === === ExternalTermANSI ===
  
 Default: ''pc3'' (Linux) or ''cons25'' (FreeBSD) Default: ''pc3'' (Linux) or ''cons25'' (FreeBSD)
 +
 +When the BBS is running on a *nix-like OS, this value determines the value of the ''TERM'' environment variable that will be set when invoking interactive external programs for users with terminals supporting ANSI.
  
 === ExternalTermDumb === === ExternalTermDumb ===
  
 Default: ''dumb'' Default: ''dumb''
 +
 +When the BBS is running on a *nix-like OS, this value determines the value of the ''TERM'' environment variable that will be set when invoking interactive external programs for users with terminals that **do not** support ANSI.
  
 === DOSemuPath === === DOSemuPath ===
  
 Default: ''/usr/bin/dosemu.bin'' (Linux) or ''/usr/local/bin/doscmd'' (FreeBSD) Default: ''/usr/bin/dosemu.bin'' (Linux) or ''/usr/local/bin/doscmd'' (FreeBSD)
 +
 +When the BBS is running on a *nix-like OS and built with DOS emulator support (e.g. ''USE_DOSEMU'' defined on Linux), this value determines the default path of the DOS emulator to be executed when a non-native program (e.g. 16-bit MS-DOS door game) will be invoked by the BBS.
  
 === AnswerSound === === AnswerSound ===
Line 260: Line 304:
 Default: //none// Default: //none//
  
-Path to a WAVE file to played (locally) when accepting incoming connections.+Path to a WAVE file to played (locally) when accepting incoming connections. Only supported on Windows.
  
 === HangupSound === === HangupSound ===
Line 266: Line 310:
 Default: //none// Default: //none//
  
-Path to a WAVE file to be played (locally) when terminating connections.+Path to a WAVE file to be played (locally) when terminating connections. Only supported on Windows.
  
 === Options === === Options ===
  
-Default: ''XTRN_MINIMIZED | SYSOP_AVAILABLE | ALLOW_RLOGIN | ALLOW_SSH''+Default: ''XTRN_MINIMIZED'' 
 + 
 +Recommended: ''XTRN_MINIMIZED | ALLOW_RLOGIN | ALLOW_SSH''
  
 Supported options, separated by the pipe (''|'') symbol: Supported options, separated by the pipe (''|'') symbol:
Line 276: Line 322:
 ^ Option         ^ Description ^ ^ Option         ^ Description ^
 |XTRN_MINIMIZED  | External program windows are automatically minimized (Windows) | |XTRN_MINIMIZED  | External program windows are automatically minimized (Windows) |
-|AUTO_LOGON | Enable automatic login based on IP address (not recommended) | +|AUTO_LOGON | Enable automatic login based on IP address for V-exempt users (not recommended) | 
-|DEBUG_TELNET     | Log Telnet commands and responses (with Debug log level) | +|DEBUG_TELNET    | Log Telnet commands and responses (with Debug log-level messages) | 
-|SYSOP_AVAILABLE Sysop is available to be paged for chat +|ALLOW_SSH  Enable the Secure Shell (SSH) protocol for incoming connections 
-|ALLOW_RLOGIN | Enable the [[server:terminal#RLogin]] protocol for incoming connections +|ALLOW_RLOGIN | Enable the RLogin protocol for incoming connections |
-|USE_2ND_RLOGIN  | Use the 2nd [[server:terminal#RLogin]] string as the user name to login with (DEPRECATED: this behavior is now hard-coded and non-optional) |+
 |NO_QWK_EVENTS   | Disable QWK networking events | |NO_QWK_EVENTS   | Disable QWK networking events |
-|NO_TELNET_GA    | Disable periodic transmissions of the Telnet "Go Ahead" command (Telnet only) |+|NO_NEWDAY_EVENTS| Disable daily events from running in this instance of Synchronet |
 |NO_EVENTS | Disable the Events thread (all timed events) | |NO_EVENTS | Disable the Events thread (all timed events) |
-|NO_HOST_LOOKUP  | Do not attempt hostname look-ups on incomming connections (log IP addresses only) |+|NO_TELNET_GA    | Disable periodic transmissions of the Telnet "Go Ahead" command (Telnet only) | 
 +|NO_HOST_LOOKUP  | Do not attempt hostname look-ups on incoming connections (log IP addresses only) |
 |NO_SPY_SOCKETS  | Disable node spying (on *nix) | |NO_SPY_SOCKETS  | Disable node spying (on *nix) |
-|ALLOW_SSH  Enable the Secure Shell ([[server:terminal#SSH]]) protocol for incoming connections |+|NO_DOS          Disable 16-bit DOS Program support (eliminate the potential for modal error dialogs in 64-bit editions of Windows) |
 |NO_RECYCLE      | Disable the ability for the terminal server to be recycled | |NO_RECYCLE      | Disable the ability for the terminal server to be recycled |
 |GET_IDENT | Use the IDENT protocol on incoming connections | |GET_IDENT | Use the IDENT protocol on incoming connections |
-|NO_JAVASCRIPT   | Disable JavaScript support (not recommended) | 
-|NO_DOS          | Disable DOS Program support (eliminate the potential for modal error dialogs in 64-bit editions of Windows) | 
 |MUTE | Disable all local sound output | |MUTE | Disable all local sound output |