1 /* SPDX-License-Identifier: GPL-2.0-only */ <<
2 /* 1 /*
3 * Generic HDLC support routines for Linux 2 * Generic HDLC support routines for Linux
4 * 3 *
5 * Copyright (C) 1999-2005 Krzysztof Halasa <k !! 4 * Copyright (C) 1999-2003 Krzysztof Halasa <khc@pm.waw.pl>
>> 5 *
>> 6 * This program is free software; you can redistribute it and/or modify it
>> 7 * under the terms of version 2 of the GNU General Public License
>> 8 * as published by the Free Software Foundation.
6 */ 9 */
>> 10
7 #ifndef __HDLC_H 11 #ifndef __HDLC_H
8 #define __HDLC_H 12 #define __HDLC_H
9 13
>> 14 #define GENERIC_HDLC_VERSION 4 /* For synchronization with sethdlc utility */
>> 15
>> 16 #define CLOCK_DEFAULT 0 /* Default setting */
>> 17 #define CLOCK_EXT 1 /* External TX and RX clock - DTE */
>> 18 #define CLOCK_INT 2 /* Internal TX and RX clock - DCE */
>> 19 #define CLOCK_TXINT 3 /* Internal TX and external RX clock */
>> 20 #define CLOCK_TXFROMRX 4 /* TX clock derived from external RX clock */
>> 21
>> 22
>> 23 #define ENCODING_DEFAULT 0 /* Default setting */
>> 24 #define ENCODING_NRZ 1
>> 25 #define ENCODING_NRZI 2
>> 26 #define ENCODING_FM_MARK 3
>> 27 #define ENCODING_FM_SPACE 4
>> 28 #define ENCODING_MANCHESTER 5
>> 29
>> 30
>> 31 #define PARITY_DEFAULT 0 /* Default setting */
>> 32 #define PARITY_NONE 1 /* No parity */
>> 33 #define PARITY_CRC16_PR0 2 /* CRC16, initial value 0x0000 */
>> 34 #define PARITY_CRC16_PR1 3 /* CRC16, initial value 0xFFFF */
>> 35 #define PARITY_CRC16_PR0_CCITT 4 /* CRC16, initial 0x0000, ITU-T version */
>> 36 #define PARITY_CRC16_PR1_CCITT 5 /* CRC16, initial 0xFFFF, ITU-T version */
>> 37 #define PARITY_CRC32_PR0_CCITT 6 /* CRC32, initial value 0x00000000 */
>> 38 #define PARITY_CRC32_PR1_CCITT 7 /* CRC32, initial value 0xFFFFFFFF */
>> 39
>> 40 #define LMI_DEFAULT 0 /* Default setting */
>> 41 #define LMI_NONE 1 /* No LMI, all PVCs are static */
>> 42 #define LMI_ANSI 2 /* ANSI Annex D */
>> 43 #define LMI_CCITT 3 /* ITU-T Annex A */
>> 44
>> 45 #define HDLC_MAX_MTU 1500 /* Ethernet 1500 bytes */
>> 46 #define HDLC_MAX_MRU (HDLC_MAX_MTU + 10 + 14 + 4) /* for ETH+VLAN over FR */
>> 47
>> 48
>> 49 #ifdef __KERNEL__
10 50
11 #include <linux/skbuff.h> 51 #include <linux/skbuff.h>
12 #include <linux/netdevice.h> 52 #include <linux/netdevice.h>
>> 53 #include <net/syncppp.h>
13 #include <linux/hdlc/ioctl.h> 54 #include <linux/hdlc/ioctl.h>
14 #include <uapi/linux/hdlc.h> <<
15 55
16 /* This structure is a private property of HDL <<
17 Hardware drivers have no interest here */ <<
18 56
19 struct hdlc_proto { !! 57 typedef struct { /* Used in Cisco and PPP mode */
20 int (*open)(struct net_device *dev); !! 58 u8 address;
21 void (*close)(struct net_device *dev); !! 59 u8 control;
22 void (*start)(struct net_device *dev); !! 60 u16 protocol;
23 void (*stop)(struct net_device *dev); !! 61 }__attribute__ ((packed)) hdlc_header;
24 void (*detach)(struct net_device *dev) !! 62
25 int (*ioctl)(struct net_device *dev, s !! 63
26 __be16 (*type_trans)(struct sk_buff *s !! 64
27 int (*netif_rx)(struct sk_buff *skb); !! 65 typedef struct {
28 netdev_tx_t (*xmit)(struct sk_buff *sk !! 66 u32 type; /* code */
29 struct module *module; !! 67 u32 par1;
30 struct hdlc_proto *next; /* next proto !! 68 u32 par2;
31 }; !! 69 u16 rel; /* reliability */
>> 70 u32 time;
>> 71 }__attribute__ ((packed)) cisco_packet;
>> 72 #define CISCO_PACKET_LEN 18
>> 73 #define CISCO_BIG_PACKET_LEN 20
32 74
33 75
34 /* Pointed to by netdev_priv(dev) */ !! 76
35 typedef struct hdlc_device { !! 77 typedef struct pvc_device_struct {
>> 78 struct hdlc_device_struct *master;
>> 79 struct net_device *main;
>> 80 struct net_device *ether; /* bridged Ethernet interface */
>> 81 struct pvc_device_struct *next; /* Sorted in ascending DLCI order */
>> 82 int dlci;
>> 83 int open_count;
>> 84
>> 85 struct {
>> 86 unsigned int new: 1;
>> 87 unsigned int active: 1;
>> 88 unsigned int exist: 1;
>> 89 unsigned int deleted: 1;
>> 90 unsigned int fecn: 1;
>> 91 unsigned int becn: 1;
>> 92 }state;
>> 93 }pvc_device;
>> 94
>> 95
>> 96
>> 97 typedef struct hdlc_device_struct {
>> 98 /* To be initialized by hardware driver */
>> 99 struct net_device netdev; /* master net device - must be first */
>> 100 struct net_device_stats stats;
>> 101
36 /* used by HDLC layer to take control 102 /* used by HDLC layer to take control over HDLC device from hw driver*/
37 int (*attach)(struct net_device *dev, !! 103 int (*attach)(struct hdlc_device_struct *hdlc,
38 unsigned short encoding, 104 unsigned short encoding, unsigned short parity);
39 105
40 /* hardware driver must handle this in 106 /* hardware driver must handle this instead of dev->hard_start_xmit */
41 netdev_tx_t (*xmit)(struct sk_buff *sk !! 107 int (*xmit)(struct sk_buff *skb, struct net_device *dev);
>> 108
42 109
43 /* Things below are for HDLC layer int 110 /* Things below are for HDLC layer internal use only */
44 const struct hdlc_proto *proto; !! 111 struct {
>> 112 int (*open)(struct hdlc_device_struct *hdlc);
>> 113 void (*close)(struct hdlc_device_struct *hdlc);
>> 114
>> 115 /* if open & DCD */
>> 116 void (*start)(struct hdlc_device_struct *hdlc);
>> 117 /* if open & !DCD */
>> 118 void (*stop)(struct hdlc_device_struct *hdlc);
>> 119
>> 120 void (*detach)(struct hdlc_device_struct *hdlc);
>> 121 int (*netif_rx)(struct sk_buff *skb);
>> 122 unsigned short (*type_trans)(struct sk_buff *skb,
>> 123 struct net_device *dev);
>> 124 int id; /* IF_PROTO_HDLC/CISCO/FR/etc. */
>> 125 }proto;
>> 126
45 int carrier; 127 int carrier;
46 int open; 128 int open;
47 spinlock_t state_lock; 129 spinlock_t state_lock;
48 void *state; !! 130
49 void *priv; !! 131 union {
50 } hdlc_device; !! 132 struct {
>> 133 fr_proto settings;
>> 134 pvc_device *first_pvc;
>> 135 int dce_pvc_count;
>> 136
>> 137 struct timer_list timer;
>> 138 int last_poll;
>> 139 int reliable;
>> 140 int dce_changed;
>> 141 int request;
>> 142 int fullrep_sent;
>> 143 u32 last_errors; /* last errors bit list */
>> 144 u8 n391cnt;
>> 145 u8 txseq; /* TX sequence number */
>> 146 u8 rxseq; /* RX sequence number */
>> 147 }fr;
>> 148
>> 149 struct {
>> 150 cisco_proto settings;
>> 151
>> 152 struct timer_list timer;
>> 153 int last_poll;
>> 154 int up;
>> 155 u32 txseq; /* TX sequence number */
>> 156 u32 rxseq; /* RX sequence number */
>> 157 }cisco;
>> 158
>> 159 struct {
>> 160 raw_hdlc_proto settings;
>> 161 }raw_hdlc;
>> 162
>> 163 struct {
>> 164 struct ppp_device pppdev;
>> 165 struct ppp_device *syncppp_ptr;
>> 166 int (*old_change_mtu)(struct net_device *dev,
>> 167 int new_mtu);
>> 168 }ppp;
>> 169 }state;
>> 170 }hdlc_device;
51 171
52 172
53 173
54 /* Exported from hdlc module */ !! 174 int hdlc_raw_ioctl(hdlc_device *hdlc, struct ifreq *ifr);
>> 175 int hdlc_raw_eth_ioctl(hdlc_device *hdlc, struct ifreq *ifr);
>> 176 int hdlc_cisco_ioctl(hdlc_device *hdlc, struct ifreq *ifr);
>> 177 int hdlc_ppp_ioctl(hdlc_device *hdlc, struct ifreq *ifr);
>> 178 int hdlc_fr_ioctl(hdlc_device *hdlc, struct ifreq *ifr);
>> 179 int hdlc_x25_ioctl(hdlc_device *hdlc, struct ifreq *ifr);
>> 180
>> 181
>> 182 /* Exported from hdlc.o */
55 183
56 /* Called by hardware driver when a user reque 184 /* Called by hardware driver when a user requests HDLC service */
57 int hdlc_ioctl(struct net_device *dev, struct !! 185 int hdlc_ioctl(struct net_device *dev, struct ifreq *ifr, int cmd);
58 186
59 /* Must be used by hardware driver on module s 187 /* Must be used by hardware driver on module startup/exit */
60 #define register_hdlc_device(dev) regist !! 188 int register_hdlc_device(hdlc_device *hdlc);
61 void unregister_hdlc_device(struct net_device !! 189 void unregister_hdlc_device(hdlc_device *hdlc);
>> 190
>> 191
>> 192 static __inline__ struct net_device* hdlc_to_dev(hdlc_device *hdlc)
>> 193 {
>> 194 return &hdlc->netdev;
>> 195 }
>> 196
>> 197
>> 198 static __inline__ hdlc_device* dev_to_hdlc(struct net_device *dev)
>> 199 {
>> 200 return (hdlc_device*)dev;
>> 201 }
62 202
63 203
64 void register_hdlc_protocol(struct hdlc_proto !! 204 static __inline__ pvc_device* dev_to_pvc(struct net_device *dev)
65 void unregister_hdlc_protocol(struct hdlc_prot !! 205 {
>> 206 return (pvc_device*)dev->priv;
>> 207 }
66 208
67 struct net_device *alloc_hdlcdev(void *priv); <<
68 209
69 static inline struct hdlc_device* dev_to_hdlc( !! 210 static __inline__ const char *hdlc_to_name(hdlc_device *hdlc)
70 { 211 {
71 return netdev_priv(dev); !! 212 return hdlc_to_dev(hdlc)->name;
72 } 213 }
73 214
>> 215
74 static __inline__ void debug_frame(const struc 216 static __inline__ void debug_frame(const struct sk_buff *skb)
75 { 217 {
76 int i; 218 int i;
77 219
78 for (i=0; i < skb->len; i++) { 220 for (i=0; i < skb->len; i++) {
79 if (i == 100) { 221 if (i == 100) {
80 printk("...\n"); 222 printk("...\n");
81 return; 223 return;
82 } 224 }
83 printk(" %02X", skb->data[i]); 225 printk(" %02X", skb->data[i]);
84 } 226 }
85 printk("\n"); 227 printk("\n");
86 } 228 }
87 229
88 230
89 /* Must be called by hardware driver when HDLC 231 /* Must be called by hardware driver when HDLC device is being opened */
90 int hdlc_open(struct net_device *dev); !! 232 int hdlc_open(hdlc_device *hdlc);
91 /* Must be called by hardware driver when HDLC 233 /* Must be called by hardware driver when HDLC device is being closed */
92 void hdlc_close(struct net_device *dev); !! 234 void hdlc_close(hdlc_device *hdlc);
93 /* Must be pointed to by hw driver's dev->netd !! 235 /* Called by hardware driver when DCD line level changes */
94 netdev_tx_t hdlc_start_xmit(struct sk_buff *sk !! 236 void hdlc_set_carrier(int on, hdlc_device *hdlc);
95 237
96 int attach_hdlc_protocol(struct net_device *de <<
97 size_t size); <<
98 /* May be used by hardware driver to gain cont 238 /* May be used by hardware driver to gain control over HDLC device */
99 int detach_hdlc_protocol(struct net_device *de !! 239 static __inline__ void hdlc_proto_detach(hdlc_device *hdlc)
100 <<
101 static __inline__ __be16 hdlc_type_trans(struc <<
102 struc <<
103 { 240 {
104 hdlc_device *hdlc = dev_to_hdlc(dev); !! 241 if (hdlc->proto.detach)
>> 242 hdlc->proto.detach(hdlc);
>> 243 hdlc->proto.detach = NULL;
>> 244 }
105 245
106 skb->dev = dev; <<
107 skb_reset_mac_header(skb); <<
108 246
109 if (hdlc->proto->type_trans) !! 247 static __inline__ unsigned short hdlc_type_trans(struct sk_buff *skb,
110 return hdlc->proto->type_trans !! 248 struct net_device *dev)
>> 249 {
>> 250 hdlc_device *hdlc = dev_to_hdlc(skb->dev);
>> 251 if (hdlc->proto.type_trans)
>> 252 return hdlc->proto.type_trans(skb, dev);
111 else 253 else
112 return htons(ETH_P_HDLC); !! 254 return __constant_htons(ETH_P_HDLC);
113 } 255 }
114 256
>> 257 #endif /* __KERNEL */
115 #endif /* __HDLC_H */ 258 #endif /* __HDLC_H */
116 259
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.