Merge tag 'docs-5.10-2' of git://git.lwn.net/linux
[linux-2.6-microblaze.git] / Documentation / networking / x25.rst
1 .. SPDX-License-Identifier: GPL-2.0
2
3 ==================
4 Linux X.25 Project
5 ==================
6
7 As my third year dissertation at University I have taken it upon myself to
8 write an X.25 implementation for Linux. My aim is to provide a complete X.25
9 Packet Layer and a LAPB module to allow for "normal" X.25 to be run using
10 Linux. There are two sorts of X.25 cards available, intelligent ones that
11 implement LAPB on the card itself, and unintelligent ones that simply do
12 framing, bit-stuffing and checksumming. These both need to be handled by the
13 system.
14
15 I therefore decided to write the implementation such that as far as the
16 Packet Layer is concerned, the link layer was being performed by a lower
17 layer of the Linux kernel and therefore it did not concern itself with
18 implementation of LAPB. Therefore the LAPB modules would be called by
19 unintelligent X.25 card drivers and not by intelligent ones, this would
20 provide a uniform device driver interface, and simplify configuration.
21
22 To confuse matters a little, an 802.2 LLC implementation for Linux is being
23 written which will allow X.25 to be run over an Ethernet (or Token Ring) and
24 conform with the JNT "Pink Book", this will have a different interface to
25 the Packet Layer but there will be no confusion since the class of device
26 being served by the LLC will be completely separate from LAPB. The LLC
27 implementation is being done as part of another protocol project (SNA) and
28 by a different author.
29
30 Just when you thought that it could not become more confusing, another
31 option appeared, XOT. This allows X.25 Packet Layer frames to operate over
32 the Internet using TCP/IP as a reliable link layer. RFC1613 specifies the
33 format and behaviour of the protocol. If time permits this option will also
34 be actively considered.
35
36 A linux-x25 mailing list has been created at vger.kernel.org to support the
37 development and use of Linux X.25. It is early days yet, but interested
38 parties are welcome to subscribe to it. Just send a message to
39 majordomo@vger.kernel.org with the following in the message body:
40
41 subscribe linux-x25
42 end
43
44 The contents of the Subject line are ignored.
45
46 Jonathan
47
48 g4klx@g4klx.demon.co.uk