1 // SPDX-License-Identifier: GPL-2.0-only 2 /* Copyright (C) 2005 Marc Kleine-Budde, Pengutronix 3 * Copyright (C) 2006 Andrey Volkov, Varma Electronics 4 * Copyright (C) 2008-2009 Wolfgang Grandegger <wg@grandegger.com> 5 */ 6 7 #include <linux/can/dev.h> 8 #include <linux/module.h> 9 10 #define MOD_DESC "CAN device driver interface" 11 12 MODULE_DESCRIPTION(MOD_DESC); 13 MODULE_LICENSE("GPL v2"); 14 MODULE_AUTHOR("Wolfgang Grandegger <wg@grandegger.com>"); 15 16 /* Local echo of CAN messages 17 * 18 * CAN network devices *should* support a local echo functionality 19 * (see Documentation/networking/can.rst). To test the handling of CAN 20 * interfaces that do not support the local echo both driver types are 21 * implemented. In the case that the driver does not support the echo 22 * the IFF_ECHO remains clear in dev->flags. This causes the PF_CAN core 23 * to perform the echo as a fallback solution. 24 */ 25 void can_flush_echo_skb(struct net_device *dev) 26 { 27 struct can_priv *priv = netdev_priv(dev); 28 struct net_device_stats *stats = &dev->stats; 29 int i; 30 31 for (i = 0; i < priv->echo_skb_max; i++) { 32 if (priv->echo_skb[i]) { 33 kfree_skb(priv->echo_skb[i]); 34 priv->echo_skb[i] = NULL; 35 stats->tx_dropped++; 36 stats->tx_aborted_errors++; 37 } 38 } 39 } 40 41 /* Put the skb on the stack to be looped backed locally lateron 42 * 43 * The function is typically called in the start_xmit function 44 * of the device driver. The driver must protect access to 45 * priv->echo_skb, if necessary. 46 */ 47 int can_put_echo_skb(struct sk_buff *skb, struct net_device *dev, 48 unsigned int idx, unsigned int frame_len) 49 { 50 struct can_priv *priv = netdev_priv(dev); 51 52 BUG_ON(idx >= priv->echo_skb_max); 53 54 /* check flag whether this packet has to be looped back */ 55 if (!(dev->flags & IFF_ECHO) || 56 (skb->protocol != htons(ETH_P_CAN) && 57 skb->protocol != htons(ETH_P_CANFD) && 58 skb->protocol != htons(ETH_P_CANXL))) { 59 kfree_skb(skb); 60 return 0; 61 } 62 63 if (!priv->echo_skb[idx]) { 64 skb = can_create_echo_skb(skb); 65 if (!skb) 66 return -ENOMEM; 67 68 /* make settings for echo to reduce code in irq context */ 69 skb->ip_summed = CHECKSUM_UNNECESSARY; 70 skb->dev = dev; 71 72 /* save frame_len to reuse it when transmission is completed */ 73 can_skb_prv(skb)->frame_len = frame_len; 74 75 if (skb_shinfo(skb)->tx_flags & SKBTX_HW_TSTAMP) 76 skb_shinfo(skb)->tx_flags |= SKBTX_IN_PROGRESS; 77 78 skb_tx_timestamp(skb); 79 80 /* save this skb for tx interrupt echo handling */ 81 priv->echo_skb[idx] = skb; 82 } else { 83 /* locking problem with netif_stop_queue() ?? */ 84 netdev_err(dev, "%s: BUG! echo_skb %d is occupied!\n", __func__, idx); 85 kfree_skb(skb); 86 return -EBUSY; 87 } 88 89 return 0; 90 } 91 EXPORT_SYMBOL_GPL(can_put_echo_skb); 92 93 struct sk_buff * 94 __can_get_echo_skb(struct net_device *dev, unsigned int idx, 95 unsigned int *len_ptr, unsigned int *frame_len_ptr) 96 { 97 struct can_priv *priv = netdev_priv(dev); 98 99 if (idx >= priv->echo_skb_max) { 100 netdev_err(dev, "%s: BUG! Trying to access can_priv::echo_skb out of bounds (%u/max %u)\n", 101 __func__, idx, priv->echo_skb_max); 102 return NULL; 103 } 104 105 if (priv->echo_skb[idx]) { 106 /* Using "struct canfd_frame::len" for the frame 107 * length is supported on both CAN and CANFD frames. 108 */ 109 struct sk_buff *skb = priv->echo_skb[idx]; 110 struct can_skb_priv *can_skb_priv = can_skb_prv(skb); 111 112 if (skb_shinfo(skb)->tx_flags & SKBTX_IN_PROGRESS) 113 skb_tstamp_tx(skb, skb_hwtstamps(skb)); 114 115 /* get the real payload length for netdev statistics */ 116 *len_ptr = can_skb_get_data_len(skb); 117 118 if (frame_len_ptr) 119 *frame_len_ptr = can_skb_priv->frame_len; 120 121 priv->echo_skb[idx] = NULL; 122 123 if (skb->pkt_type == PACKET_LOOPBACK) { 124 skb->pkt_type = PACKET_BROADCAST; 125 } else { 126 dev_consume_skb_any(skb); 127 return NULL; 128 } 129 130 return skb; 131 } 132 133 return NULL; 134 } 135 136 /* Get the skb from the stack and loop it back locally 137 * 138 * The function is typically called when the TX done interrupt 139 * is handled in the device driver. The driver must protect 140 * access to priv->echo_skb, if necessary. 141 */ 142 unsigned int can_get_echo_skb(struct net_device *dev, unsigned int idx, 143 unsigned int *frame_len_ptr) 144 { 145 struct sk_buff *skb; 146 unsigned int len; 147 148 skb = __can_get_echo_skb(dev, idx, &len, frame_len_ptr); 149 if (!skb) 150 return 0; 151 152 skb_get(skb); 153 if (netif_rx(skb) == NET_RX_SUCCESS) 154 dev_consume_skb_any(skb); 155 else 156 dev_kfree_skb_any(skb); 157 158 return len; 159 } 160 EXPORT_SYMBOL_GPL(can_get_echo_skb); 161 162 /* Remove the skb from the stack and free it. 163 * 164 * The function is typically called when TX failed. 165 */ 166 void can_free_echo_skb(struct net_device *dev, unsigned int idx, 167 unsigned int *frame_len_ptr) 168 { 169 struct can_priv *priv = netdev_priv(dev); 170 171 if (idx >= priv->echo_skb_max) { 172 netdev_err(dev, "%s: BUG! Trying to access can_priv::echo_skb out of bounds (%u/max %u)\n", 173 __func__, idx, priv->echo_skb_max); 174 return; 175 } 176 177 if (priv->echo_skb[idx]) { 178 struct sk_buff *skb = priv->echo_skb[idx]; 179 struct can_skb_priv *can_skb_priv = can_skb_prv(skb); 180 181 if (frame_len_ptr) 182 *frame_len_ptr = can_skb_priv->frame_len; 183 184 dev_kfree_skb_any(skb); 185 priv->echo_skb[idx] = NULL; 186 } 187 } 188 EXPORT_SYMBOL_GPL(can_free_echo_skb); 189 190 /* fill common values for CAN sk_buffs */ 191 static void init_can_skb_reserve(struct sk_buff *skb) 192 { 193 skb->pkt_type = PACKET_BROADCAST; 194 skb->ip_summed = CHECKSUM_UNNECESSARY; 195 196 skb_reset_mac_header(skb); 197 skb_reset_network_header(skb); 198 skb_reset_transport_header(skb); 199 200 can_skb_reserve(skb); 201 can_skb_prv(skb)->skbcnt = 0; 202 } 203 204 struct sk_buff *alloc_can_skb(struct net_device *dev, struct can_frame **cf) 205 { 206 struct sk_buff *skb; 207 208 skb = netdev_alloc_skb(dev, sizeof(struct can_skb_priv) + 209 sizeof(struct can_frame)); 210 if (unlikely(!skb)) { 211 *cf = NULL; 212 213 return NULL; 214 } 215 216 skb->protocol = htons(ETH_P_CAN); 217 init_can_skb_reserve(skb); 218 can_skb_prv(skb)->ifindex = dev->ifindex; 219 220 *cf = skb_put_zero(skb, sizeof(struct can_frame)); 221 222 return skb; 223 } 224 EXPORT_SYMBOL_GPL(alloc_can_skb); 225 226 struct sk_buff *alloc_canfd_skb(struct net_device *dev, 227 struct canfd_frame **cfd) 228 { 229 struct sk_buff *skb; 230 231 skb = netdev_alloc_skb(dev, sizeof(struct can_skb_priv) + 232 sizeof(struct canfd_frame)); 233 if (unlikely(!skb)) { 234 *cfd = NULL; 235 236 return NULL; 237 } 238 239 skb->protocol = htons(ETH_P_CANFD); 240 init_can_skb_reserve(skb); 241 can_skb_prv(skb)->ifindex = dev->ifindex; 242 243 *cfd = skb_put_zero(skb, sizeof(struct canfd_frame)); 244 245 /* set CAN FD flag by default */ 246 (*cfd)->flags = CANFD_FDF; 247 248 return skb; 249 } 250 EXPORT_SYMBOL_GPL(alloc_canfd_skb); 251 252 struct sk_buff *alloc_canxl_skb(struct net_device *dev, 253 struct canxl_frame **cxl, 254 unsigned int data_len) 255 { 256 struct sk_buff *skb; 257 258 if (data_len < CANXL_MIN_DLEN || data_len > CANXL_MAX_DLEN) 259 goto out_error; 260 261 skb = netdev_alloc_skb(dev, sizeof(struct can_skb_priv) + 262 CANXL_HDR_SIZE + data_len); 263 if (unlikely(!skb)) 264 goto out_error; 265 266 skb->protocol = htons(ETH_P_CANXL); 267 init_can_skb_reserve(skb); 268 can_skb_prv(skb)->ifindex = dev->ifindex; 269 270 *cxl = skb_put_zero(skb, CANXL_HDR_SIZE + data_len); 271 272 /* set CAN XL flag and length information by default */ 273 (*cxl)->flags = CANXL_XLF; 274 (*cxl)->len = data_len; 275 276 return skb; 277 278 out_error: 279 *cxl = NULL; 280 281 return NULL; 282 } 283 EXPORT_SYMBOL_GPL(alloc_canxl_skb); 284 285 struct sk_buff *alloc_can_err_skb(struct net_device *dev, struct can_frame **cf) 286 { 287 struct sk_buff *skb; 288 289 skb = alloc_can_skb(dev, cf); 290 if (unlikely(!skb)) 291 return NULL; 292 293 (*cf)->can_id = CAN_ERR_FLAG; 294 (*cf)->len = CAN_ERR_DLC; 295 296 return skb; 297 } 298 EXPORT_SYMBOL_GPL(alloc_can_err_skb); 299 300 /* Check for outgoing skbs that have not been created by the CAN subsystem */ 301 static bool can_skb_headroom_valid(struct net_device *dev, struct sk_buff *skb) 302 { 303 /* af_packet creates a headroom of HH_DATA_MOD bytes which is fine */ 304 if (WARN_ON_ONCE(skb_headroom(skb) < sizeof(struct can_skb_priv))) 305 return false; 306 307 /* af_packet does not apply CAN skb specific settings */ 308 if (skb->ip_summed == CHECKSUM_NONE) { 309 /* init headroom */ 310 can_skb_prv(skb)->ifindex = dev->ifindex; 311 can_skb_prv(skb)->skbcnt = 0; 312 313 skb->ip_summed = CHECKSUM_UNNECESSARY; 314 315 /* perform proper loopback on capable devices */ 316 if (dev->flags & IFF_ECHO) 317 skb->pkt_type = PACKET_LOOPBACK; 318 else 319 skb->pkt_type = PACKET_HOST; 320 321 skb_reset_mac_header(skb); 322 skb_reset_network_header(skb); 323 skb_reset_transport_header(skb); 324 325 /* set CANFD_FDF flag for CAN FD frames */ 326 if (can_is_canfd_skb(skb)) { 327 struct canfd_frame *cfd; 328 329 cfd = (struct canfd_frame *)skb->data; 330 cfd->flags |= CANFD_FDF; 331 } 332 } 333 334 return true; 335 } 336 337 /* Drop a given socketbuffer if it does not contain a valid CAN frame. */ 338 bool can_dropped_invalid_skb(struct net_device *dev, struct sk_buff *skb) 339 { 340 switch (ntohs(skb->protocol)) { 341 case ETH_P_CAN: 342 if (!can_is_can_skb(skb)) 343 goto inval_skb; 344 break; 345 346 case ETH_P_CANFD: 347 if (!can_is_canfd_skb(skb)) 348 goto inval_skb; 349 break; 350 351 case ETH_P_CANXL: 352 if (!can_is_canxl_skb(skb)) 353 goto inval_skb; 354 break; 355 356 default: 357 goto inval_skb; 358 } 359 360 if (!can_skb_headroom_valid(dev, skb)) 361 goto inval_skb; 362 363 return false; 364 365 inval_skb: 366 kfree_skb(skb); 367 dev->stats.tx_dropped++; 368 return true; 369 } 370 EXPORT_SYMBOL_GPL(can_dropped_invalid_skb); 371