Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
config:sbbs.ini [2010/02/22 22:38] – digitalman | config:sbbs.ini [2020/12/17 19:54] – [[BBS]] update dosemu values mlong | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== |
- | The Synchronet BBS (SBBS) Initialization File is the mother of all Synchronet configuration files and is located in the '' | + | The Synchronet BBS (SBBS) Initialization File ('' |
===== Filename ===== | ===== Filename ===== | ||
Line 7: | Line 7: | ||
The base filename of the initialization file is '' | The base filename of the initialization file is '' | ||
- | The standard host/ | + | The standard host/ |
===== Defaults ===== | ===== Defaults ===== | ||
Line 15: | Line 15: | ||
===== Editing ===== | ===== Editing ===== | ||
- | When using the Synchronet-Win32 Control Panel, the contents of this file are automatically updated when any of the configuration changes are made in the File-> | + | When using the [[monitor: |
If a sysop needs to edit the file by hand, any decent text file editor should do the job. See [[INI files]] for more details. | If a sysop needs to edit the file by hand, any decent text file editor should do the job. See [[INI files]] for more details. | ||
Line 24: | Line 24: | ||
==== [Global] ==== | ==== [Global] ==== | ||
+ | |||
+ | The '' | ||
+ | |||
+ | The supported '' | ||
+ | |||
+ | === HostName === | ||
+ | |||
+ | Default: < | ||
+ | |||
+ | The public Internet DNS host name of this server. | ||
+ | |||
+ | If not set, the host name configured in '' | ||
+ | |||
+ | **Note**: | ||
+ | The '' | ||
+ | |||
+ | === Interface === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The IPv4 and/or IPv6 addresses of the network interfaces to listen on for incoming TCP/IP connections. | ||
+ | |||
+ | If multiple addresses are specified, they are to be separated by commas (this is true of all the '' | ||
+ | |||
+ | The address value '' | ||
+ | |||
+ | If this value is not set, any and all IPv4 and IPv6 network interfaces available will be listened to for incoming connections. | ||
+ | |||
+ | **Note**: | ||
+ | Although TCP port numbers may be specified (with ''//< | ||
+ | |||
+ | === OutboundInterface === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The IPv4 address of the network interface to use for outgoing TCP/IP connections. | ||
+ | |||
+ | === CtrlDirectory === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Specify the location of the Synchronet '' | ||
+ | |||
+ | === TempDirectory === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Override the default system " | ||
+ | If you do override this, do NOT use the system-wide temp dir (e.g.: ''/ | ||
+ | |||
+ | **Note**: | ||
+ | The '' | ||
+ | |||
+ | === SemFileCheckFrequency === | ||
+ | |||
+ | Default: '' | ||
+ | Minimum: '' | ||
+ | |||
+ | The interval, in seconds, betweeen [[semfiles|semaphore file]] checks. If you want to reduce the amount of disk I/O while the BBS is idle, you can increase this value. If you set this value below 1, the BBS server threads will use the default value (2). | ||
+ | |||
+ | **Note**: | ||
+ | The '' | ||
+ | |||
+ | === BindRetryCount === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Set the number of times an interface //bind// will be attempted for each port (before giving up and failing to start/ | ||
+ | |||
+ | Increase this value if you get errors binding to ports on reloads (especially on *nix). | ||
+ | |||
+ | **Note**: | ||
+ | This setting may be overridden by a '' | ||
+ | |||
+ | === BindRetryDelay === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Delay (in seconds) between bind retries. | ||
+ | |||
+ | **Note**: | ||
+ | This setting may be overridden by a '' | ||
+ | |||
+ | === LogLevel === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Highest log level to actually log/print (ignore all higher/ | ||
+ | Supported log levels in decreasing severity (ala [[: | ||
+ | Emergency, Alert, Critical, Error, Warning, Notice, Informational, | ||
+ | | ||
+ | **Note**: | ||
+ | This setting may be overridden by a '' | ||
+ | |||
+ | === JavaScriptMaxBytes === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Maximum allocation of memory per JavaScript run-time. | ||
+ | |||
+ | **Note**: | ||
+ | Each '' | ||
+ | |||
+ | === JavaScriptTimeLimit === | ||
+ | Default: '' | ||
+ | |||
+ | Maximum number of ticks (100ms) before auto-termination of a JavaScript script (i.e. //infinite loop detection// | ||
+ | |||
+ | Set to '' | ||
+ | |||
+ | Note: This key replaces the old '' | ||
+ | |||
+ | === JavaScriptGcInterval === | ||
+ | Default: '' | ||
+ | |||
+ | JavaScript Garbage Collection interval (in ticks). | ||
+ | |||
+ | Set to '' | ||
+ | |||
+ | === JavaScriptYieldInterval === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Time-slice yield interval (in ticks). | ||
+ | |||
+ | Set to '' | ||
+ | |||
+ | === JavaScriptLoadPath === | ||
+ | Default: '' | ||
+ | |||
+ | Comma-separated list of load paths (relative to '' | ||
+ | |||
+ | These are the directories/ | ||
+ | |||
+ | === LoginAttemptDelay === | ||
+ | Default: '' | ||
+ | |||
+ | The number of milliseconds to pause after a failed login attempt. | ||
+ | |||
+ | **Note**: | ||
+ | Each '' | ||
+ | |||
+ | === LoginAttemptThrottle === | ||
+ | Deafult: '' | ||
+ | |||
+ | This value is multiplied by the number of consecutive unique failed login attempts and the result is the number of milliseconds to delay a connection from a suspicious host (e.g. with multiple consecutive unique failed login attempts). | ||
+ | |||
+ | === LoginAttemptHackThreshold === | ||
+ | Default: '' | ||
+ | |||
+ | The number of consecutive unique failed login attempts from the same host before adding entries to the '' | ||
+ | |||
+ | Set to '' | ||
+ | |||
+ | === LoginAttemptTempBanThreshold === | ||
+ | Default: '' | ||
+ | |||
+ | The number of consecutive unique failed login attempts from the same host before temporarily banning connections from that client (based o IP address). | ||
+ | |||
+ | Set to '' | ||
+ | |||
+ | **Note**: Failed logins using any of the filtered user IDs (from '' | ||
+ | |||
+ | === LoginAttemptTempBanDuration === | ||
+ | Default: '' | ||
+ | |||
+ | The length (in seconds) of a temporary IP ban based on either multiple consecutive failed login attempts or any failed login attempt using a banned user ID (from '' | ||
+ | |||
+ | === LoginAttemptFilterThreshold === | ||
+ | Default: '' | ||
+ | |||
+ | The number of consecutive unique failed login attempts from the same host before auto-filtering the host's IP address in the '' | ||
+ | |||
+ | For this auto-filtering feature to work with the Synchronet v3.16c Terminal Server (Telnet, RLogin, and SSH login attempts), the sysop must set '' | ||
+ | |||
+ | Set to '' | ||
==== [BBS] ==== | ==== [BBS] ==== | ||
- | ==== [FTP] ==== | + | See [[: |
- | ==== [Mail] ==== | + | In addition to the keys listed in the '' |
- | ==== [Web] ==== | + | === AutoStart |
- | ==== [Services] ==== | + | Default: '' |
- | ==== [UNIX] ==== | + | Automatically startup the [[server: |
- | Unix Sysops will particularly want to pay attention to the '' | + | === TelnetInterface === |
- | If you do not want to run Synchronet (and all external programs/ | + | Default: value of '' |
- | root, you will have to set the '' | + | |
- | User=sbbsgroup | + | The IPv4 and/or IPv6 addresses of the network interfaces to listen on for incoming Telnet connections on ('' |
- | Group=sbbsuser | + | |
- | Also, the file | + | === TelnetPort === |
- | permissions/ | + | |
- | and write access to them. The best way to accomplish this is a command | + | |
- | like: | + | |
- | # chown -R sbbsuser:sbbsgroup /sbbs | + | Default: '' |
- | If you want Synchronet | + | The TCP port number on which to listen for incoming Telnet connections. |
- | via syslog rather than the local console, set Daemonize=True in this section. Example: | + | |
- | Daemonize=True | + | === RLoginInterface === |
- | To configure syslog and the '' | + | Default: value of '' |
- | LogFacility=3 | + | The IPv4 and/or IPv6 addresses of the network interfaces to listen on for incoming RLogin connections on ('' |
- | + | ||
- | + | ||
- | Then, in ''/ | + | |
- | local3.* | + | === RLoginPort === |
- | Depending on how your vendor set up '' | + | Default: |
- | to exclude local3.* from other log files (Noteably ''/ | + | |
- | do this varies with your syslogd implementation, | + | |
- | (Which BSD and many Linux distros use) you would add "; | + | |
- | end of the first field in the ''/ | + | |
- | You will have to create this file manually initially by running: | + | The TCP port number on which to listen for incoming RLogin connections. |
- | # touch / | + | |
- | Then send a HUP to syslogd like so: | + | === SSHInterface === |
- | # killall -HUP syslogd | + | |
- | You will want to investigate how your system rotates logs and set it up to | + | Default: value of '' |
- | rotate | + | |
- | Further use of the '' | + | The IPv4 and/or IPv6 address |
- | Read your '' | + | |
- | do NOT use the ' | + | |
- | configuration. | + | |
- | of Synchronet as appropriate. | + | |
- | LOG_AUTH | + | === SSHPort |
- | LOG_DAEMON | + | |
- | LOG_FTP (If available) | + | |
- | LOG_MAIL | + | |
- | LOG_CRON | + | |
- | + | ||
- | === LogIdent | + | |
- | Default: Synchronet | + | |
- | === PidFile === | + | |
- | Default: ''/ | + | |
- | === umask === | + | |
- | Default: 077 | + | |
- | + | ||
+ | Default: '' | ||
+ | |||
+ | The TCP port number on which to listen for incoming Secure Shell (SSH) connections. | ||
+ | |||
+ | === SSHConnectTimeout === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The maximum amount of time allowed for a SecureShell (SSH) connection negotiation to complete. | ||
+ | |||
+ | === Pet40Port === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | If a connection is made to the [[: | ||
+ | |||
+ | === Pet80Port === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | If a connection is made to the [[: | ||
+ | |||
+ | === OutboundInterface === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The IPv4 address of the network interface to use for outgoing TCP/IP connections (i.e. for Telnet and RLogin gateway connections). | ||
+ | |||
+ | === FirstNode === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The number of the first terminal server node serviced by this instance of Synchronet. The minimum value for this settings is '' | ||
+ | |||
+ | Normally, this value should be left at '' | ||
+ | |||
+ | === LastNode === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | The number of the last terminal server node serviced by this instance of Synchronet. The minimum value for this settings is '' | ||
+ | Specified last_node (x) > sys_nodes (y), auto-corrected | ||
+ | |||
+ | === MaxConcurrentConnections === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | If set to a non-zero number, this will limit the number of concurrent connections to the [[server: | ||
+ | |||
+ | === OutbufHighwaterMark === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | === OutbufDrainTimeout === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | === SemFileCheckFrequency === | ||
+ | |||
+ | Default: value of '' | ||
+ | |||
+ | === TempDirectory === | ||
+ | |||
+ | Default: value of '' | ||
+ | |||
+ | === HostName === | ||
+ | |||
+ | Default: value of '' | ||
+ | |||
+ | === ExternalTermANSI === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | When the BBS is running on a *nix-like OS, this value determines the value of the '' | ||
+ | |||
+ | === ExternalTermDumb === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | When the BBS is running on a *nix-like OS, this value determines the value of the '' | ||
+ | |||
+ | === UseDOSemu === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | This will enable [[howto: | ||
+ | |||
+ | === DOSemuPath === | ||
+ | |||
+ | Default: ''/ | ||
+ | |||
+ | When the BBS is running on a *nix-like OS, 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. | ||
+ | |||
+ | === DOSemuConfPath === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | This specifies where DOSEmu should look for the conf file. First, it will look in the startup dir of the external program, then it will use this path (if configured). If this path is not set, it will default to / | ||
+ | |||
+ | === AnswerSound === | ||
+ | |||
+ | Default: //none// | ||
+ | |||
+ | Path to a WAVE file to played (locally) when accepting incoming connections. Only supported on Windows. | ||
+ | |||
+ | === HangupSound === | ||
+ | |||
+ | Default: //none// | ||
+ | |||
+ | Path to a WAVE file to be played (locally) when terminating connections. Only supported on Windows. | ||
+ | |||
+ | === Options === | ||
+ | |||
+ | Default: '' | ||
+ | |||
+ | Recommended: | ||
+ | |||
+ | Supported options, separated by the pipe ('' | ||
+ | |||
+ | ^ Option | ||
+ | |XTRN_MINIMIZED | ||
+ | |AUTO_LOGON | Enable automatic login based on IP address for V-exempt users (not recommended) | | ||
+ | |DEBUG_TELNET | ||
+ | |ALLOW_SSH | Enable the Secure Shell (SSH) protocol for incoming connections | | ||
+ | |ALLOW_RLOGIN | Enable the RLogin protocol for incoming connections | | ||
+ | |NO_QWK_EVENTS | ||
+ | |NO_NEWDAY_EVENTS| Disable daily events from running in this instance of Synchronet | | ||
+ | |NO_EVENTS | Disable the Events thread (all timed events) | | ||
+ | |NO_TELNET_GA | ||
+ | |NO_HOST_LOOKUP | ||
+ | |NO_SPY_SOCKETS | ||
+ | |NO_DOS | ||
+ | |NO_RECYCLE | ||
+ | |GET_IDENT | Use the IDENT protocol on incoming connections | | ||
+ | |MUTE | Disable all local sound output | | ||
+ | |||
+ | ==== [FTP] ==== | ||
+ | |||
+ | See [[: | ||
+ | |||
+ | ==== [Mail] ==== | ||
+ | |||
+ | See [[: | ||
+ | |||
+ | ==== [Web] ==== | ||
+ | |||
+ | See [[: | ||
+ | |||
+ | ==== [Services] ==== | ||
+ | |||
+ | See [[: | ||
+ | |||
+ | ==== [UNIX] ==== | ||
+ | |||
+ | See [[: | ||
+ | | ||
===== See Also ===== | ===== See Also ===== | ||
* [[: | * [[: | ||
Line 106: | Line 406: | ||
- | + | {{tag> | |
- | + | ||