1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * G8BPQ compatible "AX.25 via ethernet" driver release 004
5 * This code REQUIRES 2.0.0 or higher/ NET3.029
7 * This is a "pseudo" network driver to allow AX.25 over Ethernet
8 * using G8BPQ encapsulation. It has been extracted from the protocol
9 * implementation because
11 * - things got unreadable within the protocol stack
12 * - to cure the protocol stack from "feature-ism"
13 * - a protocol implementation shouldn't need to know on
14 * which hardware it is running
15 * - user-level programs like the AX.25 utilities shouldn't
16 * need to know about the hardware.
17 * - IP over ethernet encapsulated AX.25 was impossible
18 * - rxecho.c did not work
19 * - to have room for extensions
20 * - it just deserves to "live" as an own driver
22 * This driver can use any ethernet destination address, and can be
23 * limited to accept frames from one dedicated ethernet card only.
25 * Note that the driver sets up the BPQ devices automagically on
26 * startup or (if started before the "insmod" of an ethernet device)
27 * on "ifconfig up". It hopefully will remove the BPQ on "rmmod"ing
28 * the ethernet device (in fact: as soon as another ethernet or bpq
29 * device gets "ifconfig"ured).
31 * I have heard that several people are thinking of experiments
32 * with highspeed packet radio using existing ethernet cards.
33 * Well, this driver is prepared for this purpose, just add
34 * your tx key control and a txdelay / tailtime algorithm,
35 * probably some buffering, and /voila/...
38 * BPQ 001 Joerg(DL1BKE) Extracted BPQ code from AX.25
39 * protocol stack and added my own
40 * yet existing patches
41 * BPQ 002 Joerg(DL1BKE) Scan network device list on
43 * BPQ 003 Joerg(DL1BKE) Ethernet destination address
44 * and accepted source address
45 * can be configured by an ioctl()
47 * Fixed to match Linux networking
49 * BPQ 004 Joerg(DL1BKE) Fixed to not lock up on ifconfig.
52 #include <linux/errno.h>
53 #include <linux/types.h>
54 #include <linux/socket.h>
56 #include <linux/kernel.h>
57 #include <linux/string.h>
58 #include <linux/net.h>
59 #include <linux/slab.h>
61 #include <linux/inet.h>
62 #include <linux/netdevice.h>
63 #include <linux/etherdevice.h>
64 #include <linux/if_arp.h>
65 #include <linux/skbuff.h>
67 #include <linux/uaccess.h>
69 #include <linux/interrupt.h>
70 #include <linux/notifier.h>
71 #include <linux/proc_fs.h>
72 #include <linux/seq_file.h>
73 #include <linux/stat.h>
74 #include <linux/module.h>
75 #include <linux/init.h>
76 #include <linux/rtnetlink.h>
80 #include <net/net_namespace.h>
82 #include <linux/bpqether.h>
84 static const char banner
[] __initconst
= KERN_INFO \
85 "AX.25: bpqether driver version 004\n";
87 static int bpq_rcv(struct sk_buff
*, struct net_device
*, struct packet_type
*, struct net_device
*);
88 static int bpq_device_event(struct notifier_block
*, unsigned long, void *);
90 static struct packet_type bpq_packet_type __read_mostly
= {
91 .type
= cpu_to_be16(ETH_P_BPQ
),
95 static struct notifier_block bpq_dev_notifier
= {
96 .notifier_call
= bpq_device_event
,
101 struct list_head bpq_list
; /* list of bpq devices chain */
102 struct net_device
*ethdev
; /* link to ethernet device */
103 struct net_device
*axdev
; /* bpq device (bpq#) */
104 char dest_addr
[6]; /* ether destination address */
105 char acpt_addr
[6]; /* accept ether frames from this address only */
108 static LIST_HEAD(bpq_devices
);
110 /* ------------------------------------------------------------------------ */
114 * Get the ethernet device for a BPQ device
116 static inline struct net_device
*bpq_get_ether_dev(struct net_device
*dev
)
118 struct bpqdev
*bpq
= netdev_priv(dev
);
120 return bpq
? bpq
->ethdev
: NULL
;
124 * Get the BPQ device for the ethernet device
126 static inline struct net_device
*bpq_get_ax25_dev(struct net_device
*dev
)
130 list_for_each_entry_rcu(bpq
, &bpq_devices
, bpq_list
,
131 lockdep_rtnl_is_held()) {
132 if (bpq
->ethdev
== dev
)
138 static inline int dev_is_ethdev(struct net_device
*dev
)
140 return dev
->type
== ARPHRD_ETHER
&& strncmp(dev
->name
, "dummy", 5);
143 /* ------------------------------------------------------------------------ */
147 * Receive an AX.25 frame via an ethernet interface.
149 static int bpq_rcv(struct sk_buff
*skb
, struct net_device
*dev
, struct packet_type
*ptype
, struct net_device
*orig_dev
)
156 if (!net_eq(dev_net(dev
), &init_net
))
159 if ((skb
= skb_share_check(skb
, GFP_ATOMIC
)) == NULL
)
162 if (!pskb_may_pull(skb
, sizeof(struct ethhdr
)))
166 dev
= bpq_get_ax25_dev(dev
);
168 if (dev
== NULL
|| !netif_running(dev
))
172 * if we want to accept frames from just one ethernet device
173 * we check the source address of the sender.
176 bpq
= netdev_priv(dev
);
180 if (!(bpq
->acpt_addr
[0] & 0x01) &&
181 !ether_addr_equal(eth
->h_source
, bpq
->acpt_addr
))
184 if (skb_cow(skb
, sizeof(struct ethhdr
)))
187 len
= skb
->data
[0] + skb
->data
[1] * 256 - 5;
189 skb_pull(skb
, 2); /* Remove the length bytes */
190 skb_trim(skb
, len
); /* Set the length of the data */
192 dev
->stats
.rx_packets
++;
193 dev
->stats
.rx_bytes
+= len
;
195 ptr
= skb_push(skb
, 1);
198 skb
->protocol
= ax25_type_trans(skb
, dev
);
215 * Send an AX.25 frame via an ethernet interface
217 static netdev_tx_t
bpq_xmit(struct sk_buff
*skb
, struct net_device
*dev
)
221 struct net_device
*orig_dev
;
224 if (skb
->protocol
== htons(ETH_P_IP
))
225 return ax25_ip_xmit(skb
);
228 * Just to be *really* sure not to send anything if the interface
229 * is down, the ethernet device may have gone.
231 if (!netif_running(dev
)) {
236 skb_pull(skb
, 1); /* Drop KISS byte */
240 * We're about to mess with the skb which may still shared with the
241 * generic networking code so unshare and ensure it's got enough
242 * space for the BPQ headers.
244 if (skb_cow(skb
, AX25_BPQ_HEADER_LEN
)) {
246 pr_err("bpqether: out of memory\n");
252 ptr
= skb_push(skb
, 2); /* Make space for length */
254 *ptr
++ = (size
+ 5) % 256;
255 *ptr
++ = (size
+ 5) / 256;
257 bpq
= netdev_priv(dev
);
260 if ((dev
= bpq_get_ether_dev(dev
)) == NULL
) {
261 orig_dev
->stats
.tx_dropped
++;
266 skb
->protocol
= ax25_type_trans(skb
, dev
);
267 skb_reset_network_header(skb
);
268 dev_hard_header(skb
, dev
, ETH_P_BPQ
, bpq
->dest_addr
, NULL
, 0);
269 dev
->stats
.tx_packets
++;
270 dev
->stats
.tx_bytes
+=skb
->len
;
273 netif_wake_queue(dev
);
280 static int bpq_set_mac_address(struct net_device
*dev
, void *addr
)
282 struct sockaddr
*sa
= (struct sockaddr
*)addr
;
284 memcpy(dev
->dev_addr
, sa
->sa_data
, dev
->addr_len
);
291 * SIOCSBPQETHOPT reserved for enhancements
292 * SIOCSBPQETHADDR set the destination and accepted
293 * source ethernet address (broadcast
294 * or multicast: accept all)
296 static int bpq_ioctl(struct net_device
*dev
, struct ifreq
*ifr
, int cmd
)
298 struct bpq_ethaddr __user
*ethaddr
= ifr
->ifr_data
;
299 struct bpqdev
*bpq
= netdev_priv(dev
);
302 if (!capable(CAP_NET_ADMIN
))
307 if (copy_from_user(&req
, ifr
->ifr_data
, sizeof(struct bpq_req
)))
310 case SIOCGBPQETHPARAM
:
311 case SIOCSBPQETHPARAM
:
318 case SIOCSBPQETHADDR
:
319 if (copy_from_user(bpq
->dest_addr
, ethaddr
->destination
, ETH_ALEN
))
321 if (copy_from_user(bpq
->acpt_addr
, ethaddr
->accept
, ETH_ALEN
))
333 * open/close a device
335 static int bpq_open(struct net_device
*dev
)
337 netif_start_queue(dev
);
341 static int bpq_close(struct net_device
*dev
)
343 netif_stop_queue(dev
);
348 /* ------------------------------------------------------------------------ */
354 static void *bpq_seq_start(struct seq_file
*seq
, loff_t
*pos
)
358 struct bpqdev
*bpqdev
;
363 return SEQ_START_TOKEN
;
365 list_for_each_entry_rcu(bpqdev
, &bpq_devices
, bpq_list
) {
372 static void *bpq_seq_next(struct seq_file
*seq
, void *v
, loff_t
*pos
)
375 struct bpqdev
*bpqdev
= v
;
379 if (v
== SEQ_START_TOKEN
)
380 p
= rcu_dereference(list_next_rcu(&bpq_devices
));
382 p
= rcu_dereference(list_next_rcu(&bpqdev
->bpq_list
));
384 return (p
== &bpq_devices
) ? NULL
385 : list_entry(p
, struct bpqdev
, bpq_list
);
388 static void bpq_seq_stop(struct seq_file
*seq
, void *v
)
395 static int bpq_seq_show(struct seq_file
*seq
, void *v
)
397 if (v
== SEQ_START_TOKEN
)
399 "dev ether destination accept from\n");
401 const struct bpqdev
*bpqdev
= v
;
403 seq_printf(seq
, "%-5s %-10s %pM ",
404 bpqdev
->axdev
->name
, bpqdev
->ethdev
->name
,
407 if (is_multicast_ether_addr(bpqdev
->acpt_addr
))
408 seq_printf(seq
, "*\n");
410 seq_printf(seq
, "%pM\n", bpqdev
->acpt_addr
);
416 static const struct seq_operations bpq_seqops
= {
417 .start
= bpq_seq_start
,
418 .next
= bpq_seq_next
,
419 .stop
= bpq_seq_stop
,
420 .show
= bpq_seq_show
,
423 /* ------------------------------------------------------------------------ */
425 static const struct net_device_ops bpq_netdev_ops
= {
426 .ndo_open
= bpq_open
,
427 .ndo_stop
= bpq_close
,
428 .ndo_start_xmit
= bpq_xmit
,
429 .ndo_set_mac_address
= bpq_set_mac_address
,
430 .ndo_do_ioctl
= bpq_ioctl
,
433 static void bpq_setup(struct net_device
*dev
)
435 dev
->netdev_ops
= &bpq_netdev_ops
;
436 dev
->needs_free_netdev
= true;
438 memcpy(dev
->broadcast
, &ax25_bcast
, AX25_ADDR_LEN
);
439 memcpy(dev
->dev_addr
, &ax25_defaddr
, AX25_ADDR_LEN
);
442 dev
->features
= NETIF_F_LLTX
; /* Allow recursion */
444 #if IS_ENABLED(CONFIG_AX25)
445 dev
->header_ops
= &ax25_header_ops
;
448 dev
->type
= ARPHRD_AX25
;
449 dev
->hard_header_len
= AX25_MAX_HEADER_LEN
+ AX25_BPQ_HEADER_LEN
;
450 dev
->mtu
= AX25_DEF_PACLEN
;
451 dev
->addr_len
= AX25_ADDR_LEN
;
456 * Setup a new device.
458 static int bpq_new_device(struct net_device
*edev
)
461 struct net_device
*ndev
;
464 ndev
= alloc_netdev(sizeof(struct bpqdev
), "bpq%d", NET_NAME_UNKNOWN
,
470 bpq
= netdev_priv(ndev
);
475 eth_broadcast_addr(bpq
->dest_addr
);
476 eth_broadcast_addr(bpq
->acpt_addr
);
478 err
= register_netdevice(ndev
);
482 /* List protected by RTNL */
483 list_add_rcu(&bpq
->bpq_list
, &bpq_devices
);
493 static void bpq_free_device(struct net_device
*ndev
)
495 struct bpqdev
*bpq
= netdev_priv(ndev
);
497 dev_put(bpq
->ethdev
);
498 list_del_rcu(&bpq
->bpq_list
);
500 unregister_netdevice(ndev
);
504 * Handle device status changes.
506 static int bpq_device_event(struct notifier_block
*this,
507 unsigned long event
, void *ptr
)
509 struct net_device
*dev
= netdev_notifier_info_to_dev(ptr
);
511 if (!net_eq(dev_net(dev
), &init_net
))
514 if (!dev_is_ethdev(dev
))
518 case NETDEV_UP
: /* new ethernet device -> new BPQ interface */
519 if (bpq_get_ax25_dev(dev
) == NULL
)
523 case NETDEV_DOWN
: /* ethernet device closed -> close BPQ interface */
524 if ((dev
= bpq_get_ax25_dev(dev
)) != NULL
)
528 case NETDEV_UNREGISTER
: /* ethernet device removed -> free BPQ interface */
529 if ((dev
= bpq_get_ax25_dev(dev
)) != NULL
)
530 bpq_free_device(dev
);
540 /* ------------------------------------------------------------------------ */
543 * Initialize driver. To be called from af_ax25 if not compiled as a
546 static int __init
bpq_init_driver(void)
548 #ifdef CONFIG_PROC_FS
549 if (!proc_create_seq("bpqether", 0444, init_net
.proc_net
, &bpq_seqops
)) {
551 "bpq: cannot create /proc/net/bpqether entry.\n");
554 #endif /* CONFIG_PROC_FS */
556 dev_add_pack(&bpq_packet_type
);
558 register_netdevice_notifier(&bpq_dev_notifier
);
565 static void __exit
bpq_cleanup_driver(void)
569 dev_remove_pack(&bpq_packet_type
);
571 unregister_netdevice_notifier(&bpq_dev_notifier
);
573 remove_proc_entry("bpqether", init_net
.proc_net
);
576 while (!list_empty(&bpq_devices
)) {
577 bpq
= list_entry(bpq_devices
.next
, struct bpqdev
, bpq_list
);
578 bpq_free_device(bpq
->axdev
);
583 MODULE_AUTHOR("Joerg Reuter DL1BKE <jreuter@yaina.de>");
584 MODULE_DESCRIPTION("Transmit and receive AX.25 packets over Ethernet");
585 MODULE_LICENSE("GPL");
586 module_init(bpq_init_driver
);
587 module_exit(bpq_cleanup_driver
);