Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 5fbe25c7 authored by Jing Huang's avatar Jing Huang Committed by James Bottomley
Browse files

[SCSI] bfa: fix comments for c files



This patch addresses the comments from Randy Dunlap (Randy.Dunlap@oracle.com)
regarding comment blocks that begining with "/**". bfa driver comments
currently do not follow kernel-doc convention, we hence replace all
/** with /* and **/ with */.

Signed-off-by: default avatarJing Huang <huangj@brocade.com>
Signed-off-by: default avatarJames Bottomley <James.Bottomley@suse.de>
parent acdc79a6
Loading
Loading
Loading
Loading
+56 −56
Original line number Diff line number Diff line
@@ -21,11 +21,11 @@

BFA_TRC_FILE(HAL, CORE);

/**
/*
 * BFA IOC FC related definitions
 */

/**
/*
 * IOC local definitions
 */
#define BFA_IOCFC_TOV		5000	/* msecs */
@@ -54,7 +54,7 @@ enum {
#define DEF_CFG_NUM_SBOOT_TGTS		16
#define DEF_CFG_NUM_SBOOT_LUNS		16

/**
/*
 * forward declaration for IOC FC functions
 */
static void bfa_iocfc_enable_cbfn(void *bfa_arg, enum bfa_status status);
@@ -63,7 +63,7 @@ static void bfa_iocfc_hbfail_cbfn(void *bfa_arg);
static void bfa_iocfc_reset_cbfn(void *bfa_arg);
static struct bfa_ioc_cbfn_s bfa_iocfc_cbfn;

/**
/*
 * BFA Interrupt handling functions
 */
static void
@@ -86,7 +86,7 @@ bfa_reqq_resume(struct bfa_s *bfa, int qid)

	waitq = bfa_reqq(bfa, qid);
	list_for_each_safe(qe, qen, waitq) {
		/**
		/*
		 * Callback only as long as there is room in request queue
		 */
		if (bfa_reqq_full(bfa, qid))
@@ -104,7 +104,7 @@ bfa_msix_all(struct bfa_s *bfa, int vec)
	bfa_intx(bfa);
}

/**
/*
 *  hal_intr_api
 */
bfa_boolean_t
@@ -117,7 +117,7 @@ bfa_intx(struct bfa_s *bfa)
	if (!intr)
		return BFA_FALSE;

	/**
	/*
	 * RME completion queue interrupt
	 */
	qintr = intr & __HFN_INT_RME_MASK;
@@ -131,7 +131,7 @@ bfa_intx(struct bfa_s *bfa)
	if (!intr)
		return BFA_TRUE;

	/**
	/*
	 * CPE completion queue interrupt
	 */
	qintr = intr & __HFN_INT_CPE_MASK;
@@ -211,7 +211,7 @@ bfa_msix_reqq(struct bfa_s *bfa, int qid)

	bfa->iocfc.hwif.hw_reqq_ack(bfa, qid);

	/**
	/*
	 * Resume any pending requests in the corresponding reqq.
	 */
	waitq = bfa_reqq(bfa, qid);
@@ -259,14 +259,14 @@ bfa_msix_rspq(struct bfa_s *bfa, int qid)
		}
	}

	/**
	/*
	 * update CI
	 */
	bfa_rspq_ci(bfa, qid) = pi;
	writel(pi, bfa->iocfc.bfa_regs.rme_q_ci[qid]);
	mmiowb();

	/**
	/*
	 * Resume any pending requests in the corresponding reqq.
	 */
	waitq = bfa_reqq(bfa, qid);
@@ -289,7 +289,7 @@ bfa_msix_lpu_err(struct bfa_s *bfa, int vec)

	if (intr) {
		if (intr & __HFN_INT_LL_HALT) {
			/**
			/*
			 * If LL_HALT bit is set then FW Init Halt LL Port
			 * Register needs to be cleared as well so Interrupt
			 * Status Register will be cleared.
@@ -300,7 +300,7 @@ bfa_msix_lpu_err(struct bfa_s *bfa, int vec)
		}

		if (intr & __HFN_INT_ERR_PSS) {
			/**
			/*
			 * ERR_PSS bit needs to be cleared as well in case
			 * interrups are shared so driver's interrupt handler is
			 * still called eventhough it is already masked out.
@@ -323,11 +323,11 @@ bfa_isr_bind(enum bfi_mclass mc, bfa_isr_func_t isr_func)
	bfa_isrs[mc] = isr_func;
}

/**
/*
 * BFA IOC FC related functions
 */

/**
/*
 *  hal_ioc_pvt BFA IOC private functions
 */

@@ -366,7 +366,7 @@ bfa_iocfc_fw_cfg_sz(struct bfa_iocfc_cfg_s *cfg, u32 *dm_len)
			    BFA_CACHELINE_SZ);
}

/**
/*
 * Use the Mailbox interface to send BFI_IOCFC_H2I_CFG_REQ
 */
static void
@@ -384,14 +384,14 @@ bfa_iocfc_send_cfg(void *bfa_arg)

	bfa_iocfc_reset_queues(bfa);

	/**
	/*
	 * initialize IOC configuration info
	 */
	cfg_info->endian_sig = BFI_IOC_ENDIAN_SIG;
	cfg_info->num_cqs = cfg->fwcfg.num_cqs;

	bfa_dma_be_addr_set(cfg_info->cfgrsp_addr, iocfc->cfgrsp_dma.pa);
	/**
	/*
	 * dma map REQ and RSP circular queues and shadow pointers
	 */
	for (i = 0; i < cfg->fwcfg.num_cqs; i++) {
@@ -410,7 +410,7 @@ bfa_iocfc_send_cfg(void *bfa_arg)
			cpu_to_be16(cfg->drvcfg.num_rspq_elems);
	}

	/**
	/*
	 * Enable interrupt coalescing if it is driver init path
	 * and not ioc disable/enable path.
	 */
@@ -419,7 +419,7 @@ bfa_iocfc_send_cfg(void *bfa_arg)

	iocfc->cfgdone = BFA_FALSE;

	/**
	/*
	 * dma map IOC configuration itself
	 */
	bfi_h2i_set(cfg_req.mh, BFI_MC_IOCFC, BFI_IOCFC_H2I_CFG_REQ,
@@ -442,7 +442,7 @@ bfa_iocfc_init_mem(struct bfa_s *bfa, void *bfad, struct bfa_iocfc_cfg_s *cfg,

	iocfc->cfg = *cfg;

	/**
	/*
	 * Initialize chip specific handlers.
	 */
	if (bfa_asic_id_ct(bfa_ioc_devid(&bfa->ioc))) {
@@ -559,7 +559,7 @@ bfa_iocfc_mem_claim(struct bfa_s *bfa, struct bfa_iocfc_cfg_s *cfg,
	}
}

/**
/*
 * Start BFA submodules.
 */
static void
@@ -573,7 +573,7 @@ bfa_iocfc_start_submod(struct bfa_s *bfa)
		hal_mods[i]->start(bfa);
}

/**
/*
 * Disable BFA submodules.
 */
static void
@@ -623,7 +623,7 @@ bfa_iocfc_disable_cb(void *bfa_arg, bfa_boolean_t compl)
		complete(&bfad->disable_comp);
}

/**
/*
 * Update BFA configuration from firmware configuration.
 */
static void
@@ -642,7 +642,7 @@ bfa_iocfc_cfgrsp(struct bfa_s *bfa)

	iocfc->cfgdone = BFA_TRUE;

	/**
	/*
	 * Configuration is complete - initialize/start submodules
	 */
	bfa_fcport_init(bfa);
@@ -665,7 +665,7 @@ bfa_iocfc_reset_queues(struct bfa_s *bfa)
	}
}

/**
/*
 * IOC enable request is complete
 */
static void
@@ -684,7 +684,7 @@ bfa_iocfc_enable_cbfn(void *bfa_arg, enum bfa_status status)
	bfa_iocfc_send_cfg(bfa);
}

/**
/*
 * IOC disable request is complete
 */
static void
@@ -705,7 +705,7 @@ bfa_iocfc_disable_cbfn(void *bfa_arg)
	}
}

/**
/*
 * Notify sub-modules of hardware failure.
 */
static void
@@ -723,7 +723,7 @@ bfa_iocfc_hbfail_cbfn(void *bfa_arg)
			     bfa);
}

/**
/*
 * Actions on chip-reset completion.
 */
static void
@@ -735,11 +735,11 @@ bfa_iocfc_reset_cbfn(void *bfa_arg)
	bfa_isr_enable(bfa);
}

/**
/*
 *  hal_ioc_public
 */

/**
/*
 * Query IOC memory requirement information.
 */
void
@@ -754,7 +754,7 @@ bfa_iocfc_meminfo(struct bfa_iocfc_cfg_s *cfg, u32 *km_len,
	*km_len += bfa_ioc_debug_trcsz(bfa_auto_recover);
}

/**
/*
 * Query IOC memory requirement information.
 */
void
@@ -772,7 +772,7 @@ bfa_iocfc_attach(struct bfa_s *bfa, void *bfad, struct bfa_iocfc_cfg_s *cfg,
	ioc->trcmod = bfa->trcmod;
	bfa_ioc_attach(&bfa->ioc, bfa, &bfa_iocfc_cbfn, &bfa->timer_mod);

	/**
	/*
	 * Set FC mode for BFA_PCI_DEVICE_ID_CT_FC.
	 */
	if (pcidev->device_id == BFA_PCI_DEVICE_ID_CT_FC)
@@ -790,7 +790,7 @@ bfa_iocfc_attach(struct bfa_s *bfa, void *bfad, struct bfa_iocfc_cfg_s *cfg,
		INIT_LIST_HEAD(&bfa->reqq_waitq[i]);
}

/**
/*
 * Query IOC memory requirement information.
 */
void
@@ -799,7 +799,7 @@ bfa_iocfc_detach(struct bfa_s *bfa)
	bfa_ioc_detach(&bfa->ioc);
}

/**
/*
 * Query IOC memory requirement information.
 */
void
@@ -809,7 +809,7 @@ bfa_iocfc_init(struct bfa_s *bfa)
	bfa_ioc_enable(&bfa->ioc);
}

/**
/*
 * IOC start called from bfa_start(). Called to start IOC operations
 * at driver instantiation for this instance.
 */
@@ -820,7 +820,7 @@ bfa_iocfc_start(struct bfa_s *bfa)
		bfa_iocfc_start_submod(bfa);
}

/**
/*
 * IOC stop called from bfa_stop(). Called only when driver is unloaded
 * for this instance.
 */
@@ -924,7 +924,7 @@ bfa_iocfc_set_snsbase(struct bfa_s *bfa, u64 snsbase_pa)
	iocfc->cfginfo->sense_buf_len = (BFI_IOIM_SNSLEN - 1);
	bfa_dma_be_addr_set(iocfc->cfginfo->ioim_snsbase, snsbase_pa);
}
/**
/*
 * Enable IOC after it is disabled.
 */
void
@@ -953,7 +953,7 @@ bfa_iocfc_is_operational(struct bfa_s *bfa)
	return bfa_ioc_is_operational(&bfa->ioc) && bfa->iocfc.cfgdone;
}

/**
/*
 * Return boot target port wwns -- read from boot information in flash.
 */
void
@@ -998,11 +998,11 @@ bfa_iocfc_get_pbc_vports(struct bfa_s *bfa, struct bfi_pbc_vport_s *pbc_vport)
	return cfgrsp->pbc_cfg.nvports;
}

/**
/*
 *  hal_api
 */

/**
/*
 * Use this function query the memory requirement of the BFA library.
 * This function needs to be called before bfa_attach() to get the
 * memory required of the BFA layer for a given driver configuration.
@@ -1055,7 +1055,7 @@ bfa_cfg_get_meminfo(struct bfa_iocfc_cfg_s *cfg, struct bfa_meminfo_s *meminfo)
	meminfo->meminfo[BFA_MEM_TYPE_DMA - 1].mem_len = dm_len;
}

/**
/*
 * Use this function to do attach the driver instance with the BFA
 * library. This function will not trigger any HW initialization
 * process (which will be done in bfa_init() call)
@@ -1092,7 +1092,7 @@ bfa_attach(struct bfa_s *bfa, void *bfad, struct bfa_iocfc_cfg_s *cfg,

	bfa_assert((cfg != NULL) && (meminfo != NULL));

	/**
	/*
	 * initialize all memory pointers for iterative allocation
	 */
	for (i = 0; i < BFA_MEM_TYPE_MAX; i++) {
@@ -1109,7 +1109,7 @@ bfa_attach(struct bfa_s *bfa, void *bfad, struct bfa_iocfc_cfg_s *cfg,
	bfa_com_port_attach(bfa, meminfo);
}

/**
/*
 * Use this function to delete a BFA IOC. IOC should be stopped (by
 * calling bfa_stop()) before this function call.
 *
@@ -1146,7 +1146,7 @@ bfa_init_plog(struct bfa_s *bfa, struct bfa_plog_s *plog)
	bfa->plog = plog;
}

/**
/*
 * Initialize IOC.
 *
 * This function will return immediately, when the IOC initialization is
@@ -1169,7 +1169,7 @@ bfa_init(struct bfa_s *bfa)
	bfa_iocfc_init(bfa);
}

/**
/*
 * Use this function initiate the IOC configuration setup. This function
 * will return immediately.
 *
@@ -1183,7 +1183,7 @@ bfa_start(struct bfa_s *bfa)
	bfa_iocfc_start(bfa);
}

/**
/*
 * Use this function quiese the IOC. This function will return immediately,
 * when the IOC is actually stopped, the bfad->comp will be set.
 *
@@ -1243,7 +1243,7 @@ bfa_attach_fcs(struct bfa_s *bfa)
	bfa->fcs = BFA_TRUE;
}

/**
/*
 * Periodic timer heart beat from driver
 */
void
@@ -1252,7 +1252,7 @@ bfa_timer_tick(struct bfa_s *bfa)
	bfa_timer_beat(&bfa->timer_mod);
}

/**
/*
 * Return the list of PCI vendor/device id lists supported by this
 * BFA instance.
 */
@@ -1270,7 +1270,7 @@ bfa_get_pciids(struct bfa_pciid_s **pciids, int *npciids)
	*pciids = __pciids;
}

/**
/*
 * Use this function query the default struct bfa_iocfc_cfg_s value (compiled
 * into BFA layer). The OS driver can then turn back and overwrite entries that
 * have been configured by the user.
@@ -1328,7 +1328,7 @@ bfa_get_attr(struct bfa_s *bfa, struct bfa_ioc_attr_s *ioc_attr)
	bfa_ioc_get_attr(&bfa->ioc, ioc_attr);
}

/**
/*
 * Retrieve firmware trace information on IOC failure.
 */
bfa_status_t
@@ -1337,7 +1337,7 @@ bfa_debug_fwsave(struct bfa_s *bfa, void *trcdata, int *trclen)
	return bfa_ioc_debug_fwsave(&bfa->ioc, trcdata, trclen);
}

/**
/*
 * Clear the saved firmware trace information of an IOC.
 */
void
@@ -1346,7 +1346,7 @@ bfa_debug_fwsave_clear(struct bfa_s *bfa)
	bfa_ioc_debug_fwsave_clear(&bfa->ioc);
}

/**
/*
 * Fetch firmware trace data.
 *
 * @param[in]		bfa			BFA instance
@@ -1362,7 +1362,7 @@ bfa_debug_fwtrc(struct bfa_s *bfa, void *trcdata, int *trclen)
	return bfa_ioc_debug_fwtrc(&bfa->ioc, trcdata, trclen);
}

/**
/*
 * Dump firmware memory.
 *
 * @param[in]		bfa		BFA instance
@@ -1378,7 +1378,7 @@ bfa_debug_fwcore(struct bfa_s *bfa, void *buf, u32 *offset, int *buflen)
{
	return bfa_ioc_debug_fwcore(&bfa->ioc, buf, offset, buflen);
}
/**
/*
 * Reset hw semaphore & usage cnt regs and initialize.
 */
void
@@ -1388,7 +1388,7 @@ bfa_chip_reset(struct bfa_s *bfa)
	bfa_ioc_pll_init(&bfa->ioc);
}

/**
/*
 * Fetch firmware statistics data.
 *
 * @param[in]		bfa		BFA instance
+3 −3
Original line number Diff line number Diff line
@@ -17,7 +17,7 @@

#include "bfa_modules.h"

/**
/*
 * BFA module list terminated by NULL
 */
struct bfa_module_s *hal_mods[] = {
@@ -31,7 +31,7 @@ struct bfa_module_s *hal_mods[] = {
	NULL
};

/**
/*
 * Message handlers for various modules.
 */
bfa_isr_func_t  bfa_isrs[BFI_MC_MAX] = {
@@ -70,7 +70,7 @@ bfa_isr_func_t bfa_isrs[BFI_MC_MAX] = {
};


/**
/*
 * Message handlers for mailbox command classes
 */
bfa_ioc_mbox_mcfunc_t  bfa_mbox_isrs[BFI_MC_MAX] = {
+1 −1
Original line number Diff line number Diff line
@@ -150,7 +150,7 @@ fc_gs_fchdr_build(struct fchs_s *fchs, u32 d_id, u32 s_id, u32 ox_id)
	fchs->s_id = (s_id);
	fchs->ox_id = cpu_to_be16(ox_id);

	/**
	/*
	 * @todo no need to set ox_id for request
	 *       no need to set rx_id for response
	 */
+150 −150

File changed.

Preview size limit exceeded, changes collapsed.

+67 −67
Original line number Diff line number Diff line
@@ -15,7 +15,7 @@
 * General Public License for more details.
 */

/**
/*
 *  bfa_fcs.c BFA FCS main
 */

@@ -25,7 +25,7 @@

BFA_TRC_FILE(FCS, FCS);

/**
/*
 * FCS sub-modules
 */
struct bfa_fcs_mod_s {
@@ -43,7 +43,7 @@ static struct bfa_fcs_mod_s fcs_modules[] = {
	  bfa_fcs_fabric_modexit },
};

/**
/*
 *  fcs_api BFA FCS API
 */

@@ -58,11 +58,11 @@ bfa_fcs_exit_comp(void *fcs_cbarg)



/**
/*
 *  fcs_api BFA FCS API
 */

/**
/*
 * fcs attach -- called once to initialize data structures at driver attach time
 */
void
@@ -86,7 +86,7 @@ bfa_fcs_attach(struct bfa_fcs_s *fcs, struct bfa_s *bfa, struct bfad_s *bfad,
	}
}

/**
/*
 * fcs initialization, called once after bfa initialization is complete
 */
void
@@ -110,7 +110,7 @@ bfa_fcs_init(struct bfa_fcs_s *fcs)
	}
}

/**
/*
 * Start FCS operations.
 */
void
@@ -119,7 +119,7 @@ bfa_fcs_start(struct bfa_fcs_s *fcs)
	bfa_fcs_fabric_modstart(fcs);
}

/**
/*
 *	brief
 *		FCS driver details initialization.
 *
@@ -138,7 +138,7 @@ bfa_fcs_driver_info_init(struct bfa_fcs_s *fcs,
	bfa_fcs_fabric_psymb_init(&fcs->fabric);
}

/**
/*
 *	brief
 *		FCS FDMI Driver Parameter Initialization
 *
@@ -154,7 +154,7 @@ bfa_fcs_set_fdmi_param(struct bfa_fcs_s *fcs, bfa_boolean_t fdmi_enable)
	fcs->fdmi_enabled = fdmi_enable;

}
/**
/*
 *	brief
 *		FCS instance cleanup and exit.
 *
@@ -196,7 +196,7 @@ bfa_fcs_modexit_comp(struct bfa_fcs_s *fcs)
	bfa_wc_down(&fcs->wc);
}

/**
/*
 * Fabric module implementation.
 */

@@ -232,11 +232,11 @@ static void bfa_fcs_fabric_flogiacc_comp(void *fcsarg,
					 u32 rsp_len,
					 u32 resid_len,
					 struct fchs_s *rspfchs);
/**
/*
 *  fcs_fabric_sm fabric state machine functions
 */

/**
/*
 * Fabric state machine events
 */
enum bfa_fcs_fabric_event {
@@ -286,7 +286,7 @@ static void bfa_fcs_fabric_sm_isolated(struct bfa_fcs_fabric_s *fabric,
					   enum bfa_fcs_fabric_event event);
static void	bfa_fcs_fabric_sm_deleting(struct bfa_fcs_fabric_s *fabric,
					   enum bfa_fcs_fabric_event event);
/**
/*
 *   Beginning state before fabric creation.
 */
static void
@@ -312,7 +312,7 @@ bfa_fcs_fabric_sm_uninit(struct bfa_fcs_fabric_s *fabric,
	}
}

/**
/*
 *   Beginning state before fabric creation.
 */
static void
@@ -345,7 +345,7 @@ bfa_fcs_fabric_sm_created(struct bfa_fcs_fabric_s *fabric,
	}
}

/**
/*
 *   Link is down, awaiting LINK UP event from port. This is also the
 *   first state at fabric creation.
 */
@@ -375,7 +375,7 @@ bfa_fcs_fabric_sm_linkdown(struct bfa_fcs_fabric_s *fabric,
	}
}

/**
/*
 *   FLOGI is in progress, awaiting FLOGI reply.
 */
static void
@@ -468,7 +468,7 @@ bfa_fcs_fabric_sm_flogi_retry(struct bfa_fcs_fabric_s *fabric,
	}
}

/**
/*
 *   Authentication is in progress, awaiting authentication results.
 */
static void
@@ -508,7 +508,7 @@ bfa_fcs_fabric_sm_auth(struct bfa_fcs_fabric_s *fabric,
	}
}

/**
/*
 *   Authentication failed
 */
static void
@@ -534,7 +534,7 @@ bfa_fcs_fabric_sm_auth_failed(struct bfa_fcs_fabric_s *fabric,
	}
}

/**
/*
 *   Port is in loopback mode.
 */
static void
@@ -560,7 +560,7 @@ bfa_fcs_fabric_sm_loopback(struct bfa_fcs_fabric_s *fabric,
	}
}

/**
/*
 *   There is no attached fabric - private loop or NPort-to-NPort topology.
 */
static void
@@ -593,7 +593,7 @@ bfa_fcs_fabric_sm_nofabric(struct bfa_fcs_fabric_s *fabric,
	}
}

/**
/*
 *   Fabric is online - normal operating state.
 */
static void
@@ -628,7 +628,7 @@ bfa_fcs_fabric_sm_online(struct bfa_fcs_fabric_s *fabric,
	}
}

/**
/*
 *   Exchanging virtual fabric parameters.
 */
static void
@@ -652,7 +652,7 @@ bfa_fcs_fabric_sm_evfp(struct bfa_fcs_fabric_s *fabric,
	}
}

/**
/*
 *   EVFP exchange complete and VFT tagging is enabled.
 */
static void
@@ -663,7 +663,7 @@ bfa_fcs_fabric_sm_evfp_done(struct bfa_fcs_fabric_s *fabric,
	bfa_trc(fabric->fcs, event);
}

/**
/*
 *   Port is isolated after EVFP exchange due to VF_ID mismatch (N and F).
 */
static void
@@ -684,7 +684,7 @@ bfa_fcs_fabric_sm_isolated(struct bfa_fcs_fabric_s *fabric,
		fabric->event_arg.swp_vfid);
}

/**
/*
 *   Fabric is being deleted, awaiting vport delete completions.
 */
static void
@@ -714,7 +714,7 @@ bfa_fcs_fabric_sm_deleting(struct bfa_fcs_fabric_s *fabric,



/**
/*
 *  fcs_fabric_private fabric private functions
 */

@@ -728,7 +728,7 @@ bfa_fcs_fabric_init(struct bfa_fcs_fabric_s *fabric)
	port_cfg->pwwn = bfa_ioc_get_pwwn(&fabric->fcs->bfa->ioc);
}

/**
/*
 * Port Symbolic Name Creation for base port.
 */
void
@@ -789,7 +789,7 @@ bfa_fcs_fabric_psymb_init(struct bfa_fcs_fabric_s *fabric)
	port_cfg->sym_name.symname[BFA_SYMNAME_MAXLEN - 1] = 0;
}

/**
/*
 * bfa lps login completion callback
 */
void
@@ -867,7 +867,7 @@ bfa_cb_lps_flogi_comp(void *bfad, void *uarg, bfa_status_t status)
	bfa_trc(fabric->fcs, fabric->is_npiv);
	bfa_trc(fabric->fcs, fabric->is_auth);
}
/**
/*
 *		Allocate and send FLOGI.
 */
static void
@@ -897,7 +897,7 @@ bfa_fcs_fabric_notify_online(struct bfa_fcs_fabric_s *fabric)
	bfa_fcs_fabric_set_opertype(fabric);
	fabric->stats.fabric_onlines++;

	/**
	/*
	 * notify online event to base and then virtual ports
	 */
	bfa_fcs_lport_online(&fabric->bport);
@@ -917,7 +917,7 @@ bfa_fcs_fabric_notify_offline(struct bfa_fcs_fabric_s *fabric)
	bfa_trc(fabric->fcs, fabric->fabric_name);
	fabric->stats.fabric_offlines++;

	/**
	/*
	 * notify offline event first to vports and then base port.
	 */
	list_for_each_safe(qe, qen, &fabric->vport_q) {
@@ -939,7 +939,7 @@ bfa_fcs_fabric_delay(void *cbarg)
	bfa_sm_send_event(fabric, BFA_FCS_FABRIC_SM_DELAYED);
}

/**
/*
 * Delete all vports and wait for vport delete completions.
 */
static void
@@ -965,11 +965,11 @@ bfa_fcs_fabric_delete_comp(void *cbarg)
	bfa_sm_send_event(fabric, BFA_FCS_FABRIC_SM_DELCOMP);
}

/**
/*
 *  fcs_fabric_public fabric public functions
 */

/**
/*
 * Attach time initialization.
 */
void
@@ -980,7 +980,7 @@ bfa_fcs_fabric_attach(struct bfa_fcs_s *fcs)
	fabric = &fcs->fabric;
	memset(fabric, 0, sizeof(struct bfa_fcs_fabric_s));

	/**
	/*
	 * Initialize base fabric.
	 */
	fabric->fcs = fcs;
@@ -989,7 +989,7 @@ bfa_fcs_fabric_attach(struct bfa_fcs_s *fcs)
	fabric->lps = bfa_lps_alloc(fcs->bfa);
	bfa_assert(fabric->lps);

	/**
	/*
	 * Initialize fabric delete completion handler. Fabric deletion is
	 * complete when the last vport delete is complete.
	 */
@@ -1007,7 +1007,7 @@ bfa_fcs_fabric_modinit(struct bfa_fcs_s *fcs)
	bfa_trc(fcs, 0);
}

/**
/*
 *   Module cleanup
 */
void
@@ -1017,7 +1017,7 @@ bfa_fcs_fabric_modexit(struct bfa_fcs_s *fcs)

	bfa_trc(fcs, 0);

	/**
	/*
	 * Cleanup base fabric.
	 */
	fabric = &fcs->fabric;
@@ -1025,7 +1025,7 @@ bfa_fcs_fabric_modexit(struct bfa_fcs_s *fcs)
	bfa_sm_send_event(fabric, BFA_FCS_FABRIC_SM_DELETE);
}

/**
/*
 * Fabric module start -- kick starts FCS actions
 */
void
@@ -1038,7 +1038,7 @@ bfa_fcs_fabric_modstart(struct bfa_fcs_s *fcs)
	bfa_sm_send_event(fabric, BFA_FCS_FABRIC_SM_START);
}

/**
/*
 *   Suspend fabric activity as part of driver suspend.
 */
void
@@ -1064,7 +1064,7 @@ bfa_fcs_fabric_port_type(struct bfa_fcs_fabric_s *fabric)
	return fabric->oper_type;
}

/**
/*
 *   Link up notification from BFA physical port module.
 */
void
@@ -1074,7 +1074,7 @@ bfa_fcs_fabric_link_up(struct bfa_fcs_fabric_s *fabric)
	bfa_sm_send_event(fabric, BFA_FCS_FABRIC_SM_LINK_UP);
}

/**
/*
 *   Link down notification from BFA physical port module.
 */
void
@@ -1084,7 +1084,7 @@ bfa_fcs_fabric_link_down(struct bfa_fcs_fabric_s *fabric)
	bfa_sm_send_event(fabric, BFA_FCS_FABRIC_SM_LINK_DOWN);
}

/**
/*
 *   A child vport is being created in the fabric.
 *
 *   Call from vport module at vport creation. A list of base port and vports
@@ -1099,7 +1099,7 @@ void
bfa_fcs_fabric_addvport(struct bfa_fcs_fabric_s *fabric,
			struct bfa_fcs_vport_s *vport)
{
	/**
	/*
	 * - add vport to fabric's vport_q
	 */
	bfa_trc(fabric->fcs, fabric->vf_id);
@@ -1109,7 +1109,7 @@ bfa_fcs_fabric_addvport(struct bfa_fcs_fabric_s *fabric,
	bfa_wc_up(&fabric->wc);
}

/**
/*
 *   A child vport is being deleted from fabric.
 *
 *   Vport is being deleted.
@@ -1123,7 +1123,7 @@ bfa_fcs_fabric_delvport(struct bfa_fcs_fabric_s *fabric,
	bfa_wc_down(&fabric->wc);
}

/**
/*
 *   Base port is deleted.
 */
void
@@ -1133,7 +1133,7 @@ bfa_fcs_fabric_port_delete_comp(struct bfa_fcs_fabric_s *fabric)
}


/**
/*
 *    Check if fabric is online.
 *
 *   param[in] fabric - Fabric instance. This can be a base fabric or vf.
@@ -1146,7 +1146,7 @@ bfa_fcs_fabric_is_online(struct bfa_fcs_fabric_s *fabric)
	return bfa_sm_cmp_state(fabric, bfa_fcs_fabric_sm_online);
}

/**
/*
 *	brief
 *
 */
@@ -1158,7 +1158,7 @@ bfa_fcs_fabric_addvf(struct bfa_fcs_fabric_s *vf, struct bfa_fcs_s *fcs,
	return BFA_STATUS_OK;
}

/**
/*
 * Lookup for a vport withing a fabric given its pwwn
 */
struct bfa_fcs_vport_s *
@@ -1176,7 +1176,7 @@ bfa_fcs_fabric_vport_lookup(struct bfa_fcs_fabric_s *fabric, wwn_t pwwn)
	return NULL;
}

/**
/*
 *    In a given fabric, return the number of lports.
 *
 *   param[in] fabric - Fabric instance. This can be a base fabric or vf.
@@ -1214,7 +1214,7 @@ bfa_fcs_fabric_get_switch_oui(struct bfa_fcs_fabric_s *fabric)

	return oui;
}
/**
/*
 *		Unsolicited frame receive handling.
 */
void
@@ -1230,7 +1230,7 @@ bfa_fcs_fabric_uf_recv(struct bfa_fcs_fabric_s *fabric, struct fchs_s *fchs,
	bfa_trc(fabric->fcs, len);
	bfa_trc(fabric->fcs, pid);

	/**
	/*
	 * Look for our own FLOGI frames being looped back. This means an
	 * external loopback cable is in place. Our own FLOGI frames are
	 * sometimes looped back when switch port gets temporarily bypassed.
@@ -1242,7 +1242,7 @@ bfa_fcs_fabric_uf_recv(struct bfa_fcs_fabric_s *fabric, struct fchs_s *fchs,
		return;
	}

	/**
	/*
	 * FLOGI/EVFP exchanges should be consumed by base fabric.
	 */
	if (fchs->d_id == bfa_os_hton3b(FC_FABRIC_PORT)) {
@@ -1252,7 +1252,7 @@ bfa_fcs_fabric_uf_recv(struct bfa_fcs_fabric_s *fabric, struct fchs_s *fchs,
	}

	if (fabric->bport.pid == pid) {
		/**
		/*
		 * All authentication frames should be routed to auth
		 */
		bfa_trc(fabric->fcs, els_cmd->els_code);
@@ -1266,7 +1266,7 @@ bfa_fcs_fabric_uf_recv(struct bfa_fcs_fabric_s *fabric, struct fchs_s *fchs,
		return;
	}

	/**
	/*
	 * look for a matching local port ID
	 */
	list_for_each(qe, &fabric->vport_q) {
@@ -1280,7 +1280,7 @@ bfa_fcs_fabric_uf_recv(struct bfa_fcs_fabric_s *fabric, struct fchs_s *fchs,
	bfa_fcs_lport_uf_recv(&fabric->bport, fchs, len);
}

/**
/*
 *		Unsolicited frames to be processed by fabric.
 */
static void
@@ -1304,7 +1304,7 @@ bfa_fcs_fabric_process_uf(struct bfa_fcs_fabric_s *fabric, struct fchs_s *fchs,
	}
}

/**
/*
 *	Process	incoming FLOGI
 */
static void
@@ -1351,7 +1351,7 @@ bfa_fcs_fabric_send_flogi_acc(struct bfa_fcs_fabric_s *fabric)
	struct fchs_s	fchs;

	fcxp = bfa_fcs_fcxp_alloc(fabric->fcs);
	/**
	/*
	 * Do not expect this failure -- expect remote node to retry
	 */
	if (!fcxp)
@@ -1370,7 +1370,7 @@ bfa_fcs_fabric_send_flogi_acc(struct bfa_fcs_fabric_s *fabric)
		      FC_MAX_PDUSZ, 0);
}

/**
/*
 *   Flogi Acc completion callback.
 */
static void
@@ -1417,7 +1417,7 @@ bfa_fcs_fabric_set_fabric_name(struct bfa_fcs_fabric_s *fabric,
	}
}

/**
/*
 *	Returns FCS vf structure for a given vf_id.
 *
 *	param[in]	vf_id - VF_ID
@@ -1435,7 +1435,7 @@ bfa_fcs_vf_lookup(struct bfa_fcs_s *fcs, u16 vf_id)
	return NULL;
}

/**
/*
 * BFA FCS PPORT ( physical port)
 */
static void
@@ -1465,11 +1465,11 @@ bfa_fcs_port_attach(struct bfa_fcs_s *fcs)
	bfa_fcport_event_register(fcs->bfa, bfa_fcs_port_event_handler, fcs);
}

/**
/*
 * BFA FCS UF ( Unsolicited Frames)
 */

/**
/*
 *		BFA callback for unsolicited frame receive handler.
 *
 * @param[in]		cbarg		callback arg for receive handler
@@ -1486,7 +1486,7 @@ bfa_fcs_uf_recv(void *cbarg, struct bfa_uf_s *uf)
	struct fc_vft_s *vft;
	struct bfa_fcs_fabric_s *fabric;

	/**
	/*
	 * check for VFT header
	 */
	if (fchs->routing == FC_RTG_EXT_HDR &&
@@ -1498,7 +1498,7 @@ bfa_fcs_uf_recv(void *cbarg, struct bfa_uf_s *uf)
		else
			fabric = bfa_fcs_vf_lookup(fcs, (u16) vft->vf_id);

		/**
		/*
		 * drop frame if vfid is unknown
		 */
		if (!fabric) {
@@ -1508,7 +1508,7 @@ bfa_fcs_uf_recv(void *cbarg, struct bfa_uf_s *uf)
			return;
		}

		/**
		/*
		 * skip vft header
		 */
		fchs = (struct fchs_s *) (vft + 1);
Loading