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