]> bbs.cooldavid.org Git - net-next-2.6.git/blob - drivers/scsi/libfc/fc_disc.c
9b0a5192a965d94552396d9ccac680892c795921
[net-next-2.6.git] / drivers / scsi / libfc / fc_disc.c
1 /*
2  * Copyright(c) 2007 - 2008 Intel Corporation. All rights reserved.
3  *
4  * This program is free software; you can redistribute it and/or modify it
5  * under the terms and conditions of the GNU General Public License,
6  * version 2, as published by the Free Software Foundation.
7  *
8  * This program is distributed in the hope it will be useful, but WITHOUT
9  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
11  * more details.
12  *
13  * You should have received a copy of the GNU General Public License along with
14  * this program; if not, write to the Free Software Foundation, Inc.,
15  * 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.
16  *
17  * Maintained at www.Open-FCoE.org
18  */
19
20 /*
21  * Target Discovery
22  *
23  * This block discovers all FC-4 remote ports, including FCP initiators. It
24  * also handles RSCN events and re-discovery if necessary.
25  */
26
27 /*
28  * DISC LOCKING
29  *
30  * The disc mutex is can be locked when acquiring rport locks, but may not
31  * be held when acquiring the lport lock. Refer to fc_lport.c for more
32  * details.
33  */
34
35 #include <linux/timer.h>
36 #include <linux/err.h>
37 #include <asm/unaligned.h>
38
39 #include <scsi/fc/fc_gs.h>
40
41 #include <scsi/libfc.h>
42
43 #include "fc_libfc.h"
44
45 #define FC_DISC_RETRY_LIMIT     3       /* max retries */
46 #define FC_DISC_RETRY_DELAY     500UL   /* (msecs) delay */
47
48 static void fc_disc_gpn_ft_req(struct fc_disc *);
49 static void fc_disc_gpn_ft_resp(struct fc_seq *, struct fc_frame *, void *);
50 static void fc_disc_done(struct fc_disc *, enum fc_disc_event);
51 static void fc_disc_timeout(struct work_struct *);
52 static int fc_disc_single(struct fc_lport *, struct fc_disc_port *);
53 static void fc_disc_restart(struct fc_disc *);
54
55 /**
56  * fc_disc_stop_rports() - Delete all the remote ports associated with the lport
57  * @disc: The discovery job to stop remote ports on
58  *
59  * Locking Note: This function expects that the lport mutex is locked before
60  * calling it.
61  */
62 void fc_disc_stop_rports(struct fc_disc *disc)
63 {
64         struct fc_lport *lport;
65         struct fc_rport_priv *rdata, *next;
66
67         lport = disc->lport;
68
69         mutex_lock(&disc->disc_mutex);
70         list_for_each_entry_safe(rdata, next, &disc->rports, peers)
71                 lport->tt.rport_logoff(rdata);
72         mutex_unlock(&disc->disc_mutex);
73 }
74
75 /**
76  * fc_disc_recv_rscn_req() - Handle Registered State Change Notification (RSCN)
77  * @sp:    The sequence of the RSCN exchange
78  * @fp:    The RSCN frame
79  * @lport: The local port that the request will be sent on
80  *
81  * Locking Note: This function expects that the disc_mutex is locked
82  *               before it is called.
83  */
84 static void fc_disc_recv_rscn_req(struct fc_seq *sp, struct fc_frame *fp,
85                                   struct fc_disc *disc)
86 {
87         struct fc_lport *lport;
88         struct fc_els_rscn *rp;
89         struct fc_els_rscn_page *pp;
90         struct fc_seq_els_data rjt_data;
91         unsigned int len;
92         int redisc = 0;
93         enum fc_els_rscn_ev_qual ev_qual;
94         enum fc_els_rscn_addr_fmt fmt;
95         LIST_HEAD(disc_ports);
96         struct fc_disc_port *dp, *next;
97
98         lport = disc->lport;
99
100         FC_DISC_DBG(disc, "Received an RSCN event\n");
101
102         /* make sure the frame contains an RSCN message */
103         rp = fc_frame_payload_get(fp, sizeof(*rp));
104         if (!rp)
105                 goto reject;
106         /* make sure the page length is as expected (4 bytes) */
107         if (rp->rscn_page_len != sizeof(*pp))
108                 goto reject;
109         /* get the RSCN payload length */
110         len = ntohs(rp->rscn_plen);
111         if (len < sizeof(*rp))
112                 goto reject;
113         /* make sure the frame contains the expected payload */
114         rp = fc_frame_payload_get(fp, len);
115         if (!rp)
116                 goto reject;
117         /* payload must be a multiple of the RSCN page size */
118         len -= sizeof(*rp);
119         if (len % sizeof(*pp))
120                 goto reject;
121
122         for (pp = (void *)(rp + 1); len > 0; len -= sizeof(*pp), pp++) {
123                 ev_qual = pp->rscn_page_flags >> ELS_RSCN_EV_QUAL_BIT;
124                 ev_qual &= ELS_RSCN_EV_QUAL_MASK;
125                 fmt = pp->rscn_page_flags >> ELS_RSCN_ADDR_FMT_BIT;
126                 fmt &= ELS_RSCN_ADDR_FMT_MASK;
127                 /*
128                  * if we get an address format other than port
129                  * (area, domain, fabric), then do a full discovery
130                  */
131                 switch (fmt) {
132                 case ELS_ADDR_FMT_PORT:
133                         FC_DISC_DBG(disc, "Port address format for port "
134                                     "(%6x)\n", ntoh24(pp->rscn_fid));
135                         dp = kzalloc(sizeof(*dp), GFP_KERNEL);
136                         if (!dp) {
137                                 redisc = 1;
138                                 break;
139                         }
140                         dp->lp = lport;
141                         dp->port_id = ntoh24(pp->rscn_fid);
142                         list_add_tail(&dp->peers, &disc_ports);
143                         break;
144                 case ELS_ADDR_FMT_AREA:
145                 case ELS_ADDR_FMT_DOM:
146                 case ELS_ADDR_FMT_FAB:
147                 default:
148                         FC_DISC_DBG(disc, "Address format is (%d)\n", fmt);
149                         redisc = 1;
150                         break;
151                 }
152         }
153         lport->tt.seq_els_rsp_send(sp, ELS_LS_ACC, NULL);
154
155         /*
156          * If not doing a complete rediscovery, do GPN_ID on
157          * the individual ports mentioned in the list.
158          * If any of these get an error, do a full rediscovery.
159          * In any case, go through the list and free the entries.
160          */
161         list_for_each_entry_safe(dp, next, &disc_ports, peers) {
162                 list_del(&dp->peers);
163                 if (!redisc)
164                         redisc = fc_disc_single(lport, dp);
165                 kfree(dp);
166         }
167         if (redisc) {
168                 FC_DISC_DBG(disc, "RSCN received: rediscovering\n");
169                 fc_disc_restart(disc);
170         } else {
171                 FC_DISC_DBG(disc, "RSCN received: not rediscovering. "
172                             "redisc %d state %d in_prog %d\n",
173                             redisc, lport->state, disc->pending);
174         }
175         fc_frame_free(fp);
176         return;
177 reject:
178         FC_DISC_DBG(disc, "Received a bad RSCN frame\n");
179         rjt_data.fp = NULL;
180         rjt_data.reason = ELS_RJT_LOGIC;
181         rjt_data.explan = ELS_EXPL_NONE;
182         lport->tt.seq_els_rsp_send(sp, ELS_LS_RJT, &rjt_data);
183         fc_frame_free(fp);
184 }
185
186 /**
187  * fc_disc_recv_req() - Handle incoming requests
188  * @sp:    The sequence of the request exchange
189  * @fp:    The request frame
190  * @lport: The local port receiving the request
191  *
192  * Locking Note: This function is called from the EM and will lock
193  *               the disc_mutex before calling the handler for the
194  *               request.
195  */
196 static void fc_disc_recv_req(struct fc_seq *sp, struct fc_frame *fp,
197                              struct fc_lport *lport)
198 {
199         u8 op;
200         struct fc_disc *disc = &lport->disc;
201
202         op = fc_frame_payload_op(fp);
203         switch (op) {
204         case ELS_RSCN:
205                 mutex_lock(&disc->disc_mutex);
206                 fc_disc_recv_rscn_req(sp, fp, disc);
207                 mutex_unlock(&disc->disc_mutex);
208                 break;
209         default:
210                 FC_DISC_DBG(disc, "Received an unsupported request, "
211                             "the opcode is (%x)\n", op);
212                 break;
213         }
214 }
215
216 /**
217  * fc_disc_restart() - Restart discovery
218  * @disc: The discovery object to be restarted
219  *
220  * Locking Note: This function expects that the disc mutex
221  *               is already locked.
222  */
223 static void fc_disc_restart(struct fc_disc *disc)
224 {
225         if (!disc->disc_callback)
226                 return;
227
228         FC_DISC_DBG(disc, "Restarting discovery\n");
229
230         disc->requested = 1;
231         if (disc->pending)
232                 return;
233
234         /*
235          * Advance disc_id.  This is an arbitrary non-zero number that will
236          * match the value in the fc_rport_priv after discovery for all
237          * freshly-discovered remote ports.  Avoid wrapping to zero.
238          */
239         disc->disc_id = (disc->disc_id + 2) | 1;
240         disc->retry_count = 0;
241         fc_disc_gpn_ft_req(disc);
242 }
243
244 /**
245  * fc_disc_start() - Start discovery on a local port
246  * @lport:         The local port to have discovery started on
247  * @disc_callback: Callback function to be called when discovery is complete
248  */
249 static void fc_disc_start(void (*disc_callback)(struct fc_lport *,
250                                                 enum fc_disc_event),
251                           struct fc_lport *lport)
252 {
253         struct fc_disc *disc = &lport->disc;
254
255         /*
256          * At this point we may have a new disc job or an existing
257          * one. Either way, let's lock when we make changes to it
258          * and send the GPN_FT request.
259          */
260         mutex_lock(&disc->disc_mutex);
261         disc->disc_callback = disc_callback;
262         fc_disc_restart(disc);
263         mutex_unlock(&disc->disc_mutex);
264 }
265
266 /**
267  * fc_disc_done() - Discovery has been completed
268  * @disc:  The discovery context
269  * @event: The discovery completion status
270  *
271  * Locking Note: This function expects that the disc mutex is locked before
272  * it is called. The discovery callback is then made with the lock released,
273  * and the lock is re-taken before returning from this function
274  */
275 static void fc_disc_done(struct fc_disc *disc, enum fc_disc_event event)
276 {
277         struct fc_lport *lport = disc->lport;
278         struct fc_rport_priv *rdata;
279
280         FC_DISC_DBG(disc, "Discovery complete\n");
281
282         disc->pending = 0;
283         if (disc->requested) {
284                 fc_disc_restart(disc);
285                 return;
286         }
287
288         /*
289          * Go through all remote ports.  If they were found in the latest
290          * discovery, reverify or log them in.  Otherwise, log them out.
291          * Skip ports which were never discovered.  These are the dNS port
292          * and ports which were created by PLOGI.
293          */
294         list_for_each_entry(rdata, &disc->rports, peers) {
295                 if (!rdata->disc_id)
296                         continue;
297                 if (rdata->disc_id == disc->disc_id)
298                         lport->tt.rport_login(rdata);
299                 else
300                         lport->tt.rport_logoff(rdata);
301         }
302
303         mutex_unlock(&disc->disc_mutex);
304         disc->disc_callback(lport, event);
305         mutex_lock(&disc->disc_mutex);
306 }
307
308 /**
309  * fc_disc_error() - Handle error on dNS request
310  * @disc: The discovery context
311  * @fp:   The error code encoded as a frame pointer
312  */
313 static void fc_disc_error(struct fc_disc *disc, struct fc_frame *fp)
314 {
315         struct fc_lport *lport = disc->lport;
316         unsigned long delay = 0;
317
318         FC_DISC_DBG(disc, "Error %ld, retries %d/%d\n",
319                     PTR_ERR(fp), disc->retry_count,
320                     FC_DISC_RETRY_LIMIT);
321
322         if (!fp || PTR_ERR(fp) == -FC_EX_TIMEOUT) {
323                 /*
324                  * Memory allocation failure, or the exchange timed out,
325                  * retry after delay.
326                  */
327                 if (disc->retry_count < FC_DISC_RETRY_LIMIT) {
328                         /* go ahead and retry */
329                         if (!fp)
330                                 delay = msecs_to_jiffies(FC_DISC_RETRY_DELAY);
331                         else {
332                                 delay = msecs_to_jiffies(lport->e_d_tov);
333
334                                 /* timeout faster first time */
335                                 if (!disc->retry_count)
336                                         delay /= 4;
337                         }
338                         disc->retry_count++;
339                         schedule_delayed_work(&disc->disc_work, delay);
340                 } else
341                         fc_disc_done(disc, DISC_EV_FAILED);
342         }
343 }
344
345 /**
346  * fc_disc_gpn_ft_req() - Send Get Port Names by FC-4 type (GPN_FT) request
347  * @lport: The discovery context
348  *
349  * Locking Note: This function expects that the disc_mutex is locked
350  *               before it is called.
351  */
352 static void fc_disc_gpn_ft_req(struct fc_disc *disc)
353 {
354         struct fc_frame *fp;
355         struct fc_lport *lport = disc->lport;
356
357         WARN_ON(!fc_lport_test_ready(lport));
358
359         disc->pending = 1;
360         disc->requested = 0;
361
362         disc->buf_len = 0;
363         disc->seq_count = 0;
364         fp = fc_frame_alloc(lport,
365                             sizeof(struct fc_ct_hdr) +
366                             sizeof(struct fc_ns_gid_ft));
367         if (!fp)
368                 goto err;
369
370         if (lport->tt.elsct_send(lport, 0, fp,
371                                  FC_NS_GPN_FT,
372                                  fc_disc_gpn_ft_resp,
373                                  disc, 3 * lport->r_a_tov))
374                 return;
375 err:
376         fc_disc_error(disc, NULL);
377 }
378
379 /**
380  * fc_disc_gpn_ft_parse() - Parse the body of the dNS GPN_FT response.
381  * @lport: The local port the GPN_FT was received on
382  * @buf:   The GPN_FT response buffer
383  * @len:   The size of response buffer
384  *
385  * Goes through the list of IDs and names resulting from a request.
386  */
387 static int fc_disc_gpn_ft_parse(struct fc_disc *disc, void *buf, size_t len)
388 {
389         struct fc_lport *lport;
390         struct fc_gpn_ft_resp *np;
391         char *bp;
392         size_t plen;
393         size_t tlen;
394         int error = 0;
395         struct fc_rport_identifiers ids;
396         struct fc_rport_priv *rdata;
397
398         lport = disc->lport;
399         disc->seq_count++;
400
401         /*
402          * Handle partial name record left over from previous call.
403          */
404         bp = buf;
405         plen = len;
406         np = (struct fc_gpn_ft_resp *)bp;
407         tlen = disc->buf_len;
408         disc->buf_len = 0;
409         if (tlen) {
410                 WARN_ON(tlen >= sizeof(*np));
411                 plen = sizeof(*np) - tlen;
412                 WARN_ON(plen <= 0);
413                 WARN_ON(plen >= sizeof(*np));
414                 if (plen > len)
415                         plen = len;
416                 np = &disc->partial_buf;
417                 memcpy((char *)np + tlen, bp, plen);
418
419                 /*
420                  * Set bp so that the loop below will advance it to the
421                  * first valid full name element.
422                  */
423                 bp -= tlen;
424                 len += tlen;
425                 plen += tlen;
426                 disc->buf_len = (unsigned char) plen;
427                 if (plen == sizeof(*np))
428                         disc->buf_len = 0;
429         }
430
431         /*
432          * Handle full name records, including the one filled from above.
433          * Normally, np == bp and plen == len, but from the partial case above,
434          * bp, len describe the overall buffer, and np, plen describe the
435          * partial buffer, which if would usually be full now.
436          * After the first time through the loop, things return to "normal".
437          */
438         while (plen >= sizeof(*np)) {
439                 ids.port_id = ntoh24(np->fp_fid);
440                 ids.port_name = ntohll(np->fp_wwpn);
441
442                 if (ids.port_id != fc_host_port_id(lport->host) &&
443                     ids.port_name != lport->wwpn) {
444                         rdata = lport->tt.rport_create(lport, ids.port_id);
445                         if (rdata) {
446                                 rdata->ids.port_name = ids.port_name;
447                                 rdata->disc_id = disc->disc_id;
448                         } else {
449                                 printk(KERN_WARNING "libfc: Failed to allocate "
450                                        "memory for the newly discovered port "
451                                        "(%6x)\n", ids.port_id);
452                                 error = -ENOMEM;
453                         }
454                 }
455
456                 if (np->fp_flags & FC_NS_FID_LAST) {
457                         fc_disc_done(disc, DISC_EV_SUCCESS);
458                         len = 0;
459                         break;
460                 }
461                 len -= sizeof(*np);
462                 bp += sizeof(*np);
463                 np = (struct fc_gpn_ft_resp *)bp;
464                 plen = len;
465         }
466
467         /*
468          * Save any partial record at the end of the buffer for next time.
469          */
470         if (error == 0 && len > 0 && len < sizeof(*np)) {
471                 if (np != &disc->partial_buf) {
472                         FC_DISC_DBG(disc, "Partial buffer remains "
473                                     "for discovery\n");
474                         memcpy(&disc->partial_buf, np, len);
475                 }
476                 disc->buf_len = (unsigned char) len;
477         }
478         return error;
479 }
480
481 /**
482  * fc_disc_timeout() - Handler for discovery timeouts
483  * @work: Structure holding discovery context that needs to retry discovery
484  */
485 static void fc_disc_timeout(struct work_struct *work)
486 {
487         struct fc_disc *disc = container_of(work,
488                                             struct fc_disc,
489                                             disc_work.work);
490         mutex_lock(&disc->disc_mutex);
491         fc_disc_gpn_ft_req(disc);
492         mutex_unlock(&disc->disc_mutex);
493 }
494
495 /**
496  * fc_disc_gpn_ft_resp() - Handle a response frame from Get Port Names (GPN_FT)
497  * @sp:     The sequence that the GPN_FT response was received on
498  * @fp:     The GPN_FT response frame
499  * @lp_arg: The discovery context
500  *
501  * Locking Note: This function is called without disc mutex held, and
502  *               should do all its processing with the mutex held
503  */
504 static void fc_disc_gpn_ft_resp(struct fc_seq *sp, struct fc_frame *fp,
505                                 void *disc_arg)
506 {
507         struct fc_disc *disc = disc_arg;
508         struct fc_ct_hdr *cp;
509         struct fc_frame_header *fh;
510         enum fc_disc_event event = DISC_EV_NONE;
511         unsigned int seq_cnt;
512         unsigned int len;
513         int error = 0;
514
515         mutex_lock(&disc->disc_mutex);
516         FC_DISC_DBG(disc, "Received a GPN_FT response\n");
517
518         if (IS_ERR(fp)) {
519                 fc_disc_error(disc, fp);
520                 mutex_unlock(&disc->disc_mutex);
521                 return;
522         }
523
524         WARN_ON(!fc_frame_is_linear(fp));       /* buffer must be contiguous */
525         fh = fc_frame_header_get(fp);
526         len = fr_len(fp) - sizeof(*fh);
527         seq_cnt = ntohs(fh->fh_seq_cnt);
528         if (fr_sof(fp) == FC_SOF_I3 && seq_cnt == 0 && disc->seq_count == 0) {
529                 cp = fc_frame_payload_get(fp, sizeof(*cp));
530                 if (!cp) {
531                         FC_DISC_DBG(disc, "GPN_FT response too short, len %d\n",
532                                     fr_len(fp));
533                         event = DISC_EV_FAILED;
534                 } else if (ntohs(cp->ct_cmd) == FC_FS_ACC) {
535
536                         /* Accepted, parse the response. */
537                         len -= sizeof(*cp);
538                         error = fc_disc_gpn_ft_parse(disc, cp + 1, len);
539                 } else if (ntohs(cp->ct_cmd) == FC_FS_RJT) {
540                         FC_DISC_DBG(disc, "GPN_FT rejected reason %x exp %x "
541                                     "(check zoning)\n", cp->ct_reason,
542                                     cp->ct_explan);
543                         event = DISC_EV_FAILED;
544                         if (cp->ct_reason == FC_FS_RJT_UNABL &&
545                             cp->ct_explan == FC_FS_EXP_FTNR)
546                                 event = DISC_EV_SUCCESS;
547                 } else {
548                         FC_DISC_DBG(disc, "GPN_FT unexpected response code "
549                                     "%x\n", ntohs(cp->ct_cmd));
550                         event = DISC_EV_FAILED;
551                 }
552         } else if (fr_sof(fp) == FC_SOF_N3 && seq_cnt == disc->seq_count) {
553                 error = fc_disc_gpn_ft_parse(disc, fh + 1, len);
554         } else {
555                 FC_DISC_DBG(disc, "GPN_FT unexpected frame - out of sequence? "
556                             "seq_cnt %x expected %x sof %x eof %x\n",
557                             seq_cnt, disc->seq_count, fr_sof(fp), fr_eof(fp));
558                 event = DISC_EV_FAILED;
559         }
560         if (error)
561                 fc_disc_error(disc, fp);
562         else if (event != DISC_EV_NONE)
563                 fc_disc_done(disc, event);
564         fc_frame_free(fp);
565         mutex_unlock(&disc->disc_mutex);
566 }
567
568 /**
569  * fc_disc_gpn_id_resp() - Handle a response frame from Get Port Names (GPN_ID)
570  * @sp:        The sequence the GPN_ID is on
571  * @fp:        The response frame
572  * @rdata_arg: The remote port that sent the GPN_ID response
573  *
574  * Locking Note: This function is called without disc mutex held.
575  */
576 static void fc_disc_gpn_id_resp(struct fc_seq *sp, struct fc_frame *fp,
577                                 void *rdata_arg)
578 {
579         struct fc_rport_priv *rdata = rdata_arg;
580         struct fc_rport_priv *new_rdata;
581         struct fc_lport *lport;
582         struct fc_disc *disc;
583         struct fc_ct_hdr *cp;
584         struct fc_ns_gid_pn *pn;
585         u64 port_name;
586
587         lport = rdata->local_port;
588         disc = &lport->disc;
589
590         mutex_lock(&disc->disc_mutex);
591         if (PTR_ERR(fp) == -FC_EX_CLOSED)
592                 goto out;
593         if (IS_ERR(fp))
594                 goto redisc;
595
596         cp = fc_frame_payload_get(fp, sizeof(*cp));
597         if (!cp)
598                 goto redisc;
599         if (ntohs(cp->ct_cmd) == FC_FS_ACC) {
600                 if (fr_len(fp) < sizeof(struct fc_frame_header) +
601                     sizeof(*cp) + sizeof(*pn))
602                         goto redisc;
603                 pn = (struct fc_ns_gid_pn *)(cp + 1);
604                 port_name = get_unaligned_be64(&pn->fn_wwpn);
605                 if (rdata->ids.port_name == -1)
606                         rdata->ids.port_name = port_name;
607                 else if (rdata->ids.port_name != port_name) {
608                         FC_DISC_DBG(disc, "GPN_ID accepted.  WWPN changed. "
609                                     "Port-id %x wwpn %llx\n",
610                                     rdata->ids.port_id, port_name);
611                         lport->tt.rport_logoff(rdata);
612
613                         new_rdata = lport->tt.rport_create(lport,
614                                                            rdata->ids.port_id);
615                         if (new_rdata) {
616                                 new_rdata->disc_id = disc->disc_id;
617                                 lport->tt.rport_login(new_rdata);
618                         }
619                         goto out;
620                 }
621                 rdata->disc_id = disc->disc_id;
622                 lport->tt.rport_login(rdata);
623         } else if (ntohs(cp->ct_cmd) == FC_FS_RJT) {
624                 FC_DISC_DBG(disc, "GPN_ID rejected reason %x exp %x\n",
625                             cp->ct_reason, cp->ct_explan);
626                 lport->tt.rport_logoff(rdata);
627         } else {
628                 FC_DISC_DBG(disc, "GPN_ID unexpected response code %x\n",
629                             ntohs(cp->ct_cmd));
630 redisc:
631                 fc_disc_restart(disc);
632         }
633 out:
634         mutex_unlock(&disc->disc_mutex);
635         kref_put(&rdata->kref, lport->tt.rport_destroy);
636 }
637
638 /**
639  * fc_disc_gpn_id_req() - Send Get Port Names by ID (GPN_ID) request
640  * @lport: The local port to initiate discovery on
641  * @rdata: remote port private data
642  *
643  * Locking Note: This function expects that the disc_mutex is locked
644  *               before it is called.
645  * On failure, an error code is returned.
646  */
647 static int fc_disc_gpn_id_req(struct fc_lport *lport,
648                               struct fc_rport_priv *rdata)
649 {
650         struct fc_frame *fp;
651
652         fp = fc_frame_alloc(lport, sizeof(struct fc_ct_hdr) +
653                             sizeof(struct fc_ns_fid));
654         if (!fp)
655                 return -ENOMEM;
656         if (!lport->tt.elsct_send(lport, rdata->ids.port_id, fp, FC_NS_GPN_ID,
657                                   fc_disc_gpn_id_resp, rdata,
658                                   3 * lport->r_a_tov))
659                 return -ENOMEM;
660         kref_get(&rdata->kref);
661         return 0;
662 }
663
664 /**
665  * fc_disc_single() - Discover the directory information for a single target
666  * @lport: The local port the remote port is associated with
667  * @dp:    The port to rediscover
668  *
669  * Locking Note: This function expects that the disc_mutex is locked
670  *               before it is called.
671  */
672 static int fc_disc_single(struct fc_lport *lport, struct fc_disc_port *dp)
673 {
674         struct fc_rport_priv *rdata;
675
676         rdata = lport->tt.rport_create(lport, dp->port_id);
677         if (!rdata)
678                 return -ENOMEM;
679         rdata->disc_id = 0;
680         return fc_disc_gpn_id_req(lport, rdata);
681 }
682
683 /**
684  * fc_disc_stop() - Stop discovery for a given lport
685  * @lport: The local port that discovery should stop on
686  */
687 void fc_disc_stop(struct fc_lport *lport)
688 {
689         struct fc_disc *disc = &lport->disc;
690
691         if (disc) {
692                 cancel_delayed_work_sync(&disc->disc_work);
693                 fc_disc_stop_rports(disc);
694         }
695 }
696
697 /**
698  * fc_disc_stop_final() - Stop discovery for a given lport
699  * @lport: The lport that discovery should stop on
700  *
701  * This function will block until discovery has been
702  * completely stopped and all rports have been deleted.
703  */
704 void fc_disc_stop_final(struct fc_lport *lport)
705 {
706         fc_disc_stop(lport);
707         lport->tt.rport_flush_queue();
708 }
709
710 /**
711  * fc_disc_init() - Initialize the discovery layer for a local port
712  * @lport: The local port that needs the discovery layer to be initialized
713  */
714 int fc_disc_init(struct fc_lport *lport)
715 {
716         struct fc_disc *disc;
717
718         if (!lport->tt.disc_start)
719                 lport->tt.disc_start = fc_disc_start;
720
721         if (!lport->tt.disc_stop)
722                 lport->tt.disc_stop = fc_disc_stop;
723
724         if (!lport->tt.disc_stop_final)
725                 lport->tt.disc_stop_final = fc_disc_stop_final;
726
727         if (!lport->tt.disc_recv_req)
728                 lport->tt.disc_recv_req = fc_disc_recv_req;
729
730         disc = &lport->disc;
731         INIT_DELAYED_WORK(&disc->disc_work, fc_disc_timeout);
732         mutex_init(&disc->disc_mutex);
733         INIT_LIST_HEAD(&disc->rports);
734
735         disc->lport = lport;
736
737         return 0;
738 }
739 EXPORT_SYMBOL(fc_disc_init);