| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| config:ini_files [2025/05/01 15:00] – [String Literals] Clarify that quotes are strictly required for trailing white-space digital man | config:ini_files [2025/12/21 03:41] (current) – [Enumerated Values] Fix the confusing wording about enum key value word/partial-word matches digital man |
|---|
| | ''xtrn.ini'' | External program configurations which includes timed events, message editors, hot-key events and doors | | | ''xtrn.ini'' | External program configurations which includes timed events, message editors, hot-key events and doors | |
| | ''chat.ini'' | Chat Features settings, specifically the Guru, Multi-node chat actions and channels, and external sysop pagers | | | ''chat.ini'' | Chat Features settings, specifically the Guru, Multi-node chat actions and channels, and external sysop pagers | |
| | ''node.ini'' | Located in the [[dir:node|node directories]], and configured via the SCFG [[util:scfg:Nodes]] menu | | | ''node.ini'' | Located in the [[dir:node|node directories]], and configured via the SCFG [[config:nodes]] menu | |
| |
| ==== Secondary Configuration Files ==== | ==== Secondary Configuration Files ==== |
| |''[[formmail.ini]]'' |[[https://gitlab.synchro.net/sbbs/sbbs/-/raw/master/ctrl/formmail.ini|formmail.ini]]|Configuration for ''[[dir:web]]/formmail.ssjs'', Synchronet's Server-side [[custom:JavaScript]] version of [[http://www.scriptarchive.com/formmail.html|FormMail]]| | |''[[formmail.ini]]'' |[[https://gitlab.synchro.net/sbbs/sbbs/-/raw/master/ctrl/formmail.ini|formmail.ini]]|Configuration for ''[[dir:web]]/formmail.ssjs'', Synchronet's Server-side [[custom:JavaScript]] version of [[http://www.scriptarchive.com/formmail.html|FormMail]]| |
| |''[[ircbot.ini]]'' |[[https://gitlab.synchro.net/sbbs/sbbs/-/raw/master/ctrl/ircbot.ini|ircbot.ini]]|Configuration for IRC robots, optionally works with the Synchronet [[service:IRCd]]| | |''[[ircbot.ini]]'' |[[https://gitlab.synchro.net/sbbs/sbbs/-/raw/master/ctrl/ircbot.ini|ircbot.ini]]|Configuration for IRC robots, optionally works with the Synchronet [[service:IRCd]]| |
| | |''[[ircd.ini]]'' |[[https://gitlab.synchro.net/sbbs/sbbs/-/raw/master/ctrl/ircd.ini|ircd.ini]]|Configuration for IRC server. Replaces old ircd.conf on modern Synchronet [[service:IRCd]]| |
| |''[[listserver.ini]]'' |[[https://gitlab.synchro.net/sbbs/sbbs/-/raw/master/ctrl/listservier.ini|listserver.ini]]|Configuration for the Synchronet ListServer module (''[[dir:exec]]/[[module:listserver]].js'')| | |''[[listserver.ini]]'' |[[https://gitlab.synchro.net/sbbs/sbbs/-/raw/master/ctrl/listservier.ini|listserver.ini]]|Configuration for the Synchronet ListServer module (''[[dir:exec]]/[[module:listserver]].js'')| |
| |''[[mailproc.ini]]'' |[[https://gitlab.synchro.net/sbbs/sbbs/-/raw/master/ctrl/mailproc.ini|mailproc.ini]]|Configuration of External Mail Processors for the [[server:Mail]] Server (SMTP)| | |''[[mailproc.ini]]'' |[[https://gitlab.synchro.net/sbbs/sbbs/-/raw/master/ctrl/mailproc.ini|mailproc.ini]]|Configuration of External Mail Processors for the [[server:Mail]] Server (SMTP)| |
| A numeric value higher than the highest supported enumerated value will be treated the same as the highest supported enumerated value. | A numeric value higher than the highest supported enumerated value will be treated the same as the highest supported enumerated value. |
| |
| When a word is provided for the enumerated key value, an exact case-insensitive match is performed search following by a partial-match search, so "Debug" would match the enum value for "Debugging", and "Info" would match the enum value for "Informational". | When a word is provided as an enumerated key value, an initial partial word match is all that is required. So for example, a key value of "Debugging" would match the enum value of ''Debug'', and "Informational" would match the enum value of ''Info''. These string matches are also performed case-insensitively so "ERROR" and "error" are equivalents. |
| |
| === Log Levels === | === Log Levels === |
| ''LogLevel'' keys are one example of a key with enumerated values. The ''LogLevel'' value may be specified as a decimal number (from ''0'' to ''7'') or by specifying one of the following enumerated names: | ''LogLevel'' keys are one example of a key with enumerated values. The ''LogLevel'' value may be specified as a decimal number (from ''0'' to ''7'') or by specifying one of the following enumerated names: |
| |
| ^Value ^Name ^ | ^Value ^Name ^ Description ^ |
| |0 |Emergency | | |0 |''Emergency'' | Fatal condition | |
| |1 |Alert | | |1 |''Alert'' | Very Serious condition | |
| |2 |Critical | | |2 |''Critical'' | Serious condition | |
| |3 |Error | | |3 |''Error'' | Unexpected/erroneous condition | |
| |4 |Warning | | |4 |''Warning'' | Suspicious condition | |
| |5 |Notice | | |5 |''Notice'' | Infrequent event | |
| |6 |Informational| | |6 |''Info'' | Common activity (AKA "Informational") | |
| |7 |Debugging | | |7 |''Debug'' | Extra detail sometimes helpful during issue analysis (AKA "Debugging") | |
| |
| Log entries with a log level //higher// than the specified ''LogLevel'' value will not be logged/displayed. | Log entries with a log level //higher// than the specified ''LogLevel'' value will not be logged/displayed. |
| |
| The ''Debugging'' (7) log level enables //all// possible log output. | The ''Debug'' (7) log level enables //all// possible log output. |
| |
| ==== Bit-field Values ==== | ==== Bit-field Values ==== |
