2 * Copyright(c) 2007 - 2008 Intel Corporation. All rights reserved.
4 * This program is free software; you can redistribute it and/or modify it
5 * under the terms and conditions of the GNU General Public License,
6 * version 2, as published by the Free Software Foundation.
8 * This program is distributed in the hope it will be useful, but WITHOUT
9 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
13 * You should have received a copy of the GNU General Public License along with
14 * this program; if not, write to the Free Software Foundation, Inc.,
15 * 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
17 * Maintained at www.Open-FCoE.org
20 #include <linux/module.h>
21 #include <linux/version.h>
22 #include <linux/kernel.h>
23 #include <linux/pci.h>
24 #include <linux/init.h>
25 #include <linux/spinlock.h>
26 #include <linux/netdevice.h>
27 #include <linux/etherdevice.h>
28 #include <linux/if_vlan.h>
29 #include <net/rtnetlink.h>
31 #include <scsi/fc/fc_els.h>
32 #include <scsi/fc/fc_encaps.h>
33 #include <scsi/fc/fc_fs.h>
34 #include <scsi/scsi_transport.h>
35 #include <scsi/scsi_transport_fc.h>
37 #include <scsi/libfc.h>
38 #include <scsi/libfcoe.h>
39 #include <scsi/fc_transport_fcoe.h>
41 #define FCOE_SW_VERSION "0.1"
42 #define FCOE_SW_NAME "fcoesw"
43 #define FCOE_SW_VENDOR "Open-FCoE.org"
45 #define FCOE_MAX_LUN 255
46 #define FCOE_MAX_FCP_TARGET 256
48 #define FCOE_MAX_OUTSTANDING_COMMANDS 1024
50 #define FCOE_MIN_XID 0x0001 /* the min xid supported by fcoe_sw */
51 #define FCOE_MAX_XID 0x07ef /* the max xid supported by fcoe_sw */
53 static struct scsi_transport_template *scsi_transport_fcoe_sw;
55 struct fc_function_template fcoe_sw_transport_function = {
56 .show_host_node_name = 1,
57 .show_host_port_name = 1,
58 .show_host_supported_classes = 1,
59 .show_host_supported_fc4s = 1,
60 .show_host_active_fc4s = 1,
61 .show_host_maxframe_size = 1,
63 .show_host_port_id = 1,
64 .show_host_supported_speeds = 1,
65 .get_host_speed = fc_get_host_speed,
67 .show_host_port_type = 1,
68 .get_host_port_state = fc_get_host_port_state,
69 .show_host_port_state = 1,
70 .show_host_symbolic_name = 1,
72 .dd_fcrport_size = sizeof(struct fc_rport_libfc_priv),
73 .show_rport_maxframe_size = 1,
74 .show_rport_supported_classes = 1,
76 .show_host_fabric_name = 1,
77 .show_starget_node_name = 1,
78 .show_starget_port_name = 1,
79 .show_starget_port_id = 1,
80 .set_rport_dev_loss_tmo = fc_set_rport_loss_tmo,
81 .show_rport_dev_loss_tmo = 1,
82 .get_fc_host_stats = fc_get_host_stats,
83 .issue_fc_host_lip = fcoe_reset,
85 .terminate_rport_io = fc_rport_terminate_io,
88 static struct scsi_host_template fcoe_sw_shost_template = {
89 .module = THIS_MODULE,
90 .name = "FCoE Driver",
91 .proc_name = FCOE_SW_NAME,
92 .queuecommand = fc_queuecommand,
93 .eh_abort_handler = fc_eh_abort,
94 .eh_device_reset_handler = fc_eh_device_reset,
95 .eh_host_reset_handler = fc_eh_host_reset,
96 .slave_alloc = fc_slave_alloc,
97 .change_queue_depth = fc_change_queue_depth,
98 .change_queue_type = fc_change_queue_type,
101 .can_queue = FCOE_MAX_OUTSTANDING_COMMANDS,
102 .use_clustering = ENABLE_CLUSTERING,
103 .sg_tablesize = SG_ALL,
104 .max_sectors = 0xffff,
108 * fcoe_sw_lport_config() - sets up the fc_lport
109 * @lp: ptr to the fc_lport
110 * @shost: ptr to the parent scsi host
112 * Returns: 0 for success
114 static int fcoe_sw_lport_config(struct fc_lport *lp)
118 lp->max_retry_count = 3;
119 lp->e_d_tov = 2 * 1000; /* FC-FS default */
120 lp->r_a_tov = 2 * 2 * 1000;
121 lp->service_params = (FCP_SPPF_INIT_FCN | FCP_SPPF_RD_XRDY_DIS |
122 FCP_SPPF_RETRY | FCP_SPPF_CONF_COMPL);
124 fc_lport_init_stats(lp);
126 /* lport fc_lport related configuration */
129 /* offload related configuration */
140 * fcoe_sw_netdev_config() - Set up netdev for SW FCoE
141 * @lp : ptr to the fc_lport
142 * @netdev : ptr to the associated netdevice struct
144 * Must be called after fcoe_sw_lport_config() as it will use lport mutex
146 * Returns : 0 for success
148 static int fcoe_sw_netdev_config(struct fc_lport *lp, struct net_device *netdev)
152 struct fcoe_softc *fc;
153 u8 flogi_maddr[ETH_ALEN];
155 /* Setup lport private data to point to fcoe softc */
158 fc->real_dev = netdev;
159 fc->phys_dev = netdev;
161 /* Require support for get_pauseparam ethtool op. */
162 if (netdev->priv_flags & IFF_802_1Q_VLAN)
163 fc->phys_dev = vlan_dev_real_dev(netdev);
165 /* Do not support for bonding device */
166 if ((fc->real_dev->priv_flags & IFF_MASTER_ALB) ||
167 (fc->real_dev->priv_flags & IFF_SLAVE_INACTIVE) ||
168 (fc->real_dev->priv_flags & IFF_MASTER_8023AD)) {
173 * Determine max frame size based on underlying device and optional
174 * user-configured limit. If the MFS is too low, fcoe_link_ok()
175 * will return 0, so do this first.
177 mfs = fc->real_dev->mtu - (sizeof(struct fcoe_hdr) +
178 sizeof(struct fcoe_crc_eof));
179 if (fc_set_mfs(lp, mfs))
182 if (!fcoe_link_ok(lp))
185 /* offload features support */
186 if (fc->real_dev->features & NETIF_F_SG)
189 #ifdef NETIF_F_FCOE_CRC
190 if (netdev->features & NETIF_F_FCOE_CRC) {
192 printk(KERN_DEBUG "fcoe:%s supports FCCRC offload\n",
197 if (netdev->features & NETIF_F_FSO) {
199 lp->lso_max = netdev->gso_max_size;
200 printk(KERN_DEBUG "fcoe:%s supports LSO for max len 0x%x\n",
201 netdev->name, lp->lso_max);
204 if (netdev->fcoe_ddp_xid) {
206 lp->lro_xid = netdev->fcoe_ddp_xid;
207 printk(KERN_DEBUG "fcoe:%s supports LRO for max xid 0x%x\n",
208 netdev->name, lp->lro_xid);
210 skb_queue_head_init(&fc->fcoe_pending_queue);
211 fc->fcoe_pending_queue_active = 0;
213 /* setup Source Mac Address */
214 memcpy(fc->ctl_src_addr, fc->real_dev->dev_addr,
215 fc->real_dev->addr_len);
217 wwnn = fcoe_wwn_from_mac(fc->real_dev->dev_addr, 1, 0);
218 fc_set_wwnn(lp, wwnn);
219 /* XXX - 3rd arg needs to be vlan id */
220 wwpn = fcoe_wwn_from_mac(fc->real_dev->dev_addr, 2, 0);
221 fc_set_wwpn(lp, wwpn);
224 * Add FCoE MAC address as second unicast MAC address
225 * or enter promiscuous mode if not capable of listening
226 * for multiple unicast MACs.
229 memcpy(flogi_maddr, (u8[6]) FC_FCOE_FLOGI_MAC, ETH_ALEN);
230 dev_unicast_add(fc->real_dev, flogi_maddr, ETH_ALEN);
234 * setup the receive function from ethernet driver
235 * on the ethertype for the given device
237 fc->fcoe_packet_type.func = fcoe_rcv;
238 fc->fcoe_packet_type.type = __constant_htons(ETH_P_FCOE);
239 fc->fcoe_packet_type.dev = fc->real_dev;
240 dev_add_pack(&fc->fcoe_packet_type);
246 * fcoe_sw_shost_config() - Sets up fc_lport->host
247 * @lp : ptr to the fc_lport
248 * @shost : ptr to the associated scsi host
249 * @dev : device associated to scsi host
251 * Must be called after fcoe_sw_lport_config() and fcoe_sw_netdev_config()
253 * Returns : 0 for success
255 static int fcoe_sw_shost_config(struct fc_lport *lp, struct Scsi_Host *shost,
260 /* lport scsi host config */
263 lp->host->max_lun = FCOE_MAX_LUN;
264 lp->host->max_id = FCOE_MAX_FCP_TARGET;
265 lp->host->max_channel = 0;
266 lp->host->transportt = scsi_transport_fcoe_sw;
268 /* add the new host to the SCSI-ml */
269 rc = scsi_add_host(lp->host, dev);
271 FC_DBG("fcoe_sw_shost_config:error on scsi_add_host\n");
274 sprintf(fc_host_symbolic_name(lp->host), "%s v%s over %s",
275 FCOE_SW_NAME, FCOE_SW_VERSION,
276 fcoe_netdev(lp)->name);
282 * fcoe_sw_em_config() - allocates em for this lport
283 * @lp: the port that em is to allocated for
285 * Returns : 0 on success
287 static inline int fcoe_sw_em_config(struct fc_lport *lp)
291 lp->emp = fc_exch_mgr_alloc(lp, FC_CLASS_3,
292 FCOE_MIN_XID, FCOE_MAX_XID);
300 * fcoe_sw_destroy() - FCoE software HBA tear-down function
301 * @netdev: ptr to the associated net_device
303 * Returns: 0 if link is OK for use by FCoE.
305 static int fcoe_sw_destroy(struct net_device *netdev)
307 struct fc_lport *lp = NULL;
308 struct fcoe_softc *fc;
309 u8 flogi_maddr[ETH_ALEN];
313 printk(KERN_DEBUG "fcoe_sw_destroy:interface on %s\n",
316 lp = fcoe_hostlist_lookup(netdev);
322 /* Logout of the fabric */
323 fc_fabric_logoff(lp);
325 /* Remove the instance from fcoe's list */
326 fcoe_hostlist_remove(lp);
328 /* Don't listen for Ethernet packets anymore */
329 dev_remove_pack(&fc->fcoe_packet_type);
331 /* Cleanup the fc_lport */
332 fc_lport_destroy(lp);
335 /* Detach from the scsi-ml */
336 fc_remove_host(lp->host);
337 scsi_remove_host(lp->host);
339 /* There are no more rports or I/O, free the EM */
341 fc_exch_mgr_free(lp->emp);
343 /* Delete secondary MAC addresses */
345 memcpy(flogi_maddr, (u8[6]) FC_FCOE_FLOGI_MAC, ETH_ALEN);
346 dev_unicast_delete(fc->real_dev, flogi_maddr, ETH_ALEN);
347 if (compare_ether_addr(fc->data_src_addr, (u8[6]) { 0 }))
348 dev_unicast_delete(fc->real_dev, fc->data_src_addr, ETH_ALEN);
351 /* Free the per-CPU revieve threads */
352 fcoe_percpu_clean(lp);
354 /* Free existing skbs */
355 fcoe_clean_pending_queue(lp);
357 /* Free memory used by statistical counters */
358 fc_lport_free_stats(lp);
360 /* Release the net_device and Scsi_Host */
361 dev_put(fc->real_dev);
362 scsi_host_put(lp->host);
368 * fcoe_sw_ddp_setup - calls LLD's ddp_setup through net_device
369 * @lp: the corresponding fc_lport
370 * @xid: the exchange id for this ddp transfer
371 * @sgl: the scatterlist describing this transfer
372 * @sgc: number of sg items
376 static int fcoe_sw_ddp_setup(struct fc_lport *lp, u16 xid,
377 struct scatterlist *sgl, unsigned int sgc)
379 struct net_device *n = fcoe_netdev(lp);
381 if (n->netdev_ops && n->netdev_ops->ndo_fcoe_ddp_setup)
382 return n->netdev_ops->ndo_fcoe_ddp_setup(n, xid, sgl, sgc);
388 * fcoe_sw_ddp_done - calls LLD's ddp_done through net_device
389 * @lp: the corresponding fc_lport
390 * @xid: the exchange id for this ddp transfer
392 * Returns : the length of data that have been completed by ddp
394 static int fcoe_sw_ddp_done(struct fc_lport *lp, u16 xid)
396 struct net_device *n = fcoe_netdev(lp);
398 if (n->netdev_ops && n->netdev_ops->ndo_fcoe_ddp_done)
399 return n->netdev_ops->ndo_fcoe_ddp_done(n, xid);
403 static struct libfc_function_template fcoe_sw_libfc_fcn_templ = {
404 .frame_send = fcoe_xmit,
405 .ddp_setup = fcoe_sw_ddp_setup,
406 .ddp_done = fcoe_sw_ddp_done,
410 * fcoe_sw_create() - this function creates the fcoe interface
411 * @netdev: pointer the associated netdevice
413 * Creates fc_lport struct and scsi_host for lport, configures lport
414 * and starts fabric login.
416 * Returns : 0 on success
418 static int fcoe_sw_create(struct net_device *netdev)
421 struct fc_lport *lp = NULL;
422 struct fcoe_softc *fc;
423 struct Scsi_Host *shost;
427 printk(KERN_DEBUG "fcoe_sw_create:interface on %s\n",
430 lp = fcoe_hostlist_lookup(netdev);
434 shost = fcoe_host_alloc(&fcoe_sw_shost_template,
435 sizeof(struct fcoe_softc));
437 FC_DBG("Could not allocate host structure\n");
440 lp = shost_priv(shost);
443 /* configure fc_lport, e.g., em */
444 rc = fcoe_sw_lport_config(lp);
446 FC_DBG("Could not configure lport\n");
450 /* configure lport network properties */
451 rc = fcoe_sw_netdev_config(lp, netdev);
453 FC_DBG("Could not configure netdev for lport\n");
457 /* configure lport scsi host properties */
458 rc = fcoe_sw_shost_config(lp, shost, &netdev->dev);
460 FC_DBG("Could not configure shost for lport\n");
464 /* lport exch manager allocation */
465 rc = fcoe_sw_em_config(lp);
467 FC_DBG("Could not configure em for lport\n");
471 /* Initialize the library */
472 rc = fcoe_libfc_config(lp, &fcoe_sw_libfc_fcn_templ);
474 FC_DBG("Could not configure libfc for lport!\n");
478 /* add to lports list */
479 fcoe_hostlist_add(lp);
481 lp->boot_time = jiffies;
490 fc_exch_mgr_free(lp->emp); /* Free the EM */
492 scsi_host_put(lp->host);
497 * fcoe_sw_match() - The FCoE SW transport match function
499 * Returns : false always
501 static bool fcoe_sw_match(struct net_device *netdev)
503 /* FIXME - for sw transport, always return false */
507 /* the sw hba fcoe transport */
508 struct fcoe_transport fcoe_sw_transport = {
510 .create = fcoe_sw_create,
511 .destroy = fcoe_sw_destroy,
512 .match = fcoe_sw_match,
518 * fcoe_sw_init() - Registers fcoe_sw_transport
520 * Returns : 0 on success
522 int __init fcoe_sw_init(void)
524 /* attach to scsi transport */
525 scsi_transport_fcoe_sw =
526 fc_attach_transport(&fcoe_sw_transport_function);
528 if (!scsi_transport_fcoe_sw) {
529 printk(KERN_ERR "fcoe_sw_init:fc_attach_transport() failed\n");
533 mutex_init(&fcoe_sw_transport.devlock);
534 INIT_LIST_HEAD(&fcoe_sw_transport.devlist);
536 /* register sw transport */
537 fcoe_transport_register(&fcoe_sw_transport);
542 * fcoe_sw_exit() - Unregisters fcoe_sw_transport
544 * Returns : 0 on success
546 int __exit fcoe_sw_exit(void)
548 /* dettach the transport */
549 fc_release_transport(scsi_transport_fcoe_sw);
550 fcoe_transport_unregister(&fcoe_sw_transport);