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

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
util:scfg [2010/03/17 00:29] – digitalmanutil:scfg [2023/12/25 13:47] – [Command-line Usage] Latest usage (includes -host= option) digital man
Line 1: Line 1:
 ====== SCFG ====== ====== SCFG ======
  
-The Synchronet Configuration Utility (SCFG) is used for viewing and modifying the various [[config:CNF files]] in the Synchronet ''[[dir:ctrl]]'' directory.+The Synchronet Configuration Utility (SCFG) is used for viewing and modifying the primary [[config:ini files]] in the Synchronet ''[[dir:ctrl]]'' directory.
  
 {{:util:scfg_main.png|SCFG Main Menu}} {{:util:scfg_main.png|SCFG Main Menu}}
Line 21: Line 21:
 On Windows, the executable file is: ''[[dir:exec]]/scfg.exe'' On Windows, the executable file is: ''[[dir:exec]]/scfg.exe''
  
-On Unix, the executable file is: ''[[dir:exec]]/scfg''+On UNIX, the executable file is: ''[[dir:exec]]/scfg''
  
 ===== Command-line Usage ===== ===== Command-line Usage =====
Line 28: Line 28:
  
 <code> <code>
-usage: scfg [ctrl_dir] [options] 
- 
 options: options:
  
--s  =  don't check directories +-w                run initial setup wizard 
--f  =  force save of config files +-f                force save of configuration files 
--a  =  update all message base status headers +-a                update all message base status headers 
--h  =  don't update message base status headers +-h                don't update message base status headers 
--u# =  set file creation permissions mask (in octal) +-u#               set file creation permissions mask (in octal) 
--c  =  force color mode +-k                keyboard mode only (no mouse support) 
--m  =  force monochrome mode +-c                force color mode 
--e# =  set escape delay to #msec +-m                force monochrome mode 
--iX =  set interface mode to X (default=auto) where X is one of: +-e#               set escape delay to #msec 
-       X = X11 mode +-insert           enable keyboard insert mode by default 
-       C = Curses mode +-import=<fname>   import a message area list file 
-       F = Curses mode with forced IBM charset +-faddr=<addr>     specify your FTN address for imported subs 
-       W = Win32 native mode +-misc=<value>     specify option flags for imported subs 
-       A = ANSI mode +-g#               set group number (or name) to import into 
-       D = standard input/output/door mode +-host=<name>      set hostname to use for alternate sbbs.ini file 
--v# =  set video mode to # (default=auto) +-iX               set interface mode to X (default=auto) where X is one of: 
--l# =  set screen lines to # (default=auto-detect) +                   X = X11 mode 
--b# =  set automatic back-up level (default=5) +                   C = Curses mode 
--y  =  automatically save changes (don't ask) +                   F = Curses mode with forced IBM charset 
-</code>+                   I = Curses mode with forced ASCII charset 
 +                   A = ANSI mode 
 +                   D = standard input/output/door mode 
 +-A                use alternate (ASCII) characters for arrow symbols 
 +-v#               set video mode to # (default=auto) 
 +-l#               set screen lines to # (default=auto-detect) 
 +-y                automatically save changes (don't ask)</code>
  
 :!: Note: some of the interface mode values are only available on particular platforms/operating systems. :!: Note: some of the interface mode values are only available on particular platforms/operating systems.
Line 57: Line 61:
 ===== CTRL Directory ===== ===== CTRL Directory =====
  
-If the ''[[config:env#SBBSCTRL]]'' environment variable is set, then SCFG will find the [[config:CNF files]] without needing you to specify the path to the ''[[dir:ctrl]]'' directory  (''[ctrl_dir]'') on the command-line.+If the ''[[config:env#SBBSCTRL]]'' environment variable is set, then SCFG will find the [[config:ini files]] without needing you to specify the path to the ''[[dir:ctrl]]'' directory  (''[ctrl_dir]'') on the command-line.
  
-If the ''[[config:env#SBBSCTRL]]'' environment variable is **not** set and the ''[ctrl_dir]'' is not specified on the command-line, SCFG will look for the [[config:CNF files]] in the current working directory.+If the ''[[config:env#SBBSCTRL]]'' environment variable is **not** set and the ''[ctrl_dir]'' is not specified on the command-line, SCFG will look for the [[config:ini files]] in the current working directory.
  
-===== Help Files ===== +===== Usage and Help ===== 
- +At any time within SCFG, you can press the F1 key or click the ''?'' on a window to get online help about the section being edited.
-FIXME+
  
 +  * ''Up'' and ''Down'' arrows: Move the lightbar that highlights the desired item.
 +  * ''Home'': highlight first option in the menu.
 +  * ''End'': highlight the last option in the menu.
 +  * '' Enter'': select the highlighted item.
 +  * ''Esc'' return to the previous menu, or if at the top-level menu, quit the SCFG application.
 +  * Pressing the first letter or number of an item in the menu will highlight that item.
 ===== Using SCFG ===== ===== Using SCFG =====
 +
 +==== Initial Setup Wizard ====
 +
 +When SCFG detects a new installation, or is invoked with the ''-w'' command-line options, it'll start the //Initial Setup Wizard// which will prompt for various import initial configuration settings.
  
 ==== Standard I/O Mode ==== ==== Standard I/O Mode ====
Line 79: Line 92:
 ===== Configure ===== ===== Configure =====
  
-  * ''[[scfg:Nodes]]'' +  * ''[[util:scfg:Nodes]]'' 
-  * ''[[scfg:System]]'' +  * ''[[util:scfg:System]]'' 
-  * ''[[scfg:Networks]]'' +  * ''[[util:scfg:Networks]]'' 
-  * ''[[scfg:File Areas]]'' +  * ''[[util:scfg:File Areas]]'' 
-  * ''[[scfg:File Options]]'' +  * ''[[util:scfg:File Options]]'' 
-  * ''[[scfg:Chat Features]]'' +  * ''[[util:scfg:Chat Features]]'' 
-  * ''[[scfg:Message Areas]]'' +  * ''[[util:scfg:Message Areas]]'' 
-  * ''[[scfg:Message Options]]'' +  * ''[[util:scfg:Message Options]]'' 
-  * ''[[scfg:Command Shells]]'' +  * ''[[util:scfg:Command Shells]]'' 
-  * ''[[scfg:External Programs]]'' +  * ''[[util:scfg:External Programs]]'' 
-  * ''[[Text File Sections]]'' +  * ''[[util:scfg:Text File Sections]]'' 
 +  * ''[[config:cmdline|Command Lines]]''
  
 ===== See Also ===== ===== See Also =====
 +  * [[util:|Utilities]]
   * [[dir:CTRL]] Directory   * [[dir:CTRL]] Directory
   * [[config:env#SBBSCTRL]] environment variable   * [[config:env#SBBSCTRL]] environment variable
   * [[config:|Configuration]]   * [[config:|Configuration]]
-  * [[util:|Utilities]]+  * [[ref:uifc|User Interface Library (UIFC)]]
  
 {{tag>configure scfg}} {{tag>configure scfg}}
  

Trace: