PORT.SYS

(..etc/ax25/fbb/port.sys )

  1. Basic setup
  2. Advanced setup

1. Basic Setup

This file is found under the .../fbb directory.
It defines the number and types of Ports and defines TNCs.

Text following the # character are Comments and are ignored by the BBS software.

An example of a Port.sys file for Linux



# FBB7.08
#
#Ports TNCs
 2     4
#
#Port Interface Address     Baud
 1     9	***	    115200
 2     9	17	    0
#
#TNC NbCh Type MultCh Pacln Maxfr NbFwd MxBloc M/P-Fwd Mode  Freq
 0   0    0   0      0     0     0     0      00/01   ----  File-fwd.
 1   8    1   0      250   2     2     10     23/30   UXWY  145.03 MHz
 2   10   1  rose0   250   4     7     10     15/20   UXY   Rose0
 3   8    1  netbbs  250   4     6     10     10/20   UXWY  Netrom
 4   8    2   0      250   6     5     10     05/20   UTY   Telnet
#
# End of file.


 The file begins with the Software version and is preceded by a # character.

The first uncommented line consists of two values.
 The two values represent the number of Ports and the number of TNCs.

Ports

The next uncommented lines define the Ports. The number of definitions should equal the the number of ports.  One line for each type of Port.

 Port     : Port number.

 Interface : All Linux  interfaces are 9.
			serial ports (D)
			Ax.25 sockets (X)
			Telnet port (T)

 Address : for all ax.25 sockets is *** 
			The address for Telnet is 17 (hex) for the default port 22.

 Baud  : This value is not used. 
			The baud rate for LinFBB ports is set in the /etc/ax25/axports file.

TNCs

The last group of lines define the TNCs and their configurations. The number of TNC definitions should equal the the value given in TNCs.
The line beginning with 0 defines a file forwarding process and is not counted as a TNC.

 The number of lines below must equal the number of TNCs.
 One line for each TNC. 

 TNC      : Number on TNC in use.  0 for file-forward 

 NbCh     : Number of channels Alloted to the TNC.

 Type      : Port type number.

 MultCh   : MultCh is 0 for KISS ports or the name of the socket (eg: rose0 netbbs)

 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:
           T : Ethernet/TCP-IP
           X : AX25 socket (for Linux)

 Addition: One or more of these letters can be used to indicate other functions:
           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)

At the end of the file, you can specify one (or more) calls and SSIDs for some channels. You might use this for special calls on forward- channels. If you don't need this, place an # in front of the line.

 # Special calls and modes for some channels.
 #
 #TNC Nbs Callsign-SSID Mode
 1    2   LA1B-1        B
 #
 # End of file.
 #

2. Advanced setup

Example for LinFBB (Linux):
Standard port.sys with 1 TNC in the KISS mode.
4 channels, 1 channel for outgoing forward, 1 channel
reserved for BBSs with call-ssid LA1B-1 :



# FBB7.00
# File for programming of channels and TNCs.
#
#Ports TNCs
 1      1
#Port  Interface  Address 	Baud
 1        9        ***   	 9600
# Use same number of lines as number of ports.
#
# Interface :  9 is the only interface available in LinFBB :
#             Used for AX.25 socket (X) and Telnet port (T).
#
# Address   : Address of port in hexadecimal.
#             When using AX25 socket the 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 AX.25 socket and Telnet.
#
#TNC NbCh Type 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
#
# Same number of lines as TNCs:
# TNC     : Number on TNC (file-forward uses 0 for TNC number)
# NbCh    : Number of channels 
# Type    : Number of the Port. See Port section.
# MultCh  : Number of channel  For an AX.25 socket use 1.
#            Otherwise is the interface name (eg: rose0, netbbs)
# Paclen  : PacLen on this TNC.
# Maxframe: The maximum no. 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;
#           X : AX.25 domain socket
# 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)
#
# Special callsigns and modes for some channels.
#
#TNC Nbs Callsign-SSID Mode
1    1   LA1B-1        B
#
# End of file.
#



The comment-lines are removed from the following examples for clarity.

An example of a file with 4 ports, 13 channels.
   Port 1 has limited access (guest-user),
   port 2 and 3 allows YAPP-transfer.  
   Port 2 and 3 also allows unproto-beacon-lists.


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


    In this example:
Standard kernel AX.25 socket, 7 interfaces, 42 channels,
 1 interface for file forward,
 1 interface to a KISS TNC (ax0),
 2 interfaces to a PA0HZP compatible SCC card (scc0 & scc1),
 1 interface to Pseudo-TTY loopback for LinuxNode (ax2),
 1 interface for EtherBPQ (bpq0),
 1 interface to NET/ROM in kernel (nr1).

# FBB7.00
#
#Ports TNCs
 1     6
#
#
#Com Interface Address (device)   Baud
 1   9         ****            9600
#
#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   8    1   ax0    250   7     2     10     30/01   XUWYL  ax0
 2   8    1   scc0   250   7     2     10     30/01   XUWYL  scc0
 3   8    1   scc1   250   7     2     10     30/01   XUWYL  scc1
 4   8    1   ax2    250   7     2     10     30/01   XUY    Loopback
 5   8    1   bpq0   250   7     2     10     30/01   XUWYL  bpqether
 6   2    1   nr1    250   7     2     10     30/01   XUY    netrom
#
# Special callsigns and modes for some channels.
#
#TNC Nbs Callsign-SSID Mode
1    2   XXXXX-1        B
#
# End of file.
#

Back to Contents