root/drivers/scsi/csiostor/csio_lnode.c
/*
 * This file is part of the Chelsio FCoE driver for Linux.
 *
 * Copyright (c) 2008-2012 Chelsio Communications, Inc. All rights reserved.
 *
 * This software is available to you under a choice of one of two
 * licenses.  You may choose to be licensed under the terms of the GNU
 * General Public License (GPL) Version 2, available from the file
 * COPYING in the main directory of this source tree, or the
 * OpenIB.org BSD license below:
 *
 *     Redistribution and use in source and binary forms, with or
 *     without modification, are permitted provided that the following
 *     conditions are met:
 *
 *      - Redistributions of source code must retain the above
 *        copyright notice, this list of conditions and the following
 *        disclaimer.
 *
 *      - Redistributions in binary form must reproduce the above
 *        copyright notice, this list of conditions and the following
 *        disclaimer in the documentation and/or other materials
 *        provided with the distribution.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */

#include <linux/kernel.h>
#include <linux/delay.h>
#include <linux/slab.h>
#include <linux/utsname.h>
#include <scsi/scsi_device.h>
#include <scsi/scsi_transport_fc.h>
#include <linux/unaligned.h>
#include <scsi/fc/fc_els.h>
#include <scsi/fc/fc_fs.h>
#include <scsi/fc/fc_gs.h>
#include <scsi/fc/fc_ms.h>

#include "csio_hw.h"
#include "csio_mb.h"
#include "csio_lnode.h"
#include "csio_rnode.h"

int csio_fcoe_rnodes = 1024;
int csio_fdmi_enable = 1;

#define PORT_ID_PTR(_x)         ((uint8_t *)(&_x) + 1)

/* Lnode SM declarations */
static void csio_lns_uninit(struct csio_lnode *, enum csio_ln_ev);
static void csio_lns_online(struct csio_lnode *, enum csio_ln_ev);
static void csio_lns_ready(struct csio_lnode *, enum csio_ln_ev);
static void csio_lns_offline(struct csio_lnode *, enum csio_ln_ev);

static int csio_ln_mgmt_submit_req(struct csio_ioreq *,
                void (*io_cbfn) (struct csio_hw *, struct csio_ioreq *),
                enum fcoe_cmn_type, struct csio_dma_buf *, uint32_t);

/* LN event mapping */
static enum csio_ln_ev fwevt_to_lnevt[] = {
        CSIO_LNE_NONE,          /* None */
        CSIO_LNE_NONE,          /* PLOGI_ACC_RCVD  */
        CSIO_LNE_NONE,          /* PLOGI_RJT_RCVD  */
        CSIO_LNE_NONE,          /* PLOGI_RCVD      */
        CSIO_LNE_NONE,          /* PLOGO_RCVD      */
        CSIO_LNE_NONE,          /* PRLI_ACC_RCVD   */
        CSIO_LNE_NONE,          /* PRLI_RJT_RCVD   */
        CSIO_LNE_NONE,          /* PRLI_RCVD       */
        CSIO_LNE_NONE,          /* PRLO_RCVD       */
        CSIO_LNE_NONE,          /* NPORT_ID_CHGD   */
        CSIO_LNE_LOGO,          /* FLOGO_RCVD      */
        CSIO_LNE_LOGO,          /* CLR_VIRT_LNK_RCVD */
        CSIO_LNE_FAB_INIT_DONE,/* FLOGI_ACC_RCVD   */
        CSIO_LNE_NONE,          /* FLOGI_RJT_RCVD   */
        CSIO_LNE_FAB_INIT_DONE,/* FDISC_ACC_RCVD   */
        CSIO_LNE_NONE,          /* FDISC_RJT_RCVD   */
        CSIO_LNE_NONE,          /* FLOGI_TMO_MAX_RETRY */
        CSIO_LNE_NONE,          /* IMPL_LOGO_ADISC_ACC */
        CSIO_LNE_NONE,          /* IMPL_LOGO_ADISC_RJT */
        CSIO_LNE_NONE,          /* IMPL_LOGO_ADISC_CNFLT */
        CSIO_LNE_NONE,          /* PRLI_TMO             */
        CSIO_LNE_NONE,          /* ADISC_TMO            */
        CSIO_LNE_NONE,          /* RSCN_DEV_LOST */
        CSIO_LNE_NONE,          /* SCR_ACC_RCVD */
        CSIO_LNE_NONE,          /* ADISC_RJT_RCVD */
        CSIO_LNE_NONE,          /* LOGO_SNT */
        CSIO_LNE_NONE,          /* PROTO_ERR_IMPL_LOGO */
};

#define CSIO_FWE_TO_LNE(_evt)   ((_evt > PROTO_ERR_IMPL_LOGO) ?         \
                                                CSIO_LNE_NONE : \
                                                fwevt_to_lnevt[_evt])

#define csio_ct_rsp(cp)         (((struct fc_ct_hdr *)cp)->ct_cmd)
#define csio_ct_reason(cp)      (((struct fc_ct_hdr *)cp)->ct_reason)
#define csio_ct_expl(cp)        (((struct fc_ct_hdr *)cp)->ct_explan)
#define csio_ct_get_pld(cp)     ((void *)(((uint8_t *)cp) + FC_CT_HDR_LEN))

/*
 * csio_ln_match_by_portid - lookup lnode using given portid.
 * @hw: HW module
 * @portid: port-id.
 *
 * If found, returns lnode matching given portid otherwise returns NULL.
 */
static struct csio_lnode *
csio_ln_lookup_by_portid(struct csio_hw *hw, uint8_t portid)
{
        struct csio_lnode *ln;
        struct list_head *tmp;

        /* Match siblings lnode with portid */
        list_for_each(tmp, &hw->sln_head) {
                ln = (struct csio_lnode *) tmp;
                if (ln->portid == portid)
                        return ln;
        }

        return NULL;
}

/*
 * csio_ln_lookup_by_vnpi - Lookup lnode using given vnp id.
 * @hw - HW module
 * @vnpi - vnp index.
 * Returns - If found, returns lnode matching given vnp id
 * otherwise returns NULL.
 */
static struct csio_lnode *
csio_ln_lookup_by_vnpi(struct csio_hw *hw, uint32_t vnp_id)
{
        struct list_head *tmp1, *tmp2;
        struct csio_lnode *sln = NULL, *cln = NULL;

        if (list_empty(&hw->sln_head)) {
                CSIO_INC_STATS(hw, n_lnlkup_miss);
                return NULL;
        }
        /* Traverse sibling lnodes */
        list_for_each(tmp1, &hw->sln_head) {
                sln = (struct csio_lnode *) tmp1;

                /* Match sibling lnode */
                if (sln->vnp_flowid == vnp_id)
                        return sln;

                if (list_empty(&sln->cln_head))
                        continue;

                /* Traverse children lnodes */
                list_for_each(tmp2, &sln->cln_head) {
                        cln = (struct csio_lnode *) tmp2;

                        if (cln->vnp_flowid == vnp_id)
                                return cln;
                }
        }
        CSIO_INC_STATS(hw, n_lnlkup_miss);
        return NULL;
}

/**
 * csio_lnode_lookup_by_wwpn - Lookup lnode using given wwpn.
 * @hw:         HW module.
 * @wwpn:       WWPN.
 *
 * If found, returns lnode matching given wwpn, returns NULL otherwise.
 */
struct csio_lnode *
csio_lnode_lookup_by_wwpn(struct csio_hw *hw, uint8_t *wwpn)
{
        struct list_head *tmp1, *tmp2;
        struct csio_lnode *sln = NULL, *cln = NULL;

        if (list_empty(&hw->sln_head)) {
                CSIO_INC_STATS(hw, n_lnlkup_miss);
                return NULL;
        }
        /* Traverse sibling lnodes */
        list_for_each(tmp1, &hw->sln_head) {
                sln = (struct csio_lnode *) tmp1;

                /* Match sibling lnode */
                if (!memcmp(csio_ln_wwpn(sln), wwpn, 8))
                        return sln;

                if (list_empty(&sln->cln_head))
                        continue;

                /* Traverse children lnodes */
                list_for_each(tmp2, &sln->cln_head) {
                        cln = (struct csio_lnode *) tmp2;

                        if (!memcmp(csio_ln_wwpn(cln), wwpn, 8))
                                return cln;
                }
        }
        return NULL;
}

/* FDMI */
static void
csio_fill_ct_iu(void *buf, uint8_t type, uint8_t sub_type, uint16_t op)
{
        struct fc_ct_hdr *cmd = (struct fc_ct_hdr *)buf;
        cmd->ct_rev = FC_CT_REV;
        cmd->ct_fs_type = type;
        cmd->ct_fs_subtype = sub_type;
        cmd->ct_cmd = htons(op);
}

static int
csio_hostname(uint8_t *buf, size_t buf_len)
{
        if (snprintf(buf, buf_len, "%s", init_utsname()->nodename) > 0)
                return 0;
        return -1;
}

static int
csio_osname(uint8_t *buf, size_t buf_len)
{
        if (snprintf(buf, buf_len, "%s %s %s",
                     init_utsname()->sysname,
                     init_utsname()->release,
                     init_utsname()->version) > 0)
                return 0;

        return -1;
}

static inline void
csio_append_attrib(uint8_t **ptr, uint16_t type, void *val, size_t val_len)
{
        uint16_t len;
        struct fc_fdmi_attr_entry *ae = (struct fc_fdmi_attr_entry *)*ptr;

        if (WARN_ON(val_len > U16_MAX))
                return;

        len = val_len;

        ae->type = htons(type);
        len += 4;               /* includes attribute type and length */
        len = (len + 3) & ~3;   /* should be multiple of 4 bytes */
        ae->len = htons(len);
        memcpy(ae->value, val, val_len);
        if (len > val_len)
                memset(ae->value + val_len, 0, len - val_len);
        *ptr += len;
}

/*
 * csio_ln_fdmi_done - FDMI registeration completion
 * @hw: HW context
 * @fdmi_req: fdmi request
 */
static void
csio_ln_fdmi_done(struct csio_hw *hw, struct csio_ioreq *fdmi_req)
{
        void *cmd;
        struct csio_lnode *ln = fdmi_req->lnode;

        if (fdmi_req->wr_status != FW_SUCCESS) {
                csio_ln_dbg(ln, "WR error:%x in processing fdmi rpa cmd\n",
                            fdmi_req->wr_status);
                CSIO_INC_STATS(ln, n_fdmi_err);
        }

        cmd = fdmi_req->dma_buf.vaddr;
        if (ntohs(csio_ct_rsp(cmd)) != FC_FS_ACC) {
                csio_ln_dbg(ln, "fdmi rpa cmd rejected reason %x expl %x\n",
                            csio_ct_reason(cmd), csio_ct_expl(cmd));
        }
}

/*
 * csio_ln_fdmi_rhba_cbfn - RHBA completion
 * @hw: HW context
 * @fdmi_req: fdmi request
 */
static void
csio_ln_fdmi_rhba_cbfn(struct csio_hw *hw, struct csio_ioreq *fdmi_req)
{
        void *cmd;
        uint8_t *pld;
        uint32_t len = 0;
        __be32 val;
        __be16 mfs;
        uint32_t numattrs = 0;
        struct csio_lnode *ln = fdmi_req->lnode;
        struct fs_fdmi_attrs *attrib_blk;
        struct fc_fdmi_port_name *port_name;
        uint8_t buf[64];
        uint8_t *fc4_type;
        unsigned long flags;

        if (fdmi_req->wr_status != FW_SUCCESS) {
                csio_ln_dbg(ln, "WR error:%x in processing fdmi rhba cmd\n",
                            fdmi_req->wr_status);
                CSIO_INC_STATS(ln, n_fdmi_err);
        }

        cmd = fdmi_req->dma_buf.vaddr;
        if (ntohs(csio_ct_rsp(cmd)) != FC_FS_ACC) {
                csio_ln_dbg(ln, "fdmi rhba cmd rejected reason %x expl %x\n",
                            csio_ct_reason(cmd), csio_ct_expl(cmd));
        }

        if (!csio_is_rnode_ready(fdmi_req->rnode)) {
                CSIO_INC_STATS(ln, n_fdmi_err);
                return;
        }

        /* Prepare CT hdr for RPA cmd */
        memset(cmd, 0, FC_CT_HDR_LEN);
        csio_fill_ct_iu(cmd, FC_FST_MGMT, FC_FDMI_SUBTYPE, FC_FDMI_RPA);

        /* Prepare RPA payload */
        pld = (uint8_t *)csio_ct_get_pld(cmd);
        port_name = (struct fc_fdmi_port_name *)pld;
        memcpy(&port_name->portname, csio_ln_wwpn(ln), 8);
        pld += sizeof(*port_name);

        /* Start appending Port attributes */
        attrib_blk = (struct fs_fdmi_attrs *)pld;
        attrib_blk->numattrs = 0;
        len += sizeof(attrib_blk->numattrs);
        pld += sizeof(attrib_blk->numattrs);

        fc4_type = &buf[0];
        memset(fc4_type, 0, FC_FDMI_PORT_ATTR_FC4TYPES_LEN);
        fc4_type[2] = 1;
        fc4_type[7] = 1;
        csio_append_attrib(&pld, FC_FDMI_PORT_ATTR_FC4TYPES,
                           fc4_type, FC_FDMI_PORT_ATTR_FC4TYPES_LEN);
        numattrs++;
        val = htonl(FC_PORTSPEED_1GBIT | FC_PORTSPEED_10GBIT);
        csio_append_attrib(&pld, FC_FDMI_PORT_ATTR_SUPPORTEDSPEED,
                           &val,
                           FC_FDMI_PORT_ATTR_SUPPORTEDSPEED_LEN);
        numattrs++;

        if (hw->pport[ln->portid].link_speed == FW_PORT_CAP_SPEED_1G)
                val = htonl(FC_PORTSPEED_1GBIT);
        else if (hw->pport[ln->portid].link_speed == FW_PORT_CAP_SPEED_10G)
                val = htonl(FC_PORTSPEED_10GBIT);
        else if (hw->pport[ln->portid].link_speed == FW_PORT_CAP32_SPEED_25G)
                val = htonl(FC_PORTSPEED_25GBIT);
        else if (hw->pport[ln->portid].link_speed == FW_PORT_CAP32_SPEED_40G)
                val = htonl(FC_PORTSPEED_40GBIT);
        else if (hw->pport[ln->portid].link_speed == FW_PORT_CAP32_SPEED_50G)
                val = htonl(FC_PORTSPEED_50GBIT);
        else if (hw->pport[ln->portid].link_speed == FW_PORT_CAP32_SPEED_100G)
                val = htonl(FC_PORTSPEED_100GBIT);
        else
                val = htonl(CSIO_HBA_PORTSPEED_UNKNOWN);
        csio_append_attrib(&pld, FC_FDMI_PORT_ATTR_CURRENTPORTSPEED,
                           &val, FC_FDMI_PORT_ATTR_CURRENTPORTSPEED_LEN);
        numattrs++;

        mfs = ln->ln_sparm.csp.sp_bb_data;
        csio_append_attrib(&pld, FC_FDMI_PORT_ATTR_MAXFRAMESIZE,
                           &mfs, sizeof(mfs));
        numattrs++;

        strcpy(buf, "csiostor");
        csio_append_attrib(&pld, FC_FDMI_PORT_ATTR_OSDEVICENAME, buf,
                           strlen(buf));
        numattrs++;

        if (!csio_hostname(buf, sizeof(buf))) {
                csio_append_attrib(&pld, FC_FDMI_PORT_ATTR_HOSTNAME,
                                   buf, strlen(buf));
                numattrs++;
        }
        attrib_blk->numattrs = htonl(numattrs);
        len = (uint32_t)(pld - (uint8_t *)cmd);

        /* Submit FDMI RPA request */
        spin_lock_irqsave(&hw->lock, flags);
        if (csio_ln_mgmt_submit_req(fdmi_req, csio_ln_fdmi_done,
                                FCOE_CT, &fdmi_req->dma_buf, len)) {
                CSIO_INC_STATS(ln, n_fdmi_err);
                csio_ln_dbg(ln, "Failed to issue fdmi rpa req\n");
        }
        spin_unlock_irqrestore(&hw->lock, flags);
}

/*
 * csio_ln_fdmi_dprt_cbfn - DPRT completion
 * @hw: HW context
 * @fdmi_req: fdmi request
 */
static void
csio_ln_fdmi_dprt_cbfn(struct csio_hw *hw, struct csio_ioreq *fdmi_req)
{
        void *cmd;
        uint8_t *pld;
        uint32_t len = 0;
        uint32_t numattrs = 0;
        __be32  maxpayload = htonl(65536);
        struct fc_fdmi_hba_identifier *hbaid;
        struct csio_lnode *ln = fdmi_req->lnode;
        struct fc_fdmi_rpl *reg_pl;
        struct fs_fdmi_attrs *attrib_blk;
        uint8_t buf[64];
        unsigned long flags;

        if (fdmi_req->wr_status != FW_SUCCESS) {
                csio_ln_dbg(ln, "WR error:%x in processing fdmi dprt cmd\n",
                            fdmi_req->wr_status);
                CSIO_INC_STATS(ln, n_fdmi_err);
        }

        if (!csio_is_rnode_ready(fdmi_req->rnode)) {
                CSIO_INC_STATS(ln, n_fdmi_err);
                return;
        }
        cmd = fdmi_req->dma_buf.vaddr;
        if (ntohs(csio_ct_rsp(cmd)) != FC_FS_ACC) {
                csio_ln_dbg(ln, "fdmi dprt cmd rejected reason %x expl %x\n",
                            csio_ct_reason(cmd), csio_ct_expl(cmd));
        }

        /* Prepare CT hdr for RHBA cmd */
        memset(cmd, 0, FC_CT_HDR_LEN);
        csio_fill_ct_iu(cmd, FC_FST_MGMT, FC_FDMI_SUBTYPE, FC_FDMI_RHBA);
        len = FC_CT_HDR_LEN;

        /* Prepare RHBA payload */
        pld = (uint8_t *)csio_ct_get_pld(cmd);
        hbaid = (struct fc_fdmi_hba_identifier *)pld;
        memcpy(&hbaid->id, csio_ln_wwpn(ln), 8); /* HBA identifer */
        pld += sizeof(*hbaid);

        /* Register one port per hba */
        reg_pl = (struct fc_fdmi_rpl *)pld;
        reg_pl->numport = htonl(1);
        memcpy(&reg_pl->port[0].portname, csio_ln_wwpn(ln), 8);
        pld += sizeof(*reg_pl);

        /* Start appending HBA attributes hba */
        attrib_blk = (struct fs_fdmi_attrs *)pld;
        attrib_blk->numattrs = 0;
        len += sizeof(attrib_blk->numattrs);
        pld += sizeof(attrib_blk->numattrs);

        csio_append_attrib(&pld, FC_FDMI_HBA_ATTR_NODENAME, csio_ln_wwnn(ln),
                           FC_FDMI_HBA_ATTR_NODENAME_LEN);
        numattrs++;

        memset(buf, 0, sizeof(buf));

        strcpy(buf, "Chelsio Communications");
        csio_append_attrib(&pld, FC_FDMI_HBA_ATTR_MANUFACTURER, buf,
                           strlen(buf));
        numattrs++;
        csio_append_attrib(&pld, FC_FDMI_HBA_ATTR_SERIALNUMBER,
                           hw->vpd.sn, sizeof(hw->vpd.sn));
        numattrs++;
        csio_append_attrib(&pld, FC_FDMI_HBA_ATTR_MODEL, hw->vpd.id,
                           sizeof(hw->vpd.id));
        numattrs++;
        csio_append_attrib(&pld, FC_FDMI_HBA_ATTR_MODELDESCRIPTION,
                           hw->model_desc, strlen(hw->model_desc));
        numattrs++;
        csio_append_attrib(&pld, FC_FDMI_HBA_ATTR_HARDWAREVERSION,
                           hw->hw_ver, sizeof(hw->hw_ver));
        numattrs++;
        csio_append_attrib(&pld, FC_FDMI_HBA_ATTR_FIRMWAREVERSION,
                           hw->fwrev_str, strlen(hw->fwrev_str));
        numattrs++;

        if (!csio_osname(buf, sizeof(buf))) {
                csio_append_attrib(&pld, FC_FDMI_HBA_ATTR_OSNAMEVERSION,
                                   buf, strlen(buf));
                numattrs++;
        }

        csio_append_attrib(&pld, FC_FDMI_HBA_ATTR_MAXCTPAYLOAD,
                           &maxpayload, FC_FDMI_HBA_ATTR_MAXCTPAYLOAD_LEN);
        len = (uint32_t)(pld - (uint8_t *)cmd);
        numattrs++;
        attrib_blk->numattrs = htonl(numattrs);

        /* Submit FDMI RHBA request */
        spin_lock_irqsave(&hw->lock, flags);
        if (csio_ln_mgmt_submit_req(fdmi_req, csio_ln_fdmi_rhba_cbfn,
                                FCOE_CT, &fdmi_req->dma_buf, len)) {
                CSIO_INC_STATS(ln, n_fdmi_err);
                csio_ln_dbg(ln, "Failed to issue fdmi rhba req\n");
        }
        spin_unlock_irqrestore(&hw->lock, flags);
}

/*
 * csio_ln_fdmi_dhba_cbfn - DHBA completion
 * @hw: HW context
 * @fdmi_req: fdmi request
 */
static void
csio_ln_fdmi_dhba_cbfn(struct csio_hw *hw, struct csio_ioreq *fdmi_req)
{
        struct csio_lnode *ln = fdmi_req->lnode;
        void *cmd;
        struct fc_fdmi_port_name *port_name;
        uint32_t len;
        unsigned long flags;

        if (fdmi_req->wr_status != FW_SUCCESS) {
                csio_ln_dbg(ln, "WR error:%x in processing fdmi dhba cmd\n",
                            fdmi_req->wr_status);
                CSIO_INC_STATS(ln, n_fdmi_err);
        }

        if (!csio_is_rnode_ready(fdmi_req->rnode)) {
                CSIO_INC_STATS(ln, n_fdmi_err);
                return;
        }
        cmd = fdmi_req->dma_buf.vaddr;
        if (ntohs(csio_ct_rsp(cmd)) != FC_FS_ACC) {
                csio_ln_dbg(ln, "fdmi dhba cmd rejected reason %x expl %x\n",
                            csio_ct_reason(cmd), csio_ct_expl(cmd));
        }

        /* Send FDMI cmd to de-register any Port attributes if registered
         * before
         */

        /* Prepare FDMI DPRT cmd */
        memset(cmd, 0, FC_CT_HDR_LEN);
        csio_fill_ct_iu(cmd, FC_FST_MGMT, FC_FDMI_SUBTYPE, FC_FDMI_DPRT);
        len = FC_CT_HDR_LEN;
        port_name = (struct fc_fdmi_port_name *)csio_ct_get_pld(cmd);
        memcpy(&port_name->portname, csio_ln_wwpn(ln), 8);
        len += sizeof(*port_name);

        /* Submit FDMI request */
        spin_lock_irqsave(&hw->lock, flags);
        if (csio_ln_mgmt_submit_req(fdmi_req, csio_ln_fdmi_dprt_cbfn,
                                FCOE_CT, &fdmi_req->dma_buf, len)) {
                CSIO_INC_STATS(ln, n_fdmi_err);
                csio_ln_dbg(ln, "Failed to issue fdmi dprt req\n");
        }
        spin_unlock_irqrestore(&hw->lock, flags);
}

/**
 * csio_ln_fdmi_start - Start an FDMI request.
 * @ln:         lnode
 * @context:    session context
 *
 * Issued with lock held.
 */
int
csio_ln_fdmi_start(struct csio_lnode *ln, void *context)
{
        struct csio_ioreq *fdmi_req;
        struct csio_rnode *fdmi_rn = (struct csio_rnode *)context;
        void *cmd;
        struct fc_fdmi_hba_identifier *hbaid;
        uint32_t len;

        if (!(ln->flags & CSIO_LNF_FDMI_ENABLE))
                return -EPROTONOSUPPORT;

        if (!csio_is_rnode_ready(fdmi_rn))
                CSIO_INC_STATS(ln, n_fdmi_err);

        /* Send FDMI cmd to de-register any HBA attributes if registered
         * before
         */

        fdmi_req = ln->mgmt_req;
        fdmi_req->lnode = ln;
        fdmi_req->rnode = fdmi_rn;

        /* Prepare FDMI DHBA cmd */
        cmd = fdmi_req->dma_buf.vaddr;
        memset(cmd, 0, FC_CT_HDR_LEN);
        csio_fill_ct_iu(cmd, FC_FST_MGMT, FC_FDMI_SUBTYPE, FC_FDMI_DHBA);
        len = FC_CT_HDR_LEN;

        hbaid = (struct fc_fdmi_hba_identifier *)csio_ct_get_pld(cmd);
        memcpy(&hbaid->id, csio_ln_wwpn(ln), 8);
        len += sizeof(*hbaid);

        /* Submit FDMI request */
        if (csio_ln_mgmt_submit_req(fdmi_req, csio_ln_fdmi_dhba_cbfn,
                                        FCOE_CT, &fdmi_req->dma_buf, len)) {
                CSIO_INC_STATS(ln, n_fdmi_err);
                csio_ln_dbg(ln, "Failed to issue fdmi dhba req\n");
        }

        return 0;
}

/*
 * csio_ln_vnp_read_cbfn - vnp read completion handler.
 * @hw: HW lnode
 * @cbfn: Completion handler.
 *
 * Reads vnp response and updates ln parameters.
 */
static void
csio_ln_vnp_read_cbfn(struct csio_hw *hw, struct csio_mb *mbp)
{
        struct csio_lnode *ln = ((struct csio_lnode *)mbp->priv);
        struct fw_fcoe_vnp_cmd *rsp = (struct fw_fcoe_vnp_cmd *)(mbp->mb);
        struct fc_els_csp *csp;
        struct fc_els_cssp *clsp;
        enum fw_retval retval;
        __be32 nport_id = 0;

        retval = FW_CMD_RETVAL_G(ntohl(rsp->alloc_to_len16));
        if (retval != FW_SUCCESS) {
                csio_err(hw, "FCOE VNP read cmd returned error:0x%x\n", retval);
                mempool_free(mbp, hw->mb_mempool);
                return;
        }

        spin_lock_irq(&hw->lock);

        memcpy(ln->mac, rsp->vnport_mac, sizeof(ln->mac));
        memcpy(&nport_id, &rsp->vnport_mac[3], sizeof(uint8_t)*3);
        ln->nport_id = ntohl(nport_id);
        ln->nport_id = ln->nport_id >> 8;

        /* Update WWNs */
        /*
         * This may look like a duplication of what csio_fcoe_enable_link()
         * does, but is absolutely necessary if the vnpi changes between
         * a FCOE LINK UP and FCOE LINK DOWN.
         */
        memcpy(csio_ln_wwnn(ln), rsp->vnport_wwnn, 8);
        memcpy(csio_ln_wwpn(ln), rsp->vnport_wwpn, 8);

        /* Copy common sparam */
        csp = (struct fc_els_csp *)rsp->cmn_srv_parms;
        ln->ln_sparm.csp.sp_hi_ver = csp->sp_hi_ver;
        ln->ln_sparm.csp.sp_lo_ver = csp->sp_lo_ver;
        ln->ln_sparm.csp.sp_bb_cred = csp->sp_bb_cred;
        ln->ln_sparm.csp.sp_features = csp->sp_features;
        ln->ln_sparm.csp.sp_bb_data = csp->sp_bb_data;
        ln->ln_sparm.csp.sp_r_a_tov = csp->sp_r_a_tov;
        ln->ln_sparm.csp.sp_e_d_tov = csp->sp_e_d_tov;

        /* Copy word 0 & word 1 of class sparam */
        clsp = (struct fc_els_cssp *)rsp->clsp_word_0_1;
        ln->ln_sparm.clsp[2].cp_class = clsp->cp_class;
        ln->ln_sparm.clsp[2].cp_init = clsp->cp_init;
        ln->ln_sparm.clsp[2].cp_recip = clsp->cp_recip;
        ln->ln_sparm.clsp[2].cp_rdfs = clsp->cp_rdfs;

        spin_unlock_irq(&hw->lock);

        mempool_free(mbp, hw->mb_mempool);

        /* Send an event to update local attribs */
        csio_lnode_async_event(ln, CSIO_LN_FC_ATTRIB_UPDATE);
}

/*
 * csio_ln_vnp_read - Read vnp params.
 * @ln: lnode
 * @cbfn: Completion handler.
 *
 * Issued with lock held.
 */
static int
csio_ln_vnp_read(struct csio_lnode *ln,
                void (*cbfn) (struct csio_hw *, struct csio_mb *))
{
        struct csio_hw *hw = ln->hwp;
        struct csio_mb  *mbp;

        /* Allocate Mbox request */
        mbp = mempool_alloc(hw->mb_mempool, GFP_ATOMIC);
        if (!mbp) {
                CSIO_INC_STATS(hw, n_err_nomem);
                return -ENOMEM;
        }

        /* Prepare VNP Command */
        csio_fcoe_vnp_read_init_mb(ln, mbp,
                                    CSIO_MB_DEFAULT_TMO,
                                    ln->fcf_flowid,
                                    ln->vnp_flowid,
                                    cbfn);

        /* Issue MBOX cmd */
        if (csio_mb_issue(hw, mbp)) {
                csio_err(hw, "Failed to issue mbox FCoE VNP command\n");
                mempool_free(mbp, hw->mb_mempool);
                return -EINVAL;
        }

        return 0;
}

/*
 * csio_fcoe_enable_link - Enable fcoe link.
 * @ln: lnode
 * @enable: enable/disable
 * Issued with lock held.
 * Issues mbox cmd to bring up FCOE link on port associated with given ln.
 */
static int
csio_fcoe_enable_link(struct csio_lnode *ln, bool enable)
{
        struct csio_hw *hw = ln->hwp;
        struct csio_mb  *mbp;
        enum fw_retval retval;
        uint8_t portid;
        uint8_t sub_op;
        struct fw_fcoe_link_cmd *lcmd;
        int i;

        mbp = mempool_alloc(hw->mb_mempool, GFP_ATOMIC);
        if (!mbp) {
                CSIO_INC_STATS(hw, n_err_nomem);
                return -ENOMEM;
        }

        portid = ln->portid;
        sub_op = enable ? FCOE_LINK_UP : FCOE_LINK_DOWN;

        csio_dbg(hw, "bringing FCOE LINK %s on Port:%d\n",
                 sub_op ? "UP" : "DOWN", portid);

        csio_write_fcoe_link_cond_init_mb(ln, mbp, CSIO_MB_DEFAULT_TMO,
                                          portid, sub_op, 0, 0, 0, NULL);

        if (csio_mb_issue(hw, mbp)) {
                csio_err(hw, "failed to issue FCOE LINK cmd on port[%d]\n",
                        portid);
                mempool_free(mbp, hw->mb_mempool);
                return -EINVAL;
        }

        retval = csio_mb_fw_retval(mbp);
        if (retval != FW_SUCCESS) {
                csio_err(hw,
                         "FCOE LINK %s cmd on port[%d] failed with "
                         "ret:x%x\n", sub_op ? "UP" : "DOWN", portid, retval);
                mempool_free(mbp, hw->mb_mempool);
                return -EINVAL;
        }

        if (!enable)
                goto out;

        lcmd = (struct fw_fcoe_link_cmd *)mbp->mb;

        memcpy(csio_ln_wwnn(ln), lcmd->vnport_wwnn, 8);
        memcpy(csio_ln_wwpn(ln), lcmd->vnport_wwpn, 8);

        for (i = 0; i < CSIO_MAX_PPORTS; i++)
                if (hw->pport[i].portid == portid)
                        memcpy(hw->pport[i].mac, lcmd->phy_mac, 6);

out:
        mempool_free(mbp, hw->mb_mempool);
        return 0;
}

/*
 * csio_ln_read_fcf_cbfn - Read fcf parameters
 * @ln: lnode
 *
 * read fcf response and Update ln fcf information.
 */
static void
csio_ln_read_fcf_cbfn(struct csio_hw *hw, struct csio_mb *mbp)
{
        struct csio_lnode *ln = (struct csio_lnode *)mbp->priv;
        struct csio_fcf_info    *fcf_info;
        struct fw_fcoe_fcf_cmd *rsp =
                                (struct fw_fcoe_fcf_cmd *)(mbp->mb);
        enum fw_retval retval;

        retval = FW_CMD_RETVAL_G(ntohl(rsp->retval_len16));
        if (retval != FW_SUCCESS) {
                csio_ln_err(ln, "FCOE FCF cmd failed with ret x%x\n",
                                retval);
                mempool_free(mbp, hw->mb_mempool);
                return;
        }

        spin_lock_irq(&hw->lock);
        fcf_info = ln->fcfinfo;
        fcf_info->priority = FW_FCOE_FCF_CMD_PRIORITY_GET(
                                        ntohs(rsp->priority_pkd));
        fcf_info->vf_id = ntohs(rsp->vf_id);
        fcf_info->vlan_id = rsp->vlan_id;
        fcf_info->max_fcoe_size = ntohs(rsp->max_fcoe_size);
        fcf_info->fka_adv = be32_to_cpu(rsp->fka_adv);
        fcf_info->fcfi = FW_FCOE_FCF_CMD_FCFI_GET(ntohl(rsp->op_to_fcfi));
        fcf_info->fpma = FW_FCOE_FCF_CMD_FPMA_GET(rsp->fpma_to_portid);
        fcf_info->spma = FW_FCOE_FCF_CMD_SPMA_GET(rsp->fpma_to_portid);
        fcf_info->login = FW_FCOE_FCF_CMD_LOGIN_GET(rsp->fpma_to_portid);
        fcf_info->portid = FW_FCOE_FCF_CMD_PORTID_GET(rsp->fpma_to_portid);
        memcpy(fcf_info->fc_map, rsp->fc_map, sizeof(fcf_info->fc_map));
        memcpy(fcf_info->mac, rsp->mac, sizeof(fcf_info->mac));
        memcpy(fcf_info->name_id, rsp->name_id, sizeof(fcf_info->name_id));
        memcpy(fcf_info->fabric, rsp->fabric, sizeof(fcf_info->fabric));
        memcpy(fcf_info->spma_mac, rsp->spma_mac, sizeof(fcf_info->spma_mac));

        spin_unlock_irq(&hw->lock);

        mempool_free(mbp, hw->mb_mempool);
}

/*
 * csio_ln_read_fcf_entry - Read fcf entry.
 * @ln: lnode
 * @cbfn: Completion handler.
 *
 * Issued with lock held.
 */
static int
csio_ln_read_fcf_entry(struct csio_lnode *ln,
                        void (*cbfn) (struct csio_hw *, struct csio_mb *))
{
        struct csio_hw *hw = ln->hwp;
        struct csio_mb  *mbp;

        mbp = mempool_alloc(hw->mb_mempool, GFP_ATOMIC);
        if (!mbp) {
                CSIO_INC_STATS(hw, n_err_nomem);
                return -ENOMEM;
        }

        /* Get FCoE FCF information */
        csio_fcoe_read_fcf_init_mb(ln, mbp, CSIO_MB_DEFAULT_TMO,
                                      ln->portid, ln->fcf_flowid, cbfn);

        if (csio_mb_issue(hw, mbp)) {
                csio_err(hw, "failed to issue FCOE FCF cmd\n");
                mempool_free(mbp, hw->mb_mempool);
                return -EINVAL;
        }

        return 0;
}

/*
 * csio_handle_link_up - Logical Linkup event.
 * @hw - HW module.
 * @portid - Physical port number
 * @fcfi - FCF index.
 * @vnpi - VNP index.
 * Returns - none.
 *
 * This event is received from FW, when virtual link is established between
 * Physical port[ENode] and FCF. If its new vnpi, then local node object is
 * created on this FCF and set to [ONLINE] state.
 * Lnode waits for FW_RDEV_CMD event to be received indicating that
 * Fabric login is completed and lnode moves to [READY] state.
 *
 * This called with hw lock held
 */
static void
csio_handle_link_up(struct csio_hw *hw, uint8_t portid, uint32_t fcfi,
                    uint32_t vnpi)
{
        struct csio_lnode *ln = NULL;

        /* Lookup lnode based on vnpi */
        ln = csio_ln_lookup_by_vnpi(hw, vnpi);
        if (!ln) {
                /* Pick lnode based on portid */
                ln = csio_ln_lookup_by_portid(hw, portid);
                if (!ln) {
                        csio_err(hw, "failed to lookup fcoe lnode on port:%d\n",
                                portid);
                        CSIO_DB_ASSERT(0);
                        return;
                }

                /* Check if lnode has valid vnp flowid */
                if (ln->vnp_flowid != CSIO_INVALID_IDX) {
                        /* New VN-Port */
                        spin_unlock_irq(&hw->lock);
                        csio_lnode_alloc(hw);
                        spin_lock_irq(&hw->lock);
                        if (!ln) {
                                csio_err(hw,
                                         "failed to allocate fcoe lnode"
                                         "for port:%d vnpi:x%x\n",
                                         portid, vnpi);
                                CSIO_DB_ASSERT(0);
                                return;
                        }
                        ln->portid = portid;
                }
                ln->vnp_flowid = vnpi;
                ln->dev_num &= ~0xFFFF;
                ln->dev_num |= vnpi;
        }

        /*Initialize fcfi */
        ln->fcf_flowid = fcfi;

        csio_info(hw, "Port:%d - FCOE LINK UP\n", portid);

        CSIO_INC_STATS(ln, n_link_up);

        /* Send LINKUP event to SM */
        csio_post_event(&ln->sm, CSIO_LNE_LINKUP);
}

/*
 * csio_post_event_rns
 * @ln - FCOE lnode
 * @evt - Given rnode event
 * Returns - none
 *
 * Posts given rnode event to all FCOE rnodes connected with given Lnode.
 * This routine is invoked when lnode receives LINK_DOWN/DOWN_LINK/CLOSE
 * event.
 *
 * This called with hw lock held
 */
static void
csio_post_event_rns(struct csio_lnode *ln, enum csio_rn_ev evt)
{
        struct csio_rnode *rnhead = (struct csio_rnode *) &ln->rnhead;
        struct list_head *tmp, *next;
        struct csio_rnode *rn;

        list_for_each_safe(tmp, next, &rnhead->sm.sm_list) {
                rn = (struct csio_rnode *) tmp;
                csio_post_event(&rn->sm, evt);
        }
}

/*
 * csio_cleanup_rns
 * @ln - FCOE lnode
 * Returns - none
 *
 * Frees all FCOE rnodes connected with given Lnode.
 *
 * This called with hw lock held
 */
static void
csio_cleanup_rns(struct csio_lnode *ln)
{
        struct csio_rnode *rnhead = (struct csio_rnode *) &ln->rnhead;
        struct list_head *tmp, *next_rn;
        struct csio_rnode *rn;

        list_for_each_safe(tmp, next_rn, &rnhead->sm.sm_list) {
                rn = (struct csio_rnode *) tmp;
                csio_put_rnode(ln, rn);
        }

}

/*
 * csio_post_event_lns
 * @ln - FCOE lnode
 * @evt - Given lnode event
 * Returns - none
 *
 * Posts given lnode event to all FCOE lnodes connected with given Lnode.
 * This routine is invoked when lnode receives LINK_DOWN/DOWN_LINK/CLOSE
 * event.
 *
 * This called with hw lock held
 */
static void
csio_post_event_lns(struct csio_lnode *ln, enum csio_ln_ev evt)
{
        struct list_head *tmp;
        struct csio_lnode *cln, *sln;

        /* If NPIV lnode, send evt only to that and return */
        if (csio_is_npiv_ln(ln)) {
                csio_post_event(&ln->sm, evt);
                return;
        }

        sln = ln;
        /* Traverse children lnodes list and send evt */
        list_for_each(tmp, &sln->cln_head) {
                cln = (struct csio_lnode *) tmp;
                csio_post_event(&cln->sm, evt);
        }

        /* Send evt to parent lnode */
        csio_post_event(&ln->sm, evt);
}

/*
 * csio_ln_down - Lcoal nport is down
 * @ln - FCOE Lnode
 * Returns - none
 *
 * Sends LINK_DOWN events to Lnode and its associated NPIVs lnodes.
 *
 * This called with hw lock held
 */
static void
csio_ln_down(struct csio_lnode *ln)
{
        csio_post_event_lns(ln, CSIO_LNE_LINK_DOWN);
}

/*
 * csio_handle_link_down - Logical Linkdown event.
 * @hw - HW module.
 * @portid - Physical port number
 * @fcfi - FCF index.
 * @vnpi - VNP index.
 * Returns - none
 *
 * This event is received from FW, when virtual link goes down between
 * Physical port[ENode] and FCF. Lnode and its associated NPIVs lnode hosted on
 * this vnpi[VN-Port] will be de-instantiated.
 *
 * This called with hw lock held
 */
static void
csio_handle_link_down(struct csio_hw *hw, uint8_t portid, uint32_t fcfi,
                      uint32_t vnpi)
{
        struct csio_fcf_info *fp;
        struct csio_lnode *ln;

        /* Lookup lnode based on vnpi */
        ln = csio_ln_lookup_by_vnpi(hw, vnpi);
        if (ln) {
                fp = ln->fcfinfo;
                CSIO_INC_STATS(ln, n_link_down);

                /*Warn if linkdown received if lnode is not in ready state */
                if (!csio_is_lnode_ready(ln)) {
                        csio_ln_warn(ln,
                                "warn: FCOE link is already in offline "
                                "Ignoring Fcoe linkdown event on portid %d\n",
                                 portid);
                        CSIO_INC_STATS(ln, n_evt_drop);
                        return;
                }

                /* Verify portid */
                if (fp->portid != portid) {
                        csio_ln_warn(ln,
                                "warn: FCOE linkdown recv with "
                                "invalid port %d\n", portid);
                        CSIO_INC_STATS(ln, n_evt_drop);
                        return;
                }

                /* verify fcfi */
                if (ln->fcf_flowid != fcfi) {
                        csio_ln_warn(ln,
                                "warn: FCOE linkdown recv with "
                                "invalid fcfi x%x\n", fcfi);
                        CSIO_INC_STATS(ln, n_evt_drop);
                        return;
                }

                csio_info(hw, "Port:%d - FCOE LINK DOWN\n", portid);

                /* Send LINK_DOWN event to lnode s/m */
                csio_ln_down(ln);

                return;
        } else {
                csio_warn(hw,
                          "warn: FCOE linkdown recv with invalid vnpi x%x\n",
                          vnpi);
                CSIO_INC_STATS(hw, n_evt_drop);
        }
}

/*
 * csio_is_lnode_ready - Checks FCOE lnode is in ready state.
 * @ln: Lnode module
 *
 * Returns True if FCOE lnode is in ready state.
 */
int
csio_is_lnode_ready(struct csio_lnode *ln)
{
        return (csio_get_state(ln) == csio_lns_ready);
}

/*****************************************************************************/
/* START: Lnode SM                                                           */
/*****************************************************************************/
/*
 * csio_lns_uninit - The request in uninit state.
 * @ln - FCOE lnode.
 * @evt - Event to be processed.
 *
 * Process the given lnode event which is currently in "uninit" state.
 * Invoked with HW lock held.
 * Return - none.
 */
static void
csio_lns_uninit(struct csio_lnode *ln, enum csio_ln_ev evt)
{
        struct csio_hw *hw = csio_lnode_to_hw(ln);
        struct csio_lnode *rln = hw->rln;
        int rv;

        CSIO_INC_STATS(ln, n_evt_sm[evt]);
        switch (evt) {
        case CSIO_LNE_LINKUP:
                csio_set_state(&ln->sm, csio_lns_online);
                /* Read FCF only for physical lnode */
                if (csio_is_phys_ln(ln)) {
                        rv = csio_ln_read_fcf_entry(ln,
                                        csio_ln_read_fcf_cbfn);
                        if (rv != 0) {
                                /* TODO: Send HW RESET event */
                                CSIO_INC_STATS(ln, n_err);
                                break;
                        }

                        /* Add FCF record */
                        list_add_tail(&ln->fcfinfo->list, &rln->fcf_lsthead);
                }

                rv = csio_ln_vnp_read(ln, csio_ln_vnp_read_cbfn);
                if (rv != 0) {
                        /* TODO: Send HW RESET event */
                        CSIO_INC_STATS(ln, n_err);
                }
                break;

        case CSIO_LNE_DOWN_LINK:
                break;

        default:
                csio_ln_dbg(ln,
                            "unexp ln event %d recv from did:x%x in "
                            "ln state[uninit].\n", evt, ln->nport_id);
                CSIO_INC_STATS(ln, n_evt_unexp);
                break;
        } /* switch event */
}

/*
 * csio_lns_online - The request in online state.
 * @ln - FCOE lnode.
 * @evt - Event to be processed.
 *
 * Process the given lnode event which is currently in "online" state.
 * Invoked with HW lock held.
 * Return - none.
 */
static void
csio_lns_online(struct csio_lnode *ln, enum csio_ln_ev evt)
{
        struct csio_hw *hw = csio_lnode_to_hw(ln);

        CSIO_INC_STATS(ln, n_evt_sm[evt]);
        switch (evt) {
        case CSIO_LNE_LINKUP:
                csio_ln_warn(ln,
                             "warn: FCOE link is up already "
                             "Ignoring linkup on port:%d\n", ln->portid);
                CSIO_INC_STATS(ln, n_evt_drop);
                break;

        case CSIO_LNE_FAB_INIT_DONE:
                csio_set_state(&ln->sm, csio_lns_ready);

                spin_unlock_irq(&hw->lock);
                csio_lnode_async_event(ln, CSIO_LN_FC_LINKUP);
                spin_lock_irq(&hw->lock);

                break;

        case CSIO_LNE_LINK_DOWN:
        case CSIO_LNE_DOWN_LINK:
                csio_set_state(&ln->sm, csio_lns_uninit);
                if (csio_is_phys_ln(ln)) {
                        /* Remove FCF entry */
                        list_del_init(&ln->fcfinfo->list);
                }
                break;

        default:
                csio_ln_dbg(ln,
                            "unexp ln event %d recv from did:x%x in "
                            "ln state[uninit].\n", evt, ln->nport_id);
                CSIO_INC_STATS(ln, n_evt_unexp);

                break;
        } /* switch event */
}

/*
 * csio_lns_ready - The request in ready state.
 * @ln - FCOE lnode.
 * @evt - Event to be processed.
 *
 * Process the given lnode event which is currently in "ready" state.
 * Invoked with HW lock held.
 * Return - none.
 */
static void
csio_lns_ready(struct csio_lnode *ln, enum csio_ln_ev evt)
{
        struct csio_hw *hw = csio_lnode_to_hw(ln);

        CSIO_INC_STATS(ln, n_evt_sm[evt]);
        switch (evt) {
        case CSIO_LNE_FAB_INIT_DONE:
                csio_ln_dbg(ln,
                            "ignoring event %d recv from did x%x"
                            "in ln state[ready].\n", evt, ln->nport_id);
                CSIO_INC_STATS(ln, n_evt_drop);
                break;

        case CSIO_LNE_LINK_DOWN:
                csio_set_state(&ln->sm, csio_lns_offline);
                csio_post_event_rns(ln, CSIO_RNFE_DOWN);

                spin_unlock_irq(&hw->lock);
                csio_lnode_async_event(ln, CSIO_LN_FC_LINKDOWN);
                spin_lock_irq(&hw->lock);

                if (csio_is_phys_ln(ln)) {
                        /* Remove FCF entry */
                        list_del_init(&ln->fcfinfo->list);
                }
                break;

        case CSIO_LNE_DOWN_LINK:
                csio_set_state(&ln->sm, csio_lns_offline);
                csio_post_event_rns(ln, CSIO_RNFE_DOWN);

                /* Host need to issue aborts in case if FW has not returned
                 * WRs with status "ABORTED"
                 */
                spin_unlock_irq(&hw->lock);
                csio_lnode_async_event(ln, CSIO_LN_FC_LINKDOWN);
                spin_lock_irq(&hw->lock);

                if (csio_is_phys_ln(ln)) {
                        /* Remove FCF entry */
                        list_del_init(&ln->fcfinfo->list);
                }
                break;

        case CSIO_LNE_CLOSE:
                csio_set_state(&ln->sm, csio_lns_uninit);
                csio_post_event_rns(ln, CSIO_RNFE_CLOSE);
                break;

        case CSIO_LNE_LOGO:
                csio_set_state(&ln->sm, csio_lns_offline);
                csio_post_event_rns(ln, CSIO_RNFE_DOWN);
                break;

        default:
                csio_ln_dbg(ln,
                            "unexp ln event %d recv from did:x%x in "
                            "ln state[uninit].\n", evt, ln->nport_id);
                CSIO_INC_STATS(ln, n_evt_unexp);
                CSIO_DB_ASSERT(0);
                break;
        } /* switch event */
}

/*
 * csio_lns_offline - The request in offline state.
 * @ln - FCOE lnode.
 * @evt - Event to be processed.
 *
 * Process the given lnode event which is currently in "offline" state.
 * Invoked with HW lock held.
 * Return - none.
 */
static void
csio_lns_offline(struct csio_lnode *ln, enum csio_ln_ev evt)
{
        struct csio_hw *hw = csio_lnode_to_hw(ln);
        struct csio_lnode *rln = hw->rln;
        int rv;

        CSIO_INC_STATS(ln, n_evt_sm[evt]);
        switch (evt) {
        case CSIO_LNE_LINKUP:
                csio_set_state(&ln->sm, csio_lns_online);
                /* Read FCF only for physical lnode */
                if (csio_is_phys_ln(ln)) {
                        rv = csio_ln_read_fcf_entry(ln,
                                        csio_ln_read_fcf_cbfn);
                        if (rv != 0) {
                                /* TODO: Send HW RESET event */
                                CSIO_INC_STATS(ln, n_err);
                                break;
                        }

                        /* Add FCF record */
                        list_add_tail(&ln->fcfinfo->list, &rln->fcf_lsthead);
                }

                rv = csio_ln_vnp_read(ln, csio_ln_vnp_read_cbfn);
                if (rv != 0) {
                        /* TODO: Send HW RESET event */
                        CSIO_INC_STATS(ln, n_err);
                }
                break;

        case CSIO_LNE_LINK_DOWN:
        case CSIO_LNE_DOWN_LINK:
        case CSIO_LNE_LOGO:
                csio_ln_dbg(ln,
                            "ignoring event %d recv from did x%x"
                            "in ln state[offline].\n", evt, ln->nport_id);
                CSIO_INC_STATS(ln, n_evt_drop);
                break;

        case CSIO_LNE_CLOSE:
                csio_set_state(&ln->sm, csio_lns_uninit);
                csio_post_event_rns(ln, CSIO_RNFE_CLOSE);
                break;

        default:
                csio_ln_dbg(ln,
                            "unexp ln event %d recv from did:x%x in "
                            "ln state[offline]\n", evt, ln->nport_id);
                CSIO_INC_STATS(ln, n_evt_unexp);
                CSIO_DB_ASSERT(0);
                break;
        } /* switch event */
}

/*****************************************************************************/
/* END: Lnode SM                                                             */
/*****************************************************************************/

static void
csio_free_fcfinfo(struct kref *kref)
{
        struct csio_fcf_info *fcfinfo = container_of(kref,
                                                struct csio_fcf_info, kref);
        kfree(fcfinfo);
}

/* Helper routines for attributes  */
/*
 * csio_lnode_state_to_str - Get current state of FCOE lnode.
 * @ln - lnode
 * @str - state of lnode.
 *
 */
void
csio_lnode_state_to_str(struct csio_lnode *ln, int8_t *str)
{
        if (csio_get_state(ln) == csio_lns_uninit) {
                strcpy(str, "UNINIT");
                return;
        }
        if (csio_get_state(ln) == csio_lns_ready) {
                strcpy(str, "READY");
                return;
        }
        if (csio_get_state(ln) == csio_lns_offline) {
                strcpy(str, "OFFLINE");
                return;
        }
        strcpy(str, "UNKNOWN");
} /* csio_lnode_state_to_str */


int
csio_get_phy_port_stats(struct csio_hw *hw, uint8_t portid,
                        struct fw_fcoe_port_stats *port_stats)
{
        struct csio_mb  *mbp;
        struct fw_fcoe_port_cmd_params portparams;
        enum fw_retval retval;
        int idx;

        mbp = mempool_alloc(hw->mb_mempool, GFP_ATOMIC);
        if (!mbp) {
                csio_err(hw, "FCoE FCF PARAMS command out of memory!\n");
                return -EINVAL;
        }
        portparams.portid = portid;

        for (idx = 1; idx <= 3; idx++) {
                portparams.idx = (idx-1)*6 + 1;
                portparams.nstats = 6;
                if (idx == 3)
                        portparams.nstats = 4;
                csio_fcoe_read_portparams_init_mb(hw, mbp, CSIO_MB_DEFAULT_TMO,
                                                        &portparams, NULL);
                if (csio_mb_issue(hw, mbp)) {
                        csio_err(hw, "Issue of FCoE port params failed!\n");
                        mempool_free(mbp, hw->mb_mempool);
                        return -EINVAL;
                }
                csio_mb_process_portparams_rsp(hw, mbp, &retval,
                                                &portparams, port_stats);
        }

        mempool_free(mbp, hw->mb_mempool);
        return 0;
}

/*
 * csio_ln_mgmt_wr_handler -Mgmt Work Request handler.
 * @wr - WR.
 * @len - WR len.
 * This handler is invoked when an outstanding mgmt WR is completed.
 * Its invoked in the context of FW event worker thread for every
 * mgmt event received.
 * Return - none.
 */

static void
csio_ln_mgmt_wr_handler(struct csio_hw *hw, void *wr, uint32_t len)
{
        struct csio_mgmtm *mgmtm = csio_hw_to_mgmtm(hw);
        struct csio_ioreq *io_req = NULL;
        struct fw_fcoe_els_ct_wr *wr_cmd;


        wr_cmd = (struct fw_fcoe_els_ct_wr *) wr;

        if (len < sizeof(struct fw_fcoe_els_ct_wr)) {
                csio_err(mgmtm->hw,
                         "Invalid ELS CT WR length recvd, len:%x\n", len);
                mgmtm->stats.n_err++;
                return;
        }

        io_req = (struct csio_ioreq *) ((uintptr_t) wr_cmd->cookie);
        io_req->wr_status = csio_wr_status(wr_cmd);

        /* lookup ioreq exists in our active Q */
        spin_lock_irq(&hw->lock);
        if (csio_mgmt_req_lookup(mgmtm, io_req) != 0) {
                csio_err(mgmtm->hw,
                        "Error- Invalid IO handle recv in WR. handle: %p\n",
                        io_req);
                mgmtm->stats.n_err++;
                spin_unlock_irq(&hw->lock);
                return;
        }

        mgmtm = csio_hw_to_mgmtm(hw);

        /* Dequeue from active queue */
        list_del_init(&io_req->sm.sm_list);
        mgmtm->stats.n_active--;
        spin_unlock_irq(&hw->lock);

        /* io_req will be freed by completion handler */
        if (io_req->io_cbfn)
                io_req->io_cbfn(hw, io_req);
}

/**
 * csio_fcoe_fwevt_handler - Event handler for Firmware FCoE events.
 * @hw:         HW module
 * @cpl_op:     CPL opcode
 * @cmd:        FW cmd/WR.
 *
 * Process received FCoE cmd/WR event from FW.
 */
void
csio_fcoe_fwevt_handler(struct csio_hw *hw, __u8 cpl_op, __be64 *cmd)
{
        struct csio_lnode *ln;
        struct csio_rnode *rn;
        uint8_t portid, opcode = *(uint8_t *)cmd;
        struct fw_fcoe_link_cmd *lcmd;
        struct fw_wr_hdr *wr;
        struct fw_rdev_wr *rdev_wr;
        enum fw_fcoe_link_status lstatus;
        uint32_t fcfi, rdev_flowid, vnpi;
        enum csio_ln_ev evt;

        if (cpl_op == CPL_FW6_MSG && opcode == FW_FCOE_LINK_CMD) {

                lcmd = (struct fw_fcoe_link_cmd *)cmd;
                lstatus = lcmd->lstatus;
                portid = FW_FCOE_LINK_CMD_PORTID_GET(
                                        ntohl(lcmd->op_to_portid));
                fcfi = FW_FCOE_LINK_CMD_FCFI_GET(ntohl(lcmd->sub_opcode_fcfi));
                vnpi = FW_FCOE_LINK_CMD_VNPI_GET(ntohl(lcmd->vnpi_pkd));

                if (lstatus == FCOE_LINKUP) {

                        /* HW lock here */
                        spin_lock_irq(&hw->lock);
                        csio_handle_link_up(hw, portid, fcfi, vnpi);
                        spin_unlock_irq(&hw->lock);
                        /* HW un lock here */

                } else if (lstatus == FCOE_LINKDOWN) {

                        /* HW lock here */
                        spin_lock_irq(&hw->lock);
                        csio_handle_link_down(hw, portid, fcfi, vnpi);
                        spin_unlock_irq(&hw->lock);
                        /* HW un lock here */
                } else {
                        csio_warn(hw, "Unexpected FCOE LINK status:0x%x\n",
                                  lcmd->lstatus);
                        CSIO_INC_STATS(hw, n_cpl_unexp);
                }
        } else if (cpl_op == CPL_FW6_PLD) {
                wr = (struct fw_wr_hdr *) (cmd + 4);
                if (FW_WR_OP_G(be32_to_cpu(wr->hi))
                        == FW_RDEV_WR) {

                        rdev_wr = (struct fw_rdev_wr *) (cmd + 4);

                        rdev_flowid = FW_RDEV_WR_FLOWID_GET(
                                        ntohl(rdev_wr->alloc_to_len16));
                        vnpi = FW_RDEV_WR_ASSOC_FLOWID_GET(
                                    ntohl(rdev_wr->flags_to_assoc_flowid));

                        csio_dbg(hw,
                                "FW_RDEV_WR: flowid:x%x ev_cause:x%x "
                                "vnpi:0x%x\n", rdev_flowid,
                                rdev_wr->event_cause, vnpi);

                        if (rdev_wr->protocol != PROT_FCOE) {
                                csio_err(hw,
                                        "FW_RDEV_WR: invalid proto:x%x "
                                        "received with flowid:x%x\n",
                                        rdev_wr->protocol,
                                        rdev_flowid);
                                CSIO_INC_STATS(hw, n_evt_drop);
                                return;
                        }

                        /* HW lock here */
                        spin_lock_irq(&hw->lock);
                        ln = csio_ln_lookup_by_vnpi(hw, vnpi);
                        if (!ln) {
                                csio_err(hw,
                                        "FW_DEV_WR: invalid vnpi:x%x received "
                                        "with flowid:x%x\n", vnpi, rdev_flowid);
                                CSIO_INC_STATS(hw, n_evt_drop);
                                goto out_pld;
                        }

                        rn = csio_confirm_rnode(ln, rdev_flowid,
                                        &rdev_wr->u.fcoe_rdev);
                        if (!rn) {
                                csio_ln_dbg(ln,
                                        "Failed to confirm rnode "
                                        "for flowid:x%x\n", rdev_flowid);
                                CSIO_INC_STATS(hw, n_evt_drop);
                                goto out_pld;
                        }

                        /* save previous event for debugging */
                        ln->prev_evt = ln->cur_evt;
                        ln->cur_evt = rdev_wr->event_cause;
                        CSIO_INC_STATS(ln, n_evt_fw[rdev_wr->event_cause]);

                        /* Translate all the fabric events to lnode SM events */
                        evt = CSIO_FWE_TO_LNE(rdev_wr->event_cause);
                        if (evt) {
                                csio_ln_dbg(ln,
                                        "Posting event to lnode event:%d "
                                        "cause:%d flowid:x%x\n", evt,
                                        rdev_wr->event_cause, rdev_flowid);
                                csio_post_event(&ln->sm, evt);
                        }

                        /* Handover event to rn SM here. */
                        csio_rnode_fwevt_handler(rn, rdev_wr->event_cause);
out_pld:
                        spin_unlock_irq(&hw->lock);
                        return;
                } else {
                        csio_warn(hw, "unexpected WR op(0x%x) recv\n",
                                  FW_WR_OP_G(be32_to_cpu((wr->hi))));
                        CSIO_INC_STATS(hw, n_cpl_unexp);
                }
        } else if (cpl_op == CPL_FW6_MSG) {
                wr = (struct fw_wr_hdr *) (cmd);
                if (FW_WR_OP_G(be32_to_cpu(wr->hi)) == FW_FCOE_ELS_CT_WR) {
                        csio_ln_mgmt_wr_handler(hw, wr,
                                        sizeof(struct fw_fcoe_els_ct_wr));
                } else {
                        csio_warn(hw, "unexpected WR op(0x%x) recv\n",
                                  FW_WR_OP_G(be32_to_cpu((wr->hi))));
                        CSIO_INC_STATS(hw, n_cpl_unexp);
                }
        } else {
                csio_warn(hw, "unexpected CPL op(0x%x) recv\n", opcode);
                CSIO_INC_STATS(hw, n_cpl_unexp);
        }
}

/**
 * csio_lnode_start - Kickstart lnode discovery.
 * @ln:         lnode
 *
 * This routine kickstarts the discovery by issuing an FCOE_LINK (up) command.
 */
int
csio_lnode_start(struct csio_lnode *ln)
{
        int rv = 0;
        if (csio_is_phys_ln(ln) && !(ln->flags & CSIO_LNF_LINK_ENABLE)) {
                rv = csio_fcoe_enable_link(ln, 1);
                ln->flags |= CSIO_LNF_LINK_ENABLE;
        }

        return rv;
}

/**
 * csio_lnode_stop - Stop the lnode.
 * @ln:         lnode
 *
 * This routine is invoked by HW module to stop lnode and its associated NPIV
 * lnodes.
 */
void
csio_lnode_stop(struct csio_lnode *ln)
{
        csio_post_event_lns(ln, CSIO_LNE_DOWN_LINK);
        if (csio_is_phys_ln(ln) && (ln->flags & CSIO_LNF_LINK_ENABLE)) {
                csio_fcoe_enable_link(ln, 0);
                ln->flags &= ~CSIO_LNF_LINK_ENABLE;
        }
        csio_ln_dbg(ln, "stopping ln :%p\n", ln);
}

/**
 * csio_lnode_close - Close an lnode.
 * @ln:         lnode
 *
 * This routine is invoked by HW module to close an lnode and its
 * associated NPIV lnodes. Lnode and its associated NPIV lnodes are
 * set to uninitialized state.
 */
void
csio_lnode_close(struct csio_lnode *ln)
{
        csio_post_event_lns(ln, CSIO_LNE_CLOSE);
        if (csio_is_phys_ln(ln))
                ln->vnp_flowid = CSIO_INVALID_IDX;

        csio_ln_dbg(ln, "closed ln :%p\n", ln);
}

/*
 * csio_ln_prep_ecwr - Prepare ELS/CT WR.
 * @io_req - IO request.
 * @wr_len - WR len
 * @immd_len - WR immediate data
 * @sub_op - Sub opcode
 * @sid - source portid.
 * @did - destination portid
 * @flow_id - flowid
 * @fw_wr - ELS/CT WR to be prepared.
 * Returns: 0 - on success
 */
static int
csio_ln_prep_ecwr(struct csio_ioreq *io_req, uint32_t wr_len,
                      uint32_t immd_len, uint8_t sub_op, uint32_t sid,
                      uint32_t did, uint32_t flow_id, uint8_t *fw_wr)
{
        struct fw_fcoe_els_ct_wr *wr;
        __be32 port_id;

        wr  = (struct fw_fcoe_els_ct_wr *)fw_wr;
        wr->op_immdlen = cpu_to_be32(FW_WR_OP_V(FW_FCOE_ELS_CT_WR) |
                                     FW_FCOE_ELS_CT_WR_IMMDLEN(immd_len));

        wr_len =  DIV_ROUND_UP(wr_len, 16);
        wr->flowid_len16 = cpu_to_be32(FW_WR_FLOWID_V(flow_id) |
                                       FW_WR_LEN16_V(wr_len));
        wr->els_ct_type = sub_op;
        wr->ctl_pri = 0;
        wr->cp_en_class = 0;
        wr->cookie = io_req->fw_handle;
        wr->iqid = cpu_to_be16(csio_q_physiqid(
                                        io_req->lnode->hwp, io_req->iq_idx));
        wr->fl_to_sp =  FW_FCOE_ELS_CT_WR_SP(1);
        wr->tmo_val = (uint8_t) io_req->tmo;
        port_id = htonl(sid);
        memcpy(wr->l_id, PORT_ID_PTR(port_id), 3);
        port_id = htonl(did);
        memcpy(wr->r_id, PORT_ID_PTR(port_id), 3);

        /* Prepare RSP SGL */
        wr->rsp_dmalen = cpu_to_be32(io_req->dma_buf.len);
        wr->rsp_dmaaddr = cpu_to_be64(io_req->dma_buf.paddr);
        return 0;
}

/*
 * csio_ln_mgmt_submit_wr - Post elsct work request.
 * @mgmtm - mgmtm
 * @io_req - io request.
 * @sub_op - ELS or CT request type
 * @pld - Dma Payload buffer
 * @pld_len - Payload len
 * Prepares ELSCT Work request and sents it to FW.
 * Returns: 0 - on success
 */
static int
csio_ln_mgmt_submit_wr(struct csio_mgmtm *mgmtm, struct csio_ioreq *io_req,
                uint8_t sub_op, struct csio_dma_buf *pld,
                uint32_t pld_len)
{
        struct csio_wr_pair wrp;
        struct csio_lnode *ln = io_req->lnode;
        struct csio_rnode *rn = io_req->rnode;
        struct  csio_hw *hw = mgmtm->hw;
        uint8_t fw_wr[64];
        struct ulptx_sgl dsgl;
        uint32_t wr_size = 0;
        uint8_t im_len = 0;
        uint32_t wr_off = 0;

        int ret = 0;

        /* Calculate WR Size for this ELS REQ */
        wr_size = sizeof(struct fw_fcoe_els_ct_wr);

        /* Send as immediate data if pld < 256 */
        if (pld_len < 256) {
                wr_size += ALIGN(pld_len, 8);
                im_len = (uint8_t)pld_len;
        } else
                wr_size += sizeof(struct ulptx_sgl);

        /* Roundup WR size in units of 16 bytes */
        wr_size = ALIGN(wr_size, 16);

        /* Get WR to send ELS REQ */
        ret = csio_wr_get(hw, mgmtm->eq_idx, wr_size, &wrp);
        if (ret != 0) {
                csio_err(hw, "Failed to get WR for ec_req %p ret:%d\n",
                        io_req, ret);
                return ret;
        }

        /* Prepare Generic WR used by all ELS/CT cmd */
        csio_ln_prep_ecwr(io_req, wr_size, im_len, sub_op,
                                ln->nport_id, rn->nport_id,
                                csio_rn_flowid(rn),
                                &fw_wr[0]);

        /* Copy ELS/CT WR CMD */
        csio_wr_copy_to_wrp(&fw_wr[0], &wrp, wr_off,
                        sizeof(struct fw_fcoe_els_ct_wr));
        wr_off += sizeof(struct fw_fcoe_els_ct_wr);

        /* Copy payload to Immediate section of WR */
        if (im_len)
                csio_wr_copy_to_wrp(pld->vaddr, &wrp, wr_off, im_len);
        else {
                /* Program DSGL to dma payload */
                dsgl.cmd_nsge = htonl(ULPTX_CMD_V(ULP_TX_SC_DSGL) |
                                        ULPTX_MORE_F | ULPTX_NSGE_V(1));
                dsgl.len0 = cpu_to_be32(pld_len);
                dsgl.addr0 = cpu_to_be64(pld->paddr);
                csio_wr_copy_to_wrp(&dsgl, &wrp, ALIGN(wr_off, 8),
                                   sizeof(struct ulptx_sgl));
        }

        /* Issue work request to xmit ELS/CT req to FW */
        csio_wr_issue(mgmtm->hw, mgmtm->eq_idx, false);
        return ret;
}

/*
 * csio_ln_mgmt_submit_req - Submit FCOE Mgmt request.
 * @io_req - IO Request
 * @io_cbfn - Completion handler.
 * @req_type - ELS or CT request type
 * @pld - Dma Payload buffer
 * @pld_len - Payload len
 *
 *
 * This API used submit managment ELS/CT request.
 * This called with hw lock held
 * Returns: 0 - on success
 *          -ENOMEM     - on error.
 */
static int
csio_ln_mgmt_submit_req(struct csio_ioreq *io_req,
                void (*io_cbfn) (struct csio_hw *, struct csio_ioreq *),
                enum fcoe_cmn_type req_type, struct csio_dma_buf *pld,
                uint32_t pld_len)
{
        struct csio_hw *hw = csio_lnode_to_hw(io_req->lnode);
        struct csio_mgmtm *mgmtm = csio_hw_to_mgmtm(hw);
        int rv;

        BUG_ON(pld_len > pld->len);

        io_req->io_cbfn = io_cbfn;      /* Upper layer callback handler */
        io_req->fw_handle = (uintptr_t) (io_req);
        io_req->eq_idx = mgmtm->eq_idx;
        io_req->iq_idx = mgmtm->iq_idx;

        rv = csio_ln_mgmt_submit_wr(mgmtm, io_req, req_type, pld, pld_len);
        if (rv == 0) {
                list_add_tail(&io_req->sm.sm_list, &mgmtm->active_q);
                mgmtm->stats.n_active++;
        }
        return rv;
}

/*
 * csio_ln_fdmi_init - FDMI Init entry point.
 * @ln: lnode
 */
static int
csio_ln_fdmi_init(struct csio_lnode *ln)
{
        struct csio_hw *hw = csio_lnode_to_hw(ln);
        struct csio_dma_buf     *dma_buf;

        /* Allocate MGMT request required for FDMI */
        ln->mgmt_req = kzalloc_obj(struct csio_ioreq);
        if (!ln->mgmt_req) {
                csio_ln_err(ln, "Failed to alloc ioreq for FDMI\n");
                CSIO_INC_STATS(hw, n_err_nomem);
                return -ENOMEM;
        }

        /* Allocate Dma buffers for FDMI response Payload */
        dma_buf = &ln->mgmt_req->dma_buf;
        dma_buf->len = 2048;
        dma_buf->vaddr = dma_alloc_coherent(&hw->pdev->dev, dma_buf->len,
                                                &dma_buf->paddr, GFP_KERNEL);
        if (!dma_buf->vaddr) {
                csio_err(hw, "Failed to alloc DMA buffer for FDMI!\n");
                kfree(ln->mgmt_req);
                ln->mgmt_req = NULL;
                return -ENOMEM;
        }

        ln->flags |= CSIO_LNF_FDMI_ENABLE;
        return 0;
}

/*
 * csio_ln_fdmi_exit - FDMI exit entry point.
 * @ln: lnode
 */
static int
csio_ln_fdmi_exit(struct csio_lnode *ln)
{
        struct csio_dma_buf *dma_buf;
        struct csio_hw *hw = csio_lnode_to_hw(ln);

        if (!ln->mgmt_req)
                return 0;

        dma_buf = &ln->mgmt_req->dma_buf;
        if (dma_buf->vaddr)
                dma_free_coherent(&hw->pdev->dev, dma_buf->len, dma_buf->vaddr,
                                    dma_buf->paddr);

        kfree(ln->mgmt_req);
        return 0;
}

int
csio_scan_done(struct csio_lnode *ln, unsigned long ticks,
                unsigned long time, unsigned long max_scan_ticks,
                unsigned long delta_scan_ticks)
{
        int rv = 0;

        if (time >= max_scan_ticks)
                return 1;

        if (!ln->tgt_scan_tick)
                ln->tgt_scan_tick = ticks;

        if (((ticks - ln->tgt_scan_tick) >= delta_scan_ticks)) {
                if (!ln->last_scan_ntgts)
                        ln->last_scan_ntgts = ln->n_scsi_tgts;
                else {
                        if (ln->last_scan_ntgts == ln->n_scsi_tgts)
                                return 1;

                        ln->last_scan_ntgts = ln->n_scsi_tgts;
                }
                ln->tgt_scan_tick = ticks;
        }
        return rv;
}

/*
 * csio_notify_lnodes:
 * @hw: HW module
 * @note: Notification
 *
 * Called from the HW SM to fan out notifications to the
 * Lnode SM. Since the HW SM is entered with lock held,
 * there is no need to hold locks here.
 *
 */
void
csio_notify_lnodes(struct csio_hw *hw, enum csio_ln_notify note)
{
        struct list_head *tmp;
        struct csio_lnode *ln;

        csio_dbg(hw, "Notifying all nodes of event %d\n", note);

        /* Traverse children lnodes list and send evt */
        list_for_each(tmp, &hw->sln_head) {
                ln = (struct csio_lnode *) tmp;

                switch (note) {
                case CSIO_LN_NOTIFY_HWREADY:
                        csio_lnode_start(ln);
                        break;

                case CSIO_LN_NOTIFY_HWRESET:
                case CSIO_LN_NOTIFY_HWREMOVE:
                        csio_lnode_close(ln);
                        break;

                case CSIO_LN_NOTIFY_HWSTOP:
                        csio_lnode_stop(ln);
                        break;

                default:
                        break;

                }
        }
}

/*
 * csio_disable_lnodes:
 * @hw: HW module
 * @portid:port id
 * @disable: disable/enable flag.
 * If disable=1, disables all lnode hosted on given physical port.
 * otherwise enables all the lnodes on given phsysical port.
 * This routine need to called with hw lock held.
 */
void
csio_disable_lnodes(struct csio_hw *hw, uint8_t portid, bool disable)
{
        struct list_head *tmp;
        struct csio_lnode *ln;

        csio_dbg(hw, "Notifying event to all nodes of port:%d\n", portid);

        /* Traverse sibling lnodes list and send evt */
        list_for_each(tmp, &hw->sln_head) {
                ln = (struct csio_lnode *) tmp;
                if (ln->portid != portid)
                        continue;

                if (disable)
                        csio_lnode_stop(ln);
                else
                        csio_lnode_start(ln);
        }
}

/*
 * csio_ln_init - Initialize an lnode.
 * @ln:         lnode
 *
 */
static int
csio_ln_init(struct csio_lnode *ln)
{
        int rv = -EINVAL;
        struct csio_lnode *pln;
        struct csio_hw *hw = csio_lnode_to_hw(ln);

        csio_init_state(&ln->sm, csio_lns_uninit);
        ln->vnp_flowid = CSIO_INVALID_IDX;
        ln->fcf_flowid = CSIO_INVALID_IDX;

        if (csio_is_root_ln(ln)) {

                /* This is the lnode used during initialization */

                ln->fcfinfo = kzalloc_obj(struct csio_fcf_info);
                if (!ln->fcfinfo) {
                        csio_ln_err(ln, "Failed to alloc FCF record\n");
                        CSIO_INC_STATS(hw, n_err_nomem);
                        goto err;
                }

                INIT_LIST_HEAD(&ln->fcf_lsthead);
                kref_init(&ln->fcfinfo->kref);

                if (csio_fdmi_enable && csio_ln_fdmi_init(ln))
                        goto err;

        } else { /* Either a non-root physical or a virtual lnode */

                /*
                 * THe rest is common for non-root physical and NPIV lnodes.
                 * Just get references to all other modules
                 */

                if (csio_is_npiv_ln(ln)) {
                        /* NPIV */
                        pln = csio_parent_lnode(ln);
                        kref_get(&pln->fcfinfo->kref);
                        ln->fcfinfo = pln->fcfinfo;
                } else {
                        /* Another non-root physical lnode (FCF) */
                        ln->fcfinfo = kzalloc_obj(struct csio_fcf_info);
                        if (!ln->fcfinfo) {
                                csio_ln_err(ln, "Failed to alloc FCF info\n");
                                CSIO_INC_STATS(hw, n_err_nomem);
                                goto err;
                        }

                        kref_init(&ln->fcfinfo->kref);

                        if (csio_fdmi_enable && csio_ln_fdmi_init(ln))
                                goto err;
                }

        } /* if (!csio_is_root_ln(ln)) */

        return 0;
err:
        return rv;
}

static void
csio_ln_exit(struct csio_lnode *ln)
{
        struct csio_lnode *pln;

        csio_cleanup_rns(ln);
        if (csio_is_npiv_ln(ln)) {
                pln = csio_parent_lnode(ln);
                kref_put(&pln->fcfinfo->kref, csio_free_fcfinfo);
        } else {
                kref_put(&ln->fcfinfo->kref, csio_free_fcfinfo);
                if (csio_fdmi_enable)
                        csio_ln_fdmi_exit(ln);
        }
        ln->fcfinfo = NULL;
}

/*
 * csio_lnode_init - Initialize the members of an lnode.
 * @ln:         lnode
 */
int
csio_lnode_init(struct csio_lnode *ln, struct csio_hw *hw,
                struct csio_lnode *pln)
{
        int rv = -EINVAL;

        /* Link this lnode to hw */
        csio_lnode_to_hw(ln)    = hw;

        /* Link child to parent if child lnode */
        if (pln)
                ln->pln = pln;
        else
                ln->pln = NULL;

        /* Initialize scsi_tgt and timers to zero */
        ln->n_scsi_tgts = 0;
        ln->last_scan_ntgts = 0;
        ln->tgt_scan_tick = 0;

        /* Initialize rnode list */
        INIT_LIST_HEAD(&ln->rnhead);
        INIT_LIST_HEAD(&ln->cln_head);

        /* Initialize log level for debug */
        ln->params.log_level    = hw->params.log_level;

        if (csio_ln_init(ln))
                goto err;

        /* Add lnode to list of sibling or children lnodes */
        spin_lock_irq(&hw->lock);
        list_add_tail(&ln->sm.sm_list, pln ? &pln->cln_head : &hw->sln_head);
        if (pln)
                pln->num_vports++;
        spin_unlock_irq(&hw->lock);

        hw->num_lns++;

        return 0;
err:
        csio_lnode_to_hw(ln) = NULL;
        return rv;
}

/**
 * csio_lnode_exit - De-instantiate an lnode.
 * @ln:         lnode
 *
 */
void
csio_lnode_exit(struct csio_lnode *ln)
{
        struct csio_hw *hw = csio_lnode_to_hw(ln);

        csio_ln_exit(ln);

        /* Remove this lnode from hw->sln_head */
        spin_lock_irq(&hw->lock);

        list_del_init(&ln->sm.sm_list);

        /* If it is children lnode, decrement the
         * counter in its parent lnode
         */
        if (ln->pln)
                ln->pln->num_vports--;

        /* Update root lnode pointer */
        if (list_empty(&hw->sln_head))
                hw->rln = NULL;
        else
                hw->rln = (struct csio_lnode *)csio_list_next(&hw->sln_head);

        spin_unlock_irq(&hw->lock);

        csio_lnode_to_hw(ln)    = NULL;
        hw->num_lns--;
}