                  DOCUMENTATION FOR THE LINFBB VERSION 7.03
                         
            THE biggest SUMMARY has TAKEN IT OF THE MANUAL IN HTML   
                            By Per Olsen LA6CU                 

                    By Jose R. Marte A. (HI8GN) 12/15/2000

                   Linux Version for the LinFBB 7.03
 serie
                            By Jean Paul F6FBB

 
                       First installation and startup. 
                       ==============================

(A)    This part of the manual is intended for the sysop who has never used LinFBB
       software before. I hope this part of the manual will help you to get
       "on the air" with LinFBB without too many problems.

       I presume that you have installed your operating-system,
       (Linux) correct before you attempt to install the LinFBB.
       Normally you will install LinFBB from a package .TGZ.

       Normally will be called xd7xx.tgz, and normally you will install the
       LinFBB-program on hard-disk called /dev/hda. 

       But this is no absolute need, you may use other drives as well.
       More about this a little later.

(B)    Your hard-disk is organized in several directories. 
       If you are not familiar with this, you should read in your
       operating-system's manual about how the hard-disk is organized.

       LinFBB will normally be installed on your hard-disk in a directory named FBB.
       This directory should be placed directly under root  (/usr/local/fbb).
       This directory automatically will be created for you.

       The BBS will also need a lot of other directories, and they can be created 
       directly from root, or they can be created under the FBB-directory. 
       In the procedure I will describe here, are several FBB-directory will be at the root

       (bin files =/usr/local/fbb, data files =/var/ax25/fbb, config files =/etc/ax25/fbb)
       and (fbbdos and /yapp users directories =/home/fbbdos) of the hard-disk, while all 
       the other directories will be placed under FBB (like  /home/fbbdos etc). 
 
       But you can choose this yourself. More about this a little later.
       However, this is the recommended organization for your  directories.
       The directories will be created like this if you make no changes (a list of the
       files and directories is given in APPENDIX 1).

(C)    Put the first of the diskettes or packages that you downloaded in your hard disk.
       and decompress the packages on a empty subdir like /usr/src/fbbsrc
       and verify the Makefile for the right path libraries then make the command make.

       You should now be ready to start the installation procedure.
       To install and run LinFBB you MUST have root access,
       you may log in as root or you can go to superuser mode with: su root


              Procedure to compile and install LinFBB
              ---------------------------------------

(1) - Put the floppy disk into the diskdrive.

(2) - If you have MTOOLS installed.
      To copy from floppy disk A:, type: mcopy a:/xd701.tgz /tmp

      If you have NOT MTOOLS installed.
      To mount floppy drive A: type: mount -t msdos /dev/fd0 /mnt

      Then type: cp /mnt/xd701.tgz /tmp , to copy the contents of disk to /tmp,
      then type: umount /mnt , to unmount the floppy disk.
	
      On the new release of linux like 2.2.x kernel you can mount the floppy
      like this: mount /dev/fd0 /mnt/floppy
      and unmount this make this: umount /mnt/floppy

(3) - Now you should create the base directory where you want to compile the LinFBB.
      Example, if you want LinFBB compile in: /usr/src/fbbsrc
      Then type: mkdir /usr/src/fbbsrc

(4) - If you now are ready to install LinFBB for the first time on your PC,

      Type: cd /usr/src/fbbsrc , to go to the LinFBB root directory.
      Type: tar xvzf /tmp/xd701_src.tgz , to unpack the LinFBB archive.

      Verify the Makefiles from /usr/src/fbbssrc/src and /usr/src/fbbssrc/src/X11
      for the right path libraries then make the command make.
      Now start the compilation of the source code
      after that you have been compiled from the source code the Linfbb.
      You should now be ready to start the installation procedure.
 
(5) - If you now are ready to install FBB for the first time on your PC.
      Next, the installation-procedure continues by starting the program
      INSTALL.SH or the new one install_fbb.
 
      You can type ./install_fbb, from the /usr/src/fbbsrc diretory.
      Next thing when finished the install go to /etc/ax25/fbb.


(6) - Now you will see the standard [root@hostname /etc/ax25/fbb]#  prompt again.
      Now you must use a normal text-editor and edit the files.  I presume that
      you have such an editor... Make sure that it is able to save the file again
      in ASCII (DOS) format ! So if you use for example MC, you MUST
      remember to save the file again in TXT-format !

      OK. That is about all. Now the BBS-program and all its files will be
      installed on your hard-disk.

(7) - This program lets you set all the parametres in fbb.conf and port.sys 
      that you need for your installation. 

      (INSTALL.SH supports multiple language files, but for the first time 
      installation you will probably have only the English language files.)  
      Please take great care here, and go through ALL the docs of this
      installation very carefully before you exit the program.  Be sure to put in 
      your correct callsign, your correct H-route etc.  INSTALL.SH will update 
      FBB.CONF and PORT.SYS for you, you will not need to change it manually later,
      if you take great care to do a good job now.


There are two versions of LinFBB:
--------------------------------

A) - a windowing version
     (using X11 windowing system and MOTIF toolkit).

B) - a daemon version.
     The daemon version has no interface and works alone in background. 
     So the compter may be used for any application while the BBS is running.


(8) - If you need some help in setting up AF_AX25 and AF_NETROM for use with
      LinFBB, you may want to read the APPENDIX 2 below.

      OK. That is about all.
      Now the BBS-program and all its files will be installed on your hard-disk. 
      Next, the installation-procedure continues by starting the installation
      script named INSTALL.SH or the new one install_fbb.

      This script lets you set most of the parametres in FBB.CONF (BUT NOT ALL !)
      that you need for your installation.  Please take great care here, and go 
      through ALL the questions of this installation very carefully before you 
      exit the script. Be sure to put in your correct callsign, your correct 
      H-route etc. The script INSTALL.SH will update INIT.SRV for you, but you 
      will also need to check the rest of it manually, too, afterwards !



                 FIRST-TIME SETUP OF DIFFERENT FILES.
                 ===================================

