Skip to content
Snippets Groups Projects
Commit 611458bb authored by rswindell's avatar rswindell
Browse files

Removed configuration changes which are now the default in CVS. 

Added instructions for updating an existing installation.
Simplified cvs command-lines.
parent 47d92439
No related branches found
No related tags found
No related merge requests found
Hide whitespace changes
Inline Side-by-side
Showing
with 79 additions and 196 deletions
docs/sbbsunix.txt
+ 79
− 196
View file @ 611458bb
......@@ -2,7 +2,7 @@ Synchronet for Unix
-=-=-=-=-=-=-=-=-=-
Created: Mar 15, 2002
Updated: Dec 07, 2002
Updated: Jan 17, 2003
By: Rob Swindell
http://www.synchro.net
......@@ -12,7 +12,11 @@ The information in this file is current as of the "updated" date above. The
answers and instructions in this file may change over time, so be sure to get
the current version of this file at
ftp://vert.synchro.net/Synchronet/sbbsunix.txt
or via CVSweb at
http://cvs.synchro.net/cgi-bin/cvsweb.cgi/~checkout~/docs/sbbsunix.txt
For additional tips on running Synchronet on FreeBSD, see
http://sync.bbsdev.net/tips.html
Answers to Frequently Asked Questions
=====================================
......@@ -25,12 +29,12 @@ A. Should work with any GNU/Linux-x86 distribution (e.g. RedHat, Mandrake,
Debian, Slackware, etc.).
Q. Are non-x86 (Alpha, SPARC, 68k, PowerPC, etc) processors supported?
A. No, Synchronet assumes a little-endian processor. It *may* work on other
little-endian processors (e.g. Alpha), but hasn't been tested. Big-endian
support is currently being developed for the v3.20 time-frame.
A. Not currently. Synchronet assumes a little-endian processor. It *may* work
on other little-endian processors (e.g. Alpha), but hasn't been tested.
Big-endian support is currently being developed for the v3.20 time-frame.
Q. Will Synchronet ever support big-endian and/or 64-bit processors?
A. Yes.
A. Yes, that is plan.
Q. Where do I get Synchronet for Unix?
A. There are no binary distributions at this time, so you must get the source
......@@ -38,7 +42,8 @@ A. There are no binary distributions at this time, so you must get the source
See the step-by-step instructions below for details.
Q. Will there be binary releases?
A. Yes, some day soon.
A. Yes, some day soon. Or maybe a binary installer that will come with source
code and build it for you.
Q. Can I mix Synchronet for Unix and Synchronet for Win32 or DOS or OS/2 nodes
on the same BBS?
......@@ -49,11 +54,12 @@ A. Yes. As long as all the nodes can access the same live data files (via LAN)
Q. Does Synchronet for Unix support external DOS programs/doors?
A. Currently, only the FreeBSD build has doscmd support "built-in". Other
platforms can use DOSEMU or whatever is available for running DOS programs.
There is currently no available documentation for using Synchronet with
DOSEMU on Linux (or other platforms), but there should be soon.
Q. What external programs/doors does Synchronet for Unix support?
A. Currently, only native programs are supported. These programs can either
use standard I/O (e.g. bash, pico, Lord/X, PimpWars) or socket I/O
(e.g. Synchronet XSDK doors).
A. External programs can either use standard I/O (e.g. bash, pico, Lord/X,
PimpWars) or socket I/O (e.g. Synchronet XSDK doors).
Q. Does Synchronet for Unix require X-Windows?
A. No, Synchronet for Unix is currently a console-based application.
......@@ -67,7 +73,9 @@ Step-by-step Instructions
Note: These instructions assume you are already logged in as 'root'.
1. Get and build the current source code:
Note: Skip to step 8 if you are updating an existing Synchronet installation.
1. Get the required installation and source code modules from CVS:
A. Create the Synchronet BBS directory on your file system:
mkdir /sbbs
......@@ -75,43 +83,45 @@ Note: These instructions assume you are already logged in as 'root'.
B. Change to this directory:
cd /sbbs
* Optional Shortcut *
At this point you can copy the file from this url:
http://cvs.synchro.net/cgi-bin/cvsweb.cgi/~checkout~/install/GNUmakefile
into the /sbbs directory, run "gmake install", and then skip ahead to
step 4.
*> Optional Shortcut:
*> At this point you can copy the file from this url:
*> http://cvs.synchro.net/cgi-bin/cvsweb.cgi/~checkout~/install/GNUmakefile
*> into the /sbbs directory, run "gmake install", and then skip ahead to
*> step 5.
C. Get the required modules from the CVS repository:
cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs login
C. Get the required installation modules from the CVS repository:
export CVSROOT=:pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs
cvs login
(no password - just hit enter)
cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs co ctrl
cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs co text
cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs co exec
cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs co node1
cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs co xtrn
cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs co src/sbbs3
cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs co src/uifc
cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs co src/xpdev
cvs -d :pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs co src/mozilla
(this last one may take a while as it includes pre-compiled libraries)
D. Change to this directory:
cvs -z3 co ctrl text exec node1 xtrn
D. Get the required source code modules from the CVS repository:
cvs -z3 co src/sbbs3 src/uifc src/xpdev src/mozilla
(this may take a while as it includes pre-compiled libraries)
2. Build Synchronet:
A. Change to this directory:
cd /sbbs/src/sbbs3
E. Build the main executable (and utilities):
B. Build the main executable (and utilities):
gmake
(there *should* be no warnings or errors)
(please report buid errors to rob@synchro.net)
Note: warnings (if any) can be safely ignored
F. Change to this directory:
C. Change to this directory:
cd /sbbs/src/sbbs3/scfg
G. Build the Synchronet configuration utility (SCFG):
D. Build the Synchronet configuration utility (SCFG):
gmake
(please report buid errors to rob@synchro.net)
Note: warnings (if any) can be safely ignored
H. Congratulate yourself on a job well-done.
E. Congratulate yourself on a job well-done.
2. Prepare the "exec" directory:
3. Prepare the "exec" directory:
A. Change to this directory:
cd /sbbs/exec
......@@ -121,21 +131,23 @@ Note: These instructions assume you are already logged in as 'root'.
/sbbs/src/sbbs3/gcc.linux.exe.debug/node
/sbbs/src/sbbs3/gcc.linux.exe.debug/chksmb
/sbbs/src/sbbs3/gcc.linux.exe.debug/fixsmb
/sbbs/src/sbbs3/gcc.linux.exe.debug/makeuser
/sbbs/src/sbbs3/gcc.linux.exe.debug/addfiles
/sbbs/src/sbbs3/gcc.linux.exe.debug/filelist
/sbbs/src/sbbs3/gcc.linux.exe.debug/smbutil
/sbbs/src/sbbs3/gcc.linux.exe.debug/sbbs
/sbbs/src/sbbs3/gcc.linux.exe.debug/sbbsecho
/sbbs/src/sbbs3/gcc.linux.exe.debug/echocfg
/sbbs/src/sbbs3/scfg/gcc.linux.debug/scfg
/sbbs/src/sbbs3/scfg/gcc.linux.debug/scfghelp.ixb
/sbbs/src/sbbs3/scfg/gcc.linux.debug/scfghelp.dat
(the paths will be different for FreeBSD or release builds)
(the paths will be different for other platforms or release builds)
C. Build the required Baja {tm} modules:
gmake
3. Prepare the "xtrn" directory:
4. Prepare the "xtrn" directory:
A. Change to this directory:
cd /sbbs/xtrn/sbj
......@@ -150,7 +162,7 @@ Note: These instructions assume you are already logged in as 'root'.
gmake
4. Configure the BBS:
5. Configure the BBS:
A. Run SCFG:
/sbbs/exec/scfg /sbbs/ctrl
......@@ -160,160 +172,14 @@ Note: These instructions assume you are already logged in as 'root'.
the path to the "ctrl" directory on the command-line:
export SBBSCTRL=/sbbs/ctrl
B. Add the following to SCFG->External Programs->Native Program List:
sh
bash
sz
rz
zip
unzip
C. Add "pico" (Pine Composer) to SCFG->External Programs->External Editors:
Name pico
Internal Code PICO
Remote Command Line pico -t -o %g %f
Access Requirements UNIX
Intercept Standard I/O Yes
Native (32-bit) Executable Yes
Quoted Text Prompt User
QuickBBS Style (MSGTMP) No
Expand Line Feeds to CRLF Yes
Strip FidoNet Kludge Lines No
BBS Drop File Type None
D. Add to SCFG->External Programs->Online Programs->Main->Available
Programs:
Name Synchronet Configuration
Internal Code SCFG
Start-up Directory
Command Line %!scfg -l%r
Clean-up Command Line
Execution Cost None
Access Requirements SYSOP
Execution Requirements
Multiple Concurrent Users No
Intercept Standard I/O Yes
Native (32-bit) Executable Yes
Modify User Data No
Execute on Event No
BBS Drop File Type None
Place Drop File In Node Directory
E. Configure SCFG->External Programs->Online Programs->Main->
Synchronet BBS List:
Name Synchronet BBS List
Internal Code SBL
Start-up Directory ../xtrn/sbl
Command Line ./sbl%.
Clean-up Command Line
Execution Cost None
Access Requirements
Execution Requirements
Multiple Concurrent Users Yes
Intercept Standard I/O No
Native (32-bit) Executable Yes
Modify User Data No
Execute on Event No
BBS Drop File Type Synchronet XTRN.DAT
Place Drop File In Node Directory
F. Configure SCFG->External Programs->Online Programs->Games->
Synchronet Blackjack!:
Name Synchronet Blackjack!
Internal Code SBJ
Start-up Directory ../xtrn/sbj
Command Line ./sbj%. /l
Clean-up Command Line ./sbjclean
Execution Cost None
Access Requirements
Execution Requirements
Multiple Concurrent Users Yes
Intercept Standard I/O No
Native (32-bit) Executable Yes
Modify User Data Yes
Execute on Event No
BBS Drop File Type Synchronet XTRN.DAT
Place Drop File In Node Directory
G. Change the "Access Requirements" for *all* of the following:
SCFG->File Options->Viewable File Types->ZIP,
SCFG->File Options->Testable File Types->ZIP,
SCFG->File Options->Extractable File Types->ZIP,
and SCFG->File Options->Compressable File Types->ZIP to:
Access Requirements NOT UNIX
G. Add "zip" (lowercase) to SCFG->File Options->Viewable File Types:
File Extension zip
Command Line unzip -l %s
Access Requirements UNIX
I. Add "zip" (lowercase) to SCFG->File Options->Testable File Types:
File Extension zip
Command Line unzip -t %f
Working String Testing ZIP Integrity...
Access Requirements UNIX
J. Add "zip" (lowercase) to SCFG->File Options->Extractable File Types:
File Extension zip
Command Line unzip -o -j %f %s -d %g
Access Requirements UNIX
K. Add "zip" (lowercase) to SCFG->File Options->Compressable File Types:
File Extension zip
Command Line zip -j -D %f %s
Access Requirements UNIX
NOTE: File extensions are not actually case-sensitive, but I use uppercase
extensions to denote DOS/Win32 file extensions and lowercase to
denote Unix file extensions. The Access Requirements actually
determines *which* command line will be used for the current
platform.
L. Change the "Access Requirements" for *all* the existing protocols under
SCFG->File Options->Transfer Protocols to:
Access Requirements NOT UNIX
M. Add the following transfer protocols to
SCFG->File Options->Transfer Protocols:
Mnemonic (Command Key) X
Protocol Name Xmodem (SZ)
Access Requirements UNIX
Upload Command Line rz --xmodem
Download Command Line sz --xmodem %f
Batch UL Command Line
Batch DL Command Line
Bidir Command Line
Uses DSZLOG No
Mnemonic (Command Key) Y
Protocol Name Ymodem (SZ)
Access Requirements UNIX
Upload Command Line rz --ymodem
Download Command Line sz --ymodem %f
Batch UL Command Line rz --ymodem
Batch DL Command Line sz --ymodem %s
Bidir Command Line
Uses DSZLOG No
Mnemonic (Command Key) Z
Protocol Name Zmodem (SZ)
Access Requirements UNIX
Upload Command Line rz -p -R
Download Command Line sz %f
Batch UL Command Line rz -p -R
Batch DL Command Line sz %s
Bidir Command Line
Uses DSZLOG No
N. Change SCFG->Networks->QWK->Hubs->VERT:
B. Change SCFG->Networks->QWK->Hubs->VERT:
Pack Command Line zip -j -D %f %s
Unpack Command Line unzip -o -j %f %s -d %g
Call-out Command Line *qnet-ftp VERT vert.synchro.net YOURPASS
(change YOURPASS to the password used to create your QWKnet account)
(see docs/dove-net.txt for more details)
5. Running Synchronet
6. Running Synchronet:
1. Set the SBBSCTRL environment variable to point to your "ctrl" directory:
export SBBSCTRL=/sbbs/ctrl
......@@ -327,26 +193,43 @@ Note: These instructions assume you are already logged in as 'root'.
4. To view default settings (node and port numbers), run:
/sbbs/exec/sbbs defaults
5. To edit the default settings, edit the file:
5. To change the default settings, edit the file:
/sbbs/ctrl/sbbs.ini
6. Debugging
7. Debugging:
A. Run the GNU debugger:
gdb /sbbs/exec/sbbs
B. Set command-line options [optional]:
set args tf1 tl10 m-
(these command-line options are provided as an example only)
C. Run Synchronet:
B. Run Synchronet:
run
D. After segfault, display backtrace:
C. After segfault, display backtrace:
bt
E. Copy and paste in e-mail to rob@synchro.net
D. Copy and paste in e-mail to rob@synchro.net
8. Updating/synchronizing the source code with the CVS repository:
A. Change to your Synchronet installation directory:
cd /sbbs
B. Back-up your working exec directory:
cp -a exec exec.bak
C. Get the latest changes from CVS:
export CVSROOT=:pserver:anonymous@cvs.synchro.net:/cvsroot/sbbs
cvs login
(no password - just hit enter)
cvs update docs exec src xtrn
D. Repeat steps 2, 3 and 4 (only).
E. Shutdown and re-run sbbs.
F. You're done. :-)
Send comments/questions to rob@synchro.net
......
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment