1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3 * Copyright(c) 2009 Intel Corporation. All rights reserved.
4 *
5 * Maintained at www.Open-FCoE.org
6 */
7
8 /*
9 * NPIV VN_Port helper functions for libfc
10 */
11
12 #include <scsi/libfc.h>
13 #include <linux/export.h>
14
15 /**
16 * libfc_vport_create() - Create a new NPIV vport instance
17 * @vport: fc_vport structure from scsi_transport_fc
18 * @privsize: driver private data size to allocate along with the Scsi_Host
19 */
20
libfc_vport_create(struct fc_vport * vport,int privsize)21 struct fc_lport *libfc_vport_create(struct fc_vport *vport, int privsize)
22 {
23 struct Scsi_Host *shost = vport_to_shost(vport);
24 struct fc_lport *n_port = shost_priv(shost);
25 struct fc_lport *vn_port;
26
27 vn_port = libfc_host_alloc(shost->hostt, privsize);
28 if (!vn_port)
29 return vn_port;
30
31 vn_port->vport = vport;
32 vport->dd_data = vn_port;
33
34 mutex_lock(&n_port->lp_mutex);
35 list_add_tail(&vn_port->list, &n_port->vports);
36 mutex_unlock(&n_port->lp_mutex);
37
38 return vn_port;
39 }
40 EXPORT_SYMBOL(libfc_vport_create);
41
42 /**
43 * fc_vport_id_lookup() - find NPIV lport that matches a given fabric ID
44 * @n_port: Top level N_Port which may have multiple NPIV VN_Ports
45 * @port_id: Fabric ID to find a match for
46 *
47 * Returns: matching lport pointer or NULL if there is no match
48 */
fc_vport_id_lookup(struct fc_lport * n_port,u32 port_id)49 struct fc_lport *fc_vport_id_lookup(struct fc_lport *n_port, u32 port_id)
50 {
51 struct fc_lport *lport = NULL;
52 struct fc_lport *vn_port;
53
54 if (n_port->port_id == port_id)
55 return n_port;
56
57 if (port_id == FC_FID_FLOGI)
58 return n_port; /* for point-to-point */
59
60 mutex_lock(&n_port->lp_mutex);
61 list_for_each_entry(vn_port, &n_port->vports, list) {
62 if (vn_port->port_id == port_id) {
63 lport = vn_port;
64 break;
65 }
66 }
67 mutex_unlock(&n_port->lp_mutex);
68
69 return lport;
70 }
71 EXPORT_SYMBOL(fc_vport_id_lookup);
72
73 /*
74 * When setting the link state of vports during an lport state change, it's
75 * necessary to hold the lp_mutex of both the N_Port and the VN_Port.
76 * This tells the lockdep engine to treat the nested locking of the VN_Port
77 * as a different lock class.
78 */
79 enum libfc_lport_mutex_class {
80 LPORT_MUTEX_NORMAL = 0,
81 LPORT_MUTEX_VN_PORT = 1,
82 };
83
84 /**
85 * __fc_vport_setlink() - update link and status on a VN_Port
86 * @n_port: parent N_Port
87 * @vn_port: VN_Port to update
88 *
89 * Locking: must be called with both the N_Port and VN_Port lp_mutex held
90 */
__fc_vport_setlink(struct fc_lport * n_port,struct fc_lport * vn_port)91 static void __fc_vport_setlink(struct fc_lport *n_port,
92 struct fc_lport *vn_port)
93 {
94 struct fc_vport *vport = vn_port->vport;
95
96 if (vn_port->state == LPORT_ST_DISABLED)
97 return;
98
99 if (n_port->state == LPORT_ST_READY) {
100 if (n_port->npiv_enabled) {
101 fc_vport_set_state(vport, FC_VPORT_INITIALIZING);
102 __fc_linkup(vn_port);
103 } else {
104 fc_vport_set_state(vport, FC_VPORT_NO_FABRIC_SUPP);
105 __fc_linkdown(vn_port);
106 }
107 } else {
108 fc_vport_set_state(vport, FC_VPORT_LINKDOWN);
109 __fc_linkdown(vn_port);
110 }
111 }
112
113 /**
114 * fc_vport_setlink() - update link and status on a VN_Port
115 * @vn_port: virtual port to update
116 */
fc_vport_setlink(struct fc_lport * vn_port)117 void fc_vport_setlink(struct fc_lport *vn_port)
118 {
119 struct fc_vport *vport = vn_port->vport;
120 struct Scsi_Host *shost = vport_to_shost(vport);
121 struct fc_lport *n_port = shost_priv(shost);
122
123 mutex_lock(&n_port->lp_mutex);
124 mutex_lock_nested(&vn_port->lp_mutex, LPORT_MUTEX_VN_PORT);
125 __fc_vport_setlink(n_port, vn_port);
126 mutex_unlock(&vn_port->lp_mutex);
127 mutex_unlock(&n_port->lp_mutex);
128 }
129 EXPORT_SYMBOL(fc_vport_setlink);
130
131 /**
132 * fc_vports_linkchange() - change the link state of all vports
133 * @n_port: Parent N_Port that has changed state
134 *
135 * Locking: called with the n_port lp_mutex held
136 */
fc_vports_linkchange(struct fc_lport * n_port)137 void fc_vports_linkchange(struct fc_lport *n_port)
138 {
139 struct fc_lport *vn_port;
140
141 list_for_each_entry(vn_port, &n_port->vports, list) {
142 mutex_lock_nested(&vn_port->lp_mutex, LPORT_MUTEX_VN_PORT);
143 __fc_vport_setlink(n_port, vn_port);
144 mutex_unlock(&vn_port->lp_mutex);
145 }
146 }
147
148