Commit 954b2e7f authored by Ralf Baechle's avatar Ralf Baechle Committed by David S. Miller

[NET] AX.25 Kconfig and docs updates and fixes

 o The AX.25 Howto is unmaintained since several years.  I've replaced it
   with a wiki at http://www.linux-ax25.org which provides more uptodate
   information.
 o Change default for AX25_DAMA_SLAVE to Y.  AX25_DAMA_SLAVE only compiles
   in support for DAMA but doesn't activate it.  I hope this gets Linux
   distributions to ship their AX.25 kernels with AX25_DAMA_SLAVE enabled.
   The price for this would be very small.
 o Delete historic changelog from comments, that's what SCM systems are
   meant to do.
 o ---help--- in Kconfig looks so yellingly eye insulting.  Use just help.
 o Rewrite the commented out piece of old Linux 2.4 configuration language
   to Kconfig for consistency.
 o Fixup dependencies.
Signed-off-by: default avatarRalf Baechle <ralf@linux-mips.org>
Signed-off-by: default avatarDavid S. Miller <davem@davemloft.net>
parent ecbb4169
To use the amateur radio protocols within Linux you will need to get a To use the amateur radio protocols within Linux you will need to get a
suitable copy of the AX.25 Utilities. More detailed information about these suitable copy of the AX.25 Utilities. More detailed information about
and associated programs can be found on http://zone.pspt.fi/~jsn/. AX.25, NET/ROM and ROSE, associated programs and and utilities can be
found on http://www.linux-ax25.org.
For more information about the AX.25, NET/ROM and ROSE protocol stacks, see
the AX25-HOWTO written by Terry Dawson <terry@perf.no.itg.telstra.com.au>
who is also the AX.25 Utilities maintainer.
There is an active mailing list for discussing Linux amateur radio matters There is an active mailing list for discussing Linux amateur radio matters
called linux-hams. To subscribe to it, send a message to called linux-hams@vger.kernel.org. To subscribe to it, send a message to
majordomo@vger.kernel.org with the words "subscribe linux-hams" in the body majordomo@vger.kernel.org with the words "subscribe linux-hams" in the body
of the message, the subject field is ignored. of the message, the subject field is ignored. You don't need to be
subscribed to post but of course that means you might miss an answer.
Jonathan G4KLX
g4klx@g4klx.demon.co.uk
# #
# Amateur Radio protocols and AX.25 device configuration # Amateur Radio protocols and AX.25 device configuration
# #
# 19971130 Now in an own category to make correct compilation of the
# AX.25 stuff easier...
# Joerg Reuter DL1BKE <jreuter@yaina.de>
# 19980129 Moved to net/ax25/Config.in, sourcing device drivers.
menuconfig HAMRADIO menuconfig HAMRADIO
depends on NET depends on NET
bool "Amateur Radio support" bool "Amateur Radio support"
help help
If you want to connect your Linux box to an amateur radio, answer Y If you want to connect your Linux box to an amateur radio, answer Y
here. You want to read <http://www.tapr.org/tapr/html/pkthome.html> and here. You want to read <http://www.tapr.org/tapr/html/pkthome.html>
the AX25-HOWTO, available from <http://www.tldp.org/docs.html#howto>. and more specifically about AX.25 on Linux
<http://www.linux-ax25.org/>.
Note that the answer to this question won't directly affect the Note that the answer to this question won't directly affect the
kernel: saying N will just cause the configurator to skip all kernel: saying N will just cause the configurator to skip all
the questions about amateur radio. the questions about amateur radio.
comment "Packet Radio protocols" comment "Packet Radio protocols"
depends on HAMRADIO && NET depends on HAMRADIO
config AX25 config AX25
tristate "Amateur Radio AX.25 Level 2 protocol" tristate "Amateur Radio AX.25 Level 2 protocol"
depends on HAMRADIO && NET depends on HAMRADIO
---help--- help
This is the protocol used for computer communication over amateur This is the protocol used for computer communication over amateur
radio. It is either used by itself for point-to-point links, or to radio. It is either used by itself for point-to-point links, or to
carry other protocols such as tcp/ip. To use it, you need a device carry other protocols such as tcp/ip. To use it, you need a device
...@@ -52,6 +49,7 @@ config AX25 ...@@ -52,6 +49,7 @@ config AX25
config AX25_DAMA_SLAVE config AX25_DAMA_SLAVE
bool "AX.25 DAMA Slave support" bool "AX.25 DAMA Slave support"
default y
depends on AX25 depends on AX25
help help
DAMA is a mechanism to prevent collisions when doing AX.25 DAMA is a mechanism to prevent collisions when doing AX.25
...@@ -59,23 +57,38 @@ config AX25_DAMA_SLAVE ...@@ -59,23 +57,38 @@ config AX25_DAMA_SLAVE
from clients (called "slaves") and redistributes it to other slaves. from clients (called "slaves") and redistributes it to other slaves.
If you say Y here, your Linux box will act as a DAMA slave; this is If you say Y here, your Linux box will act as a DAMA slave; this is
transparent in that you don't have to do any special DAMA transparent in that you don't have to do any special DAMA
configuration. (Linux cannot yet act as a DAMA server.) If unsure, configuration. Linux cannot yet act as a DAMA server. This option
say N. only compiles DAMA slave support into the kernel. It still needs to
be enabled at runtime. For more about DAMA see
<http://www.linux-ax25.org>. If unsure, say Y.
# placeholder until implemented
config AX25_DAMA_MASTER
bool 'AX.25 DAMA Master support'
depends on AX25_DAMA_SLAVE && BROKEN
help
DAMA is a mechanism to prevent collisions when doing AX.25
networking. A DAMA server (called "master") accepts incoming traffic
from clients (called "slaves") and redistributes it to other slaves.
If you say Y here, your Linux box will act as a DAMA master; this is
transparent in that you don't have to do any special DAMA
configuration. Linux cannot yet act as a DAMA server. This option
only compiles DAMA slave support into the kernel. It still needs to
be explicitly enabled, so if unsure, say Y.
# bool ' AX.25 DAMA Master support' CONFIG_AX25_DAMA_MASTER
config NETROM config NETROM
tristate "Amateur Radio NET/ROM protocol" tristate "Amateur Radio NET/ROM protocol"
depends on AX25 depends on AX25
---help--- help
NET/ROM is a network layer protocol on top of AX.25 useful for NET/ROM is a network layer protocol on top of AX.25 useful for
routing. routing.
A comprehensive listing of all the software for Linux amateur radio A comprehensive listing of all the software for Linux amateur radio
users as well as information about how to configure an AX.25 port is users as well as information about how to configure an AX.25 port is
contained in the AX25-HOWTO, available from contained in the Linux Ham Wiki, available from
<http://www.tldp.org/docs.html#howto>. You also might want to <http://www.linux-ax25.org>. You also might want to check out the
check out the file <file:Documentation/networking/ax25.txt>. More file <file:Documentation/networking/ax25.txt>. More information about
information about digital amateur radio in general is on the WWW at digital amateur radio in general is on the WWW at
<http://www.tapr.org/tapr/html/pkthome.html>. <http://www.tapr.org/tapr/html/pkthome.html>.
To compile this driver as a module, choose M here: the To compile this driver as a module, choose M here: the
...@@ -84,27 +97,25 @@ config NETROM ...@@ -84,27 +97,25 @@ config NETROM
config ROSE config ROSE
tristate "Amateur Radio X.25 PLP (Rose)" tristate "Amateur Radio X.25 PLP (Rose)"
depends on AX25 depends on AX25
---help--- help
The Packet Layer Protocol (PLP) is a way to route packets over X.25 The Packet Layer Protocol (PLP) is a way to route packets over X.25
connections in general and amateur radio AX.25 connections in connections in general and amateur radio AX.25 connections in
particular, essentially an alternative to NET/ROM. particular, essentially an alternative to NET/ROM.
A comprehensive listing of all the software for Linux amateur radio A comprehensive listing of all the software for Linux amateur radio
users as well as information about how to configure an AX.25 port is users as well as information about how to configure an AX.25 port is
contained in the AX25-HOWTO, available from contained in the Linux Ham Wiki, available from
<http://www.tldp.org/docs.html#howto>. You also might want to <http://www.linux-ax25.org>. You also might want to check out the
check out the file <file:Documentation/networking/ax25.txt>. More file <file:Documentation/networking/ax25.txt>. More information about
information about digital amateur radio in general is on the WWW at digital amateur radio in general is on the WWW at
<http://www.tapr.org/tapr/html/pkthome.html>. <http://www.tapr.org/tapr/html/pkthome.html>.
To compile this driver as a module, choose M here: the To compile this driver as a module, choose M here: the
module will be called rose. module will be called rose.
menu "AX.25 network device drivers" menu "AX.25 network device drivers"
depends on HAMRADIO && NET && AX25!=n depends on HAMRADIO && AX25
source "drivers/net/hamradio/Kconfig" source "drivers/net/hamradio/Kconfig"
endmenu endmenu
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment