Next revision | Previous revisionLast revisionBoth sides next revision |
util:scfg [2010/02/26 14:22] – Deleted by PageMove plugin digitalman | util:scfg [2023/12/30 21:59] – new SCFG graphic screen shot digital man |
---|
| ====== SCFG ====== |
| |
| The Synchronet Configuration Utility (SCFG) is used for viewing and modifying the primary [[config:ini files]] in the Synchronet ''[[dir:ctrl]]'' directory. |
| |
| {{:util:scfg.3.20.main.png?800|SCFG Main Menu}} |
| |
| ===== Invoke ===== |
| |
| SCFG may be invoked from the [[:monitor:sbbsctrl|Synchronet Control Panel]] with the BBS->Configure menu option: |
| |
| {{:monitor:sbbsctrl_configure.png|}} |
| |
| Or by running ''scfg'' from a command prompt. |
| |
| :!: Note: If the Synchronet ''[[dir:exec]]'' directory is not in your search path, you may need to change the current working directory (e.g. using ''cd'') or specify the //full path// to ''scfg''. |
| |
| ===== Executable ===== |
| |
| SCFG is a native executable program. |
| |
| On Windows, the executable file is: ''[[dir:exec]]/scfg.exe'' |
| |
| On UNIX, the executable file is: ''[[dir:exec]]/scfg'' |
| |
| ===== Command-line ===== |
| |
| Help on the command-line usage can be displayed by executing the command: ''scfg -?'' or ''scfg --help'': |
| |
| <code> |
| options: |
| |
| -w run initial setup wizard |
| -f force save of configuration files |
| -a update all message base status headers |
| -h don't update message base status headers |
| -u# set file creation permissions mask (in octal) |
| -k keyboard mode only (no mouse support) |
| -c force color mode |
| -m force monochrome mode |
| -e# set escape delay to #msec |
| -insert enable keyboard insert mode by default |
| -import=<fname> import a message area list file |
| -faddr=<addr> specify your FTN address for imported subs |
| -misc=<value> specify option flags for imported subs |
| -g# set group number (or name) to import into |
| -host=<name> set hostname to use for alternate sbbs.ini file |
| -iX set interface mode to X (default=auto) where X is one of: |
| X = X11 mode |
| C = Curses mode |
| F = Curses mode with forced IBM charset |
| 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. |
| |
| ===== CTRL Directory ===== |
| |
| 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:ini files]] in the current working directory. |
| |
| ===== Usage ===== |
| |
| ==== Help ==== |
| |
| At any time within SCFG, you can press the ''F1'' or ''?'' keys or click the ''?'' on a window to get online help about the list of options or items being viewed or the option being edited. |
| |
| ==== Navigation keys: ==== |
| |
| ^ Key(s) ^ Action ^ |
| | ''Up'' and ''Down'' arrows | Move the lightbar that highlights the desired item| |
| | ''Page Up'' and ''Page Down'' | Move the lightbar up or down one "screen full" at a time | |
| | ''Home'' | Highlight first option in the menu | |
| | ''End'' | Highlight the last option in the menu | |
| | '' Enter'' | Select the highlighted item | |
| | ''Esc'' or ''Backspace'' | Return to the previous menu, or if at the top-level menu, quit the SCFG application | |
| | ''F1'' or ''?'' | Display help text on current windows/dialog/list | |
| | ''Ctrl-F'' | Find an option or item in a list | |
| | ''Ctrl-G'' | Find next option or item in list (after use of ''Ctrl-F'') | |
| | Letters/numbers | Pressing the first letter or number of an item in the menu will highlight that item | |
| |
| ==== Editing keys: ==== |
| |
| ^ Key(s) ^ Action ^ |
| | ''Insert'' or ''+'' | Insert new items in lists | |
| | ''Delete'' or ''-'' | Delete items from lists | |
| | ''Ctrl-C'' or ''F5'' or ''Ctrl-Insert'' | Copy item from list into clipboard | |
| | ''Ctrl-X'' or '' Shift-Delete'' | Cut item from list into clipboard | |
| | ''Ctrl-V'' or ''F6'' or ''Shift-Insert'' | Paste clipboard item into list (above highlighted item) | |
| |
| ==== 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. |
| |
| ===== Configure ===== |
| |
| * ''[[util:scfg:Nodes]]'' |
| * ''[[util:scfg:System]]'' |
| * ''[[server:|Servers]]'' |
| * ''[[util:scfg:Networks]]'' |
| * ''[[util:scfg:File Areas]]'' |
| * ''[[util:scfg:File Options]]'' |
| * ''[[util:scfg:Chat Features]]'' |
| * ''[[util:scfg:Message Areas]]'' |
| * ''[[util:scfg:Message Options]]'' |
| * ''[[util:scfg:Command Shells]]'' |
| * ''[[util:scfg:External Programs]]'' |
| * ''[[util:scfg:Text File Sections]]'' |
| |
| ===== See Also ===== |
| * [[util:|Utilities]] |
| * [[dir:CTRL]] Directory |
| * [[config:env#SBBSCTRL]] environment variable |
| * [[config:|Configuration]] |
| * [[config:cmdline|Command Lines]] |
| * [[ref:uifc|User Interface Library (UIFC)]] |
| |
| {{tag>configure scfg}} |
| |