(9) - So far so good... Now we must modify some files, to make the system work. I
      will describe all the changes you MUST do, and some changes that you CAN do,
      if you like. Read this section very carefully. For most of the files it is
      VERY important that the number of non-comment lines must NOT be changed.
      Later in the sysop-manual you will find more details on some of these files,
      and also details on other files that are not described here in this startup-section.


Files you MUST check/change:
----------------------------
      XFBB.SH now is [fbb]   (it is on /usr/sbin)
      INSTALL.SH now is [install_fbb] (it is on /usr/src/fbbsrc)
      INIT.SRV now is [fbb.conf]   (it is on /etc/ax25)


Other Files you MUST check/change:
----------------------------------

/etc/ax25/fbb
-------------
PORT.SYS
INITTNCx.SYS
MAINTx.SYS

Files you must change if you plan to do any forward:
---------------------------------------------------
BBS.SYS
FORWARD.SYS

Files you should check, too, but not SO important:
--------------------------------------------------
BEACONx.SYS
EPURMESS.INI
SWAPP.SYS

Files you may have a look at later (not so important).
-----------------------------------------------------
CRON.SYS
REJECT.SYS
PASSWD.SYS
PROTECT.SYS
LANGUE.SYS
THEMES.SYS
REDIST.SYS
MEMO.SYS

		    Script files for run the xfbb
		    -----------------------------
/usr/sbin
---------
bbs		run the xfbbC terminal client from console.
monitor		Monitor for see some forward partner on users connected on console.
fbbX		Script for run under the X-Windows this call the GUI client
fbb		Symbolic link for run the xfbb on daemon way.

NOTE: by Jose Ramon HI8GN

		If you are installing the xfbb RPM package ignore the 
		"Start the bbs for first time" below.

		You just run on console for the daemon version this command
		fbb start, then under the X-windows run the xfbb Client GUI
		looking for the button xfbb Client GUI

		or if you want to start the xfbb X11 version, then
		go to under X-Windows and start this like this:
		fbb xwin, or the button called xfbb X11 on the start button.


                  Start the BBS for the first time.
                  ---------------------------------
 
      Now you should be ready to start the BBS for the first time. Before you do,
      make sure that the internal clock of the BBS is correct. If not, you must
      correct it now with the DOS-command DATE and TIME. In most newer PCs today,
      the clock is automatically set at each power-up. But in some older PCs you
      may need to use a special clock/calendar card in your PC, and use a special
      program to set the date/time at each startup. For this you must look in the
      manual for that clock/calendar card and include the appropriate command in

a) To start LinFBB in X-Windows:
   Go to base directory and run "./xfbb.sh" in a xterm.
   
   On my RPM pkg after you have been installed the xfbb-7.03.i386.rpm (RedHat)
   you can to start the xfbb X11 under the X-Windows like this: fbb xwin
   or looking for the Icon on the desktop for the FBB X11.
   
b) To start LinFBB deamon:
   Go to base directory and run "./xfbb.sh -d &".

   On my RPM pkg after you have been installed the xfbb-7.03.i386.rpm (RedHat)
   you can to start the xfbb on daemon like this: fbb start

   under X-Windows looking for the Icon of the GUI xfbb_client.

      The first time you start the BBS like this, it may ask you if you want to
      create some files. Just answer Y (for Yes) every time. Then those files are
      automatically created for you.

      The BBS should now be ready for use. Try a connect to the BBS. Do this by
      pressing F2. The BBS will ask you for your name, city, home-BBS and ZIP-code.

Deamon version of LinFBB:
------------------------
      Go to 'bin' directory, then use the utility 'xfbbC' to connect (eg: xfbbC -c).
      If you have set up PORT.SYS to allow incoming Telnet connections to LinFBB,
      then you can also use this..

      For example, if you defined LinFBB to listen on port 6300 (hex = 189C) 
      for incoming Telnet connections, then you type: telnet sm6tky.ampr.org 6300


      Next you must define all the BBSs you want to forward to. You do this with
      the command EU. If you want to have forward to for example LA2D, you type EU LA2D.

      The BBS will say that this callsign is not known, and ask if you want to create it.
      You answer Y. Next you will see a line of different options for that user.
      You only have to type B. Now that callsign (LA2D) will be defined as a BBS.
      You must press ENTER once more to stop editing the user. Repeat
      this procedure with the callsign of all the BBSs that you will forward to.
      You terminate the keyboard-session with the command B (Bye).

      Well, if all is ok, and you have not encountered any big problems so far,
      you can stop the BBS.  
      In LinFBB you do this: Deamon version:
      Do 'ps ax' , check for 'xfbbd' look after
      the process number and do 'kill <process number>'

      You can connect the TNCs, and in INIT.SRV you must change from No to Ok in
      the line that asks 'Mode test ?', or in LinFBB  : Use INSTALL.SH
      to change the field "TEST MODE" to "NO".


                    Installation-help for Linux. 
                    ===========================

The contents of this file is: 

a0) - Why use FBB with Linux ?
a1) - Info on AF_AX25, AF_NETROM and AF_ROSE.
a2) - Install AF_AX25, AF_NETROM and AF_ROSE.
a3) - Config AF_AX25, AF_NETROM and AF_ROSE for KISS TNC and SCC card.
a4) - Config AF_AX25, AF_INET sockets with a DUAL-KISS TNC.
a5) - Telnet installation.


