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

Next revision		Previous revision
dir:ctrl [2010/02/21 23:45] – created digitalmandir:ctrl [2023/02/12 15:45] (current) – add modopts.d reference digital man
Line 1: Line 1:
-====== CTRL Directory ======+====== ctrl directory ======
  
-The path to the Synchronet control (CTRL) directory defaults to a sub-directory named ''ctrl'' off of the installation directory (e.g. ''/sbbs/ctrl/'').+The path to the Synchronet control directory defaults to a sub-directory named ''ctrl'' off of the installation directory (e.g. ''/sbbs/ctrl/'').
  
 ===== Directory Contents ===== ===== Directory Contents =====
  
-The Synchronet control directory contains critical configuration and data files for the operation of the software.+The Synchronet control directory contains critical configuration and data files for the operation of the software as well as some files (e.g. ''[[custom:text.dat]]'') that allow for sysop customization of the BBS.
  
-===== SBBSCTRL Environment Variable =====+The stock/default contents of the ''ctrl'' directory can be browsed online [[https://gitlab.synchro.net/sbbs/sbbs/-/tree/master/ctrl|here]].
  
-The ''SBBSCTRL'' environment variable of your operating system/shell should be set the path of this directory.+A daily snapshot archive of the stock/default contents of the ''ctrl'' directory can downloaded in [[ftp://ftp.synchro.net/sbbsctrl.zip|zip]] (for Windows) or [[ftp://ftp.synchro.net/sbbsctrl.tgz|tgz]] (for *nix).
  
-==== Windows NT ====+Since most of the files in the ''ctrl'' directory reflect the sysop's configuration changes, it's a highly recommended to be very careful when replacing/overwriting any files in this directory. 
 +===== Purpose =====
  
-For Windows NT-based operating systems, goto the Windows Control Panel-> +The purpose of this directory is a single place for the configuration of the BBS.  Although there are data files (DAB and LST) present in a running system, these are legacy and the intent is that this directory will only contain files which configure components that ship with Synchronet itself.
-System->Advanced->Environment Variables->System Variables->New... +
-    Variable:           SBBSCTRL +
-    Variable Value:     c:\sbbs\ctrl +
-(replace ''c:\sbbs\ctrl'' with the full path to your ''ctrl'' directory)+
  
-==== Windows 9x ====+===== SBBSCTRL Environment Variable =====
  
-For Windows 9x-based operating systems, edit your C:\AUTOEXEC.BAT file +The [[config:env#SBBSCTRL]] environment variable informs Synchronet programs where to locate the ''ctrl'' directory and should be set to the full path of the ''ctrl'' directory (e.g. ''/sbbs/ctrl'').
-and add the line: +
-    SET SBBSCTRL=c:\sbbs\ctrl +
-(replace ''c:\sbbs\ctrl'' with the full path to your ''ctrl'' directory)+
  
-==== bash ====+===== Sub-directories ===== 
  
-For Unix bash/sh: +==== fonts ====
-In the home directory of the user the BBS will be running as, edit the file +
-named either .profile or .bash_profile depending on if you're running bash or +
-sh and add the line:+
  
-    SBBSCTRL=/sbbs/ctrl && export SBBSCTRL +The ''[[https://gitlab.synchro.net/sbbs/sbbs/-/tree/master/ctrl/fonts|fonts]]'' sub-directory contains optional font files in IBM CGA 8-bit/pixel wide character/glyph format. The supported character **height** is specified in the file's extension:
-(replace ''/sbbs/ctrl'' with the full path to your ''ctrl'' directory)+
  
-==== csh/tcsh ====+^ File Extension ^ Character Dimensions (w x h) ^ File Size (in bytes) ^ Supported Screen Modes ^ 
 +| ''.f16''       | 8x16                 | 4096                 | 30 and fewer than 28 lines, **most common** | 
 +| ''.f14''       | 8x14                 | 3584                 | 28 lines and 34 lines | 
 +| ''.f8''        | 8x8                  | 2048                 | 35 or more lines |
  
 +These files may be sent (loaded and activated) into the terminals of SyncTERM users by referencing the files in your ''[[config:fonts.ini]]'' file.
  
-For Unix csh/tcsh: +==== modopts.d ====
-Again, in the home directory of the user the BBS will be running as, in the +
-file named .tcshrc (for tcsh) or .cshrc (for csh) add the line:+
  
-    setenv SBBSCTRL /sbbs/ctrl +Module option [[config:ini files]], see [[modopts.d]] for details. 
-(replace ''/sbbs/ctrl'' with the full path to your ''ctrl'' directory)+===== See Also =====
  
 +  * [[config:ini_files|INI Files]]
 +  * [[config:cfg_files|CFG Files]]
 +  * [[custom:text.dat]] 
 +  * [[https://gitlab.synchro.net/sbbs/sbbs/-/tree/master/ctrl/|CTRL directory in Git]]
 +  * [[dir:|Directory structure]]
 + 
 +{{tag>config sbbsctrl fonts}}

Trace: