1 // SPDX-License-Identifier: GPL-2.0-only
3 * Copyright(c) 2007 - 2009 Intel Corporation. All rights reserved.
5 * Maintained at www.Open-FCoE.org
8 #include <linux/module.h>
9 #include <linux/spinlock.h>
10 #include <linux/netdevice.h>
11 #include <linux/etherdevice.h>
12 #include <linux/ethtool.h>
13 #include <linux/if_ether.h>
14 #include <linux/if_vlan.h>
15 #include <linux/crc32.h>
16 #include <linux/slab.h>
17 #include <linux/cpu.h>
19 #include <linux/sysfs.h>
20 #include <linux/ctype.h>
21 #include <linux/workqueue.h>
22 #include <net/dcbnl.h>
23 #include <net/dcbevent.h>
24 #include <scsi/scsi_tcq.h>
25 #include <scsi/scsicam.h>
26 #include <scsi/scsi_transport.h>
27 #include <scsi/scsi_transport_fc.h>
28 #include <net/rtnetlink.h>
30 #include <scsi/fc/fc_encaps.h>
31 #include <scsi/fc/fc_fip.h>
32 #include <scsi/fc/fc_fcoe.h>
34 #include <scsi/libfc.h>
35 #include <scsi/fc_frame.h>
36 #include <scsi/libfcoe.h>
40 MODULE_AUTHOR("Open-FCoE.org");
41 MODULE_DESCRIPTION("FCoE");
42 MODULE_LICENSE("GPL v2");
44 /* Performance tuning parameters for fcoe */
45 static unsigned int fcoe_ddp_min
= 4096;
46 module_param_named(ddp_min
, fcoe_ddp_min
, uint
, S_IRUGO
| S_IWUSR
);
47 MODULE_PARM_DESC(ddp_min
, "Minimum I/O size in bytes for " \
48 "Direct Data Placement (DDP).");
50 unsigned int fcoe_debug_logging
;
51 module_param_named(debug_logging
, fcoe_debug_logging
, int, S_IRUGO
|S_IWUSR
);
52 MODULE_PARM_DESC(debug_logging
, "a bit mask of logging levels");
54 static unsigned int fcoe_e_d_tov
= 2 * 1000;
55 module_param_named(e_d_tov
, fcoe_e_d_tov
, int, S_IRUGO
|S_IWUSR
);
56 MODULE_PARM_DESC(e_d_tov
, "E_D_TOV in ms, default 2000");
58 static unsigned int fcoe_r_a_tov
= 2 * 2 * 1000;
59 module_param_named(r_a_tov
, fcoe_r_a_tov
, int, S_IRUGO
|S_IWUSR
);
60 MODULE_PARM_DESC(r_a_tov
, "R_A_TOV in ms, default 4000");
62 static DEFINE_MUTEX(fcoe_config_mutex
);
64 static struct workqueue_struct
*fcoe_wq
;
67 /* must only by accessed under the RTNL mutex */
68 static LIST_HEAD(fcoe_hostlist
);
69 static DEFINE_PER_CPU(struct fcoe_percpu_s
, fcoe_percpu
);
71 /* Function Prototypes */
72 static int fcoe_reset(struct Scsi_Host
*);
73 static int fcoe_xmit(struct fc_lport
*, struct fc_frame
*);
74 static int fcoe_rcv(struct sk_buff
*, struct net_device
*,
75 struct packet_type
*, struct net_device
*);
76 static void fcoe_percpu_clean(struct fc_lport
*);
77 static int fcoe_link_ok(struct fc_lport
*);
79 static struct fc_lport
*fcoe_hostlist_lookup(const struct net_device
*);
80 static int fcoe_hostlist_add(const struct fc_lport
*);
81 static void fcoe_hostlist_del(const struct fc_lport
*);
83 static int fcoe_device_notification(struct notifier_block
*, ulong
, void *);
84 static void fcoe_dev_setup(void);
85 static void fcoe_dev_cleanup(void);
86 static struct fcoe_interface
87 *fcoe_hostlist_lookup_port(const struct net_device
*);
89 static int fcoe_fip_recv(struct sk_buff
*, struct net_device
*,
90 struct packet_type
*, struct net_device
*);
91 static int fcoe_fip_vlan_recv(struct sk_buff
*, struct net_device
*,
92 struct packet_type
*, struct net_device
*);
94 static void fcoe_fip_send(struct fcoe_ctlr
*, struct sk_buff
*);
95 static void fcoe_update_src_mac(struct fc_lport
*, u8
*);
96 static u8
*fcoe_get_src_mac(struct fc_lport
*);
97 static void fcoe_destroy_work(struct work_struct
*);
99 static int fcoe_ddp_setup(struct fc_lport
*, u16
, struct scatterlist
*,
101 static int fcoe_ddp_done(struct fc_lport
*, u16
);
102 static int fcoe_ddp_target(struct fc_lport
*, u16
, struct scatterlist
*,
104 static int fcoe_dcb_app_notification(struct notifier_block
*notifier
,
105 ulong event
, void *ptr
);
107 static bool fcoe_match(struct net_device
*netdev
);
108 static int fcoe_create(struct net_device
*netdev
, enum fip_mode fip_mode
);
109 static int fcoe_destroy(struct net_device
*netdev
);
110 static int fcoe_enable(struct net_device
*netdev
);
111 static int fcoe_disable(struct net_device
*netdev
);
113 /* fcoe_syfs control interface handlers */
114 static int fcoe_ctlr_alloc(struct net_device
*netdev
);
115 static int fcoe_ctlr_enabled(struct fcoe_ctlr_device
*cdev
);
116 static void fcoe_ctlr_mode(struct fcoe_ctlr_device
*ctlr_dev
);
118 static struct fc_seq
*fcoe_elsct_send(struct fc_lport
*,
119 u32 did
, struct fc_frame
*,
121 void (*resp
)(struct fc_seq
*,
124 void *, u32 timeout
);
125 static void fcoe_recv_frame(struct sk_buff
*skb
);
127 /* notification function for packets from net device */
128 static struct notifier_block fcoe_notifier
= {
129 .notifier_call
= fcoe_device_notification
,
132 /* notification function for DCB events */
133 static struct notifier_block dcb_notifier
= {
134 .notifier_call
= fcoe_dcb_app_notification
,
137 static struct scsi_transport_template
*fcoe_nport_scsi_transport
;
138 static struct scsi_transport_template
*fcoe_vport_scsi_transport
;
140 static int fcoe_vport_destroy(struct fc_vport
*);
141 static int fcoe_vport_create(struct fc_vport
*, bool disabled
);
142 static int fcoe_vport_disable(struct fc_vport
*, bool disable
);
143 static void fcoe_set_vport_symbolic_name(struct fc_vport
*);
144 static void fcoe_set_port_id(struct fc_lport
*, u32
, struct fc_frame
*);
145 static void fcoe_fcf_get_vlan_id(struct fcoe_fcf_device
*);
146 static void fcoe_vport_remove(struct fc_lport
*);
148 static struct fcoe_sysfs_function_template fcoe_sysfs_templ
= {
149 .set_fcoe_ctlr_mode
= fcoe_ctlr_mode
,
150 .set_fcoe_ctlr_enabled
= fcoe_ctlr_enabled
,
151 .get_fcoe_ctlr_link_fail
= fcoe_ctlr_get_lesb
,
152 .get_fcoe_ctlr_vlink_fail
= fcoe_ctlr_get_lesb
,
153 .get_fcoe_ctlr_miss_fka
= fcoe_ctlr_get_lesb
,
154 .get_fcoe_ctlr_symb_err
= fcoe_ctlr_get_lesb
,
155 .get_fcoe_ctlr_err_block
= fcoe_ctlr_get_lesb
,
156 .get_fcoe_ctlr_fcs_error
= fcoe_ctlr_get_lesb
,
158 .get_fcoe_fcf_selected
= fcoe_fcf_get_selected
,
159 .get_fcoe_fcf_vlan_id
= fcoe_fcf_get_vlan_id
,
162 static struct libfc_function_template fcoe_libfc_fcn_templ
= {
163 .frame_send
= fcoe_xmit
,
164 .ddp_setup
= fcoe_ddp_setup
,
165 .ddp_done
= fcoe_ddp_done
,
166 .ddp_target
= fcoe_ddp_target
,
167 .elsct_send
= fcoe_elsct_send
,
168 .get_lesb
= fcoe_get_lesb
,
169 .lport_set_port_id
= fcoe_set_port_id
,
172 static struct fc_function_template fcoe_nport_fc_functions
= {
173 .show_host_node_name
= 1,
174 .show_host_port_name
= 1,
175 .show_host_supported_classes
= 1,
176 .show_host_supported_fc4s
= 1,
177 .show_host_active_fc4s
= 1,
178 .show_host_maxframe_size
= 1,
179 .show_host_serial_number
= 1,
180 .show_host_manufacturer
= 1,
181 .show_host_model
= 1,
182 .show_host_model_description
= 1,
183 .show_host_hardware_version
= 1,
184 .show_host_driver_version
= 1,
185 .show_host_firmware_version
= 1,
186 .show_host_optionrom_version
= 1,
188 .show_host_port_id
= 1,
189 .show_host_supported_speeds
= 1,
190 .get_host_speed
= fc_get_host_speed
,
191 .show_host_speed
= 1,
192 .show_host_port_type
= 1,
193 .get_host_port_state
= fc_get_host_port_state
,
194 .show_host_port_state
= 1,
195 .show_host_symbolic_name
= 1,
197 .dd_fcrport_size
= sizeof(struct fc_rport_libfc_priv
),
198 .show_rport_maxframe_size
= 1,
199 .show_rport_supported_classes
= 1,
201 .show_host_fabric_name
= 1,
202 .show_starget_node_name
= 1,
203 .show_starget_port_name
= 1,
204 .show_starget_port_id
= 1,
205 .set_rport_dev_loss_tmo
= fc_set_rport_loss_tmo
,
206 .show_rport_dev_loss_tmo
= 1,
207 .get_fc_host_stats
= fc_get_host_stats
,
208 .issue_fc_host_lip
= fcoe_reset
,
210 .terminate_rport_io
= fc_rport_terminate_io
,
212 .vport_create
= fcoe_vport_create
,
213 .vport_delete
= fcoe_vport_destroy
,
214 .vport_disable
= fcoe_vport_disable
,
215 .set_vport_symbolic_name
= fcoe_set_vport_symbolic_name
,
217 .bsg_request
= fc_lport_bsg_request
,
220 static struct fc_function_template fcoe_vport_fc_functions
= {
221 .show_host_node_name
= 1,
222 .show_host_port_name
= 1,
223 .show_host_supported_classes
= 1,
224 .show_host_supported_fc4s
= 1,
225 .show_host_active_fc4s
= 1,
226 .show_host_maxframe_size
= 1,
227 .show_host_serial_number
= 1,
228 .show_host_manufacturer
= 1,
229 .show_host_model
= 1,
230 .show_host_model_description
= 1,
231 .show_host_hardware_version
= 1,
232 .show_host_driver_version
= 1,
233 .show_host_firmware_version
= 1,
234 .show_host_optionrom_version
= 1,
236 .show_host_port_id
= 1,
237 .show_host_supported_speeds
= 1,
238 .get_host_speed
= fc_get_host_speed
,
239 .show_host_speed
= 1,
240 .show_host_port_type
= 1,
241 .get_host_port_state
= fc_get_host_port_state
,
242 .show_host_port_state
= 1,
243 .show_host_symbolic_name
= 1,
245 .dd_fcrport_size
= sizeof(struct fc_rport_libfc_priv
),
246 .show_rport_maxframe_size
= 1,
247 .show_rport_supported_classes
= 1,
249 .show_host_fabric_name
= 1,
250 .show_starget_node_name
= 1,
251 .show_starget_port_name
= 1,
252 .show_starget_port_id
= 1,
253 .set_rport_dev_loss_tmo
= fc_set_rport_loss_tmo
,
254 .show_rport_dev_loss_tmo
= 1,
255 .get_fc_host_stats
= fc_get_host_stats
,
256 .issue_fc_host_lip
= fcoe_reset
,
258 .terminate_rport_io
= fc_rport_terminate_io
,
260 .bsg_request
= fc_lport_bsg_request
,
263 static struct scsi_host_template fcoe_shost_template
= {
264 .module
= THIS_MODULE
,
265 .name
= "FCoE Driver",
266 .proc_name
= FCOE_NAME
,
267 .queuecommand
= fc_queuecommand
,
268 .eh_timed_out
= fc_eh_timed_out
,
269 .eh_abort_handler
= fc_eh_abort
,
270 .eh_device_reset_handler
= fc_eh_device_reset
,
271 .eh_host_reset_handler
= fc_eh_host_reset
,
272 .slave_alloc
= fc_slave_alloc
,
273 .change_queue_depth
= scsi_change_queue_depth
,
276 .can_queue
= FCOE_MAX_OUTSTANDING_COMMANDS
,
277 .sg_tablesize
= SG_ALL
,
278 .max_sectors
= 0xffff,
279 .track_queue_depth
= 1,
283 * fcoe_interface_setup() - Setup a FCoE interface
284 * @fcoe: The new FCoE interface
285 * @netdev: The net device that the fcoe interface is on
287 * Returns : 0 for success
288 * Locking: must be called with the RTNL mutex held
290 static int fcoe_interface_setup(struct fcoe_interface
*fcoe
,
291 struct net_device
*netdev
)
293 struct fcoe_ctlr
*fip
= fcoe_to_ctlr(fcoe
);
294 struct netdev_hw_addr
*ha
;
295 struct net_device
*real_dev
;
296 u8 flogi_maddr
[ETH_ALEN
];
297 const struct net_device_ops
*ops
;
299 fcoe
->netdev
= netdev
;
301 /* Let LLD initialize for FCoE */
302 ops
= netdev
->netdev_ops
;
303 if (ops
->ndo_fcoe_enable
) {
304 if (ops
->ndo_fcoe_enable(netdev
))
305 FCOE_NETDEV_DBG(netdev
, "Failed to enable FCoE"
306 " specific feature for LLD.\n");
309 /* Do not support for bonding device */
310 if (netdev
->priv_flags
& IFF_BONDING
&& netdev
->flags
& IFF_MASTER
) {
311 FCOE_NETDEV_DBG(netdev
, "Bonded interfaces not supported\n");
315 /* look for SAN MAC address, if multiple SAN MACs exist, only
316 * use the first one for SPMA */
317 real_dev
= is_vlan_dev(netdev
) ? vlan_dev_real_dev(netdev
) : netdev
;
318 fcoe
->realdev
= real_dev
;
320 for_each_dev_addr(real_dev
, ha
) {
321 if ((ha
->type
== NETDEV_HW_ADDR_T_SAN
) &&
322 (is_valid_ether_addr(ha
->addr
))) {
323 memcpy(fip
->ctl_src_addr
, ha
->addr
, ETH_ALEN
);
330 /* setup Source Mac Address */
332 memcpy(fip
->ctl_src_addr
, netdev
->dev_addr
, netdev
->addr_len
);
335 * Add FCoE MAC address as second unicast MAC address
336 * or enter promiscuous mode if not capable of listening
337 * for multiple unicast MACs.
339 memcpy(flogi_maddr
, (u8
[6]) FC_FCOE_FLOGI_MAC
, ETH_ALEN
);
340 dev_uc_add(netdev
, flogi_maddr
);
342 dev_uc_add(netdev
, fip
->ctl_src_addr
);
343 if (fip
->mode
== FIP_MODE_VN2VN
) {
344 dev_mc_add(netdev
, FIP_ALL_VN2VN_MACS
);
345 dev_mc_add(netdev
, FIP_ALL_P2P_MACS
);
347 dev_mc_add(netdev
, FIP_ALL_ENODE_MACS
);
350 * setup the receive function from ethernet driver
351 * on the ethertype for the given device
353 fcoe
->fcoe_packet_type
.func
= fcoe_rcv
;
354 fcoe
->fcoe_packet_type
.type
= htons(ETH_P_FCOE
);
355 fcoe
->fcoe_packet_type
.dev
= netdev
;
356 dev_add_pack(&fcoe
->fcoe_packet_type
);
358 fcoe
->fip_packet_type
.func
= fcoe_fip_recv
;
359 fcoe
->fip_packet_type
.type
= htons(ETH_P_FIP
);
360 fcoe
->fip_packet_type
.dev
= netdev
;
361 dev_add_pack(&fcoe
->fip_packet_type
);
363 if (netdev
!= real_dev
) {
364 fcoe
->fip_vlan_packet_type
.func
= fcoe_fip_vlan_recv
;
365 fcoe
->fip_vlan_packet_type
.type
= htons(ETH_P_FIP
);
366 fcoe
->fip_vlan_packet_type
.dev
= real_dev
;
367 dev_add_pack(&fcoe
->fip_vlan_packet_type
);
373 * fcoe_interface_create() - Create a FCoE interface on a net device
374 * @netdev: The net device to create the FCoE interface on
375 * @fip_mode: The mode to use for FIP
377 * Returns: pointer to a struct fcoe_interface or NULL on error
379 static struct fcoe_interface
*fcoe_interface_create(struct net_device
*netdev
,
380 enum fip_mode fip_mode
)
382 struct fcoe_ctlr_device
*ctlr_dev
;
383 struct fcoe_ctlr
*ctlr
;
384 struct fcoe_interface
*fcoe
;
388 if (!try_module_get(THIS_MODULE
)) {
389 FCOE_NETDEV_DBG(netdev
,
390 "Could not get a reference to the module\n");
391 fcoe
= ERR_PTR(-EBUSY
);
395 size
= sizeof(struct fcoe_ctlr
) + sizeof(struct fcoe_interface
);
396 ctlr_dev
= fcoe_ctlr_device_add(&netdev
->dev
, &fcoe_sysfs_templ
,
399 FCOE_DBG("Failed to add fcoe_ctlr_device\n");
400 fcoe
= ERR_PTR(-ENOMEM
);
404 ctlr
= fcoe_ctlr_device_priv(ctlr_dev
);
405 ctlr
->cdev
= ctlr_dev
;
406 fcoe
= fcoe_ctlr_priv(ctlr
);
413 fcoe_ctlr_init(ctlr
, fip_mode
);
414 ctlr
->send
= fcoe_fip_send
;
415 ctlr
->update_mac
= fcoe_update_src_mac
;
416 ctlr
->get_src_addr
= fcoe_get_src_mac
;
418 err
= fcoe_interface_setup(fcoe
, netdev
);
420 fcoe_ctlr_destroy(ctlr
);
421 fcoe_ctlr_device_delete(ctlr_dev
);
430 module_put(THIS_MODULE
);
436 * fcoe_interface_remove() - remove FCoE interface from netdev
437 * @fcoe: The FCoE interface to be cleaned up
439 * Caller must be holding the RTNL mutex
441 static void fcoe_interface_remove(struct fcoe_interface
*fcoe
)
443 struct net_device
*netdev
= fcoe
->netdev
;
444 struct fcoe_ctlr
*fip
= fcoe_to_ctlr(fcoe
);
445 u8 flogi_maddr
[ETH_ALEN
];
446 const struct net_device_ops
*ops
;
449 * Don't listen for Ethernet packets anymore.
450 * synchronize_net() ensures that the packet handlers are not running
451 * on another CPU. dev_remove_pack() would do that, this calls the
452 * unsyncronized version __dev_remove_pack() to avoid multiple delays.
454 __dev_remove_pack(&fcoe
->fcoe_packet_type
);
455 __dev_remove_pack(&fcoe
->fip_packet_type
);
456 if (netdev
!= fcoe
->realdev
)
457 __dev_remove_pack(&fcoe
->fip_vlan_packet_type
);
460 /* Delete secondary MAC addresses */
461 memcpy(flogi_maddr
, (u8
[6]) FC_FCOE_FLOGI_MAC
, ETH_ALEN
);
462 dev_uc_del(netdev
, flogi_maddr
);
464 dev_uc_del(netdev
, fip
->ctl_src_addr
);
465 if (fip
->mode
== FIP_MODE_VN2VN
) {
466 dev_mc_del(netdev
, FIP_ALL_VN2VN_MACS
);
467 dev_mc_del(netdev
, FIP_ALL_P2P_MACS
);
469 dev_mc_del(netdev
, FIP_ALL_ENODE_MACS
);
471 /* Tell the LLD we are done w/ FCoE */
472 ops
= netdev
->netdev_ops
;
473 if (ops
->ndo_fcoe_disable
) {
474 if (ops
->ndo_fcoe_disable(netdev
))
475 FCOE_NETDEV_DBG(netdev
, "Failed to disable FCoE"
476 " specific feature for LLD.\n");
483 * fcoe_interface_cleanup() - Clean up a FCoE interface
484 * @fcoe: The FCoE interface to be cleaned up
486 static void fcoe_interface_cleanup(struct fcoe_interface
*fcoe
)
488 struct net_device
*netdev
= fcoe
->netdev
;
489 struct fcoe_ctlr
*fip
= fcoe_to_ctlr(fcoe
);
491 /* Release the self-reference taken during fcoe_interface_create() */
492 /* tear-down the FCoE controller */
493 fcoe_ctlr_destroy(fip
);
494 scsi_host_put(fip
->lp
->host
);
496 module_put(THIS_MODULE
);
500 * fcoe_fip_recv() - Handler for received FIP frames
501 * @skb: The receive skb
502 * @netdev: The associated net device
503 * @ptype: The packet_type structure which was used to register this handler
504 * @orig_dev: The original net_device the skb was received on.
505 * (in case dev is a bond)
507 * Returns: 0 for success
509 static int fcoe_fip_recv(struct sk_buff
*skb
, struct net_device
*netdev
,
510 struct packet_type
*ptype
,
511 struct net_device
*orig_dev
)
513 struct fcoe_interface
*fcoe
;
514 struct fcoe_ctlr
*ctlr
;
516 fcoe
= container_of(ptype
, struct fcoe_interface
, fip_packet_type
);
517 ctlr
= fcoe_to_ctlr(fcoe
);
518 fcoe_ctlr_recv(ctlr
, skb
);
523 * fcoe_fip_vlan_recv() - Handler for received FIP VLAN discovery frames
524 * @skb: The receive skb
525 * @netdev: The associated net device
526 * @ptype: The packet_type structure which was used to register this handler
527 * @orig_dev: The original net_device the skb was received on.
528 * (in case dev is a bond)
530 * Returns: 0 for success
532 static int fcoe_fip_vlan_recv(struct sk_buff
*skb
, struct net_device
*netdev
,
533 struct packet_type
*ptype
,
534 struct net_device
*orig_dev
)
536 struct fcoe_interface
*fcoe
;
537 struct fcoe_ctlr
*ctlr
;
539 fcoe
= container_of(ptype
, struct fcoe_interface
, fip_vlan_packet_type
);
540 ctlr
= fcoe_to_ctlr(fcoe
);
541 fcoe_ctlr_recv(ctlr
, skb
);
546 * fcoe_port_send() - Send an Ethernet-encapsulated FIP/FCoE frame
547 * @port: The FCoE port
548 * @skb: The FIP/FCoE packet to be sent
550 static void fcoe_port_send(struct fcoe_port
*port
, struct sk_buff
*skb
)
552 if (port
->fcoe_pending_queue
.qlen
)
553 fcoe_check_wait_queue(port
->lport
, skb
);
554 else if (fcoe_start_io(skb
))
555 fcoe_check_wait_queue(port
->lport
, skb
);
559 * fcoe_fip_send() - Send an Ethernet-encapsulated FIP frame
560 * @fip: The FCoE controller
561 * @skb: The FIP packet to be sent
563 static void fcoe_fip_send(struct fcoe_ctlr
*fip
, struct sk_buff
*skb
)
565 struct fcoe_interface
*fcoe
= fcoe_from_ctlr(fip
);
568 struct fip_header fip
;
572 * Use default VLAN for FIP VLAN discovery protocol
574 frame
= (struct fip_frame
*)skb
->data
;
575 if (ntohs(frame
->eth
.h_proto
) == ETH_P_FIP
&&
576 ntohs(frame
->fip
.fip_op
) == FIP_OP_VLAN
&&
577 fcoe
->realdev
!= fcoe
->netdev
)
578 skb
->dev
= fcoe
->realdev
;
580 skb
->dev
= fcoe
->netdev
;
581 fcoe_port_send(lport_priv(fip
->lp
), skb
);
585 * fcoe_update_src_mac() - Update the Ethernet MAC filters
586 * @lport: The local port to update the source MAC on
587 * @addr: Unicast MAC address to add
589 * Remove any previously-set unicast MAC filter.
590 * Add secondary FCoE MAC address filter for our OUI.
592 static void fcoe_update_src_mac(struct fc_lport
*lport
, u8
*addr
)
594 struct fcoe_port
*port
= lport_priv(lport
);
595 struct fcoe_interface
*fcoe
= port
->priv
;
597 if (!is_zero_ether_addr(port
->data_src_addr
))
598 dev_uc_del(fcoe
->netdev
, port
->data_src_addr
);
599 if (!is_zero_ether_addr(addr
))
600 dev_uc_add(fcoe
->netdev
, addr
);
601 memcpy(port
->data_src_addr
, addr
, ETH_ALEN
);
605 * fcoe_get_src_mac() - return the Ethernet source address for an lport
606 * @lport: libfc lport
608 static u8
*fcoe_get_src_mac(struct fc_lport
*lport
)
610 struct fcoe_port
*port
= lport_priv(lport
);
612 return port
->data_src_addr
;
616 * fcoe_lport_config() - Set up a local port
617 * @lport: The local port to be setup
619 * Returns: 0 for success
621 static int fcoe_lport_config(struct fc_lport
*lport
)
625 lport
->max_retry_count
= 3;
626 lport
->max_rport_retry_count
= 3;
627 lport
->e_d_tov
= fcoe_e_d_tov
;
628 lport
->r_a_tov
= fcoe_r_a_tov
;
629 lport
->service_params
= (FCP_SPPF_INIT_FCN
| FCP_SPPF_RD_XRDY_DIS
|
630 FCP_SPPF_RETRY
| FCP_SPPF_CONF_COMPL
);
631 lport
->does_npiv
= 1;
633 fc_lport_init_stats(lport
);
635 /* lport fc_lport related configuration */
636 fc_lport_config(lport
);
638 /* offload related configuration */
639 lport
->crc_offload
= 0;
640 lport
->seq_offload
= 0;
641 lport
->lro_enabled
= 0;
649 * fcoe_netdev_features_change - Updates the lport's offload flags based
650 * on the LLD netdev's FCoE feature flags
652 static void fcoe_netdev_features_change(struct fc_lport
*lport
,
653 struct net_device
*netdev
)
655 mutex_lock(&lport
->lp_mutex
);
657 if (netdev
->features
& NETIF_F_SG
)
662 if (netdev
->features
& NETIF_F_FCOE_CRC
) {
663 lport
->crc_offload
= 1;
664 FCOE_NETDEV_DBG(netdev
, "Supports FCCRC offload\n");
666 lport
->crc_offload
= 0;
669 if (netdev
->features
& NETIF_F_FSO
) {
670 lport
->seq_offload
= 1;
671 lport
->lso_max
= netdev
->gso_max_size
;
672 FCOE_NETDEV_DBG(netdev
, "Supports LSO for max len 0x%x\n",
675 lport
->seq_offload
= 0;
679 if (netdev
->fcoe_ddp_xid
) {
680 lport
->lro_enabled
= 1;
681 lport
->lro_xid
= netdev
->fcoe_ddp_xid
;
682 FCOE_NETDEV_DBG(netdev
, "Supports LRO for max xid 0x%x\n",
685 lport
->lro_enabled
= 0;
689 mutex_unlock(&lport
->lp_mutex
);
693 * fcoe_netdev_config() - Set up net devive for SW FCoE
694 * @lport: The local port that is associated with the net device
695 * @netdev: The associated net device
697 * Must be called after fcoe_lport_config() as it will use local port mutex
699 * Returns: 0 for success
701 static int fcoe_netdev_config(struct fc_lport
*lport
, struct net_device
*netdev
)
705 struct fcoe_interface
*fcoe
;
706 struct fcoe_ctlr
*ctlr
;
707 struct fcoe_port
*port
;
709 /* Setup lport private data to point to fcoe softc */
710 port
= lport_priv(lport
);
712 ctlr
= fcoe_to_ctlr(fcoe
);
714 /* Figure out the VLAN ID, if any */
715 if (is_vlan_dev(netdev
))
716 lport
->vlan
= vlan_dev_vlan_id(netdev
);
721 * Determine max frame size based on underlying device and optional
722 * user-configured limit. If the MFS is too low, fcoe_link_ok()
723 * will return 0, so do this first.
726 if (netdev
->features
& NETIF_F_FCOE_MTU
) {
728 FCOE_NETDEV_DBG(netdev
, "Supports FCOE_MTU of %d bytes\n", mfs
);
730 mfs
-= (sizeof(struct fcoe_hdr
) + sizeof(struct fcoe_crc_eof
));
731 if (fc_set_mfs(lport
, mfs
))
734 /* offload features support */
735 fcoe_netdev_features_change(lport
, netdev
);
737 skb_queue_head_init(&port
->fcoe_pending_queue
);
738 port
->fcoe_pending_queue_active
= 0;
739 timer_setup(&port
->timer
, fcoe_queue_timer
, 0);
741 fcoe_link_speed_update(lport
);
744 if (fcoe_get_wwn(netdev
, &wwnn
, NETDEV_FCOE_WWNN
))
745 wwnn
= fcoe_wwn_from_mac(ctlr
->ctl_src_addr
, 1, 0);
746 fc_set_wwnn(lport
, wwnn
);
747 if (fcoe_get_wwn(netdev
, &wwpn
, NETDEV_FCOE_WWPN
))
748 wwpn
= fcoe_wwn_from_mac(ctlr
->ctl_src_addr
,
750 fc_set_wwpn(lport
, wwpn
);
757 * fcoe_shost_config() - Set up the SCSI host associated with a local port
758 * @lport: The local port
759 * @dev: The device associated with the SCSI host
761 * Must be called after fcoe_lport_config() and fcoe_netdev_config()
763 * Returns: 0 for success
765 static int fcoe_shost_config(struct fc_lport
*lport
, struct device
*dev
)
769 /* lport scsi host config */
770 lport
->host
->max_lun
= FCOE_MAX_LUN
;
771 lport
->host
->max_id
= FCOE_MAX_FCP_TARGET
;
772 lport
->host
->max_channel
= 0;
773 lport
->host
->max_cmd_len
= FCOE_MAX_CMD_LEN
;
776 lport
->host
->transportt
= fcoe_vport_scsi_transport
;
778 lport
->host
->transportt
= fcoe_nport_scsi_transport
;
780 /* add the new host to the SCSI-ml */
781 rc
= scsi_add_host(lport
->host
, dev
);
783 FCOE_NETDEV_DBG(fcoe_netdev(lport
), "fcoe_shost_config: "
784 "error on scsi_add_host\n");
789 fc_host_max_npiv_vports(lport
->host
) = USHRT_MAX
;
791 snprintf(fc_host_symbolic_name(lport
->host
), FC_SYMBOLIC_NAME_SIZE
,
792 "%s v%s over %s", FCOE_NAME
, FCOE_VERSION
,
793 fcoe_netdev(lport
)->name
);
800 * fcoe_fdmi_info() - Get FDMI related info from net devive for SW FCoE
801 * @lport: The local port that is associated with the net device
802 * @netdev: The associated net device
804 * Must be called after fcoe_shost_config() as it will use local port mutex
807 static void fcoe_fdmi_info(struct fc_lport
*lport
, struct net_device
*netdev
)
809 struct fcoe_interface
*fcoe
;
810 struct fcoe_port
*port
;
811 struct net_device
*realdev
;
814 port
= lport_priv(lport
);
816 realdev
= fcoe
->realdev
;
818 /* No FDMI state m/c for NPIV ports */
822 if (realdev
->netdev_ops
->ndo_fcoe_get_hbainfo
) {
823 struct netdev_fcoe_hbainfo
*fdmi
;
824 fdmi
= kzalloc(sizeof(*fdmi
), GFP_KERNEL
);
828 rc
= realdev
->netdev_ops
->ndo_fcoe_get_hbainfo(realdev
,
831 printk(KERN_INFO
"fcoe: Failed to retrieve FDMI "
832 "information from netdev.\n");
836 snprintf(fc_host_serial_number(lport
->host
),
837 FC_SERIAL_NUMBER_SIZE
,
839 fdmi
->serial_number
);
840 snprintf(fc_host_manufacturer(lport
->host
),
841 FC_SERIAL_NUMBER_SIZE
,
844 snprintf(fc_host_model(lport
->host
),
845 FC_SYMBOLIC_NAME_SIZE
,
848 snprintf(fc_host_model_description(lport
->host
),
849 FC_SYMBOLIC_NAME_SIZE
,
851 fdmi
->model_description
);
852 snprintf(fc_host_hardware_version(lport
->host
),
853 FC_VERSION_STRING_SIZE
,
855 fdmi
->hardware_version
);
856 snprintf(fc_host_driver_version(lport
->host
),
857 FC_VERSION_STRING_SIZE
,
859 fdmi
->driver_version
);
860 snprintf(fc_host_optionrom_version(lport
->host
),
861 FC_VERSION_STRING_SIZE
,
863 fdmi
->optionrom_version
);
864 snprintf(fc_host_firmware_version(lport
->host
),
865 FC_VERSION_STRING_SIZE
,
867 fdmi
->firmware_version
);
869 /* Enable FDMI lport states */
870 lport
->fdmi_enabled
= 1;
873 lport
->fdmi_enabled
= 0;
874 printk(KERN_INFO
"fcoe: No FDMI support.\n");
879 * fcoe_oem_match() - The match routine for the offloaded exchange manager
882 * This routine will be associated with an exchange manager (EM). When
883 * the libfc exchange handling code is looking for an EM to use it will
884 * call this routine and pass it the frame that it wishes to send. This
885 * routine will return True if the associated EM is to be used and False
886 * if the echange code should continue looking for an EM.
888 * The offload EM that this routine is associated with will handle any
889 * packets that are for SCSI read requests.
891 * This has been enhanced to work when FCoE stack is operating in target
894 * Returns: True for read types I/O, otherwise returns false.
896 static bool fcoe_oem_match(struct fc_frame
*fp
)
898 struct fc_frame_header
*fh
= fc_frame_header_get(fp
);
899 struct fcp_cmnd
*fcp
;
901 if (fc_fcp_is_read(fr_fsp(fp
)) &&
902 (fr_fsp(fp
)->data_len
> fcoe_ddp_min
))
904 else if ((fr_fsp(fp
) == NULL
) &&
905 (fh
->fh_r_ctl
== FC_RCTL_DD_UNSOL_CMD
) &&
906 (ntohs(fh
->fh_rx_id
) == FC_XID_UNKNOWN
)) {
907 fcp
= fc_frame_payload_get(fp
, sizeof(*fcp
));
908 if ((fcp
->fc_flags
& FCP_CFL_WRDATA
) &&
909 (ntohl(fcp
->fc_dl
) > fcoe_ddp_min
))
916 * fcoe_em_config() - Allocate and configure an exchange manager
917 * @lport: The local port that the new EM will be associated with
919 * Returns: 0 on success
921 static inline int fcoe_em_config(struct fc_lport
*lport
)
923 struct fcoe_port
*port
= lport_priv(lport
);
924 struct fcoe_interface
*fcoe
= port
->priv
;
925 struct fcoe_interface
*oldfcoe
= NULL
;
926 struct net_device
*old_real_dev
, *cur_real_dev
;
927 u16 min_xid
= FCOE_MIN_XID
;
928 u16 max_xid
= FCOE_MAX_XID
;
931 * Check if need to allocate an em instance for
932 * offload exchange ids to be shared across all VN_PORTs/lport.
934 if (!lport
->lro_enabled
|| !lport
->lro_xid
||
935 (lport
->lro_xid
>= max_xid
)) {
941 * Reuse existing offload em instance in case
942 * it is already allocated on real eth device
944 if (is_vlan_dev(fcoe
->netdev
))
945 cur_real_dev
= vlan_dev_real_dev(fcoe
->netdev
);
947 cur_real_dev
= fcoe
->netdev
;
949 list_for_each_entry(oldfcoe
, &fcoe_hostlist
, list
) {
950 if (is_vlan_dev(oldfcoe
->netdev
))
951 old_real_dev
= vlan_dev_real_dev(oldfcoe
->netdev
);
953 old_real_dev
= oldfcoe
->netdev
;
955 if (cur_real_dev
== old_real_dev
) {
956 fcoe
->oem
= oldfcoe
->oem
;
962 if (!fc_exch_mgr_add(lport
, fcoe
->oem
, fcoe_oem_match
)) {
963 printk(KERN_ERR
"fcoe_em_config: failed to add "
964 "offload em:%p on interface:%s\n",
965 fcoe
->oem
, fcoe
->netdev
->name
);
969 fcoe
->oem
= fc_exch_mgr_alloc(lport
, FC_CLASS_3
,
970 FCOE_MIN_XID
, lport
->lro_xid
,
973 printk(KERN_ERR
"fcoe_em_config: failed to allocate "
974 "em for offload exches on interface:%s\n",
981 * Exclude offload EM xid range from next EM xid range.
983 min_xid
+= lport
->lro_xid
+ 1;
986 if (!fc_exch_mgr_alloc(lport
, FC_CLASS_3
, min_xid
, max_xid
, NULL
)) {
987 printk(KERN_ERR
"fcoe_em_config: failed to "
988 "allocate em on interface %s\n", fcoe
->netdev
->name
);
996 * fcoe_if_destroy() - Tear down a SW FCoE instance
997 * @lport: The local port to be destroyed
999 * Locking: Must be called with the RTNL mutex held.
1002 static void fcoe_if_destroy(struct fc_lport
*lport
)
1004 struct fcoe_port
*port
= lport_priv(lport
);
1005 struct fcoe_interface
*fcoe
= port
->priv
;
1006 struct net_device
*netdev
= fcoe
->netdev
;
1008 FCOE_NETDEV_DBG(netdev
, "Destroying interface\n");
1010 /* Logout of the fabric */
1011 fc_fabric_logoff(lport
);
1013 /* Cleanup the fc_lport */
1014 fc_lport_destroy(lport
);
1016 /* Stop the transmit retry timer */
1017 del_timer_sync(&port
->timer
);
1019 /* Free existing transmit skbs */
1020 fcoe_clean_pending_queue(lport
);
1022 if (!is_zero_ether_addr(port
->data_src_addr
))
1023 dev_uc_del(netdev
, port
->data_src_addr
);
1027 fcoe_interface_remove(fcoe
);
1029 /* Free queued packets for the per-CPU receive threads */
1030 fcoe_percpu_clean(lport
);
1032 /* Detach from the scsi-ml */
1033 fc_remove_host(lport
->host
);
1034 scsi_remove_host(lport
->host
);
1036 /* Destroy lport scsi_priv */
1037 fc_fcp_destroy(lport
);
1039 /* There are no more rports or I/O, free the EM */
1040 fc_exch_mgr_free(lport
);
1042 /* Free memory used by statistical counters */
1043 fc_lport_free_stats(lport
);
1046 * Release the Scsi_Host for vport but hold on to
1047 * master lport until it fcoe interface fully cleaned-up.
1050 scsi_host_put(lport
->host
);
1054 * fcoe_ddp_setup() - Call a LLD's ddp_setup through the net device
1055 * @lport: The local port to setup DDP for
1056 * @xid: The exchange ID for this DDP transfer
1057 * @sgl: The scatterlist describing this transfer
1058 * @sgc: The number of sg items
1060 * Returns: 0 if the DDP context was not configured
1062 static int fcoe_ddp_setup(struct fc_lport
*lport
, u16 xid
,
1063 struct scatterlist
*sgl
, unsigned int sgc
)
1065 struct net_device
*netdev
= fcoe_netdev(lport
);
1067 if (netdev
->netdev_ops
->ndo_fcoe_ddp_setup
)
1068 return netdev
->netdev_ops
->ndo_fcoe_ddp_setup(netdev
,
1076 * fcoe_ddp_target() - Call a LLD's ddp_target through the net device
1077 * @lport: The local port to setup DDP for
1078 * @xid: The exchange ID for this DDP transfer
1079 * @sgl: The scatterlist describing this transfer
1080 * @sgc: The number of sg items
1082 * Returns: 0 if the DDP context was not configured
1084 static int fcoe_ddp_target(struct fc_lport
*lport
, u16 xid
,
1085 struct scatterlist
*sgl
, unsigned int sgc
)
1087 struct net_device
*netdev
= fcoe_netdev(lport
);
1089 if (netdev
->netdev_ops
->ndo_fcoe_ddp_target
)
1090 return netdev
->netdev_ops
->ndo_fcoe_ddp_target(netdev
, xid
,
1098 * fcoe_ddp_done() - Call a LLD's ddp_done through the net device
1099 * @lport: The local port to complete DDP on
1100 * @xid: The exchange ID for this DDP transfer
1102 * Returns: the length of data that have been completed by DDP
1104 static int fcoe_ddp_done(struct fc_lport
*lport
, u16 xid
)
1106 struct net_device
*netdev
= fcoe_netdev(lport
);
1108 if (netdev
->netdev_ops
->ndo_fcoe_ddp_done
)
1109 return netdev
->netdev_ops
->ndo_fcoe_ddp_done(netdev
, xid
);
1114 * fcoe_if_create() - Create a FCoE instance on an interface
1115 * @fcoe: The FCoE interface to create a local port on
1116 * @parent: The device pointer to be the parent in sysfs for the SCSI host
1117 * @npiv: Indicates if the port is a vport or not
1119 * Creates a fc_lport instance and a Scsi_Host instance and configure them.
1121 * Returns: The allocated fc_lport or an error pointer
1123 static struct fc_lport
*fcoe_if_create(struct fcoe_interface
*fcoe
,
1124 struct device
*parent
, int npiv
)
1126 struct fcoe_ctlr
*ctlr
= fcoe_to_ctlr(fcoe
);
1127 struct net_device
*netdev
= fcoe
->netdev
;
1128 struct fc_lport
*lport
, *n_port
;
1129 struct fcoe_port
*port
;
1130 struct Scsi_Host
*shost
;
1133 * parent is only a vport if npiv is 1,
1134 * but we'll only use vport in that case so go ahead and set it
1136 struct fc_vport
*vport
= dev_to_vport(parent
);
1138 FCOE_NETDEV_DBG(netdev
, "Create Interface\n");
1141 lport
= libfc_host_alloc(&fcoe_shost_template
, sizeof(*port
));
1143 lport
= libfc_vport_create(vport
, sizeof(*port
));
1146 FCOE_NETDEV_DBG(netdev
, "Could not allocate host structure\n");
1150 port
= lport_priv(lport
);
1151 port
->lport
= lport
;
1153 port
->get_netdev
= fcoe_netdev
;
1154 port
->max_queue_depth
= FCOE_MAX_QUEUE_DEPTH
;
1155 port
->min_queue_depth
= FCOE_MIN_QUEUE_DEPTH
;
1156 INIT_WORK(&port
->destroy_work
, fcoe_destroy_work
);
1159 * Need to add the lport to the hostlist
1160 * so we catch NETDEV_CHANGE events.
1162 fcoe_hostlist_add(lport
);
1164 /* configure a fc_lport including the exchange manager */
1165 rc
= fcoe_lport_config(lport
);
1167 FCOE_NETDEV_DBG(netdev
, "Could not configure lport for the "
1173 FCOE_NETDEV_DBG(netdev
, "Setting vport names, "
1174 "%16.16llx %16.16llx\n",
1175 vport
->node_name
, vport
->port_name
);
1176 fc_set_wwnn(lport
, vport
->node_name
);
1177 fc_set_wwpn(lport
, vport
->port_name
);
1180 /* configure lport network properties */
1181 rc
= fcoe_netdev_config(lport
, netdev
);
1183 FCOE_NETDEV_DBG(netdev
, "Could not configure netdev for the "
1185 goto out_lp_destroy
;
1188 /* configure lport scsi host properties */
1189 rc
= fcoe_shost_config(lport
, parent
);
1191 FCOE_NETDEV_DBG(netdev
, "Could not configure shost for the "
1193 goto out_lp_destroy
;
1196 /* Initialize the library */
1197 rc
= fcoe_libfc_config(lport
, ctlr
, &fcoe_libfc_fcn_templ
, 1);
1199 FCOE_NETDEV_DBG(netdev
, "Could not configure libfc for the "
1201 goto out_lp_destroy
;
1204 /* Initialized FDMI information */
1205 fcoe_fdmi_info(lport
, netdev
);
1208 * fcoe_em_alloc() and fcoe_hostlist_add() both
1209 * need to be atomic with respect to other changes to the
1210 * hostlist since fcoe_em_alloc() looks for an existing EM
1211 * instance on host list updated by fcoe_hostlist_add().
1213 * This is currently handled through the fcoe_config_mutex
1217 /* lport exch manager allocation */
1218 rc
= fcoe_em_config(lport
);
1220 shost
= vport_to_shost(vport
);
1221 n_port
= shost_priv(shost
);
1222 rc
= fc_exch_mgr_list_clone(n_port
, lport
);
1226 FCOE_NETDEV_DBG(netdev
, "Could not configure the EM\n");
1227 goto out_lp_destroy
;
1233 fc_exch_mgr_free(lport
);
1235 fcoe_hostlist_del(lport
);
1236 scsi_host_put(lport
->host
);
1242 * fcoe_if_init() - Initialization routine for fcoe.ko
1244 * Attaches the SW FCoE transport to the FC transport
1246 * Returns: 0 on success
1248 static int __init
fcoe_if_init(void)
1250 /* attach to scsi transport */
1251 fcoe_nport_scsi_transport
=
1252 fc_attach_transport(&fcoe_nport_fc_functions
);
1253 if (!fcoe_nport_scsi_transport
)
1256 fcoe_vport_scsi_transport
=
1257 fc_attach_transport(&fcoe_vport_fc_functions
);
1258 if (!fcoe_vport_scsi_transport
)
1264 fc_release_transport(fcoe_nport_scsi_transport
);
1266 printk(KERN_ERR
"fcoe: Failed to attach to the FC transport\n");
1271 * fcoe_if_exit() - Tear down fcoe.ko
1273 * Detaches the SW FCoE transport from the FC transport
1275 * Returns: 0 on success
1277 static int __exit
fcoe_if_exit(void)
1279 fc_release_transport(fcoe_nport_scsi_transport
);
1280 fc_release_transport(fcoe_vport_scsi_transport
);
1281 fcoe_nport_scsi_transport
= NULL
;
1282 fcoe_vport_scsi_transport
= NULL
;
1286 static void fcoe_thread_cleanup_local(unsigned int cpu
)
1288 struct page
*crc_eof
;
1289 struct fcoe_percpu_s
*p
;
1291 p
= per_cpu_ptr(&fcoe_percpu
, cpu
);
1292 spin_lock_bh(&p
->fcoe_rx_list
.lock
);
1293 crc_eof
= p
->crc_eof_page
;
1294 p
->crc_eof_page
= NULL
;
1295 p
->crc_eof_offset
= 0;
1296 spin_unlock_bh(&p
->fcoe_rx_list
.lock
);
1300 flush_work(&p
->work
);
1304 * fcoe_select_cpu() - Selects CPU to handle post-processing of incoming
1307 * This routine selects next CPU based on cpumask to distribute
1308 * incoming requests in round robin.
1310 * Returns: int CPU number
1312 static inline unsigned int fcoe_select_cpu(void)
1314 static unsigned int selected_cpu
;
1316 selected_cpu
= cpumask_next(selected_cpu
, cpu_online_mask
);
1317 if (selected_cpu
>= nr_cpu_ids
)
1318 selected_cpu
= cpumask_first(cpu_online_mask
);
1320 return selected_cpu
;
1324 * fcoe_rcv() - Receive packets from a net device
1325 * @skb: The received packet
1326 * @netdev: The net device that the packet was received on
1327 * @ptype: The packet type context
1328 * @olddev: The last device net device
1330 * This routine is called by NET_RX_SOFTIRQ. It receives a packet, builds a
1331 * FC frame and passes the frame to libfc.
1333 * Returns: 0 for success
1335 static int fcoe_rcv(struct sk_buff
*skb
, struct net_device
*netdev
,
1336 struct packet_type
*ptype
, struct net_device
*olddev
)
1338 struct fc_lport
*lport
;
1339 struct fcoe_rcv_info
*fr
;
1340 struct fcoe_ctlr
*ctlr
;
1341 struct fcoe_interface
*fcoe
;
1342 struct fc_frame_header
*fh
;
1343 struct fcoe_percpu_s
*fps
;
1347 fcoe
= container_of(ptype
, struct fcoe_interface
, fcoe_packet_type
);
1348 ctlr
= fcoe_to_ctlr(fcoe
);
1350 if (unlikely(!lport
)) {
1351 FCOE_NETDEV_DBG(netdev
, "Cannot find hba structure\n");
1354 if (!lport
->link_up
)
1357 FCOE_NETDEV_DBG(netdev
,
1358 "skb_info: len:%d data_len:%d head:%p data:%p tail:%p end:%p sum:%d dev:%s\n",
1359 skb
->len
, skb
->data_len
, skb
->head
, skb
->data
,
1360 skb_tail_pointer(skb
), skb_end_pointer(skb
),
1361 skb
->csum
, skb
->dev
? skb
->dev
->name
: "<NULL>");
1364 skb
= skb_share_check(skb
, GFP_ATOMIC
);
1371 if (is_fip_mode(ctlr
) &&
1372 !ether_addr_equal(eh
->h_source
, ctlr
->dest_addr
)) {
1373 FCOE_NETDEV_DBG(netdev
, "wrong source mac address:%pM\n",
1379 * Check for minimum frame length, and make sure required FCoE
1380 * and FC headers are pulled into the linear data area.
1382 if (unlikely((skb
->len
< FCOE_MIN_FRAME
) ||
1383 !pskb_may_pull(skb
, FCOE_HEADER_LEN
)))
1386 skb_set_transport_header(skb
, sizeof(struct fcoe_hdr
));
1387 fh
= (struct fc_frame_header
*) skb_transport_header(skb
);
1389 if (ntoh24(&eh
->h_dest
[3]) != ntoh24(fh
->fh_d_id
)) {
1390 FCOE_NETDEV_DBG(netdev
, "FC frame d_id mismatch with MAC:%pM\n",
1395 fr
= fcoe_dev_from_skb(skb
);
1399 * In case the incoming frame's exchange is originated from
1400 * the initiator, then received frame's exchange id is ANDed
1401 * with fc_cpu_mask bits to get the same cpu on which exchange
1402 * was originated, otherwise select cpu using rx exchange id
1403 * or fcoe_select_cpu().
1405 if (ntoh24(fh
->fh_f_ctl
) & FC_FC_EX_CTX
)
1406 cpu
= ntohs(fh
->fh_ox_id
) & fc_cpu_mask
;
1408 if (ntohs(fh
->fh_rx_id
) == FC_XID_UNKNOWN
)
1409 cpu
= fcoe_select_cpu();
1411 cpu
= ntohs(fh
->fh_rx_id
) & fc_cpu_mask
;
1414 if (cpu
>= nr_cpu_ids
)
1417 fps
= &per_cpu(fcoe_percpu
, cpu
);
1418 spin_lock(&fps
->fcoe_rx_list
.lock
);
1420 * We now have a valid CPU that we're targeting for
1421 * this skb. We also have this receive thread locked,
1422 * so we're free to queue skbs into it's queue.
1426 * Note: We used to have a set of conditions under which we would
1427 * call fcoe_recv_frame directly, rather than queuing to the rx list
1428 * as it could save a few cycles, but doing so is prohibited, as
1429 * fcoe_recv_frame has several paths that may sleep, which is forbidden
1430 * in softirq context.
1432 __skb_queue_tail(&fps
->fcoe_rx_list
, skb
);
1433 schedule_work_on(cpu
, &fps
->work
);
1434 spin_unlock(&fps
->fcoe_rx_list
.lock
);
1436 return NET_RX_SUCCESS
;
1438 per_cpu_ptr(lport
->stats
, get_cpu())->ErrorFrames
++;
1446 * fcoe_alloc_paged_crc_eof() - Allocate a page to be used for the trailer CRC
1447 * @skb: The packet to be transmitted
1448 * @tlen: The total length of the trailer
1450 * Returns: 0 for success
1452 static int fcoe_alloc_paged_crc_eof(struct sk_buff
*skb
, int tlen
)
1454 struct fcoe_percpu_s
*fps
;
1457 fps
= &get_cpu_var(fcoe_percpu
);
1458 rc
= fcoe_get_paged_crc_eof(skb
, tlen
, fps
);
1459 put_cpu_var(fcoe_percpu
);
1465 * fcoe_xmit() - Transmit a FCoE frame
1466 * @lport: The local port that the frame is to be transmitted for
1467 * @fp: The frame to be transmitted
1469 * Return: 0 for success
1471 static int fcoe_xmit(struct fc_lport
*lport
, struct fc_frame
*fp
)
1476 struct fcoe_crc_eof
*cp
;
1477 struct sk_buff
*skb
;
1478 struct fc_stats
*stats
;
1479 struct fc_frame_header
*fh
;
1480 unsigned int hlen
; /* header length implies the version */
1481 unsigned int tlen
; /* trailer length */
1482 unsigned int elen
; /* eth header, may include vlan */
1483 struct fcoe_port
*port
= lport_priv(lport
);
1484 struct fcoe_interface
*fcoe
= port
->priv
;
1485 struct fcoe_ctlr
*ctlr
= fcoe_to_ctlr(fcoe
);
1487 struct fcoe_hdr
*hp
;
1489 WARN_ON((fr_len(fp
) % sizeof(u32
)) != 0);
1491 fh
= fc_frame_header_get(fp
);
1493 wlen
= skb
->len
/ FCOE_WORD_TO_BYTE
;
1495 if (!lport
->link_up
) {
1500 if (unlikely(fh
->fh_type
== FC_TYPE_ELS
) &&
1501 fcoe_ctlr_els_send(ctlr
, lport
, skb
))
1507 elen
= sizeof(struct ethhdr
);
1508 hlen
= sizeof(struct fcoe_hdr
);
1509 tlen
= sizeof(struct fcoe_crc_eof
);
1510 wlen
= (skb
->len
- tlen
+ sizeof(crc
)) / FCOE_WORD_TO_BYTE
;
1513 if (likely(lport
->crc_offload
)) {
1514 skb
->ip_summed
= CHECKSUM_PARTIAL
;
1515 skb
->csum_start
= skb_headroom(skb
);
1516 skb
->csum_offset
= skb
->len
;
1519 skb
->ip_summed
= CHECKSUM_NONE
;
1520 crc
= fcoe_fc_crc(fp
);
1523 /* copy port crc and eof to the skb buff */
1524 if (skb_is_nonlinear(skb
)) {
1526 if (fcoe_alloc_paged_crc_eof(skb
, tlen
)) {
1530 frag
= &skb_shinfo(skb
)->frags
[skb_shinfo(skb
)->nr_frags
- 1];
1531 cp
= kmap_atomic(skb_frag_page(frag
)) + skb_frag_off(frag
);
1533 cp
= skb_put(skb
, tlen
);
1536 memset(cp
, 0, sizeof(*cp
));
1538 cp
->fcoe_crc32
= cpu_to_le32(~crc
);
1540 if (skb_is_nonlinear(skb
)) {
1545 /* adjust skb network/transport offsets to match mac/fcoe/port */
1546 skb_push(skb
, elen
+ hlen
);
1547 skb_reset_mac_header(skb
);
1548 skb_reset_network_header(skb
);
1549 skb
->mac_len
= elen
;
1550 skb
->protocol
= htons(ETH_P_FCOE
);
1551 skb
->priority
= fcoe
->priority
;
1553 if (is_vlan_dev(fcoe
->netdev
) &&
1554 fcoe
->realdev
->features
& NETIF_F_HW_VLAN_CTAG_TX
) {
1555 /* must set skb->dev before calling vlan_put_tag */
1556 skb
->dev
= fcoe
->realdev
;
1557 __vlan_hwaccel_put_tag(skb
, htons(ETH_P_8021Q
),
1558 vlan_dev_vlan_id(fcoe
->netdev
));
1560 skb
->dev
= fcoe
->netdev
;
1562 /* fill up mac and fcoe headers */
1564 eh
->h_proto
= htons(ETH_P_FCOE
);
1565 memcpy(eh
->h_dest
, ctlr
->dest_addr
, ETH_ALEN
);
1567 memcpy(eh
->h_dest
+ 3, fh
->fh_d_id
, 3);
1569 if (unlikely(ctlr
->flogi_oxid
!= FC_XID_UNKNOWN
))
1570 memcpy(eh
->h_source
, ctlr
->ctl_src_addr
, ETH_ALEN
);
1572 memcpy(eh
->h_source
, port
->data_src_addr
, ETH_ALEN
);
1574 hp
= (struct fcoe_hdr
*)(eh
+ 1);
1575 memset(hp
, 0, sizeof(*hp
));
1577 FC_FCOE_ENCAPS_VER(hp
, FC_FCOE_VER
);
1580 /* fcoe lso, mss is in max_payload which is non-zero for FCP data */
1581 if (lport
->seq_offload
&& fr_max_payload(fp
)) {
1582 skb_shinfo(skb
)->gso_type
= SKB_GSO_FCOE
;
1583 skb_shinfo(skb
)->gso_size
= fr_max_payload(fp
);
1585 skb_shinfo(skb
)->gso_type
= 0;
1586 skb_shinfo(skb
)->gso_size
= 0;
1588 /* update tx stats: regardless if LLD fails */
1589 stats
= per_cpu_ptr(lport
->stats
, get_cpu());
1591 stats
->TxWords
+= wlen
;
1594 /* send down to lld */
1596 fcoe_port_send(port
, skb
);
1601 * fcoe_filter_frames() - filter out bad fcoe frames, i.e. bad CRC
1602 * @lport: The local port the frame was received on
1603 * @fp: The received frame
1605 * Return: 0 on passing filtering checks
1607 static inline int fcoe_filter_frames(struct fc_lport
*lport
,
1608 struct fc_frame
*fp
)
1610 struct fcoe_ctlr
*ctlr
;
1611 struct fcoe_interface
*fcoe
;
1612 struct fc_frame_header
*fh
;
1613 struct sk_buff
*skb
= (struct sk_buff
*)fp
;
1614 struct fc_stats
*stats
;
1617 * We only check CRC if no offload is available and if it is
1618 * it's solicited data, in which case, the FCP layer would
1619 * check it during the copy.
1621 if (lport
->crc_offload
&& skb
->ip_summed
== CHECKSUM_UNNECESSARY
)
1622 fr_flags(fp
) &= ~FCPHF_CRC_UNCHECKED
;
1624 fr_flags(fp
) |= FCPHF_CRC_UNCHECKED
;
1626 fh
= fc_frame_header_get(fp
);
1627 if (fh
->fh_r_ctl
== FC_RCTL_DD_SOL_DATA
&& fh
->fh_type
== FC_TYPE_FCP
)
1630 fcoe
= ((struct fcoe_port
*)lport_priv(lport
))->priv
;
1631 ctlr
= fcoe_to_ctlr(fcoe
);
1632 if (is_fip_mode(ctlr
) && fc_frame_payload_op(fp
) == ELS_LOGO
&&
1633 ntoh24(fh
->fh_s_id
) == FC_FID_FLOGI
) {
1634 FCOE_DBG("fcoe: dropping FCoE lport LOGO in fip mode\n");
1638 if (!(fr_flags(fp
) & FCPHF_CRC_UNCHECKED
) ||
1639 le32_to_cpu(fr_crc(fp
)) == ~crc32(~0, skb
->data
, skb
->len
)) {
1640 fr_flags(fp
) &= ~FCPHF_CRC_UNCHECKED
;
1644 stats
= per_cpu_ptr(lport
->stats
, get_cpu());
1645 stats
->InvalidCRCCount
++;
1646 if (stats
->InvalidCRCCount
< 5)
1647 printk(KERN_WARNING
"fcoe: dropping frame with CRC error\n");
1653 * fcoe_recv_frame() - process a single received frame
1654 * @skb: frame to process
1656 static void fcoe_recv_frame(struct sk_buff
*skb
)
1659 struct fc_lport
*lport
;
1660 struct fcoe_rcv_info
*fr
;
1661 struct fc_stats
*stats
;
1662 struct fcoe_crc_eof crc_eof
;
1663 struct fc_frame
*fp
;
1664 struct fcoe_hdr
*hp
;
1666 fr
= fcoe_dev_from_skb(skb
);
1668 if (unlikely(!lport
)) {
1669 FCOE_NETDEV_DBG(skb
->dev
, "NULL lport in skb\n");
1674 FCOE_NETDEV_DBG(skb
->dev
,
1675 "skb_info: len:%d data_len:%d head:%p data:%p tail:%p end:%p sum:%d dev:%s\n",
1676 skb
->len
, skb
->data_len
,
1677 skb
->head
, skb
->data
, skb_tail_pointer(skb
),
1678 skb_end_pointer(skb
), skb
->csum
,
1679 skb
->dev
? skb
->dev
->name
: "<NULL>");
1681 skb_linearize(skb
); /* check for skb_is_nonlinear is within skb_linearize */
1684 * Frame length checks and setting up the header pointers
1685 * was done in fcoe_rcv already.
1687 hp
= (struct fcoe_hdr
*) skb_network_header(skb
);
1689 stats
= per_cpu_ptr(lport
->stats
, get_cpu());
1690 if (unlikely(FC_FCOE_DECAPS_VER(hp
) != FC_FCOE_VER
)) {
1691 if (stats
->ErrorFrames
< 5)
1692 printk(KERN_WARNING
"fcoe: FCoE version "
1693 "mismatch: The frame has "
1694 "version %x, but the "
1695 "initiator supports version "
1696 "%x\n", FC_FCOE_DECAPS_VER(hp
),
1701 skb_pull(skb
, sizeof(struct fcoe_hdr
));
1702 fr_len
= skb
->len
- sizeof(struct fcoe_crc_eof
);
1705 stats
->RxWords
+= fr_len
/ FCOE_WORD_TO_BYTE
;
1707 fp
= (struct fc_frame
*)skb
;
1710 fr_sof(fp
) = hp
->fcoe_sof
;
1712 /* Copy out the CRC and EOF trailer for access */
1713 if (skb_copy_bits(skb
, fr_len
, &crc_eof
, sizeof(crc_eof
)))
1715 fr_eof(fp
) = crc_eof
.fcoe_eof
;
1716 fr_crc(fp
) = crc_eof
.fcoe_crc32
;
1717 if (pskb_trim(skb
, fr_len
))
1720 if (!fcoe_filter_frames(lport
, fp
)) {
1722 fc_exch_recv(lport
, fp
);
1726 stats
->ErrorFrames
++;
1732 * fcoe_receive_work() - The per-CPU worker
1733 * @work: The work struct
1736 static void fcoe_receive_work(struct work_struct
*work
)
1738 struct fcoe_percpu_s
*p
;
1739 struct sk_buff
*skb
;
1740 struct sk_buff_head tmp
;
1742 p
= container_of(work
, struct fcoe_percpu_s
, work
);
1743 skb_queue_head_init(&tmp
);
1745 spin_lock_bh(&p
->fcoe_rx_list
.lock
);
1746 skb_queue_splice_init(&p
->fcoe_rx_list
, &tmp
);
1747 spin_unlock_bh(&p
->fcoe_rx_list
.lock
);
1749 if (!skb_queue_len(&tmp
))
1752 while ((skb
= __skb_dequeue(&tmp
)))
1753 fcoe_recv_frame(skb
);
1757 * fcoe_dev_setup() - Setup the link change notification interface
1759 static void fcoe_dev_setup(void)
1761 register_dcbevent_notifier(&dcb_notifier
);
1762 register_netdevice_notifier(&fcoe_notifier
);
1766 * fcoe_dev_cleanup() - Cleanup the link change notification interface
1768 static void fcoe_dev_cleanup(void)
1770 unregister_dcbevent_notifier(&dcb_notifier
);
1771 unregister_netdevice_notifier(&fcoe_notifier
);
1774 static struct fcoe_interface
*
1775 fcoe_hostlist_lookup_realdev_port(struct net_device
*netdev
)
1777 struct fcoe_interface
*fcoe
;
1778 struct net_device
*real_dev
;
1780 list_for_each_entry(fcoe
, &fcoe_hostlist
, list
) {
1781 if (is_vlan_dev(fcoe
->netdev
))
1782 real_dev
= vlan_dev_real_dev(fcoe
->netdev
);
1784 real_dev
= fcoe
->netdev
;
1786 if (netdev
== real_dev
)
1792 static int fcoe_dcb_app_notification(struct notifier_block
*notifier
,
1793 ulong event
, void *ptr
)
1795 struct dcb_app_type
*entry
= ptr
;
1796 struct fcoe_ctlr
*ctlr
;
1797 struct fcoe_interface
*fcoe
;
1798 struct net_device
*netdev
;
1801 if (entry
->app
.selector
!= DCB_APP_IDTYPE_ETHTYPE
)
1804 netdev
= dev_get_by_index(&init_net
, entry
->ifindex
);
1808 fcoe
= fcoe_hostlist_lookup_realdev_port(netdev
);
1813 ctlr
= fcoe_to_ctlr(fcoe
);
1815 if (entry
->dcbx
& DCB_CAP_DCBX_VER_CEE
)
1816 prio
= ffs(entry
->app
.priority
) - 1;
1818 prio
= entry
->app
.priority
;
1823 if (entry
->app
.protocol
== ETH_P_FIP
||
1824 entry
->app
.protocol
== ETH_P_FCOE
)
1825 ctlr
->priority
= prio
;
1827 if (entry
->app
.protocol
== ETH_P_FCOE
)
1828 fcoe
->priority
= prio
;
1834 * fcoe_device_notification() - Handler for net device events
1835 * @notifier: The context of the notification
1836 * @event: The type of event
1837 * @ptr: The net device that the event was on
1839 * This function is called by the Ethernet driver in case of link change event.
1841 * Returns: 0 for success
1843 static int fcoe_device_notification(struct notifier_block
*notifier
,
1844 ulong event
, void *ptr
)
1846 struct fcoe_ctlr_device
*cdev
;
1847 struct fc_lport
*lport
= NULL
;
1848 struct net_device
*netdev
= netdev_notifier_info_to_dev(ptr
);
1849 struct fcoe_ctlr
*ctlr
;
1850 struct fcoe_interface
*fcoe
;
1851 struct fc_stats
*stats
;
1852 u32 link_possible
= 1;
1856 list_for_each_entry(fcoe
, &fcoe_hostlist
, list
) {
1857 if (fcoe
->netdev
== netdev
) {
1858 ctlr
= fcoe_to_ctlr(fcoe
);
1870 case NETDEV_GOING_DOWN
:
1876 case NETDEV_CHANGEMTU
:
1877 if (netdev
->features
& NETIF_F_FCOE_MTU
)
1879 mfs
= netdev
->mtu
- (sizeof(struct fcoe_hdr
) +
1880 sizeof(struct fcoe_crc_eof
));
1881 if (mfs
>= FC_MIN_MAX_FRAME
)
1882 fc_set_mfs(lport
, mfs
);
1884 case NETDEV_REGISTER
:
1886 case NETDEV_UNREGISTER
:
1887 list_del(&fcoe
->list
);
1888 fcoe_vport_remove(lport
);
1889 mutex_lock(&fcoe_config_mutex
);
1890 fcoe_if_destroy(lport
);
1892 fcoe_interface_remove(fcoe
);
1893 fcoe_interface_cleanup(fcoe
);
1894 mutex_unlock(&fcoe_config_mutex
);
1895 fcoe_ctlr_device_delete(fcoe_ctlr_to_ctlr_dev(ctlr
));
1898 case NETDEV_FEAT_CHANGE
:
1899 fcoe_netdev_features_change(lport
, netdev
);
1902 FCOE_NETDEV_DBG(netdev
, "Unknown event %ld "
1903 "from netdev netlink\n", event
);
1906 fcoe_link_speed_update(lport
);
1908 cdev
= fcoe_ctlr_to_ctlr_dev(ctlr
);
1910 if (link_possible
&& !fcoe_link_ok(lport
)) {
1911 switch (cdev
->enabled
) {
1912 case FCOE_CTLR_DISABLED
:
1913 pr_info("Link up while interface is disabled.\n");
1915 case FCOE_CTLR_ENABLED
:
1916 case FCOE_CTLR_UNUSED
:
1917 fcoe_ctlr_link_up(ctlr
);
1919 } else if (fcoe_ctlr_link_down(ctlr
)) {
1920 switch (cdev
->enabled
) {
1921 case FCOE_CTLR_DISABLED
:
1922 pr_info("Link down while interface is disabled.\n");
1924 case FCOE_CTLR_ENABLED
:
1925 case FCOE_CTLR_UNUSED
:
1926 stats
= per_cpu_ptr(lport
->stats
, get_cpu());
1927 stats
->LinkFailureCount
++;
1929 fcoe_clean_pending_queue(lport
);
1937 * fcoe_disable() - Disables a FCoE interface
1938 * @netdev : The net_device object the Ethernet interface to create on
1940 * Called from fcoe transport.
1942 * Returns: 0 for success
1944 * Deprecated: use fcoe_ctlr_enabled()
1946 static int fcoe_disable(struct net_device
*netdev
)
1948 struct fcoe_ctlr
*ctlr
;
1949 struct fcoe_interface
*fcoe
;
1952 mutex_lock(&fcoe_config_mutex
);
1955 fcoe
= fcoe_hostlist_lookup_port(netdev
);
1959 ctlr
= fcoe_to_ctlr(fcoe
);
1960 fcoe_ctlr_link_down(ctlr
);
1961 fcoe_clean_pending_queue(ctlr
->lp
);
1965 mutex_unlock(&fcoe_config_mutex
);
1970 * fcoe_enable() - Enables a FCoE interface
1971 * @netdev : The net_device object the Ethernet interface to create on
1973 * Called from fcoe transport.
1975 * Returns: 0 for success
1977 static int fcoe_enable(struct net_device
*netdev
)
1979 struct fcoe_ctlr
*ctlr
;
1980 struct fcoe_interface
*fcoe
;
1983 mutex_lock(&fcoe_config_mutex
);
1985 fcoe
= fcoe_hostlist_lookup_port(netdev
);
1993 ctlr
= fcoe_to_ctlr(fcoe
);
1995 if (!fcoe_link_ok(ctlr
->lp
))
1996 fcoe_ctlr_link_up(ctlr
);
1999 mutex_unlock(&fcoe_config_mutex
);
2004 * fcoe_ctlr_enabled() - Enable or disable an FCoE Controller
2005 * @cdev: The FCoE Controller that is being enabled or disabled
2007 * fcoe_sysfs will ensure that the state of 'enabled' has
2008 * changed, so no checking is necessary here. This routine simply
2009 * calls fcoe_enable or fcoe_disable, both of which are deprecated.
2010 * When those routines are removed the functionality can be merged
2013 static int fcoe_ctlr_enabled(struct fcoe_ctlr_device
*cdev
)
2015 struct fcoe_ctlr
*ctlr
= fcoe_ctlr_device_priv(cdev
);
2016 struct fc_lport
*lport
= ctlr
->lp
;
2017 struct net_device
*netdev
= fcoe_netdev(lport
);
2019 switch (cdev
->enabled
) {
2020 case FCOE_CTLR_ENABLED
:
2021 return fcoe_enable(netdev
);
2022 case FCOE_CTLR_DISABLED
:
2023 return fcoe_disable(netdev
);
2024 case FCOE_CTLR_UNUSED
:
2031 * fcoe_ctlr_mode() - Switch FIP mode
2032 * @cdev: The FCoE Controller that is being modified
2034 * When the FIP mode has been changed we need to update
2035 * the multicast addresses to ensure we get the correct
2038 static void fcoe_ctlr_mode(struct fcoe_ctlr_device
*ctlr_dev
)
2040 struct fcoe_ctlr
*ctlr
= fcoe_ctlr_device_priv(ctlr_dev
);
2041 struct fcoe_interface
*fcoe
= fcoe_ctlr_priv(ctlr
);
2043 if (ctlr_dev
->mode
== FIP_CONN_TYPE_VN2VN
&&
2044 ctlr
->mode
!= FIP_MODE_VN2VN
) {
2045 dev_mc_del(fcoe
->netdev
, FIP_ALL_ENODE_MACS
);
2046 dev_mc_add(fcoe
->netdev
, FIP_ALL_VN2VN_MACS
);
2047 dev_mc_add(fcoe
->netdev
, FIP_ALL_P2P_MACS
);
2048 } else if (ctlr
->mode
!= FIP_MODE_FABRIC
) {
2049 dev_mc_del(fcoe
->netdev
, FIP_ALL_VN2VN_MACS
);
2050 dev_mc_del(fcoe
->netdev
, FIP_ALL_P2P_MACS
);
2051 dev_mc_add(fcoe
->netdev
, FIP_ALL_ENODE_MACS
);
2053 fcoe_ctlr_set_fip_mode(ctlr_dev
);
2057 * fcoe_destroy() - Destroy a FCoE interface
2058 * @netdev : The net_device object the Ethernet interface to create on
2060 * Called from fcoe transport
2062 * Returns: 0 for success
2064 static int fcoe_destroy(struct net_device
*netdev
)
2066 struct fcoe_ctlr
*ctlr
;
2067 struct fcoe_interface
*fcoe
;
2068 struct fc_lport
*lport
;
2069 struct fcoe_port
*port
;
2072 mutex_lock(&fcoe_config_mutex
);
2074 fcoe
= fcoe_hostlist_lookup_port(netdev
);
2079 ctlr
= fcoe_to_ctlr(fcoe
);
2081 port
= lport_priv(lport
);
2082 list_del(&fcoe
->list
);
2083 queue_work(fcoe_wq
, &port
->destroy_work
);
2086 mutex_unlock(&fcoe_config_mutex
);
2091 * fcoe_destroy_work() - Destroy a FCoE port in a deferred work context
2092 * @work: Handle to the FCoE port to be destroyed
2094 static void fcoe_destroy_work(struct work_struct
*work
)
2096 struct fcoe_ctlr_device
*cdev
;
2097 struct fcoe_ctlr
*ctlr
;
2098 struct fcoe_port
*port
;
2099 struct fcoe_interface
*fcoe
;
2101 port
= container_of(work
, struct fcoe_port
, destroy_work
);
2103 fcoe_vport_remove(port
->lport
);
2105 mutex_lock(&fcoe_config_mutex
);
2108 ctlr
= fcoe_to_ctlr(fcoe
);
2109 cdev
= fcoe_ctlr_to_ctlr_dev(ctlr
);
2112 fcoe_if_destroy(port
->lport
);
2114 fcoe_interface_remove(fcoe
);
2116 fcoe_interface_cleanup(fcoe
);
2118 mutex_unlock(&fcoe_config_mutex
);
2120 fcoe_ctlr_device_delete(cdev
);
2124 * fcoe_match() - Check if the FCoE is supported on the given netdevice
2125 * @netdev : The net_device object the Ethernet interface to create on
2127 * Called from fcoe transport.
2129 * Returns: always returns true as this is the default FCoE transport,
2130 * i.e., support all netdevs.
2132 static bool fcoe_match(struct net_device
*netdev
)
2138 * fcoe_dcb_create() - Initialize DCB attributes and hooks
2139 * @netdev: The net_device object of the L2 link that should be queried
2140 * @port: The fcoe_port to bind FCoE APP priority with
2143 static void fcoe_dcb_create(struct fcoe_interface
*fcoe
)
2145 int ctlr_prio
= TC_PRIO_BESTEFFORT
;
2146 int fcoe_prio
= TC_PRIO_INTERACTIVE
;
2147 struct fcoe_ctlr
*ctlr
= fcoe_to_ctlr(fcoe
);
2151 struct net_device
*netdev
= fcoe
->realdev
;
2152 struct dcb_app app
= {
2154 .protocol
= ETH_P_FCOE
2157 /* setup DCB priority attributes. */
2158 if (netdev
&& netdev
->dcbnl_ops
&& netdev
->dcbnl_ops
->getdcbx
) {
2159 dcbx
= netdev
->dcbnl_ops
->getdcbx(netdev
);
2161 if (dcbx
& DCB_CAP_DCBX_VER_IEEE
) {
2162 app
.selector
= IEEE_8021QAZ_APP_SEL_ETHERTYPE
;
2163 up
= dcb_ieee_getapp_mask(netdev
, &app
);
2164 app
.protocol
= ETH_P_FIP
;
2165 fup
= dcb_ieee_getapp_mask(netdev
, &app
);
2167 app
.selector
= DCB_APP_IDTYPE_ETHTYPE
;
2168 up
= dcb_getapp(netdev
, &app
);
2169 app
.protocol
= ETH_P_FIP
;
2170 fup
= dcb_getapp(netdev
, &app
);
2173 fcoe_prio
= ffs(up
) ? ffs(up
) - 1 : 0;
2174 ctlr_prio
= ffs(fup
) ? ffs(fup
) - 1 : fcoe_prio
;
2177 fcoe
->priority
= fcoe_prio
;
2178 ctlr
->priority
= ctlr_prio
;
2181 enum fcoe_create_link_state
{
2182 FCOE_CREATE_LINK_DOWN
,
2183 FCOE_CREATE_LINK_UP
,
2187 * _fcoe_create() - (internal) Create a fcoe interface
2188 * @netdev : The net_device object the Ethernet interface to create on
2189 * @fip_mode: The FIP mode for this creation
2190 * @link_state: The ctlr link state on creation
2192 * Called from either the libfcoe 'create' module parameter
2193 * via fcoe_create or from fcoe_syfs's ctlr_create file.
2195 * libfcoe's 'create' module parameter is deprecated so some
2196 * consolidation of code can be done when that interface is
2199 static int _fcoe_create(struct net_device
*netdev
, enum fip_mode fip_mode
,
2200 enum fcoe_create_link_state link_state
)
2203 struct fcoe_ctlr_device
*ctlr_dev
;
2204 struct fcoe_ctlr
*ctlr
;
2205 struct fcoe_interface
*fcoe
;
2206 struct fc_lport
*lport
;
2208 mutex_lock(&fcoe_config_mutex
);
2211 /* look for existing lport */
2212 if (fcoe_hostlist_lookup(netdev
)) {
2217 fcoe
= fcoe_interface_create(netdev
, fip_mode
);
2223 ctlr
= fcoe_to_ctlr(fcoe
);
2224 ctlr_dev
= fcoe_ctlr_to_ctlr_dev(ctlr
);
2225 lport
= fcoe_if_create(fcoe
, &ctlr_dev
->dev
, 0);
2226 if (IS_ERR(lport
)) {
2227 printk(KERN_ERR
"fcoe: Failed to create interface (%s)\n",
2231 fcoe_interface_remove(fcoe
);
2233 fcoe_interface_cleanup(fcoe
);
2234 mutex_unlock(&fcoe_config_mutex
);
2235 fcoe_ctlr_device_delete(ctlr_dev
);
2239 /* Make this the "master" N_Port */
2242 /* setup DCB priority attributes. */
2243 fcoe_dcb_create(fcoe
);
2245 /* start FIP Discovery and FLOGI */
2246 lport
->boot_time
= jiffies
;
2247 fc_fabric_login(lport
);
2250 * If the fcoe_ctlr_device is to be set to DISABLED
2251 * it must be done after the lport is added to the
2252 * hostlist, but before the rtnl_lock is released.
2253 * This is because the rtnl_lock protects the
2254 * hostlist that fcoe_device_notification uses. If
2255 * the FCoE Controller is intended to be created
2256 * DISABLED then 'enabled' needs to be considered
2257 * handling link events. 'enabled' must be set
2258 * before the lport can be found in the hostlist
2259 * when a link up event is received.
2261 if (link_state
== FCOE_CREATE_LINK_UP
)
2262 ctlr_dev
->enabled
= FCOE_CTLR_ENABLED
;
2264 ctlr_dev
->enabled
= FCOE_CTLR_DISABLED
;
2266 if (link_state
== FCOE_CREATE_LINK_UP
&&
2267 !fcoe_link_ok(lport
)) {
2269 fcoe_ctlr_link_up(ctlr
);
2270 mutex_unlock(&fcoe_config_mutex
);
2276 mutex_unlock(&fcoe_config_mutex
);
2282 * fcoe_create() - Create a fcoe interface
2283 * @netdev : The net_device object the Ethernet interface to create on
2284 * @fip_mode: The FIP mode for this creation
2286 * Called from fcoe transport
2288 * Returns: 0 for success
2290 static int fcoe_create(struct net_device
*netdev
, enum fip_mode fip_mode
)
2292 return _fcoe_create(netdev
, fip_mode
, FCOE_CREATE_LINK_UP
);
2296 * fcoe_ctlr_alloc() - Allocate a fcoe interface from fcoe_sysfs
2297 * @netdev: The net_device to be used by the allocated FCoE Controller
2299 * This routine is called from fcoe_sysfs. It will start the fcoe_ctlr
2300 * in a link_down state. The allows the user an opportunity to configure
2301 * the FCoE Controller from sysfs before enabling the FCoE Controller.
2303 * Creating in with this routine starts the FCoE Controller in Fabric
2304 * mode. The user can change to VN2VN or another mode before enabling.
2306 static int fcoe_ctlr_alloc(struct net_device
*netdev
)
2308 return _fcoe_create(netdev
, FIP_MODE_FABRIC
,
2309 FCOE_CREATE_LINK_DOWN
);
2313 * fcoe_link_ok() - Check if the link is OK for a local port
2314 * @lport: The local port to check link on
2316 * Returns: 0 if link is UP and OK, -1 if not
2319 static int fcoe_link_ok(struct fc_lport
*lport
)
2321 struct net_device
*netdev
= fcoe_netdev(lport
);
2323 if (netif_oper_up(netdev
))
2329 * fcoe_percpu_clean() - Clear all pending skbs for an local port
2330 * @lport: The local port whose skbs are to be cleared
2332 * Must be called with fcoe_create_mutex held to single-thread completion.
2334 * This flushes the pending skbs by flush the work item for each CPU. The work
2335 * item on each possible CPU is flushed because we may have used the per-CPU
2336 * struct of an offline CPU.
2338 static void fcoe_percpu_clean(struct fc_lport
*lport
)
2340 struct fcoe_percpu_s
*pp
;
2343 for_each_possible_cpu(cpu
) {
2344 pp
= &per_cpu(fcoe_percpu
, cpu
);
2346 flush_work(&pp
->work
);
2351 * fcoe_reset() - Reset a local port
2352 * @shost: The SCSI host associated with the local port to be reset
2354 * Returns: Always 0 (return value required by FC transport template)
2356 static int fcoe_reset(struct Scsi_Host
*shost
)
2358 struct fc_lport
*lport
= shost_priv(shost
);
2359 struct fcoe_port
*port
= lport_priv(lport
);
2360 struct fcoe_interface
*fcoe
= port
->priv
;
2361 struct fcoe_ctlr
*ctlr
= fcoe_to_ctlr(fcoe
);
2362 struct fcoe_ctlr_device
*cdev
= fcoe_ctlr_to_ctlr_dev(ctlr
);
2364 fcoe_ctlr_link_down(ctlr
);
2365 fcoe_clean_pending_queue(ctlr
->lp
);
2367 if (cdev
->enabled
!= FCOE_CTLR_DISABLED
&&
2368 !fcoe_link_ok(ctlr
->lp
))
2369 fcoe_ctlr_link_up(ctlr
);
2374 * fcoe_hostlist_lookup_port() - Find the FCoE interface associated with a net device
2375 * @netdev: The net device used as a key
2377 * Locking: Must be called with the RNL mutex held.
2379 * Returns: NULL or the FCoE interface
2381 static struct fcoe_interface
*
2382 fcoe_hostlist_lookup_port(const struct net_device
*netdev
)
2384 struct fcoe_interface
*fcoe
;
2386 list_for_each_entry(fcoe
, &fcoe_hostlist
, list
) {
2387 if (fcoe
->netdev
== netdev
)
2394 * fcoe_hostlist_lookup() - Find the local port associated with a
2396 * @netdev: The netdevice used as a key
2398 * Locking: Must be called with the RTNL mutex held
2400 * Returns: NULL or the local port
2402 static struct fc_lport
*fcoe_hostlist_lookup(const struct net_device
*netdev
)
2404 struct fcoe_ctlr
*ctlr
;
2405 struct fcoe_interface
*fcoe
;
2407 fcoe
= fcoe_hostlist_lookup_port(netdev
);
2408 ctlr
= fcoe_to_ctlr(fcoe
);
2409 return (fcoe
) ? ctlr
->lp
: NULL
;
2413 * fcoe_hostlist_add() - Add the FCoE interface identified by a local
2414 * port to the hostlist
2415 * @lport: The local port that identifies the FCoE interface to be added
2417 * Locking: must be called with the RTNL mutex held
2419 * Returns: 0 for success
2421 static int fcoe_hostlist_add(const struct fc_lport
*lport
)
2423 struct fcoe_interface
*fcoe
;
2424 struct fcoe_port
*port
;
2426 fcoe
= fcoe_hostlist_lookup_port(fcoe_netdev(lport
));
2428 port
= lport_priv(lport
);
2430 list_add_tail(&fcoe
->list
, &fcoe_hostlist
);
2436 * fcoe_hostlist_del() - Remove the FCoE interface identified by a local
2437 * port to the hostlist
2438 * @lport: The local port that identifies the FCoE interface to be added
2440 * Locking: must be called with the RTNL mutex held
2443 static void fcoe_hostlist_del(const struct fc_lport
*lport
)
2445 struct fcoe_interface
*fcoe
;
2446 struct fcoe_port
*port
;
2448 port
= lport_priv(lport
);
2450 list_del(&fcoe
->list
);
2454 static struct fcoe_transport fcoe_sw_transport
= {
2455 .name
= {FCOE_TRANSPORT_DEFAULT
},
2457 .list
= LIST_HEAD_INIT(fcoe_sw_transport
.list
),
2458 .match
= fcoe_match
,
2459 .alloc
= fcoe_ctlr_alloc
,
2460 .create
= fcoe_create
,
2461 .destroy
= fcoe_destroy
,
2462 .enable
= fcoe_enable
,
2463 .disable
= fcoe_disable
,
2467 * fcoe_init() - Initialize fcoe.ko
2469 * Returns: 0 on success, or a negative value on failure
2471 static int __init
fcoe_init(void)
2473 struct fcoe_percpu_s
*p
;
2477 fcoe_wq
= alloc_workqueue("fcoe", 0, 0);
2481 /* register as a fcoe transport */
2482 rc
= fcoe_transport_attach(&fcoe_sw_transport
);
2484 printk(KERN_ERR
"failed to register an fcoe transport, check "
2485 "if libfcoe is loaded\n");
2489 mutex_lock(&fcoe_config_mutex
);
2491 for_each_possible_cpu(cpu
) {
2492 p
= per_cpu_ptr(&fcoe_percpu
, cpu
);
2493 INIT_WORK(&p
->work
, fcoe_receive_work
);
2494 skb_queue_head_init(&p
->fcoe_rx_list
);
2497 /* Setup link change notification */
2500 rc
= fcoe_if_init();
2504 mutex_unlock(&fcoe_config_mutex
);
2508 mutex_unlock(&fcoe_config_mutex
);
2510 destroy_workqueue(fcoe_wq
);
2513 module_init(fcoe_init
);
2516 * fcoe_exit() - Clean up fcoe.ko
2518 * Returns: 0 on success or a negative value on failure
2520 static void __exit
fcoe_exit(void)
2522 struct fcoe_interface
*fcoe
, *tmp
;
2523 struct fcoe_ctlr
*ctlr
;
2524 struct fcoe_port
*port
;
2527 mutex_lock(&fcoe_config_mutex
);
2531 /* releases the associated fcoe hosts */
2533 list_for_each_entry_safe(fcoe
, tmp
, &fcoe_hostlist
, list
) {
2534 ctlr
= fcoe_to_ctlr(fcoe
);
2535 port
= lport_priv(ctlr
->lp
);
2536 fcoe_hostlist_del(port
->lport
);
2537 queue_work(fcoe_wq
, &port
->destroy_work
);
2541 for_each_possible_cpu(cpu
)
2542 fcoe_thread_cleanup_local(cpu
);
2544 mutex_unlock(&fcoe_config_mutex
);
2547 * destroy_work's may be chained but destroy_workqueue()
2548 * can take care of them. Just kill the fcoe_wq.
2550 destroy_workqueue(fcoe_wq
);
2553 * Detaching from the scsi transport must happen after all
2554 * destroys are done on the fcoe_wq. destroy_workqueue will
2555 * enusre the fcoe_wq is flushed.
2559 /* detach from fcoe transport */
2560 fcoe_transport_detach(&fcoe_sw_transport
);
2562 module_exit(fcoe_exit
);
2565 * fcoe_flogi_resp() - FCoE specific FLOGI and FDISC response handler
2566 * @seq: active sequence in the FLOGI or FDISC exchange
2567 * @fp: response frame, or error encoded in a pointer (timeout)
2568 * @arg: pointer to the fcoe_ctlr structure
2570 * This handles MAC address management for FCoE, then passes control on to
2571 * the libfc FLOGI response handler.
2573 static void fcoe_flogi_resp(struct fc_seq
*seq
, struct fc_frame
*fp
, void *arg
)
2575 struct fcoe_ctlr
*fip
= arg
;
2576 struct fc_exch
*exch
= fc_seq_exch(seq
);
2577 struct fc_lport
*lport
= exch
->lp
;
2583 mac
= fr_cb(fp
)->granted_mac
;
2585 if (is_zero_ether_addr(mac
))
2586 fcoe_ctlr_recv_flogi(fip
, lport
, fp
);
2587 if (!is_zero_ether_addr(mac
))
2588 fcoe_update_src_mac(lport
, mac
);
2590 fc_lport_flogi_resp(seq
, fp
, lport
);
2594 * fcoe_logo_resp() - FCoE specific LOGO response handler
2595 * @seq: active sequence in the LOGO exchange
2596 * @fp: response frame, or error encoded in a pointer (timeout)
2597 * @arg: pointer to the fcoe_ctlr structure
2599 * This handles MAC address management for FCoE, then passes control on to
2600 * the libfc LOGO response handler.
2602 static void fcoe_logo_resp(struct fc_seq
*seq
, struct fc_frame
*fp
, void *arg
)
2604 struct fc_lport
*lport
= arg
;
2605 static u8 zero_mac
[ETH_ALEN
] = { 0 };
2608 fcoe_update_src_mac(lport
, zero_mac
);
2609 fc_lport_logo_resp(seq
, fp
, lport
);
2613 * fcoe_elsct_send - FCoE specific ELS handler
2615 * This does special case handling of FIP encapsualted ELS exchanges for FCoE,
2616 * using FCoE specific response handlers and passing the FIP controller as
2617 * the argument (the lport is still available from the exchange).
2619 * Most of the work here is just handed off to the libfc routine.
2621 static struct fc_seq
*fcoe_elsct_send(struct fc_lport
*lport
, u32 did
,
2622 struct fc_frame
*fp
, unsigned int op
,
2623 void (*resp
)(struct fc_seq
*,
2626 void *arg
, u32 timeout
)
2628 struct fcoe_port
*port
= lport_priv(lport
);
2629 struct fcoe_interface
*fcoe
= port
->priv
;
2630 struct fcoe_ctlr
*fip
= fcoe_to_ctlr(fcoe
);
2631 struct fc_frame_header
*fh
= fc_frame_header_get(fp
);
2636 if (lport
->point_to_multipoint
)
2638 return fc_elsct_send(lport
, did
, fp
, op
, fcoe_flogi_resp
,
2641 /* only hook onto fabric logouts, not port logouts */
2642 if (ntoh24(fh
->fh_d_id
) != FC_FID_FLOGI
)
2644 return fc_elsct_send(lport
, did
, fp
, op
, fcoe_logo_resp
,
2647 return fc_elsct_send(lport
, did
, fp
, op
, resp
, arg
, timeout
);
2651 * fcoe_vport_create() - create an fc_host/scsi_host for a vport
2652 * @vport: fc_vport object to create a new fc_host for
2653 * @disabled: start the new fc_host in a disabled state by default?
2655 * Returns: 0 for success
2657 static int fcoe_vport_create(struct fc_vport
*vport
, bool disabled
)
2659 struct Scsi_Host
*shost
= vport_to_shost(vport
);
2660 struct fc_lport
*n_port
= shost_priv(shost
);
2661 struct fcoe_port
*port
= lport_priv(n_port
);
2662 struct fcoe_interface
*fcoe
= port
->priv
;
2663 struct net_device
*netdev
= fcoe
->netdev
;
2664 struct fc_lport
*vn_port
;
2668 rc
= fcoe_validate_vport_create(vport
);
2670 fcoe_wwn_to_str(vport
->port_name
, buf
, sizeof(buf
));
2671 printk(KERN_ERR
"fcoe: Failed to create vport, "
2672 "WWPN (0x%s) already exists\n",
2677 mutex_lock(&fcoe_config_mutex
);
2679 vn_port
= fcoe_if_create(fcoe
, &vport
->dev
, 1);
2681 mutex_unlock(&fcoe_config_mutex
);
2683 if (IS_ERR(vn_port
)) {
2684 printk(KERN_ERR
"fcoe: fcoe_vport_create(%s) failed\n",
2690 fc_vport_set_state(vport
, FC_VPORT_DISABLED
);
2692 vn_port
->boot_time
= jiffies
;
2693 fc_fabric_login(vn_port
);
2694 fc_vport_setlink(vn_port
);
2700 * fcoe_vport_destroy() - destroy the fc_host/scsi_host for a vport
2701 * @vport: fc_vport object that is being destroyed
2703 * Returns: 0 for success
2705 static int fcoe_vport_destroy(struct fc_vport
*vport
)
2707 struct Scsi_Host
*shost
= vport_to_shost(vport
);
2708 struct fc_lport
*n_port
= shost_priv(shost
);
2709 struct fc_lport
*vn_port
= vport
->dd_data
;
2711 mutex_lock(&n_port
->lp_mutex
);
2712 list_del(&vn_port
->list
);
2713 mutex_unlock(&n_port
->lp_mutex
);
2715 mutex_lock(&fcoe_config_mutex
);
2717 fcoe_if_destroy(vn_port
);
2719 mutex_unlock(&fcoe_config_mutex
);
2725 * fcoe_vport_remove() - remove attached vports
2726 * @lport: lport for which the vports should be removed
2728 static void fcoe_vport_remove(struct fc_lport
*lport
)
2730 struct Scsi_Host
*shost
;
2731 struct fc_host_attrs
*fc_host
;
2732 unsigned long flags
;
2733 struct fc_vport
*vport
;
2734 struct fc_vport
*next_vport
;
2736 shost
= lport
->host
;
2737 fc_host
= shost_to_fc_host(shost
);
2739 /* Loop through all the vports and mark them for deletion */
2740 spin_lock_irqsave(shost
->host_lock
, flags
);
2741 list_for_each_entry_safe(vport
, next_vport
, &fc_host
->vports
, peers
) {
2742 if (vport
->flags
& (FC_VPORT_DEL
| FC_VPORT_CREATING
)) {
2745 vport
->flags
|= FC_VPORT_DELETING
;
2746 queue_work(fc_host_work_q(shost
),
2747 &vport
->vport_delete_work
);
2750 spin_unlock_irqrestore(shost
->host_lock
, flags
);
2752 flush_workqueue(fc_host_work_q(shost
));
2756 * fcoe_vport_disable() - change vport state
2757 * @vport: vport to bring online/offline
2758 * @disable: should the vport be disabled?
2760 static int fcoe_vport_disable(struct fc_vport
*vport
, bool disable
)
2762 struct fc_lport
*lport
= vport
->dd_data
;
2765 fc_vport_set_state(vport
, FC_VPORT_DISABLED
);
2766 fc_fabric_logoff(lport
);
2768 lport
->boot_time
= jiffies
;
2769 fc_fabric_login(lport
);
2770 fc_vport_setlink(lport
);
2777 * fcoe_vport_set_symbolic_name() - append vport string to symbolic name
2778 * @vport: fc_vport with a new symbolic name string
2780 * After generating a new symbolic name string, a new RSPN_ID request is
2781 * sent to the name server. There is no response handler, so if it fails
2782 * for some reason it will not be retried.
2784 static void fcoe_set_vport_symbolic_name(struct fc_vport
*vport
)
2786 struct fc_lport
*lport
= vport
->dd_data
;
2787 struct fc_frame
*fp
;
2790 snprintf(fc_host_symbolic_name(lport
->host
), FC_SYMBOLIC_NAME_SIZE
,
2791 "%s v%s over %s : %s", FCOE_NAME
, FCOE_VERSION
,
2792 fcoe_netdev(lport
)->name
, vport
->symbolic_name
);
2794 if (lport
->state
!= LPORT_ST_READY
)
2797 len
= strnlen(fc_host_symbolic_name(lport
->host
), 255);
2798 fp
= fc_frame_alloc(lport
,
2799 sizeof(struct fc_ct_hdr
) +
2800 sizeof(struct fc_ns_rspn
) + len
);
2803 lport
->tt
.elsct_send(lport
, FC_FID_DIR_SERV
, fp
, FC_NS_RSPN_ID
,
2804 NULL
, NULL
, 3 * lport
->r_a_tov
);
2807 static void fcoe_fcf_get_vlan_id(struct fcoe_fcf_device
*fcf_dev
)
2809 struct fcoe_ctlr_device
*ctlr_dev
=
2810 fcoe_fcf_dev_to_ctlr_dev(fcf_dev
);
2811 struct fcoe_ctlr
*ctlr
= fcoe_ctlr_device_priv(ctlr_dev
);
2812 struct fcoe_interface
*fcoe
= fcoe_ctlr_priv(ctlr
);
2814 fcf_dev
->vlan_id
= vlan_dev_vlan_id(fcoe
->netdev
);
2818 * fcoe_set_port_id() - Callback from libfc when Port_ID is set.
2819 * @lport: the local port
2820 * @port_id: the port ID
2821 * @fp: the received frame, if any, that caused the port_id to be set.
2823 * This routine handles the case where we received a FLOGI and are
2824 * entering point-to-point mode. We need to call fcoe_ctlr_recv_flogi()
2825 * so it can set the non-mapped mode and gateway address.
2827 * The FLOGI LS_ACC is handled by fcoe_flogi_resp().
2829 static void fcoe_set_port_id(struct fc_lport
*lport
,
2830 u32 port_id
, struct fc_frame
*fp
)
2832 struct fcoe_port
*port
= lport_priv(lport
);
2833 struct fcoe_interface
*fcoe
= port
->priv
;
2834 struct fcoe_ctlr
*ctlr
= fcoe_to_ctlr(fcoe
);
2836 if (fp
&& fc_frame_payload_op(fp
) == ELS_FLOGI
)
2837 fcoe_ctlr_recv_flogi(ctlr
, lport
, fp
);