a0) - Why use FBB with Linux ?
      ----------------------

      LINUX is a true multitasking system where many applications may run 
      concurently. When Linux (and other UNIX systems) has finished booting
      it is possible to run one ore more applications running concurently (NODE,
      BBS, CLUSTER, TCPIP, etc...) on the same CPU and above all very fast and secure.

      Another good thing for linux is that the AX25 is included in the kernel, 
      and then you need no TNC, no BPQ or other. You only need hardware. (think
      of a DOS including Netrom, Rose, AX25, TCPIP and other software....)


a1) - Info on AF_AX25, AF_NETROM ans AF_ROSE.
      --------------------------------------

      Standard kernel AF_AX25, AF_NETROM and AF_ROSE sockets
      AX.25, NET/ROM and ROSE protocol are built into the Linux kernel.

      I recommend to use these interfaces, because it will give you
      more flexibility to build a system with many futures..

      This choice may be little difficult to set up,
      because the functions is depended of lots of things.. eg:

     - Linux kernel version
     - ax25-utils version
     - z8530drv version
     - net-tools version
     - and more.

     If you desire to use this/these interfaces,
     i strongly recommend to read at least AX25-HOWTO!

     The AX25-HOWTO located at:
     http://sunsite.unc.edu/mdw/HOWTO/AX25-HOWTO.html

     More HOWTO's located at:
     http://sunsite.unc.edu/mdw/HOWTO/HOWTO-INDEX-3.html

     The Linux Documentation Project Homepage is located at
     http://sunsite.unc.edu/mdw/linux.html


a2) - Install AF_AX25, AF_NETROM and AF_ROSE.
      --------------------------------------

       How to set up Linux kernel AF_AX25, AF_NETROM, AF_ROSE socket.

      These examples are for Linux kernel 2.0.36.
      First, get these files (or newer files).
      Linux kernel 2.0.38 or 2.2.16
      available @ ftp://ftp.funet.fi/pub/Linux/PEOPLE/Linus/

      ax25-utils-2.1.42a.tar.gz or the new ax25tools
      ax25-libax25-0.0.7.tar.gz
      ax25-appls-0.0.5.tar.gz
      ax25-tools-0.0.6.tar.gz

      available @ http://www.cs.nott.ac.uk/~jsn/

      Unpack kernel 2.0.36 in '/usr/src' with 'tar zxvf linux-2.0.36.tar.gz'
      this will unpack kernel 2.0.36 to a directory called 'linux' ,
      beware if you already have a directory named 'linux' in '/usr/src'.

Tip:
     I rename my kernel source directory to kernel version with 'mv linux linux-2.0.36'
     then i do a symbolic link to this directory with 'ln -s linux-2.0.36 linux'

     Before i install a new kernel, i remove the symbolic link (eg: rm linux),
     this allows me to have more kernel sources installed at same time.. :-

     Okay, now it's time to compile the 'ax25-utils-2.1.42a.tar.gz' ,
     unpack this file in '/usr/src' with 'tar zxvf ax25-utils-2.1.42a.tar.gz'.

     Read the 'INSTALL' file how to compile, and install this package.
     Okay, do 'cd linux' now, read the file README now, to know how to set up the kernel!

     Okay, now it's time to run 'make config' , be sure that you enable
     - Amateur Radio AX.25 Level 2 (CONFIG_AX25)
     - Amateur Radio NET/ROM (CONFIG_NETROM)

     If you want to use ROSE, enable this..
     - Amateur Radio X.25 PLP (Rose) (CONFIG_ROSE) 

     You can make these as loadable modules, or to be compiled into the kernel.
     After you finished with 'make config' , then type 'make dep; make clean; make zImage'
     to compile the new kernel with AX.25 and NET/ROM support (and ROSE if defined).

     After compilation, install the new kernel, as in the /usr/src/linux/README file.
     Okay, you should have rebooted and started up the new kernel now..

     If all steps has gone without problem, you are now ready to set up your Linux system
     to work with kernel AX.25, NET/ROM (and ROSE if defined), CONGRATULATIONS!

     Now you should go to '/usr/src/ax25-utils-2.1.42a' and read the README file,
     to find out what files you should need to change for suite you.

     All configuration files are in '/etc/ax25'.

Tip:
 Read the AX25-HOWTO @ http://sunsite.unc.edu/mdw/HOWTO/AX25-HOWTO.html


a3) - Config AF_AX25, AF_NETROM and AF_ROSE for KISS TNC and SCC card.
      ---------------------------------------------------------------


   Contents of the directories.
   ===========================

(APPENDIX 1) 


 You will now see at your screen something like this:


       ****   FIRST TIME INSTALLATION OF LINFBB 7.03   ****


These files and directories are mandatory. Other files may reside but will be
created by the system or by the sysop.


Directories of the FBB:

-  Main BBS-directory    -  /usr/local/fbb
-  Exec Bin files        -  /usr/local/fbb
-  Bin files for PG cmd. -  /usr/local/pg
-  Script files for xfbb -  /usr/sbin
-  Xpm bitmap files      -  /usr/local/fbb/res/bitmaps
-  Messages              -  /var/ax25/fbb/mail
-  Binary-messages       -  /var/ax25/fbb/binmail
-  User's dir.           -  /home/fbbdos/users
-  Yapp files            -  /home/fbbdos/users/yapp
-  Oldmail               -  /var/ax25/fbb/oldmail
-  Statistics and Datas  -  /var/ax25/fbb
-  Documentation         -  /var/ax25/fbb/docs
-  Log files             -  /var/ax25/fbb/log
-  Satellite files       -  /var/ax25/fbb/sat
-  White Page files      -  /var/ax25/fbb/wp
-  FBB-manuals           -  /usr/doc/xfbbd-7.03
-  Fwd-include-files     -  /etc/ax25/fbb/fwd
-  Language & info files -  /etc/ax25/fbb/lang
-  Config-files          -  /etc/ax25/fbb
-  The fbb.conf file     -  /etc/ax25

 This screen may vary a bit from version to version,
 but the work that you have to do, it will still be the same.
 
 The same applies if you want to use other directory-names or paths 
 for some of the other directories that are listed on your screen now.

 If you DO want to change any of these things, you MUST do it now. The
changes are described in this paragraph; if you do NOT want any changes, you
can go on to the next paragraph. You stop the installation-batch by pressing
CTRL-C.


Directory BIN :

/usr/local/fbb
--------------
XFBB.SH    - Batch file running the software.
CLR_USER   - Resets a users quota for downloaded files
EPURMESS   - Message processing.
EPURWP     - White Pages processing.
FBB        - Program for starting servers.  For LinFBB only.
XFBBD      - Program for starting Daemon servers.  For LinFBB.
INSTALL.SH - Program for installing the BBS-software.  For LinFBB only.
MAINTINF   - maintenance program.
REQDIR     - REQDIR server.
XFBBX      - Batch file running the software.  For LinFBB.
SATUPDAT   - Automatic update of satellite database.



Program UTILS for LinFBB:

Directory for special utillity-programs that may be used with this BBS:

/usr/local/fbb
--------------
ICOM      Program for controlling ICOM-radios.
M_FILTER  Message-filtering example-program.
FBB_VIEW  Viewer of file extensions .ZIP .ARJ .RAR .LHA
FBB_ZM    I guess is for Pro-YAM/ZCOMM
7PFBB     This is a Config file for the 7plus
AUTORESP  for automatic Reply Text
FBB.XPM   Bitmap for X-Display Icon 


Directory BINMAIL :

/var/ax25/fbb/binmail
---------------------
[MAIL0]  [MAIL1]  [MAIL2]  [MAIL3]   [MAIL4]
[MAIL5]  [MAIL6]  [MAIL7]  [MAIL8]   [MAIL9]


Directory DOC :

CHANGES  - Shows all changes in the software during development.  
README   - Some sugestions about the install etc.
SATUPDAT - Documentation for the satupdat program
FBB.CONF - fbb.conf examples.
XFBB.DOC - This same FBB Help-file. For LinFBB.


Directory DOCS:

/var/ax25/fbb/docs
---------------------
[DOCS]

 This is the section for easy-to-use documentations.
 Numerical commands for reading the docs.


Directory MAIL:

/var/ax25/fbb/mail
---------------------
[MAIL0]  [MAIL1]  [MAIL2]  [MAIL3]   [MAIL4]
[MAIL5]  [MAIL6]  [MAIL7]  [MAIL8]   [MAIL9]


Directory OLDMAIL :

/var/ax25/fbb/oldmail
---------------------
[OLDMAIL]


Directory PG:

/usr/local/pg
-------------
[PG]      Directory for special-made programs that the user can run.
          The filename is the command-name.
7PLSERV   Script file for the 7plus program file.


Directories for data and statistical files from the LinFBB.

Directories of DATA and STATS :

/var/ax25/fbb
-------------
DIRMES.SYS
ETAT.SYS
HEARD.BIN
INF.SYS
OPTIONS.SYS
STATIS.DAT
TPSTAT.SYS
WFBID.SYS
YAPPLBL.DAT


/var/ax25/fbb/log
-----------------
[LOG]         Directory for FBBLOG.nn files.
FBBLOG.xx     This is the history file of weekly activities in the fbb :xx is number of weeks.


/var/ax25/fbb/sat
-----------------
[SAT]         Directory for satellite files.
SATUPDAT      This is a Program for automatic update of satellites orbital parameters.
AMSAT.TXT     This file is the two lines of Orbital parameters, created by fbb.
SATEL.DAT     This file is the data orbital parameters for prediction of sat orbit.

/var/ax25/fbb/wp
-----------------
[WP]          Directory for White pages database
WP.SYS        This file has the data for the white page database.


Directory of CONFIGURATIONS:

/etc/ax25/fbb/fwd
-----------------
[FWD]         Directory for FORWARD.SYS include-files.
AMSAT.FWD     this it is a file include that gathers messages
              keplerians from the forward.sys for the satupdat program.

/etc/ax25/fbb/lang
------------------
[LANG]       - Directory for .TXT .HLP .ENT language files.
ESPAGNOL TXT - This file is for the Spanish language answer on connecting station
ESPAGNOL HLP - This file is for the same purpose of giving help info in the Spanish lenguage.
ESPAGNOL ENT - And this is a banner file for someone connect to on Telnet or via modem.

/etc/ax25/fbb
-------------
BEACONn  SYS - Beacon file.
BBS      SYS - BBS callsigns
CRON     SYS - Hour work.
INITTNCn SYS - Initialization of TNC.
FORWARD  SYS - Forwarding description.
LANGUE   SYS - Language description
MAINTn   SYS - Housekeeping text.
MEMO     SYS - CtrlF0 to CtrlF9 aliases
PASSWD   SYS - Password file.
PORT     SYS - Port description.
PROTECT  SYS - Directories protection.
REDIST   SYS - Configuration-file for the REDIST-server.
REJECT   SYS - Messages reject.
SWAPP    SYS - This file is used for automatically re-route messages.
THEMES   SYS - Configuration-file for the thematic-zone.



Directory FBBDOS USERS :

/home/fbbdos
------------
[FBBDOS]  Directory for the users to upload their own files.


Director USERS YAPP :

/home/fbbdos/yapp
-----------------
[YAPP]    Directory for users upload with YAPP-protocol and YU/YD commands.



APPENDIX 2.

      Same example for LinFBB and (DRSI-Card):
      -------------------------------------------

A file with 1 DRSI-card and 8 channels, max 1 channel on HF.

This example needs z8530drv by DL1BKE properly installed!

# FBB7.00
#
#Ports TNCs
1      2
#
#Com Interface Address (device)   Baud
8    9          ****              9600
#
#TNC NbCh Com MultCh Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode  Freq
 1    8    8   scc0  230   4     1     10     00/60   XUY  433.650
 2    1    8   scc1  80    2     1     10     30/60   XGW  HF
#
#TNC Nbs Callsign-SSID Mode
#1    1   LA1B-1        B
#
# End of file.
----

# /etc/rc.d/rc.ax25
#
# This file is called from /etc/rc.d/rc.local
#
# attach a TNC2 with KISS
#
# (/dev/cua0 = COM1, /dev/cua1 = COM2, /dev/cua2 = COM3, /dev/cua3 = COM4)
#
/usr/sbin/kissattach -i 44.140.208.129 /dev/cua0 ax0
#
# set up default IP routings
# This is not needed if you don't want to run TCP/IP on Radio
#
/sbin/ifconfig ax0 44.140.208.129 netmask 255.255.255.0 broadcast 44.140.208.255 arp mtu 256
/sbin/route add -host sk6ba.ampr.org ax0
/sbin/route add -net 44.140.208.0 gw sk6ba.ampr.org netmask 255.255.255.0 ax0
/sbin/route add default gw sk6ba.ampr.org ax0
#
# Send ID every 10 min
#
/usr/sbin/beacon -t 10 ax0 "This Packet Radio Node is Powered with Linux Unix" &
#
# If you want to run LinFBB in X-Windows,
# comment out this below...
#
# Start up LinFBB deamon
#
/home/xfbb/xfbb.sh -d &
#

-------------------------------------

Here is one example with one KISS TNC2 on COM2, NET/ROM interface, 16 channels.

# /etc/ax25/axports
#
# The format of this file is:
#
#name	callsign	speed	paclen	window	description
#
ax0	SM6TKY-3	9600	256	7	Tx: 437.975 Rx: 434.000 MHz 9600bps

----

# /etc/ax25/nrports
#
nr0 SM6TKY-13 #IP 236 Radio 9600bps
nr1 SM6TKY-0 XFBB 236 NET/ROM<->XFBB

----

# /etc/ax25/nrbroadcast
ax0	1	192	10	1

----

Same example for LinFBB (Linux):

# FBB7.00
#
#Ports TNCs
4      4
#
#Com Interface Address (device)   Baud
1    9         /dev/cua0          9600
2    9         /dev/cua1          9600
3    9         /dev/cua2          9600
4    9         /dev/cua3          9600
#
#TNC NbCh Com MultCh Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode  Freq
1    4    1   1      230  4     0     1      00/60   GD   433.650
2    4    2   1      230  4     1     5      10/30   UDY  144.675
3    4    3   1      230  3     4     10     20/60   UDYW 433.650
4    1    4   1      80   1     1     5      15/30   BP   15/20m
#
#TNC Nbs Callsign-SSID Mode
#1    1   LA1B-1        B
#
# End of file.
#

--------------------

# FBB7.00
#
# /usr/local/fbb/port.sys
#
# Comments is deleted to save space
#
#Ports TNCs
 1     2
#
#
#Com Interface Adress (device) Baud
 1   9         ****            9600
#
# Same number of lines as TNCs:
#
#TNC NbCh Com MultCh Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode  Freq
 1   8    1   ax0    250   7     2     10     30/01   XUWYL  ax0
 2   8    1   nr1    236   7     2     10     30/01   XUY    netrom
#
# Special callsigns and modes for some channels.
#
#TNC Nbs Callsign-SSID Mode
#1    2   SK6BA-0       B
#
# End of file.
#

----

# /etc/rc.d/rc.ax25
#
# This file is called from /etc/rc.d/rc.local
#
# attach a TNC2 with KISS
#
# (/dev/cua0 = COM1, /dev/cua1 = COM2, /dev/cua2 = COM3, /dev/cua3 = COM4)
#
/usr/sbin/kissattach -i 44.140.208.129 /dev/cua1 ax0
#
# attach NET/ROM interface
/usr/sbin/nrattach -i 44.140.208.129 nr0
#
# This is for LinFBB NET/ROM
/usr/sbin/nrattach -i 44.140.208.129 nr1
#
# set up default IP routings
# This is not needed if you don't want to run TCP/IP on Radio
#
/sbin/ifconfig ax0 44.140.208.129 netmask 255.255.255.0 broadcast 44.140.208.255 arp mtu 256
/sbin/route add -host sk6ba.ampr.org ax0
/sbin/route add -net 44.140.208.0 gw sk6ba.ampr.org netmask 255.255.255.0 ax0
/sbin/route add default gw sk6ba.ampr.org ax0
#
# Start up NET/ROM deamon
/usr/sbin/netromd
/usr/sbin/nrparms -parms -qual 192
#
# Send ID every 10 min
/usr/sbin/beacon -t 10 ax0 "This Packet Radio Node is Powered with Linux Unix" &
#
# If you want to run LinFBB in X-Windows,
# comment out this below...
#
# Start up LinFBB deamon
/home/xfbb/xfbb.sh -d &
#

