TNT - A UNIX Packet-Radio Terminal Program


Introduction
Version of TNT described
License, copying, warranty
About Packet Radio and TNT
Why this program?
What's needed?
Mailbox program DPBox

1. Screen layout
1.1. Virtual screens
1.2. Types of virtual screens
1.3. Main statusline

2. Commands
2.1. Keyboard-commands
2.1.1. Cursor movement and miscellaneous
2.1.2. Window movement and control
2.1.3. Screen switching
2.1.4. Keyboard macros
2.2. Commands in command mode
2.2.1. TNC-commands
2.2.2. External commands
2.2.2.1. Saving data to files
2.2.2.2. Sending files
2.2.2.3. Shell,Run,Redirect and Sockets
2.2.2.4. Directory
2.2.2.5. Miscellaneous
2.2.2.6. Routing scripts
2.2.2.7. Extended monitor and boxlist
2.2.2.8. Interface commands
2.2.2.9. DPBox-interface commands
2.2.2.10. Password generation commands
2.2.2.11. Remote-command permissions and access levels
2.2.2.12. Broadcast transmission/receiption

3. Detailled description
3.1. Remote commands
3.1.1. Default access levels for remote-commands
3.1.2. Sysop password validation (//SYSOP)
3.1.3. Shell with root-permissions (//ROOTSH)
3.1.4. Socket connection (//SOCKET)
3.1.5. Dangerous //ECHO command
3.1.6. Handling of unknown remote commands
3.1.7. Extended remote commands
3.2. Umlaut conversion
3.2.1. Display
3.2.2. Sending text
3.2.3. File-receive
3.2.4. File-send
3.3. Using UNIX-features
3.3.1. Shell-login
3.3.2. Redirection
3.3.3. Running programs
3.3.4. Socket server
3.3.4.1. AX25-Server
3.3.4.2. Netcmd
3.3.5. Socket connect
3.4. File transfer methods
3.4.1. AutoBIN file transfer
3.4.2. YAPP file transfer
3.4.3. 7Plus file reception
3.5. Special connect text and files with macros, Name-database
3.6. Routing scripts
3.7. Call update
3.8. Logbook
3.9. Keyboard macros
3.10. Boxlist
3.10.1. General description
3.10.2. Using boxlist
3.10.3. Using keyboard macros
3.10.4. Recognized formats
3.11. Extended monitor
3.12. Use of DPBox
3.12.1. General description
3.12.2. Using unix socket interface
3.12.3. Mailbox screen
3.12.4. Using DPBox via Packet Radio
3.12.5. Autobox and monbox feature
3.12.6. Unproto list handling
3.13. Automatic password generation
3.13.1. General description
3.13.2. DIEBOX
3.13.3. FlexNet
3.13.4. TheNet
3.13.5. Baycom
3.13.6. MD2
3.14. Huffman compression
3.15. Handling Flexnet connection quality checks
3.16. Operating different software with same callsign
3.17. PACSAT broadcast operation
3.18. Autostart on connect
3.19. TNT as daemon, TNTC

4. Description of configuration files
4.1. Main configuration file
4.1.1. Serial and general configuration
4.1.2. Security
4.1.3. Directories, Files and Sockets
4.1.3.1. Directories
4.1.3.2. Files
4.1.3.3. Sockets and Boxfiles
4.1.4. Lines of virtual screens
4.1.5. Display configuration
4.1.6. Screen attributes
4.1.6.1. Color attributes
4.1.6.2. Monochrom attributes
4.1.7. Packet assembly timeout
4.1.8. Additional options
4.2. TNC-configuration files
4.3. Cookie file
4.4. Files for remote commands
4.5. Files for connect text
4.6. Files for names database and routing scripts
4.6.1. Names database
4.6.2. Routing database
4.7. User-Id's and security
4.8. Logfile for resynchronisation
4.9. File for keyboard macros
4.10. File for password generation
4.11. File for sysop authentification
4.12. File for remote commands disabling
4.13. File containing not own callsigns
4.14. File containing Flexnet digipeaters
4.15. File for AX25-server access
4.16. File for autostart on connect
4.17. File for extended remote commands
4.18. Files for BBS features
4.19. Configuration file for TNTC

5. Additional Information
5.1. Options at startup
5.2. Running under X11
5.3. Porting of TNT

6. Credits and Contact

A. Appendix
A.1. Static huffman compression table

Back to Index


Introduction


Version of TNT described

This documentation describes TNT V1.0 dated 97/01/26. The last update of the documentation was done at 97/01/26.

Back to Index


License, copying, warranty

TNT is Copyright (c) 1993-1997 by Mark Wahl, DL4YBG

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation;

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details (contained in file 'license').

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

Back to Index


About Packet Radio and TNT

Packet-Radio is a special mode used by Radio Amateurs to transfer text and data. It is packet orientend and uses the AX.25-protocol (a special version of X.25 to fit Ham Radio needs).

There are some single board computers which implement the AX.25-protocol and contain the modem-interface to the radio-transceiver. The terminal or computer with terminalprogram is connected via a RS232-interface. These single board computers are called Terminal Node Controller (TNC).

For most of these TNCs a special software is available (WA8DED-Software or The Firmware by NORD><LINK) which can be switched to a special protocol (hostmode) at the RS232-interface. If hostmode is selected it is not possible to operate the TNC using a simple terminal, a computer with a special terminalprogram is needed.

The advantage of hostmode is that the terminalprogram can implement virtual screens for the different connections, the command mode and monitor mode. All these will be displayed together on a normal terminal which leads to confusion of the operator.

TNT is such a terminalprogram (TNT stands for TNc Terminalprogram).

Back to Index


Why this program?

There are some implementations of the AX.25-protocol available for UNIX (KA9Q, WAMPES, e.t.c.). They all use the TNC as a simple modem (KISS-mode) and have TCP/IP protocol implemented (using AX.25). But the operator frontend is very poor, there are no virtual screens and scroll back buffers. So my intention was to write a program which has a powerful operator frontend and uses the TNC not as a modem but as a Terminal Node Controller.

Back to Index


What's needed?

The program is developed for LINUX and a VT100-compatible terminal. It further needs a TNC with WA8DED-software or The Firmware by NORD><LINK connected to a serial port of the computer. The Firmware by NORD><LINK is available for TNC2, all TNC2-clones and for AEA PK232 and PK88. WA8DED-software is available for TAPR-TNC1.

If you don't have a TNC with The Firmware or you don't want to change the Software of your TNC, TFKISS may be used. TFKISS is a program running under Linux, which emulates a TNC with The Firmware. It only needs a TNC running KISS or a device which behaves like a TNC using KISS. TFKISS supports standart KISS, KISS with checksum (SMACK) and KISS with checksum used in Flexnet-digipeaters (RMNC-KISS).

Although LINUX is the development platform a porting of TNT to other UNIXes shall be possible because no special functions are used. Other terminals can be used if they have at least line insert and line delete and an entry in /etc/termcap.

Back to Index


Mailbox program DPBox

Joachim, DL8HBS has written a very powerful packet radio program called DigiPoint for ATARI computers. It contains a packet radio host terminal, satellite calculations and a bulletin board system.

The BBS contains almost all features of the known BBS-systems and is capable of performing store and forward with many other systems including packed s&f with F6FBB-BBS's. In addition it can be filled by simply monitoring the frequency. So you will get an up-to-date mailbox without transmitting yourself.

So I decided to try a port of the BBS-part of DP to Linux. Joachim gave me his Pascal-sourcecode and I translated it with P2C by Dave Gillespie (contained in most Linux-distributions) to C. P2C did a terrific job, thanks Dave! Only some minor prework at the sources was needed and P2C created almost executable code. An unix socket interface was added on both sides, TNT and DPBox and the first successful tests were performed.

Many improvements were done since then, even the PACSAT broadcast transmitter/ receiver is included now. The combination TNT and DPBox is running currently in some german full time BBS's and performing good and stable. For more information please consult the DPBox-Documentation.

Back to Index


1. Screen layout


1.1. Virtual screens

In simple other programs all commands and the data for all channels are displayed on one screen. This is not easy to handle and often leads to confusion of the user. Therefore TNT uses a 'virtual' screen for every kind of data. Because only one real display is available the operator must choose which of the several virtual screens he wants to see. He can switch between them by using special codes or keys on the keyboard.

To see which screen and channel is active and to give global information a statusline is displayed at the bottom of the screen.

All virtual screens (or the two parts of the connect screen) can be configured larger than the real display on the screen. Therefore only a small window of the virtual screen is displayed. The window can be moved by the operator.

Back to Index


1.2. Types of virtual screens

It is possible to operate several connection on the same frequency. Therefore a screen for every connection is implemented. The connect screen is splitted to a part where all input is typed and a part where all received data will be displayed. A statusline with all information about the connection is located between these two parts. Optionally some lines displaying the activity on the frequency can be displayed (command MONLINES, 'lines_moncon' in tnt.ini).

To change parameters or give commands to the TNC a command screen is available. To simplify operation all commands can be entered in the connect screens, too by using a colon (:) as the first character.

It is possible to monitor all activity of other stations on the frequency. To display these information a monitor screen is available.

In addition there are some additional screens for special purposes. A screen for the heard stations list, for the extended monitor feature, for the online-help and for the box read generator. If a link to DPBox is active, there is a screen for the box operator- console, too.

Back to Index


1.3. Main statusline

The statusline at the bottom of the screen shows the main status of the program. It shows the screen type (connect, command or monitor) and the current channel. In addition any open file (send or receive) on the current channel will be displayed.

If huffman compression is active on the selected channel CONNECT is replaced by CONN(H) and EXTMONI by EXTM(H).

In addition a 'P' will be displayed if the data output is paused, a 'I' if insert mode is active. If the hostmode synchronisation is lost a 'S' will be displayed. If the TNC was busy and a resend of data from the computer is done, a 'B' will be displayed. If a routing script is active a 'X' will be displayed.

If data is received on a channel which is not displayed the channel number will be displayed until it is switched to the connect screen of this channel. If a connection is active on a channel it is displayed by a '+' at the channel position.

If a file is open on the displayed channel, a two-character file type identifier and the filename (only last 14 charcters) will be displayed in the statusline. Files which receive data will be displayed in the first file field, files which transmit data will be displayed in the second file field. The two-character file type identifier will be explained in the file command chapter.

Back to Index


2. Commands


2.1. Keyboard-commands

Notes:

The combination Alt and key generates the code <ESC>key in normal console mode. Under X the Alt-key is not supported in that way. Therefore to activate for example the monitor screen with X you have to type first <ESC> and then M instead of Alt-M.

(*1) : Input part of connect or mailbox screen.
(*2) : Command screen and input part of extended monitor screen.
(*3) : Monitor screen, receive part of connect, extended monitor or
       mailbox screen.
(*4) : Command, boxlist, heard and help screen
(*5) : Only on monitor screen

Back to Index


2.1.1. Cursor movement and miscellaneous

CR, LF, <CNTL>M, <CNTL>J
The line from the beginning up to the cursor position is transmitted on the current channel (*1) or will be transferred to the command interpreter (*2). If the first character of (*1) is a colon (":"), the line will be sent to the command interpreter (without the colon). A colon as the first character of (*2) will be ignored and removed. If WHOLElin is set to on, the whole line will be used and the cursor position is ignored.

Arrow key left, <CNTL>S
Move the cursor one character to the left, if not on the start of the line (*1,*2).

Arrow key right, <CNTL>D
Move the cursor one character to the right, if not on the end of the line (*1,*2).

Arrow key up, <CNTL>E
Move the cursor one line up, if not on the top of the screen (*1,*2,*4).

Arrow key down, <CNTL>X
Move the cursor one line down, if not on the bottom of the screen (*1,*2,*4).

<CNTL>A
Move the cursor to the start of the line (for command screen and input part of connect screen).

<CNTL>F
Move the cursor to the last non-space character of the line (for command screen and input part of connect screen).

INSERT, <CNTL>N
Toggle insert-mode. If insert-mode is active a 'I' is displayed in the statusline at the bottom. In normal mode all characters are overwritten, in insert mode all characters from cursor position to the end of the line will be shifted one position right (*1,*2).

DEL, <CNTL>H
Delete character left of cursor and move cursor one position left. If insert-mode is active, all characters from cursor-position to the end of the line is moved one position left (*1,*2).

<CNTL>L
The character at the cursor position will be deleted, all characters right of the cursor up to the end of the line will be shifted one position left (*1,*2).

<CNTL>Y
Delete all characters from the cursor position to the end of the line (*1,*2).

<CNTL>V
The pass character. If for example you want to send cntl-T to the connected station first type cntl-V and then a 'T'. A different attribute of the character shows that it is a control character (*1).

Back to Index


2.1.2. Window movement and control

<CNTL>R, Arrow key up (*5)
Move the display window of the virtual screen one line up, if not on top of virtual screen (*3).

<CNTL>C, Arrow key down (*5)
Move the display window of the virtual screen one line down, if not on bottom of virtual screen (*3).

Page up, <CNTL>W
Move the display window of the virtual screen one page up, if not on top of virtual screen (*3,*4).

Page dwn, <CNTL>Z
Move the display window of the virtual screen one page down, if not on bottom of virtual screen (*3,*4).

HOME
Move to the beginning of the window (*3,*4).

END
Move to the end of the window (*3,*4).

<CNTL>P, <ALT>P, <ESC>P
Toggle stop of data-output on the current screen, only possible on connect and monitor screen. Stop is indicated by a 'P' in the statusline at the bottom (Monitor screen and receive part of connect screen).

Back to Index


2.1.3. Screen switching

F1 - F9
Switch to connect screen of channel 1 to 9. If the key is pressed again and the currently selected channel plus 10 exists, these 10 is added to the actual channel (2 two times F1 lead to channel 11).

F10
Switch to connect screen of channel 0 (unproto channel). If pressed again switch to channel 10, 20, ... if they exist.

F11, <ALT>M, <ESC>M
Switch to monitor screen, if in monitor screen switch back to last selected screen.

F12, <ALT>C, <ESC>C
Switch to command screen.

<ALT>Q, <ESC>Q
Switch to connect screen of current channel.

TAB, <CNTL>I
Select a new channel, a '??' as the channelnumber in the statusline indicates this. A number between 00 to 99 for channels 00 to 99 must be entered. Only existing channelnumbers are accepted. If the extended monitor is active, the channelnumber of the extended monitor channel (0 to 4) is selected instead of the connect channel.

<ALT>H, <ESC>H
Switch to help screen.

<ALT>X, <ESC>X
Switch to extended monitor screen.

<ALT>S, <ESC>S
Update heard stations list and display heard list screen.

<ALT>L, <ESC>L
Switch to box read generator (only if activated on current channel). If already in read generator screen switch back to screen before selection.

<ALT>B, <ESC>B
If DPBox is connected, switch to box operator console.

Back to Index


2.1.4. Keyboard macros

<ALT>0 - <ALT>9, <ESC>0 -<ESC>9
User definable function keys for either text or commands.

Back to Index


2.2. Commands in command mode

Back to Index


2.2.1. TNC-commands

Most commands in hostmode consist of one character. It is difficult to remember the charcter for a not often needed command. Therefore more verbose command names were created for every TNC command. But it is still possible to use the original command characters. Only the known commands are implemented, if you have a TNC software which has additional commands, the command 'TNC' must be used.

More information about the commands can be found in the documentation of the TNC software (TNC commands of NORD><LINK The Firmware 2.6a). Some of these commands are no longer existing in newer versions (TF 2.7).

DAMAdis,"B"     : DAMA timeout
Version,"V"     : Shows version of TNC-software
CHeck,"@T3"     : Connection timer T3
Connect,"C"     : Start connection
CText,"U"       : Response text if connect is received by TNC
DIGIpeat,"R"    : Digipeat function
Disconne,"D"    : End connection
DAYTIme,"K"     : Time and date functions
Frack,"F"       : Start value of round trip timer for retry timing
FUlldup,"@D"    : Fullduplex on modem side
MAXframe,"O"    : Maximum number of outstanding packets
Monitor,"M"     : Frequency monitor functions
MYcall,"I"      : Callsign of the local operator
                  With MYCALL the call sign is set permanently on this
                  channel, with "I" only up to the next disconnect.
                  A permanent MYCALL can be removed by using "$" as call
                  sign.
Persist,"P"     : Persistance value for transmitter keyup
RESptime,"@T2"  : Delay before Info-frame will be confirmed (timer T2)
REtry,"N"       : Maximum number of retries
SLottime,"W"    : Slottime value for transmitter keyup
Txdelay,"T"     : Time after transmitter keyup to sending of data
USers,"Y"       : Number of channel open for connection
Xmitok,"X"      : Locking of transmitter
BUFfers,"@B"    : Free buffers of TNC
A1SRTT,"@A1"    : A1-value for smoothed round trip timer
A2SRTT,"@A2"    : A2-value for smoothed round trip timer
A3SRTT,"@A3"    : A3-value for smoothed round trip timer
IPOll,"@I"      : Packet length up to which I-Poll mode is used
VALcall,"@V"    : Check callsign in connect command

All verbose commands can be abbreviated, the upcase part is mandatory.

Back to Index


2.2.2. External commands

Most of the commands can be abbreviated, the upcase part of the command is mandatory.

Back to Index

2.2.2.1. Saving data to files

LOGQso <filename>
A file will be openend and all transmitted and received data on the selected channel will be saved. If no directory was specified, the file will be stored in 'download_dir'. If 'download_dir' is empty, the current directory is used. A CR will be translated to a LF and control-codes will be translated to ^X. Umlaut-conversion will be done, too. The file type ID is 'RN', receive normal.

LOGRec <filename>
Same as LOGQSO but only received data will be saved. The file type ID is 'RN', receive normal.

LOGSnd <filename>
Same as LOGQSO but only transmitted data will be saved. The file type ID is 'RN', receive normal.

READ <filename>
A file will be openend and all received data will be saved. If no directory was specified, the file will be stored in 'download_dir'. If 'download_dir' is empty, the current directory is used. Only a CR to LF translation is done. READ shall be used to receive 7PLUS files. The file type ID is 'RP', receive plain.

READBin <filename>
Same as READ but no translation of characters is done. The file type ID is 'RB', receive binary.

READAbin <filename>
Start receiving a file using the AutoBIN-protocol. If no directory was specified, the file will be stored in 'download_dir'. If 'download_dir' is empty, the current directory is used. The file type ID is 'RA', receive AutoBIN.

LOGAbin <filename>
Same as READABIN except that at the end of transmission the transfer statistics are only displayed, but not sent (useful for receiving binary files from BBSs which get confused by the statistics). The file type ID is 'RQ', receive AutoBIN, quiet mode.

READYapp [filename]
Start receiving a file using the YAPP-protocol. If no filename was given, the name transmitted will be used, a directory contained in the name will be removed. If no directory was specified, the file will be stored in 'download_dir'. If 'download_dir' is empty, the current directory is used. The file type ID is 'RY', receive YAPP.

CLose
Close the active receive-file.

LOGMon <filename>
A file will be openend and all received data on the monitor screen will be saved. If no directory was specified, the file will be stored in 'download_dir'. If 'download_dir' is empty, the current directory is used. A CR will be translated to a LF and control-codes will be translated to ^X. Umlaut-conversion will be done, too. The file type ID is 'RN', receive normal.

RDMON <filename>
Same as LOGMON but only a CR to LF translation is done. The file type ID is 'RP', receive plain.

RDMONBin <filename>
Same as RDMON but no translation of characters is done. The file type ID is 'RB', receive binary.

CLOSEMon
Close the active receive-file on the monitor screen.

LOGXmon <filename> (on extended monitor screen)
LOGXmon <xmon-channel> <filename> (on other screens)
A file will be openend and all received data on the current (on extended monitor screen) or on the specified (on other screens) extended monitor channel will be saved. If no directory was specified, the file will be stored in 'download_dir'. If 'download_dir' is empty, the current directory is used. A CR will be translated to a LF and control-codes will be translated to ^X. Umlaut-conversion will be done, too. The file type ID is 'RN', receive normal.

RDXMON <filename> (on extended monitor screen)
RDXMON <xmon-channel> <filename> (on other screens)
Same as LOGXMON but only a CR to LF translation is done. The file type ID is 'RP', receive plain.

RDXMONBi <filename> (on extended monitor screen)
RDXMONBi <xmon-channel> <filename> (on other screen)
Same as RDXMON but no translation of characters is done. The file type ID is 'RB', receive binary.

CLOSEXmo (on extended monitor screen)
CLOSEXmo <xmon-channel> (on other screens)
Close the active receive-file on the current (on extended monitor screen) or on the specified (on other screens) extended monitor channel.

APPend [ON/OFF]
Flag if data shall be appended to existing files (only valid for LOGQSO, LOGREC, LOGSND, LOGMON and LOGXMON).

AUTOBIn [ON/OFF]
Flag if AutoBIN-receive shall start autonomously on reception of a valid AutoBIN-Header (AutoBIN-receive is performed in quiet mode like started with LOGABIN-command).

AUTOYApp [ON/OFF]
Flag if YAPP-receive shall start autonomously on reception of a valid YAPP-Header.

AUTO7Pl [ON/OFF]
Flag if 7Plus-receive shall start autonomously on reception of a valid 7Plus-Header. To indicate 7Plus reception a file type ID of 'A7' will be displayed at the bottom statusline.

Back to Index

2.2.2.2. Sending files

SEND <filename>
Send a file on the selected channel, a LF will be translated to CR. If no directory was specified, the file will be fetched from 'upload_dir'. If 'upload_dir' is empty, the current directory is used. SEND shall be used to send 7PLUS files. The file type ID is 'TP', transmit plain.

SENDLog <filename>
Same as SEND but control-codes will be translated to ^X and Umlaut-conversion will be done. The file type ID is 'TN', transmit normal.

SENDBin <filename>
Same as SEND but no LF to CR translation. The file type ID is 'TB', transmit binary.

SENDAbin <filename>
Send a file using the AutoBIN-protocol. If no directory was specified, the file will be fetched from 'upload_dir'. If 'upload_dir' is empty, the current directory is used. The file type ID is 'TA', transmit autoBIN.

SENDQbin <filename>
Same as SENDAbin, but it is not waited for #OK# after transmitting the #BIN#-header and the statistics are not transmitted. The file type ID is 'TQ', transmit autoBIN, quiet mode.

SENDYapp <filename>
Send a file using the YAPP-protocol. If no directory was specified, the file will be fetched from 'upload_dir'. If 'upload_dir' is empty, the current directory is used. The file type ID is 'TY', transmit YAPP.

BReak
Abort sending of a file.

FPACLen
Maximum packet length used for file sending. If SENDLog is used, the length is divided by two because of possible Umlaut-conversion. The allowed range is between 20 and 256 characters. If static huffman compression is activated the maximum value is reduced to 255 characters. Changes are global for all channels.

Back to Index

2.2.2.3. Shell,Run,Redirect and Sockets

SHell
Open a shell on the current channel. The call sign of the remote station is used as a user-id. If the user-id does not exist in the system, it depends on 'unix_new_user', whether 'remote_user' is used instead (0) or the user-id is created (1). All received data on the current channel will be sent to the shell, all data from the shell will be sent on the current channel. All line feed characters sent by the shell will be translated to carriage return . All carriage return characters received from the remote station will be translated to line feed prior to sending to the shell.
(This command is available only if TNT is invoked by root.)

TSHell
Same as SHELL, but no conversion of linefeed and carriage return will be done.

ROOTSH
Same as SHELL, but a shell with superuser privileges (root) is started.

TROOTSH
Same as ROOTSH, but no conversion of linefeed and carriage return will be done.

ENDShell
End the shell on the current channel.

RUN <program>
On the current channel the specified program will be executed. All received data on the current channel will be used as standard input of the program, all data sent to standard output by the program will be sent on the current channel. Only programs contained in 'run_dir' can be executed. All line feed characters sent by the program will be translated to carriage return. All carriage return characters received from the remote station will be translated to line feed prior to sending to the program.

RUNT <program>
Same as RUN, but no conversion of linefeed and carriage return will be done.

ENDRun
Abort execution of the program on the current channel.

REDir <device>
Redirection of input/output. All received data on the current channel will be sent to <device>, all data received from <device> will be sent on the current channel.

ENDRedir
End the redirection of the current channel.

SOCKCon <socket address>
The socket specified will be connected and all data received from the socket will be transmitted on the current channel and vice versa. All line feed characters received from the socket will be translated to carriage return. All carriage return characters received from the remote station will be translated to line feed prior to sending to the socket. More information can be found in the chapter 'Detailled Description'.

TSOCKCon <socket address>
Same as SOCKCON, but no conversion of linefeed and carriage return will be done.

ENDSOCKC
End the socket connection on the current channel.

SOCket AXSERV <socket address>
An AX25 server will be installed on the specified socket. From now on a connection to this socket is possible and after authentification AX25- connections can be started (for example internet-access to packet radio). More information can be found in the chapter 'Detailled Description'.

SOCket AXSPEC <socket address>
Same as SOCKET AXSERV, except data from the client to AX25 will be transmitted directly on occurence of line feed or carriage return without waiting for 'pty_timeout'.

SOCket NETCMD <socket address> <default callsign>
A Wampes-compatible AX25 server will be started on the specified socket. If no own callsign is given in the connect command the default callsign is used. More information can be found in the chapter 'Detailled Description'.

ENDSock <socket address>
End the socket server on the specified socket address. All connections to the server are disconnected.

Back to Index

2.2.2.4. Directory

CD <dir>
Change the working directory to <dir>. If <dir> is empty, the HOME-directory will be used.

CWD
Displays the current working directory.

Back to Index

2.2.2.5. Miscellaneous

TNC <command>
<command> is sent as a command to the TNC without any conversion.

CHANnel <x> or S <x>
Switch to connect screen of channel x. If included in a command script, no changing of screens is performed, it simply specifies the channel used for the following commands.

CONCall <callsign>
If the updated callsign in the statusline is corrupted by a connect message in normal text, the callsign can be restored using this command.

CStatus
A list of all connected channels with starttime of connect and callsigns will be displayed.

SENDCom <filename>
Execute a file containing TNC or external commands (command script).

CBell [ON/OFF/OTHER]
Beep if the state of a connection changes (connect bell). If other, then a beep will only be generated if a station connects on a different than the current channel.

INFObell [ON/OFF/OTHER]
Beep if a new packet is received on any channel (information bell). If other, then a beep will only be generated if a new packet is received on a different than the current channel.

COOKie [ON/OFF]
Send a cookie if connected from a remote station.

UMLaut [ON/OFF]
Umlaut conversion.

CONText [ON/OFF]
Send a special connect text, using macros, overrides COOKIE.

TXEcho [ON/OFF]
Echo all sent data from input part to part with received data.

PTYEcho [ON/OFF]
Echo all data received and send on a channel on which SHELL, RUN, SOCKET or REDIR is active.

NAME <name>
Set the name of the call on the current channel to <name>, if <name> is not specified, the stored name is displayed (only if channel connected).

STIme
Send time and date on the current channel.

SCOokie
Send a cookie on the current channel.

TIMESET
Send time of computer to TNC.

DATESET
Send date of computer to TNC.

RESYnc
Displays the number of hostmode resynchronisations since program start and, if applicable, some additional information concerning the problem.

LAYer3 [ON/OFF]
Enables or disables the analysis of NETROM/TheNet headers (pid CF) in monitored frames.

HEArd [ON/OFF]
Enables or Disables the heard list. If disabled, the heard list is not updated any longer.

KMAcro
Reload the keyboard macro file 'func_key_file' defined in the init-file.

MSEnd <filename>
Send a file, using macros. The file is fetched from 'macrotext_dir' defined in the init-file.

WORDWrap [ON/OFF]
Enables the wordwrap-function. An incomplete word at the end of the line will automatically be copied to the next line.

WHOLElin [ON/OFF]
If set to on, the whole line will be transmitted, if set to off only the part of the line up to the current cursor position.

LINelen <value>
Set the linelength at which additional input characters are ignored or wordwrap will be executed. This value shall normally be set to 80 characters. The default value can be specified by 'input_linelen' in the init-file.

MONLines <value>
If you like to see a part of the monitor screen on the connect screen the number of monitor lines can be specified here. Set to 0 if you don't want monitor lines. The default value can be specified by 'lines_moncon' in the init-file.

CONDiv <value>
Changes the input/output-lines ratio on the connect screen. For further details see 'scr_divide' in the init-file.

XMONDiv <value>
Changes the input/output-lines ratio on the extended monitor screen. For further details see 'xmon_scr_divide' in the init-file.

MBOXDiv <value>
Changes the input/output-lines ratio on the mailbox screen. For further details see 'mbscr_divide' in the init-file.

COMP [ON/OFF]
Huffman compression is enabled/disabled on the current channel. 'CONN(H)' in the bottom statusline indicates an enabled huffman compression. If no value is given the current status is returned. To synchronize the switching to huffman compression between local and remote station the remote command //COMP shall be used instead.

BSCRHold [ON/OFF]
If enabled, no scrolling of the displayed window will be done if the last line of the screen buffer is not displayed (backscroll active) and the first displayed line is still in the screen buffer.

TABExp [ON/OFF]
If enabled, a TAB-character is expanded to position the cursor on the next tab-stop. A tab-stop is defined every 8 characters. If disabled '^I' is displayed instead.

FREE
This command will display the number of free buffers in the TNC. The command does not execute a '@B'-command, but it displays the value of the last periodical polling.

SIGNon
Display version and copyright information of TNT.

LOGBOOK [ON/OFF]
This command can disable the writing to the logbook-file.

EXit
Leave TNT.

QUIT
Leave TNTC without termination of the TNT-daemon.

Back to Index

2.2.2.6. Routing scripts

XConnect [portheader:]<callsign>
Start of a routing script for the specified callsign. An active script can be ended by using 'OFF' as callsign. If a routing script is active, a 'X' in the main statusline will be displayed. If the callsign is not found in the routing database, a simple connect is started. If a multiport-TNC is used, a valid portheader entered with command QRG can be used in front of the callsign to select the port where the first connect shall be started. Using this command an automatic allocation of a free SSID for the source call is performed. So multiple connects to the same digipeater are possible.

QRG [<port> <frequency>] [portheader:]
With this command the operating frequency of the program is defined. The specified frequency is used to select valid routing data out of the routing database. <frequency> can be any string up to 19 characters. For TNCs with one port use 0 as <port> and omit <portheader:>: QRG 0 438.300 For multiport-TNCs for each port a frequency and the portheader must be defined: QRG 0 438.300 1: QRG 1 430.900 2: Without arguments the current frequency definition is displayed.

LSNOTOWN
This command lists all callsigns for which an entry in 'tnt_notownfile' was found. These callsigns are not allowed to be used as source calls for a xconnect. So you are able to define some SSID's of your call which TNT will not use (needed if different software is operated with the same callsign).

LDNOTOWN
If 'tnt_notownfile' was changed while TNT is running, it can be reloaded with this command. A reload is necessary because TNT only reads the file at startup and copies the data to memory.

Back to Index

2.2.2.7. Extended monitor and boxlist

XMON [ON/OFF]
Enables or Disables the extended monitor function. If disabled, received monitor frames are not analysed any longer.

EXTmon <call1> <call2> [<call3> <call4>] (extended monitor screen)
EXTmon <xmon-channel> <call1> <call2> [<call3> <call4>] (other screens)
On the current (extended monitor screen) or on the specified (other screens) channel a connection shall be monitored. If only <call1> and <call2> is specified, frames from <call1> to <call2> and <call2> to <call1> are monitored, otherwise frames from <call1> to <call2> and <call3> to <call4>.

EXTAmon <call1> <call2> [<call3> <call4>]
Same as EXTMON except that the next free xmon-channel will be used. The resulting channel will be displayed as command response.

ENDEXtm (extended monitor screen)
ENDEXtm <xmon-channel> (other screens)
The extended monitor on the current (extended monitor screen) or the specified (other screens) channel will be closed. The connection will be no longer monitored.

EXTComp [ON/OFF]
Huffman compression is enabled/disabled on the current extended monitor screen. 'EXTM(H)' in the bottom statusline indicates an enabled huffman compression. If no value is given the current status is returned.

LOGBlist
On the current channel or on the mailbox screen a file is openend and all received data is saved. The command is similar to LOGREC except a unique filename is generated (in /tmp directory) and the file will be removed during exit of TNT.

BLIst [<filename>]
On the current channel or on the mailbox screen the last active file is used for the boxlist screen and feature. If the file is not closed up to now, it will be closed. Optionally a filename can be specified. In this case this file will be loaded into the boxlist screen.

XBList
Finish boxlist and close the boxlist screen on the current channel.

Back to Index

2.2.2.8. Interface commands

IFAce <socket-name>
Build up a socket connection to an external program via an UNIX-socket <socket-name>.

ENDIFace <socket-name>
Disconnect the socket connection to an external program via an UNIX-socket <socket-name>.

FINIFace <socket-name>
Same as ENDIFACE, except that the external program get the command to terminate its execution.

ACTIf <socket-name>
Activate the external program on the current channel using the already built up socket connection.

DEACtif <socket-name>
Deactivate the external program on the current channel.

SNOCONN <string>
String which will be sent, if a program was remotely activated via the Interface and the activation was not successful.

Back to Index

2.2.2.9. DPBox-interface commands

ACTBox
Build up a socket connection to DPBox via an UNIX-socket specified by 'box_socket' in the init-file.

DEACTBox
Disconnect the socket connection to DPBox.

FINBox
Disconnect the socket connection to DPBox and terminate DPBox.

BOX [callsign]
Activate DPBox on the current channel using the already built up socket connection. If a callsign is specified at the mailbox console this callsign is used for the boxsession instead of the box callsign.

ENDBox
Deactivate DPBox on the current channel.

AUTOBOx [ON/OFF]
If activated, all connections are scanned for mail-headers. A valid mail-header leads to saving the following mail. If the end is reached, the mail will be sent via the interface to DPBox.

MONBox [ON/OFF]
If activated, all monitored frames are scanned for mail-headers. A valid mail-header leads to an extended monitoring of the connection. If no frames are lost and the mail-end is reached, the monitored mail will be sent via the interface to DPBox.

LMONbox
All mails which are currently received using the MONBOX-feature are displayed.

SNOBOX <string>
String which will be sent, if DPBox was remotely activated and the activation was not successful.

SCANMBEA [<source> <destination> <own_call> <connectcall> [<timeout>]] [$]
TNT can monitor mail-beacons and if it finds your call in it, it can activate store and forward to get your new mail. To activate this feature you have to give source and destination of the expected mail-beacon (which will be the callsign of your bbs and MAIL as destination), your own call (this call is searched in the beacon data) and a connectcall with an optional timeout. The connection is built up using the xconnect-feature giving connectcall and timeout as parameters. If the connection is established store and forward will begin. The command without parameters will give the current data. If you want to deactivate this feature, give a '$' as a single argument.

LDBOXFil
All files concerning the box configuration ('autobox_dir', 'tnt_boxender' and 'f6fbb_box') will be reread. So changes in these files can be made without the need of leaving TNT.

ACCUIReq [ON/OFF]
If ON, unproto list requests to the callsign defined by ACCUICal will be sent to DPBox. DPBox will then take the needed action.

ACCUICal <BBS-callsign>
If an unproto list request is received with the callsign (including SSID) defined here, the request will be sent to DPBox. To clear the callsign the value '$' can be used.

Back to Index

2.2.2.10. Password generation commands

PRIV
This command starts the password generation sequence. The command is rejected if the channel is not connected or the callsign of the connected station is not contained in 'tnt_pwfile'. The taken action is dependent on the type of the password generation defined for the callsign.

LISTPRIV
This command lists all callsigns for which an entry in 'tnt_pwfile' was found. In addition for every callsign the type of password generation and the file containing the password data is listed.

LOADPRIV
If 'tnt_pwfile' was changed while TNT is running, it can be reloaded with this command. A reload is necessary because TNT only reads the file at startup and copies the data to memory.

Back to Index

2.2.2.11. Remote-command permissions and access levels

REMOte [ON/OFF]
Enables or disables remote commands for ALL channels. If disabled commands with status ALWAYS are not available.

REMAllow [ON/OFF]
Enables or disables remote commands on the current channel. If disabled commands with status ALWAYS are available. This command is allowed only if connected. In addition the current status is changed at a new connect according to tnt_noremfile.

SETACC <remote-command> [NORMAL/SYSOP/ROOT/ALWAYS]
defines which access-level a remote-station needs to execute a remote- command. NORMAL means the command is available for everyone, commands with SYSOP status only after a successful validation with //sys. If the root-sysop flag was set in tnt_sysfile, commands with ROOT status are available after validation. The ALWAYS status means that this command is available even if the connected station is contained in tnt_noremfile.

NOACC [ON/OFF]
If set to ON, only remote stations contained in tnt_sysfile can connect the station. All other will receive the string defined by SNOACC and will be disconnected afterwards.

SNOACC <string>
defines the string which is sent to a station not authorized to connect.

LISTSYS
This command lists all callsigns for which an entry in 'tnt_sysfile' was found. In addition for every callsign the file containing the password data is listed and if the sysop-status can be achieved after password validation (0: not root-sysop, 1: root-sysop).

LOADSYS
If 'tnt_sysfile' was changed while TNT is running, it can be reloaded with this command. A reload is necessary because TNT only reads the file at startup and copies the data to memory.

LSTNOREM
This command lists all callsigns for which an entry in 'tnt_noremfile' was found. For these callsigns remote-commands are disabled except the commands with status ALWAYS. The disabling of remote-commands remains until the channel is disconnected, so connecting or reconnecting to a different station will not enable remote-commands any more. A change is possible using the command REMALLOW.

LDNOREM
If 'tnt_noremfile' was changed while TNT is running, it can be reloaded with this command. A reload is necessary because TNT only reads the file at startup and copies the data to memory.

LSTFLCHK
This command lists all callsigns for which an entry in 'tnt_flchkfile' was found. Connections from these callsigns will get no connect-text, no remote access and will not be linked to DPBox or other programs using the interface. In addition no entry will be included in the logbook.

LDFLCHK
If 'tnt_flchkfile' was changed while TNT is running, it can be reloaded with this command. A reload is necessary because TNT only reads the file at startup and copies the data to memory.

LSEXTREM
This command lists all currently active extended remote commands, their access level, the number of significant characters and the related command with parameters. This data is read from 'tnt_extremotefile' at startup of TNT.

LDEXTREM
If 'tnt_extremotefile' was changed while TNT is running, it can be reloaded with this command. A reload is necessary because TNT only reads the file at startup and copies the data to memory.

AUTOStrt [ON/OFF]
Enables or disables the autostart feature.

LSAUTOST
This command lists all currently active callsign/SSID combinations, for which autostart commands are defined. This data is read from 'tnt_autostartfile' at startup of TNT.

LDAUTOST
If 'tnt_autostartfile' was changed while TNT is running, it can be reloaded with this command. A reload is necessary because TNT only reads the file at startup and copies the data to memory.

Back to Index

2.2.2.12. Broadcast transmission/receiption

SENDBC <filename>
The specified file will be sent using PACSAT broadcast protocol.

BCRQST [ON/OFF]
If set to on, broadcast requests for missing data are generated, if off it is just waited for a retransmission.
SHPACSAT [ON/OFF]
If set to on, broadcast frames are displayed, if off, no display is done.

DECBCAST [ON/OFF]
If set to on, broadcast-frames are decoded. If set to off, broadcast frames are not decoded.

BCRXstat
Display of the already received or currently received files by the broadcast receiver including some status information.

BCTXstat
Display of the files currently transmitted by the broadcast transmitter including some status information.

Back to Index


3. Detailled description


3.1. Remote commands

If remote is enabled the remote station can give some commands to the program. All remote commands start with a double slash '//'. This double slash must be entered directly at the beginning of a line, otherwise the command is not recognized.

The following remote commands are recognized:

 //COMP on/off          Enable/disable huffman compression
 //NAME <name>          Store name in database
 //CSTAT                Show all active connections
 //SHELL                Start a UNIX-shell session
 //TSHELL               Start a UNIX-shell session without CR/LF translation
 //RUN <program>        Execute a program
 //RUNT <program>       Execute a program without CR/LF translation
 //RUN                  Directory of all available programs
 //BOX                  Start DigiPoint Box
 //COOKIE               Send a cookie
 //DIR <filter>         Show directory
 //DIRLONG <filter>     Show directory in long format
 //FREE                 Shows space on disks
 //INFO                 Info about station
 //HELP                 This help-information
 //NEWS                 Display news about this station
 //READ <file>          Read a file
 //BREAK                Abort reading file
 //WRITE <file>         Write file to disk
 //CLOSE                End writing file
 //WPRG <file>          Write file to disk using AUTOBIN-protocol
 //WPRG <file> <rfile>  Same as above, but send back //RPRG <rfile>
 //RPRG <file>          Read a file using AUTOBIN-protocol
 //RPRG <file> <rfile>  Same as above, but send back //WPRG <rfile>
 //WYAPP <file>         Write file to disk using YAPP-protocol
 //RYAPP [file]         Read a file using YAPP-protocol
 //VERSION              Show version of software
 //ECHO <string>        Send back string
 //TIME                 Send time
 //RTT [timestring]     Calculate round trip timer
 //RING                 Ring the bell (call for sysop)
 //QUIT                 Disconnect
 //DISC                 Disconnect

 //SYSOP                Start sysop password validation
 //ROOTSH               Start a shell with root-permissions
 //TROOTSH              Same as above without CR/LF translation
 //SOCKET <sock addr>   Start a connection to a socket
 //TSOCKET <sock addr>  Same as above without CR/LF translation
 //COMMAND <command>    Execute a valid TNT command

Back to Index


3.1.1. Default access levels for remote-commands

All remote commands are available for everyone (status NORMAL) except for //SHELL, //TSHELL, //ECHO, //COMMAND (status SYSOP), //ROOTSH, //TROOTSH, //SOCKET and //TSOCKET (status ROOT). The command //COMP is available if remote is disabled on the current channel (status ALWAYS). This default configuration can be changed by the command SETACC.

Back to Index


3.1.2. Sysop password validation (//SYSOP)

If the remote-command //sys is received, a sysop password validation sequence is started. TNT will pick 5 random numbers with values up to the length of the stored password string for the remote station. The remote station must answer with the corresponding 5 characters. The characters can be contained at every position inside a random string to make a hacking of the password more difficult. In addition there is no response if the //sys command was successful or not, the status is changed only internally. Therefore it is advisable to send //sys 3 or more times with only one correct answer. This will make the hacking of the password quite impossible. The algorithm used is compatible to the TheNet password validation.

Back to Index


3.1.3. Shell with root-permissions (//ROOTSH)

This command is very dangerous, please be sure that it is available only for the right people after password validation. If you don't want to allow this command, set it to status ROOT and set the root-sysop flag in tnt_sysfile for all callsigns to 0.

Back to Index


3.1.4. Socket connection (//SOCKET)

This command allows to connect to every socket in your system. Therefore it is quite dangerous, too. Change to a different status as ROOT is not recommended. If you want to allow the connect to specific sockets, use the extended remote commands ('tnt_extremotefile').

Back to Index


3.1.5. Dangerous //ECHO command

There are some pirat bulletins floating around in the BBS-network which use the remote-command //ECHO to let you send a bulletin with offending contents. Therefore I changed the access level of //ECHO to SYSOP level. If you put all the BBS's your are working with in tnt_noremfile or if you are using command REMALLOW to disable the remote commands on the channel you are connected to a BBS, you can change back the access level of //ECHO to NORMAL. But be very careful with it! Otherwise there may be an offending bulletin forwarded worldwide with YOUR callsign as sender!

Back to Index


3.1.6. Handling of unknown remote commands

To easily add new remote commands an unknown remote command will be used as a parameter for //RUN. For example the command //FOOBAR will be translated to //RUN FOOBAR. If the program FOOBAR is existing in 'run_dir', it will be executed. If the program is not existing, the user will be informed about an invalid remote command.

Back to Index


3.1.7. Extended remote commands

The behaviour described in the last section allows an easy extenstion of the available remote commands by providing programs in the 'run_dir'. If an extension is needed, which cannot be implemented with a program or the program needs specific parameters, the extended remote commands feature can be used.

A new extended remote command consists of a valid remote command plus parameters. In addition the access level and the number of significant characters is defined. All data is stored in 'tnt_extremotefile'.

The contents of this file can be displayed by command LSEXTREM. When the file was updated, it can be reread using command LDEXTREM.

Back to Index


3.2. Umlaut conversion

Back to Index


3.2.1. Display

If the LINUX-console control codes are used, for a display on the screen the IBM-characterset is used. No umlaut-conversion will be done. If termcap is used a received IBM-umlaut is converted depending on UMLAUT. If UMLAUT is on, the IBM-umlaut is converted into the 8-bit Latin-1 umlaut. If UMLAUT is off, it is converted to a two character representation ("ae").

Back to Index


3.2.2. Sending text

If UMLAUT is off, all entered umlauts are converted to a two character representation ("ae"). If UMLAUT is on, umlauts will not be converted and sent as an IBM-umlaut.

Back to Index


3.2.3. File-receive

Only log-files (LOGREC, LOGSND, LOGQSO, LOGMON and LOGXMON) are affected by umlaut conversion. If UMLAUT is on, the IBM-umlaut is converted into the 8-bit Latin-1 umlaut. If UMLAUT is off, it is converted to a two character representation ("ae").

Back to Index


3.2.4. File-send

Only log-files (SENDLOG) are affected by umlaut conversion. If UMLAUT is on, the 8-Bit Latin-1 umlaut is converted into the IBM-umlaut. If UMLAUT is off, it is converted to a two character representation ("ae").

Back to Index


3.3. Using UNIX-features

Back to Index


3.3.1. Shell-login

TNT allows a remote user to log into UNIX as a normal user. All received data is treated as shell input, all data from the shell is transmitted to the remote station. To use the shell-login it is necessary to invoke TNT by the superuser root. Otherwise the shell-login is disabled. The shell can be started by the operator using command SHELL or TSHELL or by the remote station using command //SHELL or //TSHELL. It is possible to execute all programs which are permitted to use from the shell.

To be in line with the end of line convention used in Packet Radio, all line feed characters from the shell will be translated to carriage return and all received carriage return characters will be translated to line feed. This translation can be disabled by using the command TSHELL instead of SHELL or //TSHELL instead of //SHELL as a remote command.

At login time, it is checked, if the callsign of the remote station is a valid user-id. If it does not exist, depending on 'unix_new_user' in the initfile a new user-id is created or the user-id specified by 'remote_user' is used. In all cases the callsign is stored on the environment variable 'CALLSIGN'.

For some configurations it is useful to be able to get a shell with root permissions. This can be done using the command ROOTSH and remote command //ROOTSH or command TROOTSH and remote command //TROOTSH for disabled CR/LF-translation. As giving superuser access to the system is very dangerous, extra care must be taken.

To increase performance, all data will be buffered. This means that data is not sent directly, but if the buffer contains 256 Bytes (the AX25 maximum packetlength) or if for a specific time no new characters were received. This time ('pty_timeout') can be configured in the initialisation file.

Back to Index


3.3.2. Redirection

A connect screen of TNT does not accept any of the standart control characters used for screen oriented programs. If you use an AX25 connection to work with such a program (for example using a TSHELL on another stations TNT) you can use redirection (command REDIR) to one of the Linux virtual consoles. Now all control codes are handled correctly and you can work with the program like you were directly connected to the remote system.

REDIR allows to redirect all data of an AX25-channel to any device which is known in the system. Examples are the Linux virtual consoles /dev/ttyX or one part of a tty/pty-pair.

There is no translation of the characters, all data received is given transparently to the device and vice versa. Like for the shell-login all data will be buffered before transmission.

Back to Index


3.3.3. Running programs

For users who are not familiar with UNIX, the use of a shell is quite complicated. Therefore a RUN command is implemented, which will execute a specified program using a shell. If you don't like running TNT under root-permissions and therefore the shell-login is disabled, the RUN command allows to execute specific programs by a remote station.

A special directory 'run_dir' contains all executable programs. Programs in other directories cannot be executed by this command. Because no login is performed, the program is executed using the default user specified by 'remote_user'. If TNT was invoked not by the superuser root, the user can't be changed. In this case the program is executed under the permission of the userid from which TNT was started. The callsign of the user is stored in the environment variables 'CALLSIGN' and 'LOGNAME'. The callsign including the SSID will be available in the environment variable 'CALLSSID'.

In most cases it is wanted to translate the UNIX-linefeed to Packet-Radio carriage return and vice versa. If no translation of the characters sent and received by the program shall be done, the command RUNT must be used. Like for the shell-login all data will be buffered before transmission.

Back to Index


3.3.4. Socket server

If your system is used by several people or is part of a network, you may want to give access to Packet Radio to these users. Or you want to use programs on your system, which must be able to perform an outgoing AX25-connect. To handle these requirements the socket server feature (command SOCKET) was implemented.

There are three type of servers, AXSERV, AXSPEC and NETCMD. AXSERV and AXSPEC are almost identical, both define an AX25-server. AXSPEC does not use the usual buffering method for data described for shell-login, but sends data directly on occurence of a line feed or carriage return character. NETCMD is a Wampes-compatible server which allows the usage of programs designed for Wampes (like conversd) together with TNT.

All types of servers need a socket address. This socket address can have different formats.

  1. UNIX-sockets
    The format for a UNIX-socket is 'unix:<socket path>' or 'local:<socket path>'. The path can be an absolute path beginning with a '/' or a relative path to 'tnt_dir'.
    Example:
    unix:/tcp/sockets/convers
    

  2. INET-sockets
    The format for a INET-socket is 'ip-address:port'. ip-address can be a hostname, an ip-address or a '*' for any ip-address. Port can be any valid port number or a name for a service.
    Example:
    *:3600
    199.199.10.10:ftp
    foo.bar.com:2000
    

Back to Index

3.3.4.1. AX25-Server

A local user can connect to this server with 'telnet localhost <portnumber>'. Then a login with callsign and password is executed. After a successful login the user is connected to the AX25-server and may use one channel of the TNC for Packet Radio connections. The usage is quite simple, help for the user is available. The login information is kept in 'sock_passfile' and is independent of the passwd file.

Back to Index

3.3.4.2. Netcmd

The Netcmd-server works compatible to Wampes. So after connect to the socket, the server is in command mode and accepts three commands: ASCII, BINARY and CONNECT. Any other input or wrong arguments lead to a closing of the connection.

ASCII selects a translation from line feed to carriage return before transmitting data on the AX25 side and vice versa. This is the default mode.

BINARY selects a transparent connection without any character translation.

CONNECT starts an AX25 connection on a free channel. It needs additional parameters, the syntax is:

CONNECT <transport mode> <destination callsign> [source callsign]
The only valid value for 'transport mode' is AX25, other modes will lead to a closing of the connection. The destination callsign must not contain any digipeaters. TNT uses the xconnect-feature to build up the connection, therefore the path must be defined in the routing database. Normally the default callsign entered with the SOCKET command will be used. If a source callsign is given in the CONNECT command, this will be used instead. There will be an automatic SSID-update to allow several connections with the same destination.

After a successful link setup the server will switch to data mode, all received data will be sent to the socket, all data from the socket will be transmitted on the AX25 side.

When the link setup was not successful, the socket connection will be simply disconnected without any further information.

Back to Index


3.3.5. Socket connect

You may have installed some socket servers on the system. To give Packet Radio users access to these, the socket connect feature is available. The only Argument needed is the socket address of the socket which shall be connected. The socket address uses the same syntax as the socket server.

Like for the other UNIX-features there is an option to translate carriage return into line feed and vice versa (command SOCKCON, remote command //SOCKET) or the possibility for a transparent connection (command TSOCKCON, remote command //TSOCKET).

Because there is no access restriction to a socket, you have to be careful with this command. A full connectivity of all sockets shall be allowed only for a sysop. Users shall get only specific sockets by defining extended remote commands ('tnt_extremotefile').

Back to Index


3.4. File transfer methods

Back to Index


3.4.1. AutoBIN file transfer

To transfer binary files easily without much overhead but with a security check, the AutoBIN-'protocol' was defined. It is implemented in many PR-programs. Therefore it is implemented in TNT, too. To use AutoBIN the commands SENDABIN, READABIN and LOGABIN are available for the operator and //WPRG and //RPRG for a remote user. In addition with AUTOBIN the protocol is autonomously started after reception of a valid AutoBIN-header.

At the end of a successful transfer the elapsed time and the effective Baudrate is displayed. If a file was received, the received checksum and the calculated checksum will be displayed, too. Normally these statistical information will be send to the remote station, too. In case of LOGABIN or AUTOBIN enabled the statistical information will only be displayed (to avoid confusion of some BBSs).

If the transfer was aborted, the connection was disconnected or the calculated checksum is not equal to the received checksum, the received file will be moved to a special directory (abin_dir). In addition the name is changed to a unique name. From time to time it is needed to clean up this directory. Although in most cases these corrupted files are of no interest, for the rare cases where they are needed they are kept in this directory.

Back to Index


3.4.2. YAPP file transfer

The AutoBIN-'protocol' is used widely in Germany. The rest of the world usually use the YAPP-protocol. From the technical point of view YAPP and its extension YAPP-C is the better approach to binary transfer and shall be preferred.

In TNT for YAPP the commands READYAPP and SENDYAPP are available, a remote user can use //RYAPP and //WYAPP. To enable the automatic reception of a YAPP-file, you can set AUTOYAPP to on. All files automatically received will be stored in 'yapp_dir' defined in tnt.ini.

Back to Index


3.4.3. 7Plus file reception

If you receive large numbers of 7Plus files, you might want to store them directly in a special directory (without any character before and after). This can be done by setting AUTO7PL to on. Now all received 7Plus files will be stored in 'tnt_7plus_dir' defined in tnt.ini.

Back to Index


3.5. Special connect text and files with macros, Name-database

To be able to send a special connect text to a connecting station, macros can be included in the connect text file. The connect text file will be sent on a connect if CONTEXT was set to ON. For default the connect text file (tnt_ctextfile) in the tnt directory will be used, but you can put for some users a personal connect text in the connect text directory (ctext_dir). The file must be named <callsign>.ctx .

In addition a file containing macros can be sent every time you like, not only on connect (command MSEND). All these files must reside in the macro text directory 'macrotext_dir'.

To be more personal and to help remembering the name of the operator of the remote station a name database is included. A name can be entered by the operator using the NAME command or with //NAME given by the remote station. If no name is specified after the command, the current name will be reported.

Following macros are expanded, if found in a connect text or macro file:

%v: Version of TNT running
%c: Call of other station
%n: Name of other station (extract from names database)
%y: Call of own station
%k: Channel number
%t: Current time
%d: Current date
%b: Bell (^G)
%i: Include news-file ('news_file_name')
%z: Timezone
%_: CR/LF
%o: Include a cookie
%?: Send a message if name of other station not contained in
    names database
%%: '%' itself

Back to Index


3.6. Routing scripts

The structure of the Packet Radio Network is quite different compared to the internet. In the internet you can directly specify your destination and the routing will be done automatically. In the Packet Radio Network there exist different systems with incompatible routing mechanisms. To connect to a destionation there may be needed several steps. Suppose the following example:

You want to connect DL7ZZZ which is standby on the frequency of the digipeater DB0LUC. Your local digipeater is DB0BLO. Therefore your first command is to connect DB0BLO:

:c db0blo
If the link setup was successful you will send the line
c db0ber
to the digipeater which then will build up a connection to DB0BER, which is the next digipeater towards DB0LUC. If the connection is established, DB0BLO will send you the message:
*** connected to DB0BER'
Now you enter the line
c db0luc db0bln
which means DB0LUC can be reached from DB0BER via DB0BLN. DB0BLN is not connected, because it uses hop-to-hop acknowledge instead of simple digipeating. Now if the connection was successful, you get the line
BSUED:DB0BER> Connected to DB0LUC via DB0BLN
and you can at last try to connect your destination with the line:
c dl7zzz
The successful connection is indicated by the line
*** connected to DL7ZZZ

If you do this manually, you must look at your screen and after each successful connect-message you must enter the new line. The connect-script facility (command XCONNECT) now does all these steps automatically, if you have given the routing information to the program. The routing information will be searched in the routing-database file (route_file_name) and reads for the example as follows:

T>DL7ZZZ Joe; N>DB0LUC T>DL7ZZZ
N>DB0LUC Digi Luckau; N>DB0BER F>DB0BLN N>DB0LUC
N>DB0BER Digi Tempelhof; N>DB0BLO N>DB0BER
N>DB0BLO Digi 9K6

As you can see the routing entries are recursive, you don't have to specify the whole routing for the destination. The characters before the callsigns give the information to the connect script shall connect the digipeater ( N> ) or if the digipeater shall be used in the via path ( F>, D> ). To identify a normal user T> is used, for mailboxes B> can be used.

Some programs used by normal users allow a connect with the command //c <callsign>. If you want to use such a user as part of your path, put a T> in front of the callsign and a '//c <callsign>'-line will be send by the routing script.

If you frequently change your operating frequency, you may want to use the QRG command and want to define routing data only valid for a special frequency ('<IF xxxx> <END>'-clause).

Back to Index


3.7. Call update

If you use routing scripts or if you connect manually through a large number of digipeaters, you easily loose the orientation, where you are. Therefore, every 'connected to' line will update the callsign displayed in the statusline.

'reconnected to' lines will update the call in the statusline, too, but routing scripts will not send the next command line and the logbook call will not be updated.

If the callsign is changed by a 'connected to' string in normal text, it can be restored by using the CONCALL command.

Back to Index


3.8. Logbook

All connections performed by the station are written into a logbook-file. Each line contains starttime and endtime of the connection and the callsign of the remote station. If the destination was connected directly only this call is logged, if the destination was connected using several digipeaters or by a routing script, the first digipeater used is logged, too. The name of the logfile can be specified in the init-file (tnt_logbookfile). The command LOGBOOK can be used to enable or disable the logbook function.

Example:

   Starttime   |    Endtime     |          Callsign
------------------------------------------------------------------
16.03.94 18:08 | 16.03.94 18:09 | DB0BLO
17.03.94 21:32 | 17.03.94 21:37 | GEHREN:DB0LUC, Uplink: DB0BLO

Back to Index


3.9. Keyboard macros

With the keyboard macro feature some often used commands or texts can be executed or sent by only one keycode. You may define up to 10 keycodes (<ALT>0 to <ALT>9 or <ESC>0 to <ESC>9) with either text patterns or TNT commands in a file specified by 'func_key_file' in the init-file.

Each line has to begin with a two digit number specifying the keycode and a colon. (01: for <ALT>1 / <ESC>1, 10: for <ALT>0 / <ESC>0). A text line must follow directly after the colon. If the last character of the line is an asterisk '*' a CR will be sent instead of it, otherwise no CR will be sent. A command must be preceeded by an additional colon, a CR is always appended to the command line. The length of the text or command must not exceed the length of the line.

If the length of one line is not sufficient for your text or you want to send a text containing macros like time and callsign, you must specify the commands 'send' or 'msend' instead of a textline. The keyboard macro file is loaded at startup. If you change this file during execution of TNT, you can reload the file with the command 'kmacro'.

Back to Index


3.10. Boxlist

Back to Index


3.10.1. General description

If you get a list of files from a BBS, you will have to write down the files you are interested in or you must store the list in a file and look through this file afterwards. In both cases you have to type the filename or number of the file to get it from the BBS.

The boxlist-feature allows to fetch a file from the BBS by selecting the file (with cursor keys) from the filelist and simply pressing CR.

If an Interface-connection to a DPBox is active and a 'check'-command with bulletin-ID in the list is given, all bulletins which are in the bulletin-ID pool of the DPBox are displayed with a special attribute/colour. That means you get an overview about the bulletins already contained in your own BBS.

Back to Index


3.10.2. Using boxlist

How does it work?

  1. Before requesting the filelist open a logfile. If you are not interested in keeping the list, simply use the command 'logblist'. A temporary file with a unique name will be used. This file will be erased when you exit TNT. If you want to keep the list, use 'logrec <filename>'.

  2. If the end of the filelist is received, use the command 'blist'. This command closes the logfile and loads it into the boxlist screen. If no file was open the last logfile on the current channel will be loaded into the boxlist screen.

  3. Use <ALT>L or <ESC>L to toggle connect and boxlist screen. In boxlist screen you can use the cursor commands to select a file. Pressing CR will send a read command to the BBS. All already fetched files will be displayed with a different attribute.

  4. If you have read all files from the filelist you can close the boxlist screen by the command 'xblist'.

Back to Index


3.10.3. Using keyboard macros

To use the boxlist feature without typing in the commands, it is advisable to use keyboard macros. For example:

<ALT>8 / <ESC>8 : 'logblist'
<ALT>9 / <ESC>9 : 'blist'
<ALT>0 / <ESC>0 : 'xblist'

These keyboard macros are already included in the sample keyboard macro file.

Back to Index


3.10.4. Recognized formats

At the moment the following list formats are recognized:

  1. DIEBOX check

    7 DL4BCU > TERMINE...16 24.09.94 DL 2214 5 2m Mobilfuchsjagd I05 08.

    -> R TERMINE 16

  2. DIEBOX list

    263 DL1ZAX 02.11.94 18:03 6763 DL-RUNDSPRUCH NR. 39/94

    -> R 263

  3. DIEBOX checklist with BID

    85 DH3FBI > KENWOOD..423 055514DB0GV DL 851 5 LF & VLF Empfang mit TS-5

    -> R KENWOOD 423

  4. RUN C with option D=CRD$@L

    DG0XC DIGI......17 28.04.95 2845DB0BALWE DL 1 DB0BRO-1 wieder ok.

    -> R DIGI 17

Back to Index


3.11. Extended monitor

The extended monitor feature allows the monitoring of specific connections on the frequency with automatic removal of headers and resent packets. There are 5 (0 to 4) different extended monitor channels available. <ALT>X or <ESC>X will switch to the extended monitor screens and TAB can be used to change the channel.

The command EXTMON is used to activate the extended monitor. If you have given the command from an extended monitor screen, the current channel will be taken. On other screens you must give the channel number as an additional parameter before specifying the callsigns. The next free extended monitor channel will be taken if the command EXTAMON is used.

As command parameters you have to specify the callsigns of the connection you want to monitor. Normally this will be 2 callsigns and both directions will be monitored (in different attributes).

Using digipeaters like NETROM/TheNet or RMNC/Flexnet a connection is build up out of 2 connections. First the connection from station 1 to the digipeater (DL9xxx <> DB0xxx) and second the connection from the digipeater to station 2 (DL9xxx-15 <> DG1xxx). In most cases you can only monitor frames sent by the digipeater. In this case you can specify 4 callsigns (DB0xxx DL9xxx DL9xxx-15 DG1xxx) and both directions of the connection will be monitored in the extended monitor screen.

If the monitored connection is huffman-coded, decoding can be activated by command
EXTCOMP.

The extended monitoring can be finished by the ENDEXTM command.

Back to Index


3.12. Use of DPBox

Back to Index


3.12.1. General description

DPBox is a daemon which is totally independent of TNT. The daemon must be activated before using any of the DPBox-commands of TNT.

Back to Index


3.12.2. Using unix socket interface

To build up the connection from TNT to DPBox the command 'actbox' must be used. If the connection shall be closed 'deactbox' must be used.

The command 'finbox' not only closes the connection like 'deactbox', it gives a termination command to the DPBox daemon.

The unix socket name of DPBox must be defined in 'box_socket' in the initfile.

Back to Index


3.12.3. Mailbox screen

If the connection to DPBox is activated, the mailbox screen (<ALT>B or <ESC>B) can be used as a sysop-console by executing the 'box' command.

You can either 'quit' or give the command 'endbox' to end your sysop- session.

All features of a normal connect screen are provided including the boxlist. In boxlist mode there is an additional feature. If you select a file and press 'e' instead of CR, the file will erased. 'k' for kill and 'l' for list are available, too. 't' generates a transfer line where you can add an new board name, '0' sets the lifetime of the message to 0.

Back to Index


3.12.4. Using DPBox via Packet Radio

DPBox can be activated on a normal connect channel by the command 'box', by the remote command //box or by connecting a channel which SSID of the callsign is equal to 'tnt_box_ssid' in the initfile.

DPBox is activated only, if the channel is connected.

The 'endbox' command, 'quit' to the box or a disconnect will terminate the box-session.

Back to Index


3.12.5. Autobox and monbox feature

If you set 'autobox' to on, all mails you will receive on any channel will be sent to DPBox and will be stored in the corresponding board. This includes personal mail and bulletins.

If you set 'monbox' to on and 'xmon' is on, all monitored frames will be searched for mail headers. If one is found, it is tried to receive the whole mail similar to the extended monitor function. If packets are lost or if any other error occurs, the mail is not accepted. If the mail was correctly received it will be sent to DPBox and will be stored in the corresponding board. All bulletins and all personal mail which contains a callsign out of 'autobox_dir' as sender or receiver will be treated in this way. All mails which will currently be received can be displayed with the 'lmonbox' command.

Back to Index


3.12.6. Unproto list handling

Unproto list handling, a feature know from F6FBB-BBS's,is now available together with DPBox 5.03.00 upwards. The BBS will send an unproto frame for every newly arrived mail. This frame contains a message number which can be used for a mail request by an user programm like TPK or TSTHOST.

If some unproto frames were lost, a listening station can request a resend of older messages. To send these requests to DPBox, you have to activate the feature using command ACCUIREQ und you have to define the BBS's callsign with command ACCUICAL. This callsign must be equal to the source-callsign of the unproto frames the BBS is sending.

All these configurations are needed to enable unproto list handling in a real BBS. The other direction, TNT handling unproto lists as a client like TPK or TSTHOST is not implemented up to now.

Back to Index


3.13. Automatic password generation

Back to Index


3.13.1. General description

In the packet radio network many different password systems are used at the moment. Therefore a configuration file 'tnt_pwfile' is provided. In this file for any callsign including SSID a password type and a file containing the password can be defined. Depending on the password type a different action is taken and the contents of the password file are different.

Up to now only few password systems are implemented in TNT, but it is planned to increase the number of supported systems. If you have added any password system, please contribute!

Back to Index


3.13.2. DIEBOX

If the password type is DIEBOX, after a connect to the specified callsign was done, every text is scanned for the string 'Login: '. If the string was found, the following date and time is recorded and the scan for the string will be stopped.

If you invoke the command 'priv', a 4 character password will be generated out of the logintime and your password file and as a result 'PRIV xxxx' will be sent (xxxx stands for generated password).

The password may contain CR and LF, CR, LF or none of both. TNT will detect this from the length of the file.

Back to Index


3.13.3. FlexNet

If the password type is FLEXNET and the connection to the wanted station is established, the command 'priv' starts the password sequence. A string containing 'SYS' is sent to the remote station which will respond with a string like '(xyz) abcde>'. An answer is calculated out of this response together with the specified password. This answer is sent to the remote station and sysop-status will be available.

Unlike the other password systems the third value in the configuration file is not the filename where the password is stored, but directly the password number.

There is some other software which uses the same password algorithm as FlexNet, but need a different activation string than SYS. In this case a fourth (optional) value can be used to define this activation string.

Back to Index


3.13.4. TheNet

If the password type is TheNet and the connection to the wanted station is established, the command 'priv' starts the password sequence. A string defined by the fifth value in the configuration file is sent to the remote station which will respond with a string like 'NODE:NO1DE: a b c d e' or simply 'a b c d e'. This response defines which characters out of the password file must be sent as an answer. This answer is generated and is sent to the remote station and sysop status will be available.

The third value in the configuration file defines the file where the password is stored.

The fourth value in the configuration file defines if some additional features shall be used. If Bit 0 is set, the password generation is done 3 times, but only one ramdomly selected time the password generation is correct. The other two 2 times a random string is sent instead of the right answer. If Bit 1 is set, the answer is hidden in a 72 character string. If Bit 2 ist set, perfect hiding is used. This means that only characters out of the password string will be used to generate the line. Alternatively you can add a second line to the password file. In this case only characters out of this line will be used.

The TheNet-type password generation is used by other software, too (for example Baycom, DigiPoint).

Back to Index


3.13.5. Baycom

The Baycom password system is almost identical to TheNet, except that no activation string is needed and right after connect you will receive the 5 random numbers.

The syntax is the same as for TheNet, except the fifth parameter (the activation string) can be omitted. The default will be SYS. Because the string is needed only if you defined a special configuration for the user profile in BayBox, it is normally not of any importance.

There is another small difference to the TheNet syntax, the option '3 tries, where only one answer is correct', is not allowed.

Back to Index


3.13.6. MD2

After connect a similar like the following string will be received:
XXXBBS> [ABCDEFGHIL]
Out of this string an answer is generated, the password algorithm used is 'RSA Data Security, Inc. MD2 Message Digest Algorithm'.

Back to Index


3.14. Huffman compression

The huffman data compression implemented in some other programs is available, too. It can be activated by the remote command //COMP or via command COMP. The compression will lead to a data reduction of about 30% for plain ASCII text. For binary files the compression is not useful.

To read a QSO in extended monitor which uses huffman compression the command EXTComp is provided.

The MONBOX feature detects huffman compression and will in most cases catch mails even if they are read in //COMP mode.

Compression is available only if tnt_comp in the configuration file is set. In this case the maximum allowed packet length (file_paclen in configuration file, command FPACLEN) for file sending is 255 Bytes.

The //comp - method was first used by DK4NB in SP 9.00, the translation table is his setup.

Back to Index


3.15. Handling Flexnet connection quality checks

The Flexnet digipeater protocol uses connects to determine the connection quality and availability. These connects leads to unnecessary activation of connect-texts, DPBox or other programs connected at the interface. In addition the logbook will be flooded with these connections.

So TNT provides a file where the callsigns of Flexnet-digipeaters performing these connection quality checks can be stored (tnt_flchkfile). If a callsign found in this file is connecting, it will get no connect-text, no remote- access and no connection via interface will be started. The logbook will not contain this connection.

The contents of this file can be displayed by command LSTFLCHK. When the file was updated, it can be reread using command LDFLCHK.

Back to Index


3.16. Operating different software with same callsign

If you want to operate different software with the same callsign, you want to define what SSID's of your call TNT must not use. This can be done in the file defined by 'tnt_notownfile'. Calls contained in this file will not be used for connecting using routing scripts.

The contents of this file can be displayed by command LSNOTOWN. When the file was updated, it can be reread using command LDNOTOWN.

Back to Index


3.17. PACSAT broadcast operation

TNT includes a PACSAT broadcast compatible receiver and transmitter. The code is mainly based on the pascal source code written by Joachim, DL8HBS.

The receiver is enabled by setting DECBCAST to ON. All files received in frames in PACSAT broadcast protocol will be decoded. Depending on the type of the file, a complete file will be stored in 'tnt_bcsavedir' (normal files) or will be sent to DPBox (BBS-files).

If parts of the received file are missing and the broadcast-transmitter allows it by a not permanent transmission, the missing parts can be requested. This is enabled by setting BCRQST to ON.

The status of the broadcast receiver can be displayed by BCRXSTAT. All files successfully received or currently in receiption will be displayed. Some statistical information shows the progress.

The broadcast transmitter is controlled either by DPBox to do a broadcast of BBS-files. More information can be found in the DPBox-documentation. In addition a broadcast transmission of normal files (command SENDBC) is possible, too.

The status of the broadcast transmitter can be displayed by BCTXSTAT. All files currently transmitted are listed including some statistical information.

As the TheFirmware and WA8DED-software does not allow to change the PID used for transmitted frames, the broadcast transmission will be sent using PID F0. This can lead to problems using other software (WISP) as a receiver. TFKISS and a special version of TheFirmware (ask me or DL8HBS for it) allows the change of the PID and therefore the correct broadcast transmission according to the protocol.

Back to Index


3.18. Autostart on connect

There are many possibilities in TNT (RUN, SOCKET) to allow a remote user to use other software on the system. But to start these applications you first have to give a special command when connected to TNT.

To make these application easily accessible and to hide that TNT is doing the work, you can define for specific callsign/SSID combinations an autostart command. This command, which contains any valid remote command plus parameters, will be executed, when the callsign/SSID combination will be connected.

The autostart-feature must be enabled using command AUTOSTRT, by default autostart is disabled.

To be able to connect the callsign/SSID combination, you have to define one or more channels of your TNC to use this callsign (use MYCALL in tnt.up).

The callsign/SSID combinations and the autostart commands are defined in 'tnt_autostartfile'. The actual data can be displayed using LSAUTOST, if the file was changed, it can be reread using LDAUTOST.

Back to Index


3.19. TNT as daemon, TNTC

Normally, TNT will use a console for the user interface. But there are some cases where this is not wanted or needed:
- TNT user interface needed on different host
- changing between X and terminalmode without terminating TNT
- no user interface needed

Therefore TNT can be started as a daemon using the command line parameter '-d' on startup. TNT then accepts socket connect requests on the socket address specified after 'frontend_socket' in tnt.ini. This socket address can have different formats (equal to the definition for socket servers):

  1. UNIX-sockets
    The format for a UNIX-socket is 'unix:<socket path>' or 'local:<socket path>'. The path can be an absolute path beginning with a '/' or a relative path to 'tnt_dir'.
    Example:
    unix:tntsock
    unix:/tcp/sockets/convers
    

  2. INET-sockets
    The format for a INET-socket is 'ip-address:port'. ip-address can be a hostname, an ip-address or a '*' for any ip-address. Port can be any valid port number or a name for a service.
    Example:
    *:3600
    199.199.10.10:ftp
    foo.bar.com:2000
    

To connect TNT, a remote console program is available: TNTC. It uses its own configuration file tntc.ini, where the home directory and the socket to connect is stored. At start TNTC sends the terminal type (environment entry TERM) and the lines and columns of the display to TNT. Except for the number of columns which are fixed to the value specified after 'input_linelen' in tnt.ini, these values are taken to provide correct screen positioning and attributing.

TNTC can be finished without terminating TNT by giving command QUIT. With EXIT both TNT and TNTC will be terminated.

Back to Index


4. Description of configuration files


4.1. Main configuration file

The configuration of the program is done by the main configuration file. This file called 'tnt.ini' is searched at the current directory or at the home directory of the user (other filenames can be specified by using the -i option at startup).

sample tnt.ini:

# defines if select() shall be used, normally 1, put to 0, if you are
# using old kernels (select() produces there a higher CPU-load).
use_select 1

# --------------------------------------------------------------------------

# 0 for real TNC at serial port, 1 for TFKISS on a UNIX-socket,
# 2 for TFKISS on other socket
soft_tnc 0

# serial port to which TNC is connected, UNIX-socket of TFKISS or
# other socket for TFKISS
device /dev/cua0

# lockfile for serial port or TFKISS
tnt_lockfile /usr/spool/uucp/LCK..cua0

# baudrate used, only used if TNC at serial port
speed 19200

# timinig parameters for interface to tfkiss (soft_tnc is 1)
# 1: fixed wait (10ms) after each hostmode-packet sent to tfkiss
fixed_wait 1
# if fixed_wait == 0, number of sent characters to tfkiss after which
# tnt will wait 10ms 
amount_wait 20

# --------------------------------------------------------------------------

# number of channels of TNC
tnc_channels 10

# first channel with reduced backscroll buffer
r_channels 4

# --------------------------------------------------------------------------

# enable static huffman compression (//COMP)
tnt_comp 1

# packet length for transmission of files
file_paclen 255

# set to 1 to disconnect all channels on startup
disc_on_start 0

# --------------------------------------------------------------------------

# UNIX-user for remote permissions
remote_user guest

# If set to 1, new users will be created, if set to 0, all new users will
# be logged in as user defined by 'remote_user'.
unix_new_user 1

# lowest user-id for creation of new users
unix_first_uid 410

# group-id for new users
unix_user_gid 101

# --------------------------------------------------------------------------

# timeout packet assembly (in seconds) for SHELL/REDIR and interface
pty_timeout 2

# --------------------------------------------------------------------------

# set to 1 for request of R:-headers in boxlist read command
blist_add_plus 0

# --------------------------------------------------------------------------

# SSID of DPBox (A channel with this SSID must exist in TNC!)
tnt_box_ssid 7

# Call and SSID of DPBox (A channel with this Call and SSID
# must exist in TNC!)
# (If this parameter is used, 'tnt_box_ssid' will be ignored)
#tnt_box_call

# SSID of a node connect (not yet ready)
tnt_node_ssid 9

# Call and SSID of a node connect (not yet ready)
#tnt_node_call

# --------------------------------------------------------------------------

# main directory
tnt_dir /work/tnt/
# remote directory
remote_dir remote/
# ctext directory
ctext_dir ctext/
# directory for corrupt autobin-files
abin_dir abin/
# directory for uploads
upload_dir up/
# directory for downloads
download_dir down/
# directory for 7plus
tnt_7plus_dir 7plus/
# directory for YAPP
yapp_dir yapp/
# directory for executable programs
run_dir bin/
# home-dir for new users
unix_user_dir tntusers/
# dir for macro-texts
macrotext_dir macro/
# dir for box-broadcastfiles
tnt_bcnewmaildir bcast/newmail/
# dir for broadcastfiles
tnt_bcsavedir bcast/save/
# dir for temporary broadcastfiles
tnt_bctempdir /tmp/

# upfile
tnt_upfile tnt.up
# downfile
tnt_downfile tnt.dwn
# file containing process id
proc_file tnt.pid
# remote infofile
rem_info_file tntrem.inf
# remote helpfile
rem_help_file tntrem.hlp
# tnthelpfile
tnt_help_file tnt.hlp
# cookiefile
tnt_cookiefile /usr/games/fortunes/startrek
# namesfile
name_file_name names.tnt
# routesfile
route_file_name routes.tnt
# newsfile
news_file_name news.tnt
# connect text
tnt_ctextfile ctext.tnt
# logbook file
tnt_logbookfile log.tnt
# password file
tnt_pwfile pw.tnt
# sysop access files
tnt_sysfile sys.tnt
# calls with remote disabled
tnt_noremfile norem.tnt
# calls which do flexnet-linkquality-check
tnt_flchkfile flchk.tnt
# own call/SSID not allowed for xconnect
tnt_notownfile notown.tnt
# resync logfile
resy_log_file resy.log
# broadcast logfile
bcast_log_file bcast.log
# socket passwordfile
sock_passfile netpass.tnt
# file for keyboard macros
func_key_file fkeys.tnt
# file for extended remote commands
tnt_extremotefile extrem.tnt
# file for autostart on connect
tnt_autostartfile autostrt.tnt

# socket for digipoint box
box_socket /work/box/stat/socket
# directory for newmail
newmaildir newmail/
# file holding monitored folders
autobox_dir autobox.dir
# file for boxfile endings
tnt_boxender boxender.tnt
# file for f6fbb-definitions
f6fbb_box /work/box/system/f6fbb.box

# socket for tntnode (not yet ready)
node_socket /work/tntnode/socket

# socket for frontend
frontend_socket unix:tntsock

# --------------------------------------------------------------------------

# maximum length of input line
input_linelen 80

# set to 1 if insertmode shall be active after startup
insertmode 0

# maximum number of entries in heardlist
num_heardentries 100

# number of lines for backscroll

# command-screen
lines_command 50
# monitor-screen
lines_monitor 400

# input area of connect-screens
lines_input 20
# output area of connect-screens
lines_output 100
# input area of connect-screens (reduced backscroll)
lines_r_input 5
# output area of connect-screens (reduced backscroll)
lines_r_output 20
# input/output-lines ratio on real screen (connect)
scr_divide 5
# monitor lines on connect-screens
lines_moncon 0

# input area of mailbox-screen
lines_mbinput 10
# output area of mailbox-screen
lines_mboutput 200
# input/output-lines ratio on real screen (mailbox)
mbscr_divide 8

# input area of extended monitor screens
lines_xmon_pre 10
# output area of extended monitor screens
lines_xmon 100
# input/output-lines ratio on real screen (extended monitor)
xmon_scr_divide 5

# --------------------------------------------------------------------------

# 0: monochrom, 1: use color attributes if TERM = 'linux' or 'conXXX',
# otherwise use monochrom attributes and termcap, 2: use color attributes,
# 3: use color attributes and termcap if TERM = 'xterm'
color 1

# 0: don't use termcap, 1: use termcap
termcap 0

# 1: alternative channel status line
altstat 0

# --------------------------------------------------------------------------

# attributes for color

# normal characters
attc_normal 0x07
# characters in bottom statusline
attc_statline 0x10
# characters in monitor-headers
attc_monitor 0x06
# characters in channel statusline
attc_cstatline 0x1F
# control-characters
attc_controlchar 0x0F
# remote-answers
attc_remote 0x06
# special features
attc_special 0x01

# --------------------------------------------------------------------------

# attributes for monochrom

# normal characters
attm_normal 0x00
# characters in bottom statusline
attm_statline 0x08
# characters in monitor-headers
attm_monitor 0x10
# characters in channel statusline
attm_cstatline 0x10
# control-characters
attm_controlchar 0x10
# remote-answers and own transmitted text
attm_remote 0x10
# special features
attm_special 0x10

# --------------------------------------------------------------------------

# these values must remain unchanged using LINUX

# 1: terminal puts cursor to a new line after character in last column
auto_newline 0

# 1: don't display characters 128-160
supp_hicntl 0

# --------------------------------------------------------------------------
<EOF>

Back to Index


4.1.1. Serial and general configuration

'use_select'
Defines if select() shall be used, normally 1, put to 0, if you are using old kernels (select() produces there a higher CPU-load)

'soft_tnc'
Defines if a real TNC (0) is connected or TFKISS (1,2).

'device'
Device, to which the TNC is connected, must be specified. If TFKISS is used and soft_tnc is 1, device must contain the path and filename of the UNIX-socket. If soft_tnc is 2, device must contain a general socket description like explained in the Detailled description of the socket servers.

'speed'
Baudrate of the serial port, only used if configured for a real TNC

'tnt_lockfile'
Filename to lock the port. Shall follow the usual conventions: for device /dev/cua0 specify the lockfile /usr/spool/uucp/LCK..cua0. For TFKISS use a pseudo-lockfile like /usr/spool/uucp/tfkiss or similar.

'fixed_wait'
Only valid if TFKISS is used: Normally set to 1, which means a fixed wait of 10ms after each hostmode-packet sent to TFKISS. If 0, 'amount_wait' defines the waiting.

'amount_wait'
Only valid if TFKISS is used and 'fixed_wait' set to 0: Number of characters sent to TFKISS after which TNT will wait 10ms (can be used to optimize the timing).

'tnc_channels'
Number of channels of TNC.

'r_channels'
First channel with reduced backscroll buffer.

'tnt_comp'
If not 0, static huffman compression is activated. In this case the maximum file packet length ('file_paclen') is 255 characters.

'file_paclen'
Defines the maximum length of a packet. Valid values are 20 up to 256 characters. If huffman compression is activated ('tnt_comp'), the maxmimum value is 255 characters. The value can be changed by command FPACLEN.

'disc_on_start'
If 1, all established connection are disconnected on startup of TNT, if 0, connections remain active.

'blist_add_plus'
If not set to 0, a '+' is appended to the boxlist read command. As a result the mail will contain full R: lines.

'tnt_box_ssid'
If the SSID of the own call on the current channel is equal to this SSID, DPBox is started on connect.

'tnt_box_call'
If the own call (plus SSID) on the current channel is equal to this call (plus SSID), DPBox is started on connect. This parameter will override 'tnt_box_ssid'. It can be used, if different callsigns with the same SSID shall be used and DPBox shall be activated only for one of the calls.

'tnt_node_ssid'
If the SSID of the own call on the current channel is equal to this ssid, TNTNODE is started on connect. (function currently under development).

'tnt_node_call'
If the own call on the current channel is equal to this call, TNTNODE is started on connect. This parameter will override 'tnt_node_ssid'. It can be used, if different callsigns with the same SSID shall be used and TNTNODE shall be activated only for one of the calls. (function currently under development).

Back to Index


4.1.2. Security

'remote_user'
User-Id for remote access.

If TNT was started by root, prior to every remote file command the user-id is changed to restrict the file permissions of the remote user. If TNT was started by a normal user, the user-id is not changed. Therefore a remote user has the same file permissions as the user himself.

'unix_new_user'
1: A new user gets an entry in /etc/passwd and a directory is created.
0: A new user is logging in as specified in 'remote_user'.

'unix_first_uid'
First user-ID which will be taken for new users.

'unix_user_gid'
Group-ID used for new users.

Back to Index


4.1.3. Directories, Files and Sockets

The directory 'tnt_dir' must always contain the complete path. For all other files and directories it depends on the first character of the path. If the first character is a '/', then the path is taken as the complete path. If the first character is not '/', 'tnt_dir' is put in front of the path.

Back to Index

4.1.3.1. Directories

'tnt_dir'
Directory which contains tnt-files

'remote_dir'
Directory used for remote access

'ctext_dir'
Directory used for personal connect texts

'abin_dir'
Directory for files of unsuccessful AutoBIN-transfers

'upload_dir'
Directory for sending files (SEND/SENDLOG/...) if no directory was specified.

'download_dir'
Directory for receiving files (READ/LOGQSO/...) if no directory was specified.

'yapp_dir'
Directory for receiving files using AUTOYAPP.

'tnt_7plus_dir'
Directory for receiving files using AUTO7PL.

'run_dir'
Directory for executable programs (//RUN).

'unix_user_dir'
Root-directory for directories of new users.

'macrotext_dir'
Directory for files containing text-macros (MSEND)

'tnt_bcnewmaildir'
Directory where received broadcast-files of type BBS will be stored.

'tnt_bcsavedir'
Directory where other received broadcast-files will be stored.

'tnt_bctempdir'
Directory for temporary files generated by broadcast receiver.

'newmaildir'
Directory where mails read by AUTOBOX and MONBOX are stored for DPBox

Back to Index

4.1.3.2. Files

'tnt_upfile'
Command script executed at startup of program

'tnt_downfile'
Command script executed before exit of program

'proc_file'
File which will contain the process ID of the running TNT process

'rem_info_file'
File transmitted if remote command //info is received

'rem_help_file'
File transmitted if remote command //help is received

'tnt_help_file'
File which is displayed if help screen is selected

'tnt_cookiefile'
File which contains database for fortune cookies

'name_file_name'
File for names database

'route_file_name'
File for routing database

'news_file_name'
File for news message, transmitted if //news is received or if %i macro is found in a connect text file

'tnt_ctextfile'
File containing common connect text

'tnt_logbookfile'
File for logbook

'tnt_pwfile'
File for generation of passwords

'tnt_sysfile'
File for access restriction and sysop authentification

'tnt_noremfile'
File containing calls for which remote-commands are disabled

'tnt_flchkfile'
File containing calls which do flexnet-linkquality-check

'tnt_notownfile'
File containing call plus SSID which are not allowed for xconnect

'resy_log_file'
Logfile if a resync occured

'bcast_log_file'
Logfile for errors/warnings from broadcast receiver/transmitter

'sock_passfile'
Socket login database

'func_key_file'
Definition of keyboard macros

'tnt_extremotefile'
File defining extended remote commands

'tnt_autostartfile'
File defining autostart commands executed on connect

Back to Index

4.1.3.3. Sockets and Boxfiles

'box_socket'
Path and name of the UNIX-socket used for connection to DPBox.

'autobox_dir'
File containing boards which shall be monitored using MONBOX-feature.

'tnt_boxender'
File containing strings indicating end or abort of message (MONBOX and AUTOBOX).

'f6fbb_box'
File containing strings which are used by the F6FBB-Box you are using. This file is used by DPBox, too and shall be placed in the DPBox-system-directory. A correct definition is needed for the AUTOBOX-feature.

'node_socket'
Path and name of the UNIX-socket used for connection to TNTNODE (currently under development).

'frontend_socket'
Name of the socket used by frontend TNTC if TNT is started as a daemon. The syntax is identical to the socket definition in the detailled description of the socket servers.

Back to Index


4.1.4. Lines of virtual screens

'input_linelen'
Maximum length of input line at which additional characters are ignored or wordwrap is executed. The value can be changed with command LINelen.

'insertmode'
Set to 1 if insertmode shall be active on all screens after startup.

'num_heardentries'
Number of entries in heardlist.

'lines_command'
Number of lines of the command screen.

'lines_monitor'
Number of lines of the monitor screen.

'lines_input'
Number of lines of the input part of the connect screen.

'lines_output'
Number of lines of the output part of the connect screen.

'lines_r_input'
Number of lines of the input part of the connect screen (reduced backscroll buffer).

'lines_r_output'
Number of lines of the output part of the connect screen (reduced backscroll buffer).

'scr_divide'
Input/output-lines ratio on real screen (connect). The value can be changed with command CONDiv. Example: Real screen has 25 Lines, scr_divide is 5. 25 Lines - 2 Statuslines = 23 lines for input/output. 23 / 5 = 4.6 -> 4 lines on input. 23 - 4 = 19 lines for output.

'lines_moncon'
Number of lines of monitor screen additionally displayed on the connect screen. Set to 0, if no monitor lines shall be displayed. The value can be changed with command MONLines (The lines of the real screen will be reduced by the number of monitor lines, before the lines of input and output part will be calculated using scr_divide)

'lines_mbinput'
Number of lines of the input part of the mailbox screen.

'lines_mboutput'
Number of lines of the output part of the mailbox screen.

'mbscr_divide'
Input/output-lines ratio on real screen (mailbox). The value can be changed with command MBOXDiv.

'lines_xmon'
Number of lines of the output part of the extended monitor screen.

'lines_xmon_pre'
Number of lines of the input part of the extended monitor screen.

'xmon_scr_divide'
Input/output-lines ratio on real screen (extended monitor screen). The value can be changed with command XMONDiv.

Back to Index


4.1.5. Display configuration

'color'
non color attributes (0), color attributes if LINUX- console (1) or color attributes always (2)
'termcap'
use LINUX-console control codes (0) or /etc/termcap (1)

'altstat'
Set to 1 if you want to use the alternative statusline on connect-screens.

if color == 1 and LINUX-console control codes are selected, but the TERM entry in the environment is not "con..." or "linux", no color and termcap is used.

Back to Index


4.1.6. Screen attributes

Depending on the selected mode (color) the color or monochrom attributes are used. Important notice: The attributes for normal text and for controlcharcters in the input field MUST be different, otherwise no control-characters can be sent.

Back to Index

4.1.6.1. Color attributes

'attc_normal'
For normal text.

'attc_statline'
For main statusline at the bottom of the screen.

'attc_monitor'
For monitor headers.

'attc_cstatline'
For statusline of channel in connect screen.

'attc_controlchar'
For controlcharacters in the input field.

'attc_remote'
For text transmitted because of remote functions.

'attc_special'
For special features.

The attributes are coded in the following manner:

    X    X    X    X    X    X    X    X
  Blink BCo2 BCo1 BCo0 FCo3 FCo2 FCo1 FCo0
          Background-      Foreground-
            Colour           Colour

Blink:
0:off, 1:on

Background Color:
        BCo2 BCo1 BCo0 
Black     0    0    0
Red       0    0    1
Green     0    1    0
orange    0    1    1
blue      1    0    0
magenta   1    0    1
cyan      1    1    0
white     1    1    1

Foreground Color:
              FCo3 FCo2 FCo1 FCo0 
Black           0    0    0    0
Red             0    0    0    1
Green           0    0    1    0
Orange          0    0    1    1
Blue            0    1    0    0
Magenta         0    1    0    1
Cyan            0    1    1    0
White           0    1    1    1
Grey            1    0    0    0
Light red       1    0    0    1
Light green     1    0    1    0
yellow          1    0    1    1
Light blue      1    1    0    0
Light magenta   1    1    0    1
Light cyan      1    1    1    0
Light white     1    1    1    1

Back to Index

4.1.6.2. Monochrom attributes

'attm_normal'
For normal text.

'attm_statline'
For main statusline at the bottom of the screen.

'attm_monitor'
For monitor headers.

'attm_cstatline'
For statusline of channel in connect screen.

'attm_controlchar'
For controlcharacters in the input field.

'attm_remote'
For text transmitted because of remote functions.

'attm_special'
For special features.

The attributes are coded in the following manner:

    X    X    X    X    X    X    X    X
             Att5 Att4 Att3 Att2 Att1 Att0

Att0: Standout    (termcap so/se)
Att1: Underline   (termcap us/ue)
Att2: Blink       (termcap mb/me)
Att3: Reverse     (termcap mr/me)
Att4: Bold        (termcap md/me)
Att5: Halfbright  (termcap mh/me)

0: off, 1: on

Back to Index


4.1.7. Packet assembly timeout

'pty_timeout'
Time for packet assembly

All characters received by a shell or redirection are buffered. If the buffer reaches the maximum packetsize (256 bytes) the buffer is transmitted. After each new character pty_timeout seconds are waited for the next character. If during this time no character is given, the buffer will be sent even if the maximum packetsize is not reached.

Back to Index


4.1.8. Additional options

The following switches are available to customize TNT to a different terminal or operating system. For use with linux, both must be set to 0.

'auto_newline'
Set to 1 if terminal performs a newline after last character in a line

'supp_hicntl'
Set to 1 if characters in range 128-160 shall be substituted by a period (.)

Back to Index


4.2. TNC-configuration files

At the startup of the program a command script is executed. It can be used to initialize some parameters in the TNC. The filename must be specified after 'tnt_upfile' in the init file.

To set up different callsigns on specific channels the following command sequence can be used:

...
CHANNEL 4
MYCALL DL4YBG-4
CHANNEL 5
MYCALL DL4YBG-5
CHANNEL 6
MYCALL DL4YBG-6
...

After the EXIT command is given another command script is executed before the termination of the program. The filename must be specified after 'tnt_downfile' in the init file.

Back to Index


4.3. Cookie file

If fortune cookie sending is active (command COOKIE) and someone is connecting to the station a randomly selected cookie out of the cookie file will be sent.

The cookie file consists of cookie texts delimited by a line containg a '-' or a '%' as the first character (the rest of the line will be ignored). The minimal size of a cookie file is 2048 bytes.

The data files contained in the 'fortunes' package in most Linux-distributions can be used.

The filename of the cookie file must be given after 'tnt_cookiefile' in the init file.

Back to Index


4.4. Files for remote commands

If the remote command //help is received a file specified after 'rem_help_file' in the init file is transmitted. The file shall contain an overview and an explanation of the possible remote commands.

If the remote command //info is received a file specified after 'rem_info_file' in the init file is transmitted. The file shall contain a description of the station and the used equipment.

If the remote command //news is received a file specified after 'news_file_name' in the init file is transmitted. The file shall contain any news about the station.

Back to Index


4.5. Files for connect text

If connect text sending is active (command CONTEXT) and someone is connecting to the station a special connect text will be sent. The connect text is fetched from the file specified after 'tnt_ctextfile'. Any macros contained in the file will be expanded. It is possible to send several users a personal connect text. To achieve this a file called <callsign>.ctx must be put to the directory specified after 'ctext_dir', where <callsign> is the call of the user.

Back to Index


4.6. Files for names database and routing scripts

Back to Index


4.6.1. Names database

For use with the connect text feature a names database is included. The database itself is contained in the file specified after 'name_file_name'.

All entries in the names database use the following format: T>DL4YBG Mark

If the command NAME or the remote command //NAME is used to update a name, the names database file will be updated.

Back to Index


4.6.2. Routing database

For routing scripts the routing database is contained in a file with a similar layout like the names database. The filename of the routing database is specified after 'route_file_name'.

Unlike the names database file, the routing database is not updated by tnt, any updates must be done with an text editor.

The entries for routing scripts can be recursive, it is not needed to specify the whole path for each callsign. The path is assembled using the relevant entries in the database.

If you frequently change the frequency and the uplink digipeater, you may want to specify for every frequency a different routing database. Therefore <IF xxxxxx> and <END> is included. If for example you operate on 438.300 Mhz, you can specify all routing information valid only on this frequency by:

<IF 438.300>
...
<END>

All routing information which is not surrounded by <IF xxxxxx> and <END> is valid on all frequencies. The frequency you are operating on can be specified using the command QRG.

The format of each database entry is as follows:

In front of the callsign a letter specifies the type of the station:

T : Normal user
N : Network node
All other characters are accepted. The only difference is the treatment of the call in routing scripts.

The database is a text file containing lines like the following:

T>DL4YBG Mark
-> The name of the operator of station DL4YBG is Mark, no routing information given or station can be reached directly.

T>DL7ZZZ Joe; N>DB0LUC T>DL7ZZZ
-> The name of the operator of station DL7ZZZ is Joe, the station can be connected from digipeater DB0LUC.

N>DB0BLO Digi 9K6
-> The digipeater DB0BLO can be connected directly.

N>DB0BER Digi Tempelhof; N>DB0BLO N>DB0BER
-> The digipeater DB0BER can be connected from digipeater DB0BLO.

N>DB0LUC Digi Luckau; N>DB0BER F>DB0BLN N>DB0LUC
-> The digipeater DB0LUC can be connected from digipeater DB0BER via DB0BLN.

Back to Index


4.7. User-Id's and security

For every user it is possible to log into the UNIX-system by using //SHELL or if the operator uses the SHELL command for the channel. The callsign of the connected station is used as the user-id. If there is no user-id existing with this call sign and 'unix_new_user' is not set, the user-id "guest" is used. Because at the moment there is no security for the password, no passwords are used. If you don't use 'unix_new_user' you must prepare the user-id's of the authorized users yourself. Therefore the entries in /etc/passwd shall look like:

guest::407:109::/home/guest:
dl4ybg::405:101::/home/dl4ybg:

These user-id's must not appear in /etc/shadow (only if shadow passwords are used).

Hint:
The user guest can be created using 'useradd -m guest', then /etc/passwd must be adapted and the password-entry in /etc/shadow (only if shadow passwords are used) must be erased. Try a login from a virtual terminal prior to logging in via remote command.

IMPORTANT:
Check the file permissions on your system and use a password for root, now you are not alone any longer!

Back to Index


4.8. Logfile for resynchronisation

If during operation a resynchronisation is frequently started, it might be useful to track down the reason for it. This can be achieved by specifying 'resy_log_file' in the init-file. The full path to the file must be given. If left blank no resync log file is written. Have a look at the size of the resync file, it is advisable to remove it from time to time to regain disc space.

Back to Index


4.9. File for keyboard macros

sample fkeys.tnt:

#
# Function-Key-File
#
# XX:text
# XX::command
#
# '*' at end sends CR after a text
#
01::send .signature
02:***end*
03::c db0abc
04::c db0zzz-8
08::logblist
09::blist
10::xblist
<EOF> 

Back to Index


4.10. File for password generation

sample pw.tnt:

# sample password file
# all lines must use the following format:
# DIEBOX:
# <callsign> <password-type> <password-file>
# FLEXNET:
# <callsign> <password-type> <secret-number> [priv-string]
# THENET:
# <callsign> <password-type> <password-file> <flags> <priv-string>
# BAYCOM:
# <callsign> <password-type> <password-file> <flags> [priv-string]
# MD2:
# <callsign> <password-type> <password-file>
#
# DieBox DB0XXX
DB0XXX-3 DIEBOX /work/tnt/db0xxx_3.pw
# FlexNet DB0YYY
DB0YYY FLEXNET 02345
# FlexNet DB0YYZ-8 with different activation string
DB0YYZ-8 FLEXNET 02345 /SYSop
# TheNet DB0ZZZ
DB0ZZZ THENET /work/tnt/db0zzz.pw 0 SYS
# TheNet DB0ZZA-2 with 3 tries
DB0ZZA-2 THENET /work/tnt/db0zza_2.pw 1 SYS
# TheNet DB0ZZB with password hiding
DB0ZZB THENET /work/tnt/db0zzb.pw 2 SYS
# TheNet DB0ZZC-15 with password hiding and 3 tries
DB0ZZC-15 THENET /work/tnt/db0zzc_15.pw 3 SYS
# TheNet DB0ZZB-1 with perfect password hiding
DB0ZZB-1 THENET /work/tnt/db0zzb_1.pw 6 SYS
# TheNet DB0ZZC-14 with perfect password hiding and 3 tries
DB0ZZC-14 THENET /work/tnt/db0zzc_14.pw 7 SYS
# Baycom DB0ZZE-5
DB0ZZE-5 BAYCOM /work/tnt/db0zze_5.pw 0
# Baycom DB0ZZD with password hiding and different activation string
DB0ZZD BAYCOM /work/tnt/db0zzd.pw 2 SYS
# Baycom DB0ZZD-1 with perfect password hiding and different activation string
DB0ZZD-1 BAYCOM /work/tnt/db0zzd_1.pw 6 SYS
# MD2 password for DB0ZZF
DB0ZZF MD2 /work/tnt/db0zzf.pw
<EOF>

Back to Index


4.11. File for sysop authentification

sample sys.tnt:

# sample access restriction and sysop authentification file
# format:
# <callsign> <password-file> <sysop-level>
#
# DL7ZZZ with root access
DL7ZZZ /work/tnt/dl7zzz.pw 1
# DL7ZZY with no root access
DL7ZZY /work/tnt/dl7zzy.pw 0
<EOF>

Back to Index


4.12. File for remote commands disabling

sample norem.tnt:

# sample file for remote commands disabling
# format:
# <callsign with SSID>
#
DB0GR
DB0BLO-8
DB0JES-3
DB0TEM-8
<EOF>

Back to Index


4.13. File containing not own callsigns

sample notown.tnt:

# sample file for call/SSID-combinations which are not allowed as
# source callsign for xconnects
# format:
# <callsign with SSID>
#
DL4YBG
DL4YBG-7
<EOF>

Back to Index


4.14. File containing Flexnet digipeaters

sample flchk.tnt:

# sample file for ignoring Flexnet connection quality checks
# format:
# <callsign with SSID>
#
DB0BNO
DB0BLN
<EOF>

Back to Index


4.15. File for AX25-server access

sample netpass.tnt:

# netpass.tnt - file
# Syntax is:
# CALL PASSWORD AUTOCONNECT-CALL LEVEL
#
# Examples
#
# Next line sets user/pass=dl7zzz/geheim, no default connect, level=9
dl7zzz geheim none 9
#
# Next line sets user/pass=dl7zzy/secret, autoconnects
# to DB0ZZZ-8 always, and he has command-access-level=3
# This autoconnect-callsign means that dl7zzy CAN'T connect
# any other station than DB0ZZZ-8 ! - Excluding if he has level=9 !
dl7zzy secret DB0ZZZ-8 3
<EOF>

Back to Index


4.16. File for autostart on connect

sample autostrt.tnt:

# sample autostart file
# format:
# <callsign+SSID> <tnt command>
#
# connect dl4ybg-5 -> start convers user-client
dl4ybg-5 convers
# connect dl4ybg-12 -> get a channel status
dl4ybg-12 cs
# connect dl4ybg-13 -> get a unix shell
dl4ybg-13 shell
# connect dl4ybg-14 -> connect to convers-server
dl4ybg-14 socket unix:/tcp/sockets/convers
<EOF>

Back to Index


4.17. File for extended remote commands

sample extrem.tnt:

# sample file for extended remote commands
# format:
# <remote command> <access level> <significant chars> <tnt command>
#
# //SCONvers : connect convers (Unix-)socket
sconvers 0 4 socket unix:/tcp/sockets/convers
# //AXSERv : connect local ax25 server on port 2001 (only for sysop)
axserv 1 5 socket localhost:2001
<EOF>

Back to Index


4.18. Files for BBS features

sample boxender.tnt:

#
# additional strings to detect the end of a mailbox-message
#
# format: 'xy string'
# x: 1 = message complete, 2 = message aborted
# y: value from 1 to 4 (up to 4 strings) 
#
# one prompt of baycom-box
11 Help Dir Read Erase Check REPly Send Alter Quit
# prompt of diebox, if message read cancelled
21 (H)elp (C)heck (L)ist (R)ead (S)end (E)rase (D)ir (U)sage (Q)uit
# flexnet-reconnect
22 *** reconnected to
<EOF>

sample f6fbb.box:

#
# Definition of F6FBB-Fileheaders for the MonitorCut-Feature of DP
# YOU WILL HAVE TO ALTER THESE SETTINGS!
# BUT: NEVER CHANGE THE ORDER OF THE DEFINITIONS!
# Unfortunately, the f6fbb-soft has two basic types of fileheaders
# The first one consists of 5 lines, the second (and newer one) of 7.
# Additionally those headers exist in many different lingual versions.
# Therefore you are obliged to setup this file for your personal use...
#
# If the Header Format of your local F6FBB doesn't match to these,
# please write me a msg.
#
# THE '#' STARTS A COMMENT LINE... THE FIRST FOUR UNCOMMENTED LINES
# ARE KEPT AS THE KEYWORDS, THE FOLLOWING 12 UNCOMMENTED LINES ARE
# THE MONTH IDENTIFIERS AS USED IN YOUR LOCAL F6FBB-BOX
#
#
# An old-style (and dutch language) fbb-header may look like this:
#
# Van : DC6OQ  voor IBM   @DL      
# Type/Status : B$
# Datum/tijd  : 21-Mrt 13:55
# Bericht #   : 72618 
# Titel       : hilfe aastor
#
# Now the definitions:
#
# first word in header (all signs until the senders callsign):
Van :
# third word in header
voor
#
#
# A new-style (and german language) fbb-header may look like this:
#
# Von        : DG8NBR
# Nach       : YAESU @EU      
# Typ/Status : B$
# Datum      : 18-Jun 06:44
# BID/MID    : 17630BDB0BOX
# Meldung #  : 85385
# Titel      : info > FT 530
#
# Now the definitions:
#
# Denotator in first line:
#Von        : 
# Denotator in second line:
#Nach       : 
#
#
#
# A new-style (and german language) fbb-header may look like this:
#
#Von         : DG1RFG
#An          : WINGT@DL
#Typ/Status  : BF
#Datum/Zeit  : 28-Apr 08:26
#BID (MID)   : DQKBUMDB0BLO
#Msg #       : 457242
#Titel       : TNX ! WinGT und Passwort wer...
#
# Now the definitions:
#
# Denotator in first line:
Von         : 
# Denotator in second line:
An          : 
#
#
#
# month identifiers as used in your local f6fbb-bbs:
# (they depend on the selected language, too)
#
Jan
Feb
Mar
Apr
Mai
Jun
Jul
Aug
Sep
Okt
Nov
Dez

<EOF>

Back to Index


4.19. Configuration file for TNTC

sample tntc.ini:

# main directory
tntc_dir /work/tnt/
# socket for frontend
frontend_socket unix:tntsock
<EOF>

Back to Index


5. Additional Information


5.1. Options at startup

Usage : tnt [-i <init-file>] [-l <log-file>] [-u] [-d]

TNT has four startup options. A file after -i is taken as the init file and a file after -l is opened on channel 1 equal to a LOGREC command. The -l option is useful if the TNC holds data from the time without a terminal. If the program was not normally ended and the serial port is locked, the lockfile can be ignored with -u. If TNT shall be started as a daemon without terminal the paramter -d must be specified. A connection to TNT can be established with TNTC.

Usage : tntc [-i <init-file>] [-s <tnt-socket>]

TNTC has two startup options. A file after -i is taken as the init file. A socket specified after -s will be used instead of the 'frontend_socket' defined in tntc.ini.

Back to Index


5.2. Running under X11

TNT needs a XTERM or RXVT console for execution under X11. Therefore TNT can be started from every XTERM or RXVT shell. As XTERM does not allow the use of the <ALT> keysequences, I suggest the usage of RXVT, which will provide the same handling as a linux-console. A sample script file 'xtnt' can be used to create a new window for TNT. To change the parameters in 'xtnt' see the manual entry for RXVT.

Back to Index


5.3. Porting of TNT

In config.h several options can be defined or undefined. Create a new entry in config.h and a new makefile for your operating system. At the moment Linux and Interactive UNIX (ISC) are supported. The codes generated by function and special keys are defined in keys.h and must be adapted. Because in most cases not all keys are listed in the /etc/termcap entry the keycodes are defined in this way. If your porting was successful, please send me your changes. They will be included then in the next release.

Back to Index


6. Credits and Contact

Thanks to Dieter, DK5SG / N0PRA for wampes. The source code contains many interesting things and I took some parts of the shell-functions out of the wampes-code.

Thanks to Joerg, DD8FR for providing the code for macro expansion in the connect text and for using more than 80 characters per line.

Patrick (ex DL7AUC), who has ported TNT to ISC Unix and has contributed many ideas and additional code for the socket feature, lost his life in an accident. His work and support was very much appreciated and will be missed very much. He will always be remembered.

Thanks to Joachim, DL8HBS (author of DigiPoint for ATARI) for providing me with his sourcecode. Thanks also for the hours of discussing and planning the porting of the box-part of DP to Linux and for the support during the debugging sessions.

Thanks to Gert, DK3NY for the implementation of the password generation for DIEBOX-BBS's and for several bug reports.

Thanks to Andreas, DK9HE for analysing and fixing the startup problem if TNT was not invoked by root.

Thanks to Werner, DL4NER for code and ideas for the FlexNet password generation.

Thanks to Mario, DL5MLO for providing the code for the alternative statusline, the 'insertmode'-flag in tnt.ini, AUTO7PL and several bugfixes.

Thanks to Oliver, DL8NEG for code for the baycom password, for perfect password hiding and for //RTT.

Thanks to Hansi, DL9RDZ for a bug report concerning unsuccessful socket connect and the solution for it.

Thanks to Claudio, IW0FBB for code for the MD2 password.

Thanks to Martin, DL3FCC for providing a TeX-version of the documentation (this was the trigger to leave the path of a clean ASCII-doc).

Thanks to Bruno, F1IRW and Daniel, F1RMB for the french translation of the documentation.

Thanks to Matthias, DL2SUT for fixes in the daemon code.

The code for YAPP is based on work of Jeff Jacobsen, WA7MBL, Jonathan Naylor, G4KLX and S N Henson.

Thanks to Sanne Graaf for code for //RTT and //RING.

Thanks to Gerd, DK3NZ and Jonny, DG4MMI for bug reports.

Thanks to all who have tested TNT and have given comments.

And last but not least thanks to Linus and all of the Linux-community for giving us a superb operating system. Special thanks to Joseph H. Allen for the JOE-editor and Dave Gillespie for the P2C Pascal to C translator.

If you have questions, comments or bug reports, just write a mail:

Ham Radio : DL4YBG @ DB0GR.#BLN.DEU.EU
Internet  : wahlm-at-berlin-snafu-de

73, Mark Wahl (DL4YBG)

Back to Index


A. Appendix


A.1. Static huffman compression table

This table was set up by DK4NB for SP 9.00


      ASCII:  HUFFMAN                ASCII:  HUFFMANN

      <  0>:  101010110010110        <128>:  100111111110110
      <  1>:  101010101000010        <129>:  00100001
      <  2>:  100111111100010        <130>:  100111111101110
      <  3>:  101010110011110        <131>:  100111111100110
      <  4>:  101010110001110        <132>:  111100000
      <  5>:  101010101111110        <133>:  011111010111110
      <  6>:  101010101110110        <134>:  011111010110110
      <  7>:  101010101101010        <135>:  00111010010000
      <  8>:  101010101011010        <136>:  101010110100000
      <  9>:  1111001101             <137>:  101010110011100
      < 10>:  101010101010010        <138>:  101010110011000
      < 11>:  011111010110010        <139>:  101010110010100
      < 12>:  101010101101110        <140>:  101010110010000
      < 13>:  1111010                <141>:  101010110001100
      < 14>:  101010101001010        <142>:  1010101101110
      < 15>:  100111111111010        <143>:  101010110001000
      < 16>:  100111111101010        <144>:  101010110000100
      < 17>:  011111010111010        <145>:  101010110000000
      < 18>:  101010110100010        <146>:  101010101111100
      < 19>:  101010110011010        <147>:  101010101111000
      < 20>:  101010110010010        <148>:  001110110
      < 21>:  101010110001010        <149>:  101010101110100
      < 22>:  101010110000010        <150>:  101010101110000
      < 23>:  101010101111010        <151>:  101010101101100
      < 24>:  101010101110010        <152>:  101010101101000
      < 25>:  10101011011000         <153>:  10101011011001
      < 26>:  101010110000110        <154>:  011111010011
      < 27>:  101010101100110        <155>:  101010101100100
      < 28>:  101010101011110        <156>:  101010101100000
      < 29>:  101010101010110        <157>:  101010101011100
      < 30>:  101010101001110        <158>:  101010101011000
      < 31>:  101010101000110        <159>:  101010101010100


      ASCII:  HUFFMAN                ASCII:  HUFFMANN

           :  110                    <160>:  101010101010000
          !:  001110101              <161>:  101010101001100
          ":  1010101111             <162>:  101010101001000
          #:  00000000011            <163>:  101010101000100
          $:  011111010100           <164>:  101010101000000
          %:  10101011010111         <165>:  100111111111100
          &:  000000000000           <166>:  100111111111000
          ':  10101011010110         <167>:  100111111110100
          (:  011111000              <168>:  100111111110000
          ):  001111001              <169>:  100111111101100
          *:  01111101000            <170>:  100111111101000
          +:  000000000001           <171>:  100111111100100
          ,:  0001001                <172>:  100111111100000
          -:  0111101                <173>:  011111010111100
          .:  101110                 <174>:  011111010111000
          /:  0011001                <175>:  0011101001011
          0:  0010001                <176>:  011111010110100
          1:  11110110               <177>:  011111010110000
          2:  00111101               <178>:  101010110100011
          3:  100111100              <179>:  101010110100001
          4:  101111011              <180>:  101010110011111
          5:  011111001              <181>:  101010110011101
          6:  000000001              <182>:  101010110011011
          7:  101010100              <183>:  101010110011001
          8:  101111010              <184>:  101010110010111
          9:  100111110              <185>:  101010110010101
          ::  00000011               <186>:  101010110010011
          ;:  1010101101111          <187>:  101010110010001
          <:  1010101101101          <188>:  101010110001111
          =:  001111000              <189>:  101010110001101
          >:  001100000              <190>:  101010110001011
          ?:  00000000001            <191>:  101010110001001


      ASCII:  HUFFMAN                ASCII:  HUFFMANN

          @:  011111010101           <192>:  101010110000111
          A:  0011100                <193>:  101010110000101
          B:  0111100                <194>:  101010110000011
          C:  1001110                <195>:  101010110000001
          D:  1111111                <196>:  101010101111111
          E:  001001                 <197>:  101010101111101
          F:  10111100               <198>:  101010101111011
          G:  00000010               <199>:  101010101111001
          H:  00000001               <200>:  101010101110111
          I:  11110001               <201>:  101010101110101
          J:  00000000010            <202>:  101010101110011
          K:  00110001               <203>:  101010101110001
          L:  11110010               <204>:  101010101101111
          M:  0011010                <205>:  101010101101101
          N:  0001110                <206>:  101010101101011
          O:  0001111                <207>:  101010101101001
          P:  1011111                <208>:  101010101100111
          Q:  10101011101            <209>:  101010101100101
          R:  0011111                <210>:  101010101100011
          S:  000101                 <211>:  101010101100001
          T:  0011011                <212>:  101010101011111
          U:  111100111              <213>:  101010101011101
          V:  111100001              <214>:  101010101011011
          W:  00100000               <215>:  101010101011001
          X:  11111100               <216>:  101010101010111
          Y:  1001111110             <217>:  101010101010101
          Z:  100111101              <218>:  101010101010011
          [:  101010111001           <219>:  101010101010001
          \:  001110111              <220>:  101010101001111
          ]:  101010111000           <221>:  001110100111
          ^:  10101011010101         <222>:  101010101001101
          _:  0011101001010          <223>:  101010101001011


      ASCII:  HUFFMAN                ASCII:  HUFFMANN

          `:  10101011010100         <224>:  101010101001001
          a:  10100                  <225>:  001100001
          b:  000110                 <226>:  101010101000111
          c:  100110                 <227>:  101010101000101
          d:  01110                  <228>:  101010101000011
          e:  010                    <229>:  101010101000001
          f:  000001                 <230>:  100111111111111
          g:  101011                 <231>:  100111111111101
          h:  111110                 <232>:  100111111111011
          i:  0110                   <233>:  100111111111001
          j:  0011101000             <234>:  100111111110111
          k:  11111101               <235>:  100111111110101
          l:  00101                  <236>:  100111111110011
          m:  101100                 <237>:  100111111110001
          n:  1000                   <238>:  100111111101111
          o:  101101                 <239>:  100111111101101
          p:  0001000                <240>:  100111111101011
          q:  011111010010           <241>:  100111111101001
          r:  11100                  <242>:  100111111100111
          s:  10010                  <243>:  100111111100101
          t:  11101                  <244>:  100111111100011
          u:  00001                  <245>:  100111111100001
          v:  11110111               <246>:  011111010111111
          w:  1010100                <247>:  011111010111101
          x:  011111011              <248>:  011111010111011
          y:  1111001100             <249>:  011111010111001
          z:  0111111                <250>:  011111010110111
          {:  10101011010010         <251>:  011111010110101
          |:  0011101001001          <252>:  011111010110011
          }:  10101011010011         <253>:  011111010110001
          ~:  001110100110           <254>:  001110100100011
      <127>:  100111111111110        <255>:  001110100100010

Back to Index