====== ctrl directory ======

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 =====

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.

The stock/default contents of the ''ctrl'' directory can be browsed online [[https://gitlab.synchro.net/sbbs/sbbs/-/tree/master/ctrl|here]].

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).

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 =====

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.

===== SBBSCTRL Environment Variable =====

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'').

===== Sub-directories ===== 

==== fonts ====

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:

^ 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.

==== modopts.d ====

Module option [[config:ini files]], see [[modopts.d]] for details.
===== 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}}