-------------------------------------

Here is a example with 2 ports SCC (PA0HZP compatible) card installed, 16 channels,
and SCC driver is a loadable module.

# /etc/z8530drv.conf
#
# Lines must not be longer than 255 bytes!
#
#
# Hardware section
#
# SCC chip 1
#
chip	1
data_a  0x153			# data port A
ctrl_a  0x152			# control port A
data_b  0x151			# data port B
ctrl_b  0x150			# control port B
irq     5			# IRQ No. 5 (#)
pclock  4915200			# clock (+)
# board	PA0HZP
# escc yes
# escc    no			# enhanced SCC chip? (8580/85180/85280) (*)
# vector  0			# latch for interrupt vector ($)
# special no			# address of special function register (*)
# option  0			# option to set via sfr (*)
#
# (*) option, default value is 0
# (+) option, default is 4915200
#
# SCC chip 2
#
# chip	2
# data_a  0x157
# ctrl_a  0x156
# data_b  0x155
# ctrl_b  0x154
# irq     5			# IRQ No. 5 (#)
# pclock  4915200			# clock (+)
# board	PA0HZP
# escc	no
# vector	0
# special	no
# option	0
#
# (#) all chips can share one interrupt, or you may use multiple INTs,
#     but there must be at least one IRQ defined in this system.
# ($) only one Vector Latch for all Chips is allowed.
#
#
# Software section
#
# The order of entries IS important!
#
# 	first     : DEVICE
# 	then      : MODEM section
# 	after that: Level 1 parameters
#
# Definition of /dev/scc0
#
device	/dev/scc0
speed	9600
clock	divider
mode	nrzi
# rxbuffers 8
# txbuffers 16
# bufsize 1152
#
txdelay 30
persist 250
slot	8
tail	8
fulldup	0
wait    12
min	3
maxkey	7
idle	3
maxdef  120
group   0
txoff   off
softdcd off			# use software dcd
#
# Definition of /dev/scc1
#
device	/dev/scc1
speed	1200
clock	divider
mode	nrzi
# rxbuffers 8
# txbuffers 16
# bufsize 1152
#
txdelay 30
persist 250
slot	8
tail	8
fulldup	0
wait    12
min	3
maxkey	7
idle	3
maxdef  120
group   0
txoff   off
softdcd off

----

# /etc/ax25/axports
#
# The format of this file is:
#
#name	callsign	speed	paclen	window	description
#
scc0	SM6TKY-3	9600	256	7	Tx: 437.975 Rx: 434.000 MHz 9600bps
scc1	SM6TKY-1	1200	256	7	MARKnet Lan 144.800 MHz 1200bps

----

# /usr/local/fbb/port.sys
#
# Comments is deleted to save space
#
#Ports TNCs
 1     2
#
#
#Com Interface Adress (device) Baud
 1   9         ****            9600
#
# Same number of lines as TNCs:
#
#TNC NbCh Com MultCh  Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode   Freq
 1   8    1   scc0    250   7     2     10     30/01   XUWYL  scc0
 2   8    1   scc1    250   7     2     10     30/01   XUWYL  scc1
#
# Special callsigns and modes for some channels.
#
#TNC Nbs Callsign-SSID Mode
#1    2   SK6BA-0       B
#
# End of file.
#

-----

# /etc/rc.d/rc.ax25
#
# This file is called from /etc/rc.d/rc.local
#
# Load the SCC module and init
/sbin/insmod scc
/sbin/sccinit
#
# attach the SCC card
#
/sbin/ifconfig scc0 44.140.208.129 hw ax25 sm6tky-3 up
/sbin/ifconfig scc1 44.140.208.129 hw ax25 sm6tky-1 up
#
# set up default IP routings
# This is not needed if you don't want to run TCP/IP on Radio
#
/sbin/ifconfig scc0 44.140.208.129 netmask 255.255.0.0 broadcast 44.140.255.255 arp mtu 256
/sbin/ifconfig scc1 44.140.208.129 netmask 255.255.255.0 broadcast 44.140.208.255 arp mtu 256
/sbin/route add -host sk6ba.ampr.org scc1
/sbin/route add -net 44.140.208.0 gw sk6ba.ampr.org netmask 255.255.255.0 scc1
/sbin/route add default gw sk6ba.ampr.org scc1
#
#
# Send ID every 10 min
/usr/sbin/beacon -t 10 scc0 "This Packet Radio Node is Powered with Linux Unix" &
/usr/sbin/beacon -t 10 scc1 "This Packet Radio Node is Powered with Linux Unix" &
#
# If you want to run LinFBB in X-Windows,
# comment out this below...
#
# Start up LinFBB deamon
/home/xfbb/xfbb.sh -d &


New Tree directories:
---------------------
Now Jean-Paul made a new tree of directories for the 7.03 serie and UP
like this:

Special files :
- configuration : /etc/ax25/fbb.conf
- mail import   : /var/ax25/fbb/mail/mail.in

binaries :
----------
/usr/sbin
	|\_Just my scripts bbs, fbbX and monitor on the RPM pkg.
	
binaries on my rpm pkg:
-----------------------
/usr/local/fbb
             |\_all binary files. <- added by (hi8gn) on the RPM pkg.
configuration tree :
--------------------
/etc/ax25/fbb
            |\_ lang
	    |\_ fwd      <- added by (hi8gn) on the RPM pkg.
utilities tree :
----------------
/usr/lib/fbb
           |\_ filter	<- m_filter, c_filter here  
           |
           |\_ pg	<- 7plsrv here
           |
           |\_ script
           |
           |\_ server	<- reqdir here
           |
            \_ tool	<- 7plus here
data tree :
-----------
/var/ax25/fbb
           |\_ 7pl	<- added by (hi8gn) on the RPM pkg.
	   |    \_7pfbb	<- added by (hi8gn) on the RPM pkg.
           |
           |\_ binmail
           |      \_ mail[0-9]
           |\_ docs
           |
           |\_ Icons
	   |     \_bitmaps for X11 Version <- added by (hi8gn) on the RPM pkg.
           |      
           |\_ log
           |
           |\_ mail
           |      \_ mail[0-9]
	   |
           |\_ oldmail     <- added by me (hi8gn) on the RPM pkg.
           |
           |\_ res     <- added by me (hi8gn) on the RPM pkg.
           |
           |\_ sat
           |
           |\_ wp
           |
           `\_ fbbdos
	        |\_ redist	<- added by (hi8gn) on the RPM pkg.
                |
		`\_ yapp
	              \_7pfbb    <- added by (hi8gn) on the RPM pkg.


New structure of the Directories of the XFBB version 7.03 series.

-  Main BBS-directory    -  /usr/local/fbb
-  Exec Bin files        -  /usr/local/fbb
-  Bin files for PG cmd. -  /usr/lib/fbb/pg
-  Filter files.	 -  /usr/lib/fbb/filter
-  Server files.	 -  /usr/lib/fbb/server
-  Script files.	 -  /usr/lib/fbb/script
-  Tools files.	 	 -  /usr/lib/fbb/tool
-  Script files for xfbb -  /usr/sbin
-  Xpm bitmap files      -  /var/ax25/fbb/Icons/bitmaps
-  Messages              -  /var/ax25/fbb/mail
-  Binary-messages       -  /var/ax25/fbb/binmail
-  User's dir.           -  /var/ax25/fbb/fbbdos
-  Yapp files            -  /var/ax25/fbb/fbbdos/yapp
-  Oldmail               -  /var/ax25/fbb/oldmail
-  Statistics and Datas  -  /var/ax25/fbb
-  Documentation         -  /var/ax25/fbb/docs
-  Log files             -  /var/ax25/fbb/log
-  Satellite files       -  /var/ax25/fbb/sat
-  White Page files      -  /var/ax25/fbb/wp
-  FBB-manuals           -  /usr/doc/xfbb-7.03
-  Fwd-include-files     -  /etc/ax25/fbb/fwd
-  Language & info files -  /etc/ax25/fbb/lang
-  Config-files          -  /etc/ax25/fbb
-  The fbb.conf file     -  /etc/ax25

Directory BIN :
/usr/local/fbb
--------------
xfbb.sh    - Batch file running the software.
clr_user   - Resets a users quota for downloaded files
epurmess   - Message processing.
epurwp     - White Pages processing.
fbb        - Program for starting servers.  For LinFBB only.
xfbbd      - Program for starting Daemon servers.  For LinFBB.
maintinf   - maintenance program.
xfbbX      - Batch file running the software.  For LinFBB.

Directory tool :
/usr/lib/fbb/tool
-----------------
7plus     - 7PLUS encoder/decoder 7pl files.
autoresp  - for automatic Reply Text
icom      - Program for controlling ICOM-radios.

Directory filter :
/usr/lib/fbb/filter
-----------------
m_filter  - Message_filter program.
c_filter  - Connect_filter program.

Directory PG :
/usr/lib/fbb/pg
---------------
7plserv  - Script file for the 7plus program file.

Directory script :
/usr/lib/fbb/script
-----------------
7pfbb    - This is a 7plus auto-extracter for the 7plus files.

Directory server :
/usr/lib/fbb/server
-------------------
reqdir     - REQDIR server.

Directory sat :
/var/ax25/fbb/sat
-----------------
satupdat   - Automatic update of satellite database.

Directory Icons :
/var/ax25/fbb/Icons
-------------------
<bitmaps>  - Diretory of all .xpm icon files for the XFBB X11.
xfbb	   - Script file for read the bitmaps files.

I like to separate every files of the fbb from other binary files
on the linux directories, it makes too easy to localize any program
of the fbb by possible problem con the fbb i can to detect this
quickly without have to search the file on a lote.


a4) - Config AF_AX25, AF_INET sockets with a DUAL-KISS TNC.
      ------------------------------------------------------

    How to setup LinFBB to use kernel AF_AX25 and AF_INET sockets.

    Here is a example with LinFBB and one DUAL-KISS TNC at COM1, 10 channels.
    more a telnet port at COM4, 5 channels.

# /etc/ax25/axports
#
# The format of this file is:
#
#name	callsign	speed	paclen	window	description
#
1	HI8GN-2		9600	256	4	145.01 MHz 1200 bps
2	HI8GN-3		9600	 80	2	14.095 MHz  300 bps

----

# /etc/ax25/fbb/port.sys
#
# Comments is deleted to save space
#
#Ports TNCs
 2     3
#
#
#Com Interface Adress (device) Baud
 1   9          --             9600
 4   9         189c            0
# telnet port numbers: 17 = 23, 189c = 6300
#
# Same number of lines as TNCs:
#
#TNC NbCh Com MultCh Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode  Freq
 0   0    0     0      0   0     0      0     00/10   ----  File-fwd
 1   5    1     1    250   4     2     10     00/30   XUWYL 145.01
 2   5    2     2     80   2     2     10     00/45   XUWYL 14.095
 3   5    4     0    250   7     5     10     00/15   TUWY  TELNET
#
# Special callsigns and modes for some channels.
#
#TNC Nbs Callsign-SSID Mode
#1    2   HI8GN-0       B
#
# End of file.
#


a5) - TELNET interface.
      ----------------
         LinFBB

      The contents of this file is:
      Info about Telnet interface

      * Example of PORT.SYS for LinFBB
      * Example of FORWARD.SYS


                Info about Telnet interface
                ---------------------------

     Telnet is a communication tool like a terminal, but using TCP-IP. That is
     you can use it on a network like the web. You MUST validate your local echo first.

     It's possible to use Telnet with LinFBB
     to be used in User contacts or in Forward contacts.

     The address to use may be 189C (189C hex = 6300 decimal).

     But, it's also possible to define another port address,
     for example if you want Telnet access to LinFBB on port 23,
     (port 23 is standard for Telnet, but 23 is also used by inetd in Linux!)
     then change the 'address' of COM2 to 17 (hex 17 = 23 decimal)

     Also if you is a advanced-user you can to user the same port
     as well as for the telnetd (linux daemon) and the telnet from the
     xfbb on port 23.
     
     If you use the ipfwadm kernel 2.0 or the ipchains kernel 2.2
     you can redirect the port on the telnetd it using the port 6300
     redirect this to 23, and on the xfbb let it without change on port 23.

     And on end to asign a IP to xfbb along, example xfbb has 1.2.3.4
     and your linux kernel has 192.168.0.1, when someone call on telnet
     to 192.168.0.1 port 23 makes on login to telnetd
     but the the user call 1.2.3.4 port 23 connect to xfbb on telnet port.

     NOTE: xfbb the IP could be a ip alias on a ethernet-card
           E.G. eth0=192.168.0.1 and eth0:0=1.2.3.4
	   
Tip:
     You may put the R letter (Read only default access) which gives a read-only
     if the user is unknown or not authorized for Modem/Telnet (M Flag in EU command).


             Example of PORT.SYS for LinFBB
             ------------------------------

      Standard PORT.SYS with 1 TNC (COM1) with WA8DED-hostmode,
      4 channels, 1 channel for outgoing forward,
      and one Telnet interface listening on port 6300,
      8 channels, 1 channel for outgoing forward.


# FBB7.00
# File for programming of channels and TNCs.
#
# Ports : How many ports (COM1, COM2, Etc...)
# TNCs : How many TNCs and modems in use. With multiplexer
# there can be up to 4 TNCs per port.
#
#Ports TNCs
2      2
#
#In LinFBB this interface is available:
# Interface   9 = Linux.  Can work via serial port (D),via AX25 domain
#                 socket (X) or via Telnet port (T).
#
# Address   : Address of port in hexadecimal (Needed for multiplexer).
#             In LinFBB:
#             Address is the device name (/dev/cua0).
#             Be sure you have the rights to access to the device (rw-rw-rw-).
#             When using kernel AF_AX25 socket, address is not used.
#             When using Telnet, address is the Telnet port in Hex (Hex 17 = Telnet port 23)
# Baud      : Ports baud rate. Ignored by BPQ, kernel AF_AX25 socket and Telnet.
#
# Use same number of lines as number of ports.
#
#Com Interface Address (device)   Baud
1    9         /dev/cua0          9600
2    9         189C               0
#
# TNC     : Number on TNC in use.  Use 0 for file-forward !
# NbCh    : Number of channels I want to use in the TNC.
#           Maximum available channels depend on firmware.
# Com     : Number of the COM-port. Com1, Com2 etc.
# MultCh  : Number of channel if port-multiplexer is used, otherwise 1.
#           In DRSI use values from 0 to 7, by KAM use 1/VHF and 2/HF.
#           When using kernel AF_AX25 socket in Linux, MultCh is the
#           interface name (eg: ax0)
# Paclen  : PACLEN on this TNC.
# Maxframe: The maximum nb of frames the TNC will send at a time.
# NbFwd   : Number of channels for OUTGOING forward at same time.
# MxBloc  : Size of forward-block in kb.
# M/P-Fwd : Minute of the hour for start of forward, and period
#           (how many minutes between each forward-start).
# Port mode, one of these:
#           B : BBS-mode.
#           G : "Guest"-mode.
#           U : Normal-mode.
# Type host-mode, one of these:
#           D : WA8DED
#           K : KAM hostmode.  Must use ESSKAM driver.
#           P : PK-232
#           Q : BPQ v 4.x
#           T : Ethernet/TCP-IP
#           X : AX25 domain socket (for Linux)
# Addition: One or more of these letters can be used too:
#           L : Send unproto beacon after each arriving mail.
#           M : Telephone-modem.
#           Y : Yapp allowed on this QRG.
#           W : Gateway allowed TO this QRG.
#           R : Modem port allowed in Read-only mode.
# Freq.   : Text to describe this port (max 9 characters, no space)
#
# Same number of lines as TNCs:
#
#TNC NbCh Com MultCh Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode Freq
0    0    0   0      0     0     0     0      00/01   ----  File-fwd.
1    4    1   1      230   4     1     10     30/60   UDYL  433.650
2    8    2   0      250   2     1     10     00/60   TUWR  Telnet
#
# Special callsigns and modes for some channels.
#
#TNC Nbs Callsign-SSID Mode
#1    1   LA1B-1        B
#
# End of file.
#

- Example of FORWARD.SYS
  ----------------------

It's syntax is common to both LinFBB and WinFBB.

A	SK6BA
	P A
#       C C <callsign> <ip address> <ip port>
	C C SK6BA 44.140.208.134 6300
#       V <login>$W<password>$W
	V SM6TKY$WPASSWORD$W
#
# the rest of fwd block...
#

I hope to enjoy too much this mini-manual

73's Jose (hi8gn)
hi8gn@hi8gn.dynip.com
http://hi8gn.dynip.com/
