2 * bcm.c - Broadcast Manager to filter/send (cyclic) CAN content
4 * Copyright (c) 2002-2016 Volkswagen Group Electronic Research
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * 3. Neither the name of Volkswagen nor the names of its contributors
16 * may be used to endorse or promote products derived from this software
17 * without specific prior written permission.
19 * Alternatively, provided that this notice is retained in full, this
20 * software may be distributed under the terms of the GNU General
21 * Public License ("GPL") version 2, in which case the provisions of the
22 * GPL apply INSTEAD OF those given above.
24 * The provided data structures and external interfaces from this code
25 * are not restricted to be used by modules with a GPL compatible license.
27 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
28 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
29 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
30 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
31 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
32 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
33 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
34 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
35 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
36 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
37 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
42 #include <linux/module.h>
43 #include <linux/init.h>
44 #include <linux/interrupt.h>
45 #include <linux/hrtimer.h>
46 #include <linux/list.h>
47 #include <linux/proc_fs.h>
48 #include <linux/seq_file.h>
49 #include <linux/uio.h>
50 #include <linux/net.h>
51 #include <linux/netdevice.h>
52 #include <linux/socket.h>
53 #include <linux/if_arp.h>
54 #include <linux/skbuff.h>
55 #include <linux/can.h>
56 #include <linux/can/core.h>
57 #include <linux/can/skb.h>
58 #include <linux/can/bcm.h>
59 #include <linux/slab.h>
61 #include <net/net_namespace.h>
64 * To send multiple CAN frame content within TX_SETUP or to filter
65 * CAN messages with multiplex index within RX_SETUP, the number of
66 * different filters is limited to 256 due to the one byte index value.
68 #define MAX_NFRAMES 256
70 /* use of last_frames[index].flags */
71 #define RX_RECV 0x40 /* received data for this element */
72 #define RX_THR 0x80 /* element not been sent due to throttle feature */
73 #define BCM_CAN_FLAGS_MASK 0x3F /* to clean private flags after usage */
75 /* get best masking value for can_rx_register() for a given single can_id */
76 #define REGMASK(id) ((id & CAN_EFF_FLAG) ? \
77 (CAN_EFF_MASK | CAN_EFF_FLAG | CAN_RTR_FLAG) : \
78 (CAN_SFF_MASK | CAN_EFF_FLAG | CAN_RTR_FLAG))
80 #define CAN_BCM_VERSION "20160617"
82 MODULE_DESCRIPTION("PF_CAN broadcast manager protocol");
83 MODULE_LICENSE("Dual BSD/GPL");
84 MODULE_AUTHOR("Oliver Hartkopp <oliver.hartkopp@volkswagen.de>");
85 MODULE_ALIAS("can-proto-2");
88 * easy access to the first 64 bit of can(fd)_frame payload. cp->data is
89 * 64 bit aligned so the offset has to be multiples of 8 which is ensured
90 * by the only callers in bcm_rx_cmp_to_index() bcm_rx_handler().
92 static inline u64
get_u64(const struct canfd_frame
*cp
, int offset
)
94 return *(u64
*)(cp
->data
+ offset
);
98 struct list_head list
;
102 unsigned long frames_abs
, frames_filtered
;
103 struct bcm_timeval ival1
, ival2
;
104 struct hrtimer timer
, thrtimer
;
105 struct tasklet_struct tsklet
, thrtsklet
;
106 ktime_t rx_stamp
, kt_ival1
, kt_ival2
, kt_lastmsg
;
112 struct canfd_frame
*frames
;
113 struct canfd_frame
*last_frames
;
114 struct canfd_frame sframe
;
115 struct canfd_frame last_sframe
;
117 struct net_device
*rx_reg_dev
;
120 static struct proc_dir_entry
*proc_dir
;
126 struct notifier_block notifier
;
127 struct list_head rx_ops
;
128 struct list_head tx_ops
;
129 unsigned long dropped_usr_msgs
;
130 struct proc_dir_entry
*bcm_proc_read
;
131 char procname
[32]; /* inode number in decimal with \0 */
134 static inline struct bcm_sock
*bcm_sk(const struct sock
*sk
)
136 return (struct bcm_sock
*)sk
;
139 static inline ktime_t
bcm_timeval_to_ktime(struct bcm_timeval tv
)
141 return ktime_set(tv
.tv_sec
, tv
.tv_usec
* NSEC_PER_USEC
);
144 #define CFSIZ(flags) ((flags & CAN_FD_FRAME) ? CANFD_MTU : CAN_MTU)
145 #define OPSIZ sizeof(struct bcm_op)
146 #define MHSIZ sizeof(struct bcm_msg_head)
151 static char *bcm_proc_getifname(char *result
, int ifindex
)
153 struct net_device
*dev
;
159 dev
= dev_get_by_index_rcu(&init_net
, ifindex
);
161 strcpy(result
, dev
->name
);
163 strcpy(result
, "???");
169 static int bcm_proc_show(struct seq_file
*m
, void *v
)
171 char ifname
[IFNAMSIZ
];
172 struct sock
*sk
= (struct sock
*)m
->private;
173 struct bcm_sock
*bo
= bcm_sk(sk
);
176 seq_printf(m
, ">>> socket %pK", sk
->sk_socket
);
177 seq_printf(m
, " / sk %pK", sk
);
178 seq_printf(m
, " / bo %pK", bo
);
179 seq_printf(m
, " / dropped %lu", bo
->dropped_usr_msgs
);
180 seq_printf(m
, " / bound %s", bcm_proc_getifname(ifname
, bo
->ifindex
));
181 seq_printf(m
, " <<<\n");
183 list_for_each_entry(op
, &bo
->rx_ops
, list
) {
185 unsigned long reduction
;
187 /* print only active entries & prevent division by zero */
191 seq_printf(m
, "rx_op: %03X %-5s ", op
->can_id
,
192 bcm_proc_getifname(ifname
, op
->ifindex
));
194 if (op
->flags
& CAN_FD_FRAME
)
195 seq_printf(m
, "(%u)", op
->nframes
);
197 seq_printf(m
, "[%u]", op
->nframes
);
199 seq_printf(m
, "%c ", (op
->flags
& RX_CHECK_DLC
) ? 'd' : ' ');
201 if (op
->kt_ival1
.tv64
)
202 seq_printf(m
, "timeo=%lld ",
203 (long long)ktime_to_us(op
->kt_ival1
));
205 if (op
->kt_ival2
.tv64
)
206 seq_printf(m
, "thr=%lld ",
207 (long long)ktime_to_us(op
->kt_ival2
));
209 seq_printf(m
, "# recv %ld (%ld) => reduction: ",
210 op
->frames_filtered
, op
->frames_abs
);
212 reduction
= 100 - (op
->frames_filtered
* 100) / op
->frames_abs
;
214 seq_printf(m
, "%s%ld%%\n",
215 (reduction
== 100) ? "near " : "", reduction
);
218 list_for_each_entry(op
, &bo
->tx_ops
, list
) {
220 seq_printf(m
, "tx_op: %03X %s ", op
->can_id
,
221 bcm_proc_getifname(ifname
, op
->ifindex
));
223 if (op
->flags
& CAN_FD_FRAME
)
224 seq_printf(m
, "(%u) ", op
->nframes
);
226 seq_printf(m
, "[%u] ", op
->nframes
);
228 if (op
->kt_ival1
.tv64
)
229 seq_printf(m
, "t1=%lld ",
230 (long long)ktime_to_us(op
->kt_ival1
));
232 if (op
->kt_ival2
.tv64
)
233 seq_printf(m
, "t2=%lld ",
234 (long long)ktime_to_us(op
->kt_ival2
));
236 seq_printf(m
, "# sent %ld\n", op
->frames_abs
);
242 static int bcm_proc_open(struct inode
*inode
, struct file
*file
)
244 return single_open(file
, bcm_proc_show
, PDE_DATA(inode
));
247 static const struct file_operations bcm_proc_fops
= {
248 .owner
= THIS_MODULE
,
249 .open
= bcm_proc_open
,
252 .release
= single_release
,
256 * bcm_can_tx - send the (next) CAN frame to the appropriate CAN interface
257 * of the given bcm tx op
259 static void bcm_can_tx(struct bcm_op
*op
)
262 struct net_device
*dev
;
263 struct canfd_frame
*cf
= op
->frames
+ op
->cfsiz
* op
->currframe
;
265 /* no target device? => exit */
269 dev
= dev_get_by_index(&init_net
, op
->ifindex
);
271 /* RFC: should this bcm_op remove itself here? */
275 skb
= alloc_skb(op
->cfsiz
+ sizeof(struct can_skb_priv
), gfp_any());
279 can_skb_reserve(skb
);
280 can_skb_prv(skb
)->ifindex
= dev
->ifindex
;
281 can_skb_prv(skb
)->skbcnt
= 0;
283 memcpy(skb_put(skb
, op
->cfsiz
), cf
, op
->cfsiz
);
285 /* send with loopback */
287 can_skb_set_owner(skb
, op
->sk
);
290 /* update statistics */
294 /* reached last frame? */
295 if (op
->currframe
>= op
->nframes
)
302 * bcm_send_to_user - send a BCM message to the userspace
303 * (consisting of bcm_msg_head + x CAN frames)
305 static void bcm_send_to_user(struct bcm_op
*op
, struct bcm_msg_head
*head
,
306 struct canfd_frame
*frames
, int has_timestamp
)
309 struct canfd_frame
*firstframe
;
310 struct sockaddr_can
*addr
;
311 struct sock
*sk
= op
->sk
;
312 unsigned int datalen
= head
->nframes
* op
->cfsiz
;
315 skb
= alloc_skb(sizeof(*head
) + datalen
, gfp_any());
319 memcpy(skb_put(skb
, sizeof(*head
)), head
, sizeof(*head
));
322 /* CAN frames starting here */
323 firstframe
= (struct canfd_frame
*)skb_tail_pointer(skb
);
325 memcpy(skb_put(skb
, datalen
), frames
, datalen
);
328 * the BCM uses the flags-element of the canfd_frame
329 * structure for internal purposes. This is only
330 * relevant for updates that are generated by the
331 * BCM, where nframes is 1
333 if (head
->nframes
== 1)
334 firstframe
->flags
&= BCM_CAN_FLAGS_MASK
;
338 /* restore rx timestamp */
339 skb
->tstamp
= op
->rx_stamp
;
343 * Put the datagram to the queue so that bcm_recvmsg() can
344 * get it from there. We need to pass the interface index to
345 * bcm_recvmsg(). We pass a whole struct sockaddr_can in skb->cb
346 * containing the interface index.
349 sock_skb_cb_check_size(sizeof(struct sockaddr_can
));
350 addr
= (struct sockaddr_can
*)skb
->cb
;
351 memset(addr
, 0, sizeof(*addr
));
352 addr
->can_family
= AF_CAN
;
353 addr
->can_ifindex
= op
->rx_ifindex
;
355 err
= sock_queue_rcv_skb(sk
, skb
);
357 struct bcm_sock
*bo
= bcm_sk(sk
);
360 /* don't care about overflows in this statistic */
361 bo
->dropped_usr_msgs
++;
365 static void bcm_tx_start_timer(struct bcm_op
*op
)
367 if (op
->kt_ival1
.tv64
&& op
->count
)
368 hrtimer_start(&op
->timer
,
369 ktime_add(ktime_get(), op
->kt_ival1
),
371 else if (op
->kt_ival2
.tv64
)
372 hrtimer_start(&op
->timer
,
373 ktime_add(ktime_get(), op
->kt_ival2
),
377 static void bcm_tx_timeout_tsklet(unsigned long data
)
379 struct bcm_op
*op
= (struct bcm_op
*)data
;
380 struct bcm_msg_head msg_head
;
382 if (op
->kt_ival1
.tv64
&& (op
->count
> 0)) {
385 if (!op
->count
&& (op
->flags
& TX_COUNTEVT
)) {
387 /* create notification to user */
388 msg_head
.opcode
= TX_EXPIRED
;
389 msg_head
.flags
= op
->flags
;
390 msg_head
.count
= op
->count
;
391 msg_head
.ival1
= op
->ival1
;
392 msg_head
.ival2
= op
->ival2
;
393 msg_head
.can_id
= op
->can_id
;
394 msg_head
.nframes
= 0;
396 bcm_send_to_user(op
, &msg_head
, NULL
, 0);
400 } else if (op
->kt_ival2
.tv64
)
403 bcm_tx_start_timer(op
);
407 * bcm_tx_timeout_handler - performs cyclic CAN frame transmissions
409 static enum hrtimer_restart
bcm_tx_timeout_handler(struct hrtimer
*hrtimer
)
411 struct bcm_op
*op
= container_of(hrtimer
, struct bcm_op
, timer
);
413 tasklet_schedule(&op
->tsklet
);
415 return HRTIMER_NORESTART
;
419 * bcm_rx_changed - create a RX_CHANGED notification due to changed content
421 static void bcm_rx_changed(struct bcm_op
*op
, struct canfd_frame
*data
)
423 struct bcm_msg_head head
;
425 /* update statistics */
426 op
->frames_filtered
++;
428 /* prevent statistics overflow */
429 if (op
->frames_filtered
> ULONG_MAX
/100)
430 op
->frames_filtered
= op
->frames_abs
= 0;
432 /* this element is not throttled anymore */
433 data
->flags
&= (BCM_CAN_FLAGS_MASK
|RX_RECV
);
435 head
.opcode
= RX_CHANGED
;
436 head
.flags
= op
->flags
;
437 head
.count
= op
->count
;
438 head
.ival1
= op
->ival1
;
439 head
.ival2
= op
->ival2
;
440 head
.can_id
= op
->can_id
;
443 bcm_send_to_user(op
, &head
, data
, 1);
447 * bcm_rx_update_and_send - process a detected relevant receive content change
448 * 1. update the last received data
449 * 2. send a notification to the user (if possible)
451 static void bcm_rx_update_and_send(struct bcm_op
*op
,
452 struct canfd_frame
*lastdata
,
453 const struct canfd_frame
*rxdata
)
455 memcpy(lastdata
, rxdata
, op
->cfsiz
);
457 /* mark as used and throttled by default */
458 lastdata
->flags
|= (RX_RECV
|RX_THR
);
460 /* throttling mode inactive ? */
461 if (!op
->kt_ival2
.tv64
) {
462 /* send RX_CHANGED to the user immediately */
463 bcm_rx_changed(op
, lastdata
);
467 /* with active throttling timer we are just done here */
468 if (hrtimer_active(&op
->thrtimer
))
471 /* first reception with enabled throttling mode */
472 if (!op
->kt_lastmsg
.tv64
)
473 goto rx_changed_settime
;
475 /* got a second frame inside a potential throttle period? */
476 if (ktime_us_delta(ktime_get(), op
->kt_lastmsg
) <
477 ktime_to_us(op
->kt_ival2
)) {
478 /* do not send the saved data - only start throttle timer */
479 hrtimer_start(&op
->thrtimer
,
480 ktime_add(op
->kt_lastmsg
, op
->kt_ival2
),
485 /* the gap was that big, that throttling was not needed here */
487 bcm_rx_changed(op
, lastdata
);
488 op
->kt_lastmsg
= ktime_get();
492 * bcm_rx_cmp_to_index - (bit)compares the currently received data to formerly
493 * received data stored in op->last_frames[]
495 static void bcm_rx_cmp_to_index(struct bcm_op
*op
, unsigned int index
,
496 const struct canfd_frame
*rxdata
)
498 struct canfd_frame
*cf
= op
->frames
+ op
->cfsiz
* index
;
499 struct canfd_frame
*lcf
= op
->last_frames
+ op
->cfsiz
* index
;
503 * no one uses the MSBs of flags for comparison,
504 * so we use it here to detect the first time of reception
507 if (!(lcf
->flags
& RX_RECV
)) {
508 /* received data for the first time => send update to user */
509 bcm_rx_update_and_send(op
, lcf
, rxdata
);
513 /* do a real check in CAN frame data section */
514 for (i
= 0; i
< rxdata
->len
; i
+= 8) {
515 if ((get_u64(cf
, i
) & get_u64(rxdata
, i
)) !=
516 (get_u64(cf
, i
) & get_u64(lcf
, i
))) {
517 bcm_rx_update_and_send(op
, lcf
, rxdata
);
522 if (op
->flags
& RX_CHECK_DLC
) {
523 /* do a real check in CAN frame length */
524 if (rxdata
->len
!= lcf
->len
) {
525 bcm_rx_update_and_send(op
, lcf
, rxdata
);
532 * bcm_rx_starttimer - enable timeout monitoring for CAN frame reception
534 static void bcm_rx_starttimer(struct bcm_op
*op
)
536 if (op
->flags
& RX_NO_AUTOTIMER
)
539 if (op
->kt_ival1
.tv64
)
540 hrtimer_start(&op
->timer
, op
->kt_ival1
, HRTIMER_MODE_REL
);
543 static void bcm_rx_timeout_tsklet(unsigned long data
)
545 struct bcm_op
*op
= (struct bcm_op
*)data
;
546 struct bcm_msg_head msg_head
;
548 /* create notification to user */
549 msg_head
.opcode
= RX_TIMEOUT
;
550 msg_head
.flags
= op
->flags
;
551 msg_head
.count
= op
->count
;
552 msg_head
.ival1
= op
->ival1
;
553 msg_head
.ival2
= op
->ival2
;
554 msg_head
.can_id
= op
->can_id
;
555 msg_head
.nframes
= 0;
557 bcm_send_to_user(op
, &msg_head
, NULL
, 0);
561 * bcm_rx_timeout_handler - when the (cyclic) CAN frame reception timed out
563 static enum hrtimer_restart
bcm_rx_timeout_handler(struct hrtimer
*hrtimer
)
565 struct bcm_op
*op
= container_of(hrtimer
, struct bcm_op
, timer
);
567 /* schedule before NET_RX_SOFTIRQ */
568 tasklet_hi_schedule(&op
->tsklet
);
570 /* no restart of the timer is done here! */
572 /* if user wants to be informed, when cyclic CAN-Messages come back */
573 if ((op
->flags
& RX_ANNOUNCE_RESUME
) && op
->last_frames
) {
574 /* clear received CAN frames to indicate 'nothing received' */
575 memset(op
->last_frames
, 0, op
->nframes
* op
->cfsiz
);
578 return HRTIMER_NORESTART
;
582 * bcm_rx_do_flush - helper for bcm_rx_thr_flush
584 static inline int bcm_rx_do_flush(struct bcm_op
*op
, int update
,
587 struct canfd_frame
*lcf
= op
->last_frames
+ op
->cfsiz
* index
;
589 if ((op
->last_frames
) && (lcf
->flags
& RX_THR
)) {
591 bcm_rx_changed(op
, lcf
);
598 * bcm_rx_thr_flush - Check for throttled data and send it to the userspace
600 * update == 0 : just check if throttled data is available (any irq context)
601 * update == 1 : check and send throttled data to userspace (soft_irq context)
603 static int bcm_rx_thr_flush(struct bcm_op
*op
, int update
)
607 if (op
->nframes
> 1) {
610 /* for MUX filter we start at index 1 */
611 for (i
= 1; i
< op
->nframes
; i
++)
612 updated
+= bcm_rx_do_flush(op
, update
, i
);
615 /* for RX_FILTER_ID and simple filter */
616 updated
+= bcm_rx_do_flush(op
, update
, 0);
622 static void bcm_rx_thr_tsklet(unsigned long data
)
624 struct bcm_op
*op
= (struct bcm_op
*)data
;
626 /* push the changed data to the userspace */
627 bcm_rx_thr_flush(op
, 1);
631 * bcm_rx_thr_handler - the time for blocked content updates is over now:
632 * Check for throttled data and send it to the userspace
634 static enum hrtimer_restart
bcm_rx_thr_handler(struct hrtimer
*hrtimer
)
636 struct bcm_op
*op
= container_of(hrtimer
, struct bcm_op
, thrtimer
);
638 tasklet_schedule(&op
->thrtsklet
);
640 if (bcm_rx_thr_flush(op
, 0)) {
641 hrtimer_forward(hrtimer
, ktime_get(), op
->kt_ival2
);
642 return HRTIMER_RESTART
;
644 /* rearm throttle handling */
645 op
->kt_lastmsg
= ktime_set(0, 0);
646 return HRTIMER_NORESTART
;
651 * bcm_rx_handler - handle a CAN frame reception
653 static void bcm_rx_handler(struct sk_buff
*skb
, void *data
)
655 struct bcm_op
*op
= (struct bcm_op
*)data
;
656 const struct canfd_frame
*rxframe
= (struct canfd_frame
*)skb
->data
;
659 if (op
->can_id
!= rxframe
->can_id
)
662 /* make sure to handle the correct frame type (CAN / CAN FD) */
663 if (skb
->len
!= op
->cfsiz
)
666 /* disable timeout */
667 hrtimer_cancel(&op
->timer
);
669 /* save rx timestamp */
670 op
->rx_stamp
= skb
->tstamp
;
671 /* save originator for recvfrom() */
672 op
->rx_ifindex
= skb
->dev
->ifindex
;
673 /* update statistics */
676 if (op
->flags
& RX_RTR_FRAME
) {
677 /* send reply for RTR-request (placed in op->frames[0]) */
682 if (op
->flags
& RX_FILTER_ID
) {
683 /* the easiest case */
684 bcm_rx_update_and_send(op
, &op
->last_frames
[0], rxframe
);
688 if (op
->nframes
== 1) {
689 /* simple compare with index 0 */
690 bcm_rx_cmp_to_index(op
, 0, rxframe
);
694 if (op
->nframes
> 1) {
698 * find the first multiplex mask that fits.
699 * Remark: The MUX-mask is stored in index 0 - but only the
700 * first 64 bits of the frame data[] are relevant (CAN FD)
703 for (i
= 1; i
< op
->nframes
; i
++) {
704 if ((get_u64(op
->frames
, 0) & get_u64(rxframe
, 0)) ==
705 (get_u64(op
->frames
, 0) &
706 get_u64(op
->frames
+ op
->cfsiz
* i
, 0))) {
707 bcm_rx_cmp_to_index(op
, i
, rxframe
);
714 bcm_rx_starttimer(op
);
718 * helpers for bcm_op handling: find & delete bcm [rx|tx] op elements
720 static struct bcm_op
*bcm_find_op(struct list_head
*ops
,
721 struct bcm_msg_head
*mh
, int ifindex
)
725 list_for_each_entry(op
, ops
, list
) {
726 if ((op
->can_id
== mh
->can_id
) && (op
->ifindex
== ifindex
) &&
727 (op
->flags
& CAN_FD_FRAME
) == (mh
->flags
& CAN_FD_FRAME
))
734 static void bcm_remove_op(struct bcm_op
*op
)
736 hrtimer_cancel(&op
->timer
);
737 hrtimer_cancel(&op
->thrtimer
);
740 tasklet_kill(&op
->tsklet
);
742 if (op
->thrtsklet
.func
)
743 tasklet_kill(&op
->thrtsklet
);
745 if ((op
->frames
) && (op
->frames
!= &op
->sframe
))
748 if ((op
->last_frames
) && (op
->last_frames
!= &op
->last_sframe
))
749 kfree(op
->last_frames
);
754 static void bcm_rx_unreg(struct net_device
*dev
, struct bcm_op
*op
)
756 if (op
->rx_reg_dev
== dev
) {
757 can_rx_unregister(dev
, op
->can_id
, REGMASK(op
->can_id
),
760 /* mark as removed subscription */
761 op
->rx_reg_dev
= NULL
;
763 printk(KERN_ERR
"can-bcm: bcm_rx_unreg: registered device "
764 "mismatch %p %p\n", op
->rx_reg_dev
, dev
);
768 * bcm_delete_rx_op - find and remove a rx op (returns number of removed ops)
770 static int bcm_delete_rx_op(struct list_head
*ops
, struct bcm_msg_head
*mh
,
773 struct bcm_op
*op
, *n
;
775 list_for_each_entry_safe(op
, n
, ops
, list
) {
776 if ((op
->can_id
== mh
->can_id
) && (op
->ifindex
== ifindex
) &&
777 (op
->flags
& CAN_FD_FRAME
) == (mh
->flags
& CAN_FD_FRAME
)) {
780 * Don't care if we're bound or not (due to netdev
781 * problems) can_rx_unregister() is always a save
786 * Only remove subscriptions that had not
787 * been removed due to NETDEV_UNREGISTER
790 if (op
->rx_reg_dev
) {
791 struct net_device
*dev
;
793 dev
= dev_get_by_index(&init_net
,
796 bcm_rx_unreg(dev
, op
);
801 can_rx_unregister(NULL
, op
->can_id
,
811 return 0; /* not found */
815 * bcm_delete_tx_op - find and remove a tx op (returns number of removed ops)
817 static int bcm_delete_tx_op(struct list_head
*ops
, struct bcm_msg_head
*mh
,
820 struct bcm_op
*op
, *n
;
822 list_for_each_entry_safe(op
, n
, ops
, list
) {
823 if ((op
->can_id
== mh
->can_id
) && (op
->ifindex
== ifindex
) &&
824 (op
->flags
& CAN_FD_FRAME
) == (mh
->flags
& CAN_FD_FRAME
)) {
831 return 0; /* not found */
835 * bcm_read_op - read out a bcm_op and send it to the user (for bcm_sendmsg)
837 static int bcm_read_op(struct list_head
*ops
, struct bcm_msg_head
*msg_head
,
840 struct bcm_op
*op
= bcm_find_op(ops
, msg_head
, ifindex
);
845 /* put current values into msg_head */
846 msg_head
->flags
= op
->flags
;
847 msg_head
->count
= op
->count
;
848 msg_head
->ival1
= op
->ival1
;
849 msg_head
->ival2
= op
->ival2
;
850 msg_head
->nframes
= op
->nframes
;
852 bcm_send_to_user(op
, msg_head
, op
->frames
, 0);
858 * bcm_tx_setup - create or update a bcm tx op (for bcm_sendmsg)
860 static int bcm_tx_setup(struct bcm_msg_head
*msg_head
, struct msghdr
*msg
,
861 int ifindex
, struct sock
*sk
)
863 struct bcm_sock
*bo
= bcm_sk(sk
);
865 struct canfd_frame
*cf
;
869 /* we need a real device to send frames */
873 /* check nframes boundaries - we need at least one CAN frame */
874 if (msg_head
->nframes
< 1 || msg_head
->nframes
> MAX_NFRAMES
)
877 /* check the given can_id */
878 op
= bcm_find_op(&bo
->tx_ops
, msg_head
, ifindex
);
880 /* update existing BCM operation */
883 * Do we need more space for the CAN frames than currently
884 * allocated? -> This is a _really_ unusual use-case and
885 * therefore (complexity / locking) it is not supported.
887 if (msg_head
->nframes
> op
->nframes
)
890 /* update CAN frames content */
891 for (i
= 0; i
< msg_head
->nframes
; i
++) {
893 cf
= op
->frames
+ op
->cfsiz
* i
;
894 err
= memcpy_from_msg((u8
*)cf
, msg
, op
->cfsiz
);
896 if (op
->flags
& CAN_FD_FRAME
) {
907 if (msg_head
->flags
& TX_CP_CAN_ID
) {
908 /* copy can_id into frame */
909 cf
->can_id
= msg_head
->can_id
;
912 op
->flags
= msg_head
->flags
;
915 /* insert new BCM operation for the given can_id */
917 op
= kzalloc(OPSIZ
, GFP_KERNEL
);
921 op
->can_id
= msg_head
->can_id
;
922 op
->cfsiz
= CFSIZ(msg_head
->flags
);
923 op
->flags
= msg_head
->flags
;
925 /* create array for CAN frames and copy the data */
926 if (msg_head
->nframes
> 1) {
927 op
->frames
= kmalloc(msg_head
->nframes
* op
->cfsiz
,
934 op
->frames
= &op
->sframe
;
936 for (i
= 0; i
< msg_head
->nframes
; i
++) {
938 cf
= op
->frames
+ op
->cfsiz
* i
;
939 err
= memcpy_from_msg((u8
*)cf
, msg
, op
->cfsiz
);
941 if (op
->flags
& CAN_FD_FRAME
) {
950 if (op
->frames
!= &op
->sframe
)
956 if (msg_head
->flags
& TX_CP_CAN_ID
) {
957 /* copy can_id into frame */
958 cf
->can_id
= msg_head
->can_id
;
962 /* tx_ops never compare with previous received messages */
963 op
->last_frames
= NULL
;
965 /* bcm_can_tx / bcm_tx_timeout_handler needs this */
967 op
->ifindex
= ifindex
;
969 /* initialize uninitialized (kzalloc) structure */
970 hrtimer_init(&op
->timer
, CLOCK_MONOTONIC
, HRTIMER_MODE_REL
);
971 op
->timer
.function
= bcm_tx_timeout_handler
;
973 /* initialize tasklet for tx countevent notification */
974 tasklet_init(&op
->tsklet
, bcm_tx_timeout_tsklet
,
977 /* currently unused in tx_ops */
978 hrtimer_init(&op
->thrtimer
, CLOCK_MONOTONIC
, HRTIMER_MODE_REL
);
980 /* add this bcm_op to the list of the tx_ops */
981 list_add(&op
->list
, &bo
->tx_ops
);
983 } /* if ((op = bcm_find_op(&bo->tx_ops, msg_head->can_id, ifindex))) */
985 if (op
->nframes
!= msg_head
->nframes
) {
986 op
->nframes
= msg_head
->nframes
;
987 /* start multiple frame transmission with index 0 */
993 if (op
->flags
& TX_RESET_MULTI_IDX
) {
994 /* start multiple frame transmission with index 0 */
998 if (op
->flags
& SETTIMER
) {
999 /* set timer values */
1000 op
->count
= msg_head
->count
;
1001 op
->ival1
= msg_head
->ival1
;
1002 op
->ival2
= msg_head
->ival2
;
1003 op
->kt_ival1
= bcm_timeval_to_ktime(msg_head
->ival1
);
1004 op
->kt_ival2
= bcm_timeval_to_ktime(msg_head
->ival2
);
1006 /* disable an active timer due to zero values? */
1007 if (!op
->kt_ival1
.tv64
&& !op
->kt_ival2
.tv64
)
1008 hrtimer_cancel(&op
->timer
);
1011 if (op
->flags
& STARTTIMER
) {
1012 hrtimer_cancel(&op
->timer
);
1013 /* spec: send CAN frame when starting timer */
1014 op
->flags
|= TX_ANNOUNCE
;
1017 if (op
->flags
& TX_ANNOUNCE
) {
1023 if (op
->flags
& STARTTIMER
)
1024 bcm_tx_start_timer(op
);
1026 return msg_head
->nframes
* op
->cfsiz
+ MHSIZ
;
1030 * bcm_rx_setup - create or update a bcm rx op (for bcm_sendmsg)
1032 static int bcm_rx_setup(struct bcm_msg_head
*msg_head
, struct msghdr
*msg
,
1033 int ifindex
, struct sock
*sk
)
1035 struct bcm_sock
*bo
= bcm_sk(sk
);
1040 if ((msg_head
->flags
& RX_FILTER_ID
) || (!(msg_head
->nframes
))) {
1041 /* be robust against wrong usage ... */
1042 msg_head
->flags
|= RX_FILTER_ID
;
1043 /* ignore trailing garbage */
1044 msg_head
->nframes
= 0;
1047 /* the first element contains the mux-mask => MAX_NFRAMES + 1 */
1048 if (msg_head
->nframes
> MAX_NFRAMES
+ 1)
1051 if ((msg_head
->flags
& RX_RTR_FRAME
) &&
1052 ((msg_head
->nframes
!= 1) ||
1053 (!(msg_head
->can_id
& CAN_RTR_FLAG
))))
1056 /* check the given can_id */
1057 op
= bcm_find_op(&bo
->rx_ops
, msg_head
, ifindex
);
1059 /* update existing BCM operation */
1062 * Do we need more space for the CAN frames than currently
1063 * allocated? -> This is a _really_ unusual use-case and
1064 * therefore (complexity / locking) it is not supported.
1066 if (msg_head
->nframes
> op
->nframes
)
1069 if (msg_head
->nframes
) {
1070 /* update CAN frames content */
1071 err
= memcpy_from_msg((u8
*)op
->frames
, msg
,
1072 msg_head
->nframes
* op
->cfsiz
);
1076 /* clear last_frames to indicate 'nothing received' */
1077 memset(op
->last_frames
, 0, msg_head
->nframes
* op
->cfsiz
);
1080 op
->nframes
= msg_head
->nframes
;
1081 op
->flags
= msg_head
->flags
;
1083 /* Only an update -> do not call can_rx_register() */
1087 /* insert new BCM operation for the given can_id */
1088 op
= kzalloc(OPSIZ
, GFP_KERNEL
);
1092 op
->can_id
= msg_head
->can_id
;
1093 op
->nframes
= msg_head
->nframes
;
1094 op
->cfsiz
= CFSIZ(msg_head
->flags
);
1095 op
->flags
= msg_head
->flags
;
1097 if (msg_head
->nframes
> 1) {
1098 /* create array for CAN frames and copy the data */
1099 op
->frames
= kmalloc(msg_head
->nframes
* op
->cfsiz
,
1106 /* create and init array for received CAN frames */
1107 op
->last_frames
= kzalloc(msg_head
->nframes
* op
->cfsiz
,
1109 if (!op
->last_frames
) {
1116 op
->frames
= &op
->sframe
;
1117 op
->last_frames
= &op
->last_sframe
;
1120 if (msg_head
->nframes
) {
1121 err
= memcpy_from_msg((u8
*)op
->frames
, msg
,
1122 msg_head
->nframes
* op
->cfsiz
);
1124 if (op
->frames
!= &op
->sframe
)
1126 if (op
->last_frames
!= &op
->last_sframe
)
1127 kfree(op
->last_frames
);
1133 /* bcm_can_tx / bcm_tx_timeout_handler needs this */
1135 op
->ifindex
= ifindex
;
1137 /* ifindex for timeout events w/o previous frame reception */
1138 op
->rx_ifindex
= ifindex
;
1140 /* initialize uninitialized (kzalloc) structure */
1141 hrtimer_init(&op
->timer
, CLOCK_MONOTONIC
, HRTIMER_MODE_REL
);
1142 op
->timer
.function
= bcm_rx_timeout_handler
;
1144 /* initialize tasklet for rx timeout notification */
1145 tasklet_init(&op
->tsklet
, bcm_rx_timeout_tsklet
,
1146 (unsigned long) op
);
1148 hrtimer_init(&op
->thrtimer
, CLOCK_MONOTONIC
, HRTIMER_MODE_REL
);
1149 op
->thrtimer
.function
= bcm_rx_thr_handler
;
1151 /* initialize tasklet for rx throttle handling */
1152 tasklet_init(&op
->thrtsklet
, bcm_rx_thr_tsklet
,
1153 (unsigned long) op
);
1155 /* add this bcm_op to the list of the rx_ops */
1156 list_add(&op
->list
, &bo
->rx_ops
);
1158 /* call can_rx_register() */
1161 } /* if ((op = bcm_find_op(&bo->rx_ops, msg_head->can_id, ifindex))) */
1165 if (op
->flags
& RX_RTR_FRAME
) {
1167 /* no timers in RTR-mode */
1168 hrtimer_cancel(&op
->thrtimer
);
1169 hrtimer_cancel(&op
->timer
);
1172 * funny feature in RX(!)_SETUP only for RTR-mode:
1173 * copy can_id into frame BUT without RTR-flag to
1174 * prevent a full-load-loopback-test ... ;-]
1176 if ((op
->flags
& TX_CP_CAN_ID
) ||
1177 (op
->frames
[0].can_id
== op
->can_id
))
1178 op
->frames
[0].can_id
= op
->can_id
& ~CAN_RTR_FLAG
;
1181 if (op
->flags
& SETTIMER
) {
1183 /* set timer value */
1184 op
->ival1
= msg_head
->ival1
;
1185 op
->ival2
= msg_head
->ival2
;
1186 op
->kt_ival1
= bcm_timeval_to_ktime(msg_head
->ival1
);
1187 op
->kt_ival2
= bcm_timeval_to_ktime(msg_head
->ival2
);
1189 /* disable an active timer due to zero value? */
1190 if (!op
->kt_ival1
.tv64
)
1191 hrtimer_cancel(&op
->timer
);
1194 * In any case cancel the throttle timer, flush
1195 * potentially blocked msgs and reset throttle handling
1197 op
->kt_lastmsg
= ktime_set(0, 0);
1198 hrtimer_cancel(&op
->thrtimer
);
1199 bcm_rx_thr_flush(op
, 1);
1202 if ((op
->flags
& STARTTIMER
) && op
->kt_ival1
.tv64
)
1203 hrtimer_start(&op
->timer
, op
->kt_ival1
,
1207 /* now we can register for can_ids, if we added a new bcm_op */
1208 if (do_rx_register
) {
1210 struct net_device
*dev
;
1212 dev
= dev_get_by_index(&init_net
, ifindex
);
1214 err
= can_rx_register(dev
, op
->can_id
,
1215 REGMASK(op
->can_id
),
1219 op
->rx_reg_dev
= dev
;
1224 err
= can_rx_register(NULL
, op
->can_id
,
1225 REGMASK(op
->can_id
),
1226 bcm_rx_handler
, op
, "bcm");
1228 /* this bcm rx op is broken -> remove it */
1229 list_del(&op
->list
);
1235 return msg_head
->nframes
* op
->cfsiz
+ MHSIZ
;
1239 * bcm_tx_send - send a single CAN frame to the CAN interface (for bcm_sendmsg)
1241 static int bcm_tx_send(struct msghdr
*msg
, int ifindex
, struct sock
*sk
,
1244 struct sk_buff
*skb
;
1245 struct net_device
*dev
;
1248 /* we need a real device to send frames */
1252 skb
= alloc_skb(cfsiz
+ sizeof(struct can_skb_priv
), GFP_KERNEL
);
1256 can_skb_reserve(skb
);
1258 err
= memcpy_from_msg(skb_put(skb
, cfsiz
), msg
, cfsiz
);
1264 dev
= dev_get_by_index(&init_net
, ifindex
);
1270 can_skb_prv(skb
)->ifindex
= dev
->ifindex
;
1271 can_skb_prv(skb
)->skbcnt
= 0;
1273 can_skb_set_owner(skb
, sk
);
1274 err
= can_send(skb
, 1); /* send with loopback */
1280 return cfsiz
+ MHSIZ
;
1284 * bcm_sendmsg - process BCM commands (opcodes) from the userspace
1286 static int bcm_sendmsg(struct socket
*sock
, struct msghdr
*msg
, size_t size
)
1288 struct sock
*sk
= sock
->sk
;
1289 struct bcm_sock
*bo
= bcm_sk(sk
);
1290 int ifindex
= bo
->ifindex
; /* default ifindex for this bcm_op */
1291 struct bcm_msg_head msg_head
;
1293 int ret
; /* read bytes or error codes as return value */
1298 /* check for valid message length from userspace */
1302 /* read message head information */
1303 ret
= memcpy_from_msg((u8
*)&msg_head
, msg
, MHSIZ
);
1307 cfsiz
= CFSIZ(msg_head
.flags
);
1308 if ((size
- MHSIZ
) % cfsiz
)
1311 /* check for alternative ifindex for this bcm_op */
1313 if (!ifindex
&& msg
->msg_name
) {
1314 /* no bound device as default => check msg_name */
1315 DECLARE_SOCKADDR(struct sockaddr_can
*, addr
, msg
->msg_name
);
1317 if (msg
->msg_namelen
< sizeof(*addr
))
1320 if (addr
->can_family
!= AF_CAN
)
1323 /* ifindex from sendto() */
1324 ifindex
= addr
->can_ifindex
;
1327 struct net_device
*dev
;
1329 dev
= dev_get_by_index(&init_net
, ifindex
);
1333 if (dev
->type
!= ARPHRD_CAN
) {
1344 switch (msg_head
.opcode
) {
1347 ret
= bcm_tx_setup(&msg_head
, msg
, ifindex
, sk
);
1351 ret
= bcm_rx_setup(&msg_head
, msg
, ifindex
, sk
);
1355 if (bcm_delete_tx_op(&bo
->tx_ops
, &msg_head
, ifindex
))
1362 if (bcm_delete_rx_op(&bo
->rx_ops
, &msg_head
, ifindex
))
1369 /* reuse msg_head for the reply to TX_READ */
1370 msg_head
.opcode
= TX_STATUS
;
1371 ret
= bcm_read_op(&bo
->tx_ops
, &msg_head
, ifindex
);
1375 /* reuse msg_head for the reply to RX_READ */
1376 msg_head
.opcode
= RX_STATUS
;
1377 ret
= bcm_read_op(&bo
->rx_ops
, &msg_head
, ifindex
);
1381 /* we need exactly one CAN frame behind the msg head */
1382 if ((msg_head
.nframes
!= 1) || (size
!= cfsiz
+ MHSIZ
))
1385 ret
= bcm_tx_send(msg
, ifindex
, sk
, cfsiz
);
1399 * notification handler for netdevice status changes
1401 static int bcm_notifier(struct notifier_block
*nb
, unsigned long msg
,
1404 struct net_device
*dev
= netdev_notifier_info_to_dev(ptr
);
1405 struct bcm_sock
*bo
= container_of(nb
, struct bcm_sock
, notifier
);
1406 struct sock
*sk
= &bo
->sk
;
1408 int notify_enodev
= 0;
1410 if (!net_eq(dev_net(dev
), &init_net
))
1413 if (dev
->type
!= ARPHRD_CAN
)
1418 case NETDEV_UNREGISTER
:
1421 /* remove device specific receive entries */
1422 list_for_each_entry(op
, &bo
->rx_ops
, list
)
1423 if (op
->rx_reg_dev
== dev
)
1424 bcm_rx_unreg(dev
, op
);
1426 /* remove device reference, if this is our bound device */
1427 if (bo
->bound
&& bo
->ifindex
== dev
->ifindex
) {
1435 if (notify_enodev
) {
1436 sk
->sk_err
= ENODEV
;
1437 if (!sock_flag(sk
, SOCK_DEAD
))
1438 sk
->sk_error_report(sk
);
1443 if (bo
->bound
&& bo
->ifindex
== dev
->ifindex
) {
1444 sk
->sk_err
= ENETDOWN
;
1445 if (!sock_flag(sk
, SOCK_DEAD
))
1446 sk
->sk_error_report(sk
);
1454 * initial settings for all BCM sockets to be set at socket creation time
1456 static int bcm_init(struct sock
*sk
)
1458 struct bcm_sock
*bo
= bcm_sk(sk
);
1462 bo
->dropped_usr_msgs
= 0;
1463 bo
->bcm_proc_read
= NULL
;
1465 INIT_LIST_HEAD(&bo
->tx_ops
);
1466 INIT_LIST_HEAD(&bo
->rx_ops
);
1469 bo
->notifier
.notifier_call
= bcm_notifier
;
1471 register_netdevice_notifier(&bo
->notifier
);
1477 * standard socket functions
1479 static int bcm_release(struct socket
*sock
)
1481 struct sock
*sk
= sock
->sk
;
1482 struct bcm_sock
*bo
;
1483 struct bcm_op
*op
, *next
;
1490 /* remove bcm_ops, timer, rx_unregister(), etc. */
1492 unregister_netdevice_notifier(&bo
->notifier
);
1496 list_for_each_entry_safe(op
, next
, &bo
->tx_ops
, list
)
1499 list_for_each_entry_safe(op
, next
, &bo
->rx_ops
, list
) {
1501 * Don't care if we're bound or not (due to netdev problems)
1502 * can_rx_unregister() is always a save thing to do here.
1506 * Only remove subscriptions that had not
1507 * been removed due to NETDEV_UNREGISTER
1510 if (op
->rx_reg_dev
) {
1511 struct net_device
*dev
;
1513 dev
= dev_get_by_index(&init_net
, op
->ifindex
);
1515 bcm_rx_unreg(dev
, op
);
1520 can_rx_unregister(NULL
, op
->can_id
,
1521 REGMASK(op
->can_id
),
1522 bcm_rx_handler
, op
);
1527 /* remove procfs entry */
1528 if (proc_dir
&& bo
->bcm_proc_read
)
1529 remove_proc_entry(bo
->procname
, proc_dir
);
1531 /* remove device reference */
1546 static int bcm_connect(struct socket
*sock
, struct sockaddr
*uaddr
, int len
,
1549 struct sockaddr_can
*addr
= (struct sockaddr_can
*)uaddr
;
1550 struct sock
*sk
= sock
->sk
;
1551 struct bcm_sock
*bo
= bcm_sk(sk
);
1553 if (len
< sizeof(*addr
))
1559 /* bind a device to this socket */
1560 if (addr
->can_ifindex
) {
1561 struct net_device
*dev
;
1563 dev
= dev_get_by_index(&init_net
, addr
->can_ifindex
);
1567 if (dev
->type
!= ARPHRD_CAN
) {
1572 bo
->ifindex
= dev
->ifindex
;
1576 /* no interface reference for ifindex = 0 ('any' CAN device) */
1583 /* unique socket address as filename */
1584 sprintf(bo
->procname
, "%lu", sock_i_ino(sk
));
1585 bo
->bcm_proc_read
= proc_create_data(bo
->procname
, 0644,
1587 &bcm_proc_fops
, sk
);
1593 static int bcm_recvmsg(struct socket
*sock
, struct msghdr
*msg
, size_t size
,
1596 struct sock
*sk
= sock
->sk
;
1597 struct sk_buff
*skb
;
1602 noblock
= flags
& MSG_DONTWAIT
;
1603 flags
&= ~MSG_DONTWAIT
;
1604 skb
= skb_recv_datagram(sk
, flags
, noblock
, &error
);
1608 if (skb
->len
< size
)
1611 err
= memcpy_to_msg(msg
, skb
->data
, size
);
1613 skb_free_datagram(sk
, skb
);
1617 sock_recv_ts_and_drops(msg
, sk
, skb
);
1619 if (msg
->msg_name
) {
1620 __sockaddr_check_size(sizeof(struct sockaddr_can
));
1621 msg
->msg_namelen
= sizeof(struct sockaddr_can
);
1622 memcpy(msg
->msg_name
, skb
->cb
, msg
->msg_namelen
);
1625 skb_free_datagram(sk
, skb
);
1630 static const struct proto_ops bcm_ops
= {
1632 .release
= bcm_release
,
1633 .bind
= sock_no_bind
,
1634 .connect
= bcm_connect
,
1635 .socketpair
= sock_no_socketpair
,
1636 .accept
= sock_no_accept
,
1637 .getname
= sock_no_getname
,
1638 .poll
= datagram_poll
,
1639 .ioctl
= can_ioctl
, /* use can_ioctl() from af_can.c */
1640 .listen
= sock_no_listen
,
1641 .shutdown
= sock_no_shutdown
,
1642 .setsockopt
= sock_no_setsockopt
,
1643 .getsockopt
= sock_no_getsockopt
,
1644 .sendmsg
= bcm_sendmsg
,
1645 .recvmsg
= bcm_recvmsg
,
1646 .mmap
= sock_no_mmap
,
1647 .sendpage
= sock_no_sendpage
,
1650 static struct proto bcm_proto __read_mostly
= {
1652 .owner
= THIS_MODULE
,
1653 .obj_size
= sizeof(struct bcm_sock
),
1657 static const struct can_proto bcm_can_proto
= {
1659 .protocol
= CAN_BCM
,
1664 static int __init
bcm_module_init(void)
1668 pr_info("can: broadcast manager protocol (rev " CAN_BCM_VERSION
" t)\n");
1670 err
= can_proto_register(&bcm_can_proto
);
1672 printk(KERN_ERR
"can: registration of bcm protocol failed\n");
1676 /* create /proc/net/can-bcm directory */
1677 proc_dir
= proc_mkdir("can-bcm", init_net
.proc_net
);
1681 static void __exit
bcm_module_exit(void)
1683 can_proto_unregister(&bcm_can_proto
);
1686 remove_proc_entry("can-bcm", init_net
.proc_net
);
1689 module_init(bcm_module_init
);
1690 module_exit(bcm_module_exit
);