2 * This file is subject to the terms and conditions of the GNU General Public
3 * License. See the file "COPYING" in the main directory of this archive
6 * Copyright (C) 1999,2001-2005 Silicon Graphics, Inc. All rights reserved.
11 * Cross Partition Network Interface (XPNET) support
13 * XPNET provides a virtual network layered on top of the Cross
14 * Partition communication layer.
16 * XPNET provides direct point-to-point and broadcast-like support
17 * for an ethernet-like device. The ethernet broadcast medium is
18 * replaced with a point-to-point message structure which passes
19 * pointers to a DMA-capable block that a remote partition should
20 * retrieve and pass to the upper level networking layer.
25 #include <linux/module.h>
26 #include <linux/kernel.h>
27 #include <linux/init.h>
28 #include <linux/ioport.h>
29 #include <linux/netdevice.h>
30 #include <linux/etherdevice.h>
31 #include <linux/delay.h>
32 #include <linux/ethtool.h>
33 #include <linux/mii.h>
34 #include <linux/smp.h>
35 #include <linux/string.h>
36 #include <asm/sn/bte.h>
37 #include <asm/sn/io.h>
38 #include <asm/sn/sn_sal.h>
39 #include <asm/types.h>
40 #include <asm/atomic.h>
41 #include <asm/sn/xp.h>
45 * The message payload transferred by XPC.
47 * buf_pa is the physical address where the DMA should pull from.
49 * NOTE: for performance reasons, buf_pa should _ALWAYS_ begin on a
50 * cacheline boundary. To accomplish this, we record the number of
51 * bytes from the beginning of the first cacheline to the first useful
52 * byte of the skb (leadin_ignore) and the number of bytes from the
53 * last useful byte of the skb to the end of the last cacheline
56 * size is the number of bytes to transfer which includes the skb->len
57 * (useful bytes of the senders skb) plus the leadin and tailout
59 struct xpnet_message
{
60 u16 version
; /* Version for this message */
61 u16 embedded_bytes
; /* #of bytes embedded in XPC message */
62 u32 magic
; /* Special number indicating this is xpnet */
63 u64 buf_pa
; /* phys address of buffer to retrieve */
64 u32 size
; /* #of bytes in buffer */
65 u8 leadin_ignore
; /* #of bytes to ignore at the beginning */
66 u8 tailout_ignore
; /* #of bytes to ignore at the end */
67 unsigned char data
; /* body of small packets */
71 * Determine the size of our message, the cacheline aligned size,
72 * and then the number of message will request from XPC.
74 * XPC expects each message to exist in an individual cacheline.
76 #define XPNET_MSG_SIZE (L1_CACHE_BYTES - XPC_MSG_PAYLOAD_OFFSET)
77 #define XPNET_MSG_DATA_MAX \
78 (XPNET_MSG_SIZE - (u64)(&((struct xpnet_message *)0)->data))
79 #define XPNET_MSG_ALIGNED_SIZE (L1_CACHE_ALIGN(XPNET_MSG_SIZE))
80 #define XPNET_MSG_NENTRIES (PAGE_SIZE / XPNET_MSG_ALIGNED_SIZE)
83 #define XPNET_MAX_KTHREADS (XPNET_MSG_NENTRIES + 1)
84 #define XPNET_MAX_IDLE_KTHREADS (XPNET_MSG_NENTRIES + 1)
87 * Version number of XPNET implementation. XPNET can always talk to versions
88 * with same major #, and never talk to versions with a different version.
90 #define _XPNET_VERSION(_major, _minor) (((_major) << 4) | (_minor))
91 #define XPNET_VERSION_MAJOR(_v) ((_v) >> 4)
92 #define XPNET_VERSION_MINOR(_v) ((_v) & 0xf)
94 #define XPNET_VERSION _XPNET_VERSION(1,0) /* version 1.0 */
95 #define XPNET_VERSION_EMBED _XPNET_VERSION(1,1) /* version 1.1 */
96 #define XPNET_MAGIC 0x88786984 /* "XNET" */
98 #define XPNET_VALID_MSG(_m) \
99 ((XPNET_VERSION_MAJOR(_m->version) == XPNET_VERSION_MAJOR(XPNET_VERSION)) \
100 && (msg->magic == XPNET_MAGIC))
102 #define XPNET_DEVICE_NAME "xp0"
106 * When messages are queued with xpc_send_notify, a kmalloc'd buffer
107 * of the following type is passed as a notification cookie. When the
108 * notification function is called, we use the cookie to decide
109 * whether all outstanding message sends have completed. The skb can
112 struct xpnet_pending_msg
{
113 struct list_head free_list
;
118 /* driver specific structure pointed to by the device structure */
119 struct xpnet_dev_private
{
120 struct net_device_stats stats
;
123 struct net_device
*xpnet_device
;
126 * When we are notified of other partitions activating, we add them to
127 * our bitmask of partitions to which we broadcast.
129 static u64 xpnet_broadcast_partitions
;
131 static DEFINE_SPINLOCK(xpnet_broadcast_lock
);
134 * Since the Block Transfer Engine (BTE) is being used for the transfer
135 * and it relies upon cache-line size transfers, we need to reserve at
136 * least one cache-line for head and tail alignment. The BTE is
137 * limited to 8MB transfers.
139 * Testing has shown that changing MTU to greater than 64KB has no effect
140 * on TCP as the two sides negotiate a Max Segment Size that is limited
141 * to 64K. Other protocols May use packets greater than this, but for
142 * now, the default is 64KB.
144 #define XPNET_MAX_MTU (0x800000UL - L1_CACHE_BYTES)
145 /* 32KB has been determined to be the ideal */
146 #define XPNET_DEF_MTU (0x8000UL)
150 * The partition id is encapsulated in the MAC address. The following
151 * define locates the octet the partid is in.
153 #define XPNET_PARTID_OCTET 1
154 #define XPNET_LICENSE_OCTET 2
158 * Define the XPNET debug device structure that is to be used with dev_dbg(),
159 * dev_err(), dev_warn(), and dev_info().
161 struct device_driver xpnet_dbg_name
= {
165 struct device xpnet_dbg_subname
= {
166 .bus_id
= {0}, /* set to "" */
167 .driver
= &xpnet_dbg_name
170 struct device
*xpnet
= &xpnet_dbg_subname
;
173 * Packet was recevied by XPC and forwarded to us.
176 xpnet_receive(partid_t partid
, int channel
, struct xpnet_message
*msg
)
180 struct xpnet_dev_private
*priv
=
181 (struct xpnet_dev_private
*) xpnet_device
->priv
;
184 if (!XPNET_VALID_MSG(msg
)) {
186 * Packet with a different XPC version. Ignore.
188 xpc_received(partid
, channel
, (void *) msg
);
190 priv
->stats
.rx_errors
++;
194 dev_dbg(xpnet
, "received 0x%lx, %d, %d, %d\n", msg
->buf_pa
, msg
->size
,
195 msg
->leadin_ignore
, msg
->tailout_ignore
);
198 /* reserve an extra cache line */
199 skb
= dev_alloc_skb(msg
->size
+ L1_CACHE_BYTES
);
201 dev_err(xpnet
, "failed on dev_alloc_skb(%d)\n",
202 msg
->size
+ L1_CACHE_BYTES
);
204 xpc_received(partid
, channel
, (void *) msg
);
206 priv
->stats
.rx_errors
++;
212 * The allocated skb has some reserved space.
213 * In order to use bte_copy, we need to get the
214 * skb->data pointer moved forward.
216 skb_reserve(skb
, (L1_CACHE_BYTES
- ((u64
)skb
->data
&
217 (L1_CACHE_BYTES
- 1)) +
218 msg
->leadin_ignore
));
221 * Update the tail pointer to indicate data actually
224 skb_put(skb
, (msg
->size
- msg
->leadin_ignore
- msg
->tailout_ignore
));
227 * Move the data over from the other side.
229 if ((XPNET_VERSION_MINOR(msg
->version
) == 1) &&
230 (msg
->embedded_bytes
!= 0)) {
231 dev_dbg(xpnet
, "copying embedded message. memcpy(0x%p, 0x%p, "
232 "%lu)\n", skb
->data
, &msg
->data
,
233 (size_t) msg
->embedded_bytes
);
235 skb_copy_to_linear_data(skb
, &msg
->data
, (size_t)msg
->embedded_bytes
);
237 dev_dbg(xpnet
, "transferring buffer to the skb->data area;\n\t"
238 "bte_copy(0x%p, 0x%p, %hu)\n", (void *)msg
->buf_pa
,
239 (void *)__pa((u64
)skb
->data
& ~(L1_CACHE_BYTES
- 1)),
242 bret
= bte_copy(msg
->buf_pa
,
243 __pa((u64
)skb
->data
& ~(L1_CACHE_BYTES
- 1)),
244 msg
->size
, (BTE_NOTIFY
| BTE_WACQUIRE
), NULL
);
246 if (bret
!= BTE_SUCCESS
) {
247 // >>> Need better way of cleaning skb. Currently skb
248 // >>> appears in_use and we can't just call
249 // >>> dev_kfree_skb.
250 dev_err(xpnet
, "bte_copy(0x%p, 0x%p, 0x%hx) returned "
251 "error=0x%x\n", (void *)msg
->buf_pa
,
252 (void *)__pa((u64
)skb
->data
&
253 ~(L1_CACHE_BYTES
- 1)),
256 xpc_received(partid
, channel
, (void *) msg
);
258 priv
->stats
.rx_errors
++;
264 dev_dbg(xpnet
, "<skb->head=0x%p skb->data=0x%p skb->tail=0x%p "
265 "skb->end=0x%p skb->len=%d\n", (void *) skb
->head
,
266 (void *)skb
->data
, skb_tail_pointer(skb
), skb_end_pointer(skb
),
269 skb
->protocol
= eth_type_trans(skb
, xpnet_device
);
270 skb
->ip_summed
= CHECKSUM_UNNECESSARY
;
272 dev_dbg(xpnet
, "passing skb to network layer\n"
273 KERN_DEBUG
"\tskb->head=0x%p skb->data=0x%p skb->tail=0x%p "
274 "skb->end=0x%p skb->len=%d\n",
275 (void *)skb
->head
, (void *)skb
->data
, skb_tail_pointer(skb
),
276 skb_end_pointer(skb
), skb
->len
);
279 xpnet_device
->last_rx
= jiffies
;
280 priv
->stats
.rx_packets
++;
281 priv
->stats
.rx_bytes
+= skb
->len
+ ETH_HLEN
;
284 xpc_received(partid
, channel
, (void *) msg
);
289 * This is the handler which XPC calls during any sort of change in
290 * state or message reception on a connection.
293 xpnet_connection_activity(enum xpc_retval reason
, partid_t partid
, int channel
,
294 void *data
, void *key
)
299 DBUG_ON(partid
<= 0 || partid
>= XP_MAX_PARTITIONS
);
300 DBUG_ON(channel
!= XPC_NET_CHANNEL
);
303 case xpcMsgReceived
: /* message received */
304 DBUG_ON(data
== NULL
);
306 xpnet_receive(partid
, channel
, (struct xpnet_message
*) data
);
309 case xpcConnected
: /* connection completed to a partition */
310 spin_lock_bh(&xpnet_broadcast_lock
);
311 xpnet_broadcast_partitions
|= 1UL << (partid
-1 );
312 bp
= xpnet_broadcast_partitions
;
313 spin_unlock_bh(&xpnet_broadcast_lock
);
315 netif_carrier_on(xpnet_device
);
317 dev_dbg(xpnet
, "%s connection created to partition %d; "
318 "xpnet_broadcast_partitions=0x%lx\n",
319 xpnet_device
->name
, partid
, bp
);
323 spin_lock_bh(&xpnet_broadcast_lock
);
324 xpnet_broadcast_partitions
&= ~(1UL << (partid
-1 ));
325 bp
= xpnet_broadcast_partitions
;
326 spin_unlock_bh(&xpnet_broadcast_lock
);
329 netif_carrier_off(xpnet_device
);
332 dev_dbg(xpnet
, "%s disconnected from partition %d; "
333 "xpnet_broadcast_partitions=0x%lx\n",
334 xpnet_device
->name
, partid
, bp
);
342 xpnet_dev_open(struct net_device
*dev
)
347 dev_dbg(xpnet
, "calling xpc_connect(%d, 0x%p, NULL, %ld, %ld, %ld, "
348 "%ld)\n", XPC_NET_CHANNEL
, xpnet_connection_activity
,
349 XPNET_MSG_SIZE
, XPNET_MSG_NENTRIES
, XPNET_MAX_KTHREADS
,
350 XPNET_MAX_IDLE_KTHREADS
);
352 ret
= xpc_connect(XPC_NET_CHANNEL
, xpnet_connection_activity
, NULL
,
353 XPNET_MSG_SIZE
, XPNET_MSG_NENTRIES
,
354 XPNET_MAX_KTHREADS
, XPNET_MAX_IDLE_KTHREADS
);
355 if (ret
!= xpcSuccess
) {
356 dev_err(xpnet
, "ifconfig up of %s failed on XPC connect, "
357 "ret=%d\n", dev
->name
, ret
);
362 dev_dbg(xpnet
, "ifconfig up of %s; XPC connected\n", dev
->name
);
369 xpnet_dev_stop(struct net_device
*dev
)
371 xpc_disconnect(XPC_NET_CHANNEL
);
373 dev_dbg(xpnet
, "ifconfig down of %s; XPC disconnected\n", dev
->name
);
380 xpnet_dev_change_mtu(struct net_device
*dev
, int new_mtu
)
382 /* 68 comes from min TCP+IP+MAC header */
383 if ((new_mtu
< 68) || (new_mtu
> XPNET_MAX_MTU
)) {
384 dev_err(xpnet
, "ifconfig %s mtu %d failed; value must be "
385 "between 68 and %ld\n", dev
->name
, new_mtu
,
391 dev_dbg(xpnet
, "ifconfig %s mtu set to %d\n", dev
->name
, new_mtu
);
397 * Required for the net_device structure.
400 xpnet_dev_set_config(struct net_device
*dev
, struct ifmap
*new_map
)
407 * Return statistics to the caller.
409 static struct net_device_stats
*
410 xpnet_dev_get_stats(struct net_device
*dev
)
412 struct xpnet_dev_private
*priv
;
415 priv
= (struct xpnet_dev_private
*) dev
->priv
;
422 * Notification that the other end has received the message and
423 * DMA'd the skb information. At this point, they are done with
424 * our side. When all recipients are done processing, we
425 * release the skb and then release our pending message structure.
428 xpnet_send_completed(enum xpc_retval reason
, partid_t partid
, int channel
,
431 struct xpnet_pending_msg
*queued_msg
=
432 (struct xpnet_pending_msg
*) __qm
;
435 DBUG_ON(queued_msg
== NULL
);
437 dev_dbg(xpnet
, "message to %d notified with reason %d\n",
440 if (atomic_dec_return(&queued_msg
->use_count
) == 0) {
441 dev_dbg(xpnet
, "all acks for skb->head=-x%p\n",
442 (void *) queued_msg
->skb
->head
);
444 dev_kfree_skb_any(queued_msg
->skb
);
451 * Network layer has formatted a packet (skb) and is ready to place it
452 * "on the wire". Prepare and send an xpnet_message to all partitions
453 * which have connected with us and are targets of this packet.
455 * MAC-NOTE: For the XPNET driver, the MAC address contains the
456 * destination partition_id. If the destination partition id word
457 * is 0xff, this packet is to broadcast to all partitions.
460 xpnet_dev_hard_start_xmit(struct sk_buff
*skb
, struct net_device
*dev
)
462 struct xpnet_pending_msg
*queued_msg
;
464 struct xpnet_message
*msg
;
465 u64 start_addr
, end_addr
;
468 partid_t dest_partid
;
469 struct xpnet_dev_private
*priv
;
473 priv
= (struct xpnet_dev_private
*) dev
->priv
;
476 dev_dbg(xpnet
, ">skb->head=0x%p skb->data=0x%p skb->tail=0x%p "
477 "skb->end=0x%p skb->len=%d\n", (void *) skb
->head
,
478 (void *)skb
->data
, skb_tail_pointer(skb
), skb_end_pointer(skb
),
483 * The xpnet_pending_msg tracks how many outstanding
484 * xpc_send_notifies are relying on this skb. When none
485 * remain, release the skb.
487 queued_msg
= kmalloc(sizeof(struct xpnet_pending_msg
), GFP_ATOMIC
);
488 if (queued_msg
== NULL
) {
489 dev_warn(xpnet
, "failed to kmalloc %ld bytes; dropping "
490 "packet\n", sizeof(struct xpnet_pending_msg
));
492 priv
->stats
.tx_errors
++;
498 /* get the beginning of the first cacheline and end of last */
499 start_addr
= ((u64
) skb
->data
& ~(L1_CACHE_BYTES
- 1));
500 end_addr
= L1_CACHE_ALIGN((u64
)skb_tail_pointer(skb
));
502 /* calculate how many bytes to embed in the XPC message */
504 if (unlikely(skb
->len
<= XPNET_MSG_DATA_MAX
)) {
505 /* skb->data does fit so embed */
506 embedded_bytes
= skb
->len
;
511 * Since the send occurs asynchronously, we set the count to one
512 * and begin sending. Any sends that happen to complete before
513 * we are done sending will not free the skb. We will be left
514 * with that task during exit. This also handles the case of
515 * a packet destined for a partition which is no longer up.
517 atomic_set(&queued_msg
->use_count
, 1);
518 queued_msg
->skb
= skb
;
521 second_mac_octet
= skb
->data
[XPNET_PARTID_OCTET
];
522 if (second_mac_octet
== 0xff) {
523 /* we are being asked to broadcast to all partitions */
524 dp
= xpnet_broadcast_partitions
;
525 } else if (second_mac_octet
!= 0) {
526 dp
= xpnet_broadcast_partitions
&
527 (1UL << (second_mac_octet
- 1));
529 /* 0 is an invalid partid. Ignore */
532 dev_dbg(xpnet
, "destination Partitions mask (dp) = 0x%lx\n", dp
);
535 * If we wanted to allow promiscuous mode to work like an
536 * unswitched network, this would be a good point to OR in a
537 * mask of partitions which should be receiving all packets.
543 for (dest_partid
= 1; dp
&& dest_partid
< XP_MAX_PARTITIONS
;
547 if (!(dp
& (1UL << (dest_partid
- 1)))) {
548 /* not destined for this partition */
552 /* remove this partition from the destinations mask */
553 dp
&= ~(1UL << (dest_partid
- 1));
556 /* found a partition to send to */
558 ret
= xpc_allocate(dest_partid
, XPC_NET_CHANNEL
,
559 XPC_NOWAIT
, (void **)&msg
);
560 if (unlikely(ret
!= xpcSuccess
)) {
564 msg
->embedded_bytes
= embedded_bytes
;
565 if (unlikely(embedded_bytes
!= 0)) {
566 msg
->version
= XPNET_VERSION_EMBED
;
567 dev_dbg(xpnet
, "calling memcpy(0x%p, 0x%p, 0x%lx)\n",
568 &msg
->data
, skb
->data
, (size_t) embedded_bytes
);
569 skb_copy_from_linear_data(skb
, &msg
->data
,
570 (size_t)embedded_bytes
);
572 msg
->version
= XPNET_VERSION
;
574 msg
->magic
= XPNET_MAGIC
;
575 msg
->size
= end_addr
- start_addr
;
576 msg
->leadin_ignore
= (u64
) skb
->data
- start_addr
;
577 msg
->tailout_ignore
= end_addr
- (u64
)skb_tail_pointer(skb
);
578 msg
->buf_pa
= __pa(start_addr
);
580 dev_dbg(xpnet
, "sending XPC message to %d:%d\n"
581 KERN_DEBUG
"msg->buf_pa=0x%lx, msg->size=%u, "
582 "msg->leadin_ignore=%u, msg->tailout_ignore=%u\n",
583 dest_partid
, XPC_NET_CHANNEL
, msg
->buf_pa
, msg
->size
,
584 msg
->leadin_ignore
, msg
->tailout_ignore
);
587 atomic_inc(&queued_msg
->use_count
);
589 ret
= xpc_send_notify(dest_partid
, XPC_NET_CHANNEL
, msg
,
590 xpnet_send_completed
, queued_msg
);
591 if (unlikely(ret
!= xpcSuccess
)) {
592 atomic_dec(&queued_msg
->use_count
);
598 if (atomic_dec_return(&queued_msg
->use_count
) == 0) {
599 dev_dbg(xpnet
, "no partitions to receive packet destined for "
600 "%d\n", dest_partid
);
607 priv
->stats
.tx_packets
++;
608 priv
->stats
.tx_bytes
+= skb
->len
;
615 * Deal with transmit timeouts coming from the network layer.
618 xpnet_dev_tx_timeout (struct net_device
*dev
)
620 struct xpnet_dev_private
*priv
;
623 priv
= (struct xpnet_dev_private
*) dev
->priv
;
625 priv
->stats
.tx_errors
++;
635 int result
= -ENOMEM
;
638 if (!ia64_platform_is("sn2")) {
642 dev_info(xpnet
, "registering network device %s\n", XPNET_DEVICE_NAME
);
645 * use ether_setup() to init the majority of our device
646 * structure and then override the necessary pieces.
648 xpnet_device
= alloc_netdev(sizeof(struct xpnet_dev_private
),
649 XPNET_DEVICE_NAME
, ether_setup
);
650 if (xpnet_device
== NULL
) {
654 netif_carrier_off(xpnet_device
);
656 xpnet_device
->mtu
= XPNET_DEF_MTU
;
657 xpnet_device
->change_mtu
= xpnet_dev_change_mtu
;
658 xpnet_device
->open
= xpnet_dev_open
;
659 xpnet_device
->get_stats
= xpnet_dev_get_stats
;
660 xpnet_device
->stop
= xpnet_dev_stop
;
661 xpnet_device
->hard_start_xmit
= xpnet_dev_hard_start_xmit
;
662 xpnet_device
->tx_timeout
= xpnet_dev_tx_timeout
;
663 xpnet_device
->set_config
= xpnet_dev_set_config
;
666 * Multicast assumes the LSB of the first octet is set for multicast
667 * MAC addresses. We chose the first octet of the MAC to be unlikely
668 * to collide with any vendor's officially issued MAC.
670 xpnet_device
->dev_addr
[0] = 0xfe;
671 xpnet_device
->dev_addr
[XPNET_PARTID_OCTET
] = sn_partition_id
;
672 license_num
= sn_partition_serial_number_val();
673 for (i
= 3; i
>= 0; i
--) {
674 xpnet_device
->dev_addr
[XPNET_LICENSE_OCTET
+ i
] =
676 license_num
= license_num
>> 8;
680 * ether_setup() sets this to a multicast device. We are
681 * really not supporting multicast at this time.
683 xpnet_device
->flags
&= ~IFF_MULTICAST
;
686 * No need to checksum as it is a DMA transfer. The BTE will
687 * report an error if the data is not retrievable and the
688 * packet will be dropped.
690 xpnet_device
->features
= NETIF_F_NO_CSUM
;
692 result
= register_netdev(xpnet_device
);
694 free_netdev(xpnet_device
);
699 module_init(xpnet_init
);
705 dev_info(xpnet
, "unregistering network device %s\n",
706 xpnet_device
[0].name
);
708 unregister_netdev(xpnet_device
);
710 free_netdev(xpnet_device
);
712 module_exit(xpnet_exit
);
715 MODULE_AUTHOR("Silicon Graphics, Inc.");
716 MODULE_DESCRIPTION("Cross Partition Network adapter (XPNET)");
717 MODULE_LICENSE("GPL");