Text Files

Text files that are displayed to remote clients / users and some configuration type files are stored in the text directory.

Text files with the following filename suffix/extensions, may include Synchronet @-codes and Ctrl-A Codes to customize the appearance and contents of the files for your BBS:

.asc
.ans
.mon
.msg

Display Files

Filename / Page	Default Contents	Description
`answer.asc`	answer.asc	Login screen displayed to Telnet clients upon connection (`.ans` and `.rip` variants also supported)
`bullseye.asc`	bullseye.asc	Bullseye! Bulletins Menu (see also `bullseye.cfg`)
`sbbs.msg`	sbbs.msg	Message regarding Synchronet features and usage displayed to new users (1st)
`system.msg`	system.msg	Message regarding your system displayed to new users (2nd)
`newuser.msg`	newuser.msg	Message displayed to user during new user sign-up (3rd)
`feedback.msg`	feedback.msg	Message displayed to user before requesting new user feedback letter (4th)
`welcome.msg`	welcome.msg	Optional welcome message e-mailed to new users (enabled in the newuser module)
`nonodes.txt`	<none>	Optional message displayed before disconnection due to no Terminal Server nodes being available for login

Logon Message Flow Chart

╔═══════════════╗
║ text/answer.* ║
╚═══════╤═══════╝
┌───────┴──────────────────────┐
│ Login Prompt (exec/login.js) │
└───────┬──────────────────────┘
  ┌─────┴─────┐ ┌─────┐ ╔═══════════════╗ ╔═════════════════╗
  │ New User? ├─┤ Yes ├─╢ text/sbbs.msg ╟─╢ text/system.msg ║
  └─────┬─────┘ └─────┘ ╚═══════════════╝ ╚════════╤════════╝
     ┌──┴─┐                               ╔════════╧═════════╗
     │ No │                               ║ text/newuser.msg ║
     └──┬─┘                               ╚════════╤═════════╝
        │                                ┌─────────┴──────────┐
        │                                │ Password Selection │
        │                                └─────────┬──────────┘
        │                               ┌──────────┴────────────┐
        │                               │ Default Configuration │
        │                               └──────────┬────────────┘
        │  ╔═══════════════════╗ ┌─────┐ ┌─────────┴──────────┐
        │  ║ text/feedback.msg ╟─┤ Yes ├─┤ Feedback Required? │
        │  ╚═════════╤═════════╝ └─────┘ └─────────┬──────────┘
        │    ┌───────┴───────┐                  ┌──┴─┐
        │    │ Send Feedback │                  │ No │
        │    └───────┬───────┘                  └──┬─┘
        │  ┌─────────┴──────────────────────────┐  │
        │  │ New User Module (exec/newuser.js)  ├──┘
        │  └─────────┬──────────────────────────┘
        │  ┌─────────┴─────────┐                   
        │  │ New User Event(s) │
        │  └─────────┬─────────┘
┌───────┴────────────┴─────────┐
│ Logon Module (exec/logon.js) │
└───────┬──────────────────────┘
        │  ╔═══════════════════════════════════╗
        └──╢ text/menu/logon<security-level>.* ║
           ╚═════════╤═════════════════════════╝
          ╔══════════╧════════╗
          ║ text/menu/logon.* ║
          ╚══════════╤════════╝
          ╔══════════╧═════════╗
          ║ text/menu/logon1.* ║
          ╚══════════╤═════════╝
                    ...

          ╔══════════╧══════════╗
          ║ text/menu/logon99.* ║
          ╚══════════╤══════════╝
          ╔══════════╧══════════╗
          ║ text/menu/random*.* ║
          ╚══════════╤══════════╝
            ┌────────┴───────┐
            │ Logon Event(s) │
            └────────────────┘

Filter Files

Trash can (.can) files allow the sysop to specify words (or any sequence of characters) that will be used to disallow users or their content.

Each line in a .can file may contain a comparison sequence.

Blank lines and lines beginning with a semicolon are ignored
Comparisons are alphabetic letters are case-insensitive
Sequences beginning with an exclamation mark (!) negate the match logic for that sequence
Sequences beginning with an asterisk (*) match only if the characters following the * are found at the end of the comparison string
Sequences ending with an asterisk (*) or caret (^) match only if the characters preceding are found at the beginning of the comparison string
Sequences ending with a tilde (~) match only if the preceding characters are found anywhere within comparison string
All other sequences are “exact match” string comparisons

Examples:

sysop in the name.can file would mean users could not use the name “sysop”.
sysop* would mean users could not use names beginning with the word “sysop”, like “sysopa” or “sysops” etc.
sysop~ would mean users could not use names that have the word “sysop” anywhere in them, like “imthesysop” or “mesysophere”.

The following table lists the supported trash can / filter files, a description of their use, and optional response message (.msg) files that may be displayed to users that are filtered.

Filename / Page	Default Contents	Description
`email.can`	email.can	Disallowed (source or destination) e-mail addresses (see also `twitlist.cfg`)
`bademail.msg`		Optional message to display to users attempting to use a disallowed email address
`file.can`	file.can	Disallowed filenames for upload
`badfile.msg`		Optional message to display to users who attempt to upload a disallowed filename
`host.can`	host.can	Disallowed hostnames for connections
`badhost.msg`		Optional message to display to users who attempt to connect from a disallowed host
`ip.can`	ip.can	Disallowed IP addresses for connections
`badip.msg`		Optional message to display to users who attempt to connect from a disallowed IP address
`ip-silent.can`	ip-silent.can	Silently-ignored IP addresses for connections
`name.can`	name.can	Disallowed user alias
`badname.msg`		Optional message to display to users who attempt to use a disallowed alias
`phone.can`	phone.can	Disallowed phone numbers for new users
`badphone.msg`		Optional message to display to users who attempt to use a disallowed phone number
`subject.can`	subject.can	Disallowed message subjects
`badsubject.msg`		Optional message to display to users who attempt to use a disallowed subject in a posted message

Miscellaneous

Filename / Page	Default Contents	Description
`bullseye.cfg`	bullseye.cfg	Bullseye! Builletins Configuration (see also `bullseye.asc`)
`example.sif`	example.sif	Example Synchronet Questionnaire file
`lbshell_bg.bin`	lbshell_bg.bin	Lightbar Command Shell background image (not text)
`ircmotd.txt`	ircmotd.txt	IRC Daemon “Message Of The Day”
`zipmsg.txt`	zipmsg.txt	ZIP message added to uploaded `.zip` files.

Menu Files

Menu files displayed to the remote terminal client / user are stored in the text/menu directory hierarchy.

Menu files may have one of the following file suffixes / extensions:

Extension	Description
`.asc`	Ctrl-A Encoded ANSI X3.64-subset and Dumb ASCII Terminals
`.ans`	ANSI X3.64 Color Terminals
`.mon`	ANSI X3.64 Monochrome Terminals
`.rip`	RIPscrip Terminals