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 | |
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(sht: shost->hostt, priv_size: 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(new: &vn_port->list, head: &n_port->vports); |
36 | mutex_unlock(lock: &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 | */ |
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(lock: &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 | */ |
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, new_state: FC_VPORT_INITIALIZING); |
102 | __fc_linkup(vn_port); |
103 | } else { |
104 | fc_vport_set_state(vport, new_state: FC_VPORT_NO_FABRIC_SUPP); |
105 | __fc_linkdown(vn_port); |
106 | } |
107 | } else { |
108 | fc_vport_set_state(vport, new_state: 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 | */ |
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(lock: &vn_port->lp_mutex, subclass: LPORT_MUTEX_VN_PORT); |
125 | __fc_vport_setlink(n_port, vn_port); |
126 | mutex_unlock(lock: &vn_port->lp_mutex); |
127 | mutex_unlock(lock: &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 | */ |
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(lock: &vn_port->lp_mutex, subclass: LPORT_MUTEX_VN_PORT); |
143 | __fc_vport_setlink(n_port, vn_port); |
144 | mutex_unlock(lock: &vn_port->lp_mutex); |
145 | } |
146 | } |
147 | |
148 | |