Linux AX25-HOWTO, Amateur Radio.

Terry Dawson, VK2KTJ, terry@perf.no.itg.telstra.com.au

1. Introduction.

• 1.1 Changes from the previous version
• 1.2 Other related documentation.

2. Where to obtain new versions of this document.

3. The Packet Radio Protocols and Linux.

• 3.1 How it all fits together.

4. The AX.25/NetRom/Rose software components.

• 4.1 Finding the kernel, tools and utility packages.

5. Installing the AX.25/NetRom/Rose software.

• 5.1 Compiling the kernel.
• 5.2 The network configuration tools.
• 5.3 The AX.25 user and utility programs.

6. A note on callsigns, addresses and things before we start.

• 6.1 What are all those T1, T2, N2 and things ?
• 6.2 Run time configurable parameters

7. Configuring an AX.25 port.

• 7.1 Creating the AX.25 network device.
• 7.2 Creating the /etc/ax25/axports file.
• 7.3 Configuring AX.25 routing.

8. Configuring an AX.25 interface for TCP/IP.

9. Configuring a NetRom port.

• 9.1 Configuring /etc/ax25/nrports
• 9.2 Configuring /etc/ax25/nrbroadcast
• 9.3 Creating the NetRom Network device
• 9.4 Starting the NetRom daemon
• 9.5 Configuring NetRom routing.

10. Configuring a NetRom interface for TCP/IP.

11. Configuring a Rose port.

• 11.1 Configuring /etc/ax25/rsports
• 11.2 Creating the Rose Network device.
• 11.3 Configuring Rose Routing

12. Making AX.25/NetRom/Rose calls.

13. Configuring Linux to accept Packet connections.

• 13.1 Creating the /etc/ax25/ax25d.conf file.
• 13.2 A simple example ax25d.conf file.
• 13.3 Starting ax25d

14. Configuring the node software.

• 14.1 Creating the /etc/ax25/node.conf file.
• 14.2 Creating the /etc/ax25/node.perms file.
• 14.3 Configuring node to run from ax25d
• 14.4 Configuring node to run from inetd

15. Configuring axspawn.

• 15.1 Creating the /etc/ax25/axspawn.conf file.

16. Configuring the pms

• 16.1 Create the /etc/ax25/pms.motd file.
• 16.2 Create the /etc/ax25/pms.info file.
• 16.3 Associate AX.25 callsigns with system users.
• 16.4 Add the PMS to the /etc/ax25/ax25d.conf file.
• 16.5 Test the PMS.

17. Configuring the user_call programs.

18. Configuring the Rose Uplink and Downlink commands

• 18.1 Configuring a Rose downlink
• 18.2 Configuring a Rose uplink

19. Associating AX.25 callsigns with Linux users.

20. HOWTO link NOS and the Linux kernel networking software

• 20.1 Linking NOS and Linux using a pipe device

21. The /proc/ file system entries.

22. Some sample configurations.

• 22.1 Small Ethernet LAN with Linux as a router to Radio LAN
• 22.2 IPIP encapsulated gateway configuration.

23. AX.25, NetRom, Rose network programming.

• 23.1 The address families.
• 23.2 The header files.
• 23.3 Callsign mangling and examples.

24. Discussion relating to Amateur Radio and Linux.

25. Acknowledgements.

26. Copyright.