4 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 2 only,
8 * as published by the Free Software Foundation.
10 * This program is distributed in the hope that it will be useful, but
11 * WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * General Public License version 2 for more details (a copy is included
14 * in the LICENSE file that accompanied this code).
16 * You should have received a copy of the GNU General Public License
17 * version 2 along with this program; If not, see
18 * http://www.gnu.org/licenses/gpl-2.0.html
23 * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
24 * Use is subject to license terms.
26 * Copyright (c) 2012, 2017, Intel Corporation.
29 * This file is part of Lustre, http://www.lustre.org/
30 * Lustre is a trademark of Sun Microsystems, Inc.
32 * lnet/lnet/lib-move.c
34 * Data movement routines
37 #define DEBUG_SUBSYSTEM S_LNET
39 #include <linux/pagemap.h>
41 #include <lnet/lib-lnet.h>
42 #include <linux/nsproxy.h>
43 #include <net/net_namespace.h>
45 static int local_nid_dist_zero = 1;
46 module_param(local_nid_dist_zero, int, 0444);
47 MODULE_PARM_DESC(local_nid_dist_zero, "Reserved");
49 struct lnet_send_data {
50 struct lnet_ni *sd_best_ni;
51 struct lnet_peer_ni *sd_best_lpni;
52 struct lnet_peer_ni *sd_final_dst_lpni;
53 struct lnet_peer *sd_peer;
54 struct lnet_peer *sd_gw_peer;
55 struct lnet_peer_ni *sd_gw_lpni;
56 struct lnet_peer_net *sd_peer_net;
57 struct lnet_msg *sd_msg;
58 lnet_nid_t sd_dst_nid;
59 lnet_nid_t sd_src_nid;
60 lnet_nid_t sd_rtr_nid;
67 lnet_msg_is_response(struct lnet_msg *msg)
69 return msg->msg_type == LNET_MSG_ACK || msg->msg_type == LNET_MSG_REPLY;
73 lnet_response_tracking_enabled(__u32 msg_type, unsigned int md_options)
75 if (md_options & LNET_MD_NO_TRACK_RESPONSE)
76 /* Explicitly disabled in MD options */
79 if (md_options & LNET_MD_TRACK_RESPONSE)
80 /* Explicity enabled in MD options */
83 if (lnet_response_tracking == 3)
84 /* Enabled for all message types */
87 if (msg_type == LNET_MSG_PUT)
88 return lnet_response_tracking == 2;
90 if (msg_type == LNET_MSG_GET)
91 return lnet_response_tracking == 1;
96 static inline struct lnet_comm_count *
97 get_stats_counts(struct lnet_element_stats *stats,
98 enum lnet_stats_type stats_type)
100 switch (stats_type) {
101 case LNET_STATS_TYPE_SEND:
102 return &stats->el_send_stats;
103 case LNET_STATS_TYPE_RECV:
104 return &stats->el_recv_stats;
105 case LNET_STATS_TYPE_DROP:
106 return &stats->el_drop_stats;
108 CERROR("Unknown stats type\n");
114 void lnet_incr_stats(struct lnet_element_stats *stats,
115 enum lnet_msg_type msg_type,
116 enum lnet_stats_type stats_type)
118 struct lnet_comm_count *counts = get_stats_counts(stats, stats_type);
124 atomic_inc(&counts->co_ack_count);
127 atomic_inc(&counts->co_put_count);
130 atomic_inc(&counts->co_get_count);
133 atomic_inc(&counts->co_reply_count);
136 atomic_inc(&counts->co_hello_count);
139 CERROR("There is a BUG in the code. Unknown message type\n");
144 __u32 lnet_sum_stats(struct lnet_element_stats *stats,
145 enum lnet_stats_type stats_type)
147 struct lnet_comm_count *counts = get_stats_counts(stats, stats_type);
151 return (atomic_read(&counts->co_ack_count) +
152 atomic_read(&counts->co_put_count) +
153 atomic_read(&counts->co_get_count) +
154 atomic_read(&counts->co_reply_count) +
155 atomic_read(&counts->co_hello_count));
158 static inline void assign_stats(struct lnet_ioctl_comm_count *msg_stats,
159 struct lnet_comm_count *counts)
161 msg_stats->ico_get_count = atomic_read(&counts->co_get_count);
162 msg_stats->ico_put_count = atomic_read(&counts->co_put_count);
163 msg_stats->ico_reply_count = atomic_read(&counts->co_reply_count);
164 msg_stats->ico_ack_count = atomic_read(&counts->co_ack_count);
165 msg_stats->ico_hello_count = atomic_read(&counts->co_hello_count);
168 void lnet_usr_translate_stats(struct lnet_ioctl_element_msg_stats *msg_stats,
169 struct lnet_element_stats *stats)
171 struct lnet_comm_count *counts;
176 counts = get_stats_counts(stats, LNET_STATS_TYPE_SEND);
179 assign_stats(&msg_stats->im_send_stats, counts);
181 counts = get_stats_counts(stats, LNET_STATS_TYPE_RECV);
184 assign_stats(&msg_stats->im_recv_stats, counts);
186 counts = get_stats_counts(stats, LNET_STATS_TYPE_DROP);
189 assign_stats(&msg_stats->im_drop_stats, counts);
193 lnet_fail_nid(lnet_nid_t nid, unsigned int threshold)
195 struct lnet_test_peer *tp;
196 struct list_head *el;
197 struct list_head *next;
200 /* NB: use lnet_net_lock(0) to serialize operations on test peers */
201 if (threshold != 0) {
202 /* Adding a new entry */
203 LIBCFS_ALLOC(tp, sizeof(*tp));
208 tp->tp_threshold = threshold;
211 list_add_tail(&tp->tp_list, &the_lnet.ln_test_peers);
218 list_for_each_safe(el, next, &the_lnet.ln_test_peers) {
219 tp = list_entry(el, struct lnet_test_peer, tp_list);
221 if (tp->tp_threshold == 0 || /* needs culling anyway */
222 nid == LNET_NID_ANY || /* removing all entries */
223 tp->tp_nid == nid) { /* matched this one */
224 list_move(&tp->tp_list, &cull);
230 while (!list_empty(&cull)) {
231 tp = list_entry(cull.next, struct lnet_test_peer, tp_list);
233 list_del(&tp->tp_list);
234 LIBCFS_FREE(tp, sizeof(*tp));
240 fail_peer (lnet_nid_t nid, int outgoing)
242 struct lnet_test_peer *tp;
243 struct list_head *el;
244 struct list_head *next;
248 /* NB: use lnet_net_lock(0) to serialize operations on test peers */
251 list_for_each_safe(el, next, &the_lnet.ln_test_peers) {
252 tp = list_entry(el, struct lnet_test_peer, tp_list);
254 if (tp->tp_threshold == 0) {
257 /* only cull zombies on outgoing tests,
258 * since we may be at interrupt priority on
259 * incoming messages. */
260 list_move(&tp->tp_list, &cull);
265 if (tp->tp_nid == LNET_NID_ANY || /* fail every peer */
266 nid == tp->tp_nid) { /* fail this peer */
269 if (tp->tp_threshold != LNET_MD_THRESH_INF) {
272 tp->tp_threshold == 0) {
274 list_move(&tp->tp_list, &cull);
283 while (!list_empty(&cull)) {
284 tp = list_entry(cull.next, struct lnet_test_peer, tp_list);
285 list_del(&tp->tp_list);
287 LIBCFS_FREE(tp, sizeof(*tp));
294 lnet_iov_nob(unsigned int niov, struct kvec *iov)
296 unsigned int nob = 0;
298 LASSERT(niov == 0 || iov != NULL);
300 nob += (iov++)->iov_len;
304 EXPORT_SYMBOL(lnet_iov_nob);
307 lnet_copy_iov2iov(unsigned int ndiov, struct kvec *diov, unsigned int doffset,
308 unsigned int nsiov, struct kvec *siov, unsigned int soffset,
311 /* NB diov, siov are READ-ONLY */
312 unsigned int this_nob;
317 /* skip complete frags before 'doffset' */
319 while (doffset >= diov->iov_len) {
320 doffset -= diov->iov_len;
326 /* skip complete frags before 'soffset' */
328 while (soffset >= siov->iov_len) {
329 soffset -= siov->iov_len;
338 this_nob = min3((unsigned int)diov->iov_len - doffset,
339 (unsigned int)siov->iov_len - soffset,
342 memcpy((char *)diov->iov_base + doffset,
343 (char *)siov->iov_base + soffset, this_nob);
346 if (diov->iov_len > doffset + this_nob) {
354 if (siov->iov_len > soffset + this_nob) {
363 EXPORT_SYMBOL(lnet_copy_iov2iov);
366 lnet_kiov_nob(unsigned int niov, struct bio_vec *kiov)
368 unsigned int nob = 0;
370 LASSERT(niov == 0 || kiov != NULL);
372 nob += (kiov++)->bv_len;
376 EXPORT_SYMBOL(lnet_kiov_nob);
379 lnet_copy_kiov2kiov(unsigned int ndiov, struct bio_vec *diov,
380 unsigned int doffset,
381 unsigned int nsiov, struct bio_vec *siov,
382 unsigned int soffset,
385 /* NB diov, siov are READ-ONLY */
386 unsigned int this_nob;
393 LASSERT (!in_interrupt ());
396 while (doffset >= diov->bv_len) {
397 doffset -= diov->bv_len;
404 while (soffset >= siov->bv_len) {
405 soffset -= siov->bv_len;
414 this_nob = min3(diov->bv_len - doffset,
415 siov->bv_len - soffset,
419 daddr = ((char *)kmap(diov->bv_page)) +
420 diov->bv_offset + doffset;
422 saddr = ((char *)kmap(siov->bv_page)) +
423 siov->bv_offset + soffset;
425 /* Vanishing risk of kmap deadlock when mapping 2 pages.
426 * However in practice at least one of the kiovs will be mapped
427 * kernel pages and the map/unmap will be NOOPs */
429 memcpy (daddr, saddr, this_nob);
432 if (diov->bv_len > doffset + this_nob) {
436 kunmap(diov->bv_page);
443 if (siov->bv_len > soffset + this_nob) {
447 kunmap(siov->bv_page);
456 kunmap(diov->bv_page);
458 kunmap(siov->bv_page);
460 EXPORT_SYMBOL(lnet_copy_kiov2kiov);
463 lnet_copy_kiov2iov (unsigned int niov, struct kvec *iov, unsigned int iovoffset,
464 unsigned int nkiov, struct bio_vec *kiov,
465 unsigned int kiovoffset,
468 /* NB iov, kiov are READ-ONLY */
469 unsigned int this_nob;
475 LASSERT (!in_interrupt ());
478 while (iovoffset >= iov->iov_len) {
479 iovoffset -= iov->iov_len;
486 while (kiovoffset >= kiov->bv_len) {
487 kiovoffset -= kiov->bv_len;
496 this_nob = min3((unsigned int)iov->iov_len - iovoffset,
497 (unsigned int)kiov->bv_len - kiovoffset,
501 addr = ((char *)kmap(kiov->bv_page)) +
502 kiov->bv_offset + kiovoffset;
504 memcpy((char *)iov->iov_base + iovoffset, addr, this_nob);
507 if (iov->iov_len > iovoffset + this_nob) {
508 iovoffset += this_nob;
515 if (kiov->bv_len > kiovoffset + this_nob) {
517 kiovoffset += this_nob;
519 kunmap(kiov->bv_page);
529 kunmap(kiov->bv_page);
531 EXPORT_SYMBOL(lnet_copy_kiov2iov);
534 lnet_copy_iov2kiov(unsigned int nkiov, struct bio_vec *kiov,
535 unsigned int kiovoffset,
536 unsigned int niov, struct kvec *iov, unsigned int iovoffset,
539 /* NB kiov, iov are READ-ONLY */
540 unsigned int this_nob;
546 LASSERT (!in_interrupt ());
549 while (kiovoffset >= kiov->bv_len) {
550 kiovoffset -= kiov->bv_len;
557 while (iovoffset >= iov->iov_len) {
558 iovoffset -= iov->iov_len;
567 this_nob = min3((unsigned int)kiov->bv_len - kiovoffset,
568 (unsigned int)iov->iov_len - iovoffset,
572 addr = ((char *)kmap(kiov->bv_page)) +
573 kiov->bv_offset + kiovoffset;
575 memcpy (addr, (char *)iov->iov_base + iovoffset, this_nob);
578 if (kiov->bv_len > kiovoffset + this_nob) {
580 kiovoffset += this_nob;
582 kunmap(kiov->bv_page);
589 if (iov->iov_len > iovoffset + this_nob) {
590 iovoffset += this_nob;
599 kunmap(kiov->bv_page);
601 EXPORT_SYMBOL(lnet_copy_iov2kiov);
604 lnet_extract_kiov(int dst_niov, struct bio_vec *dst,
605 int src_niov, struct bio_vec *src,
606 unsigned int offset, unsigned int len)
608 /* Initialise 'dst' to the subset of 'src' starting at 'offset',
609 * for exactly 'len' bytes, and return the number of entries.
610 * NB not destructive to 'src' */
611 unsigned int frag_len;
614 if (len == 0) /* no data => */
615 return (0); /* no frags */
617 LASSERT(src_niov > 0);
618 while (offset >= src->bv_len) { /* skip initial frags */
619 offset -= src->bv_len;
622 LASSERT(src_niov > 0);
627 LASSERT(src_niov > 0);
628 LASSERT((int)niov <= dst_niov);
630 frag_len = src->bv_len - offset;
631 dst->bv_page = src->bv_page;
632 dst->bv_offset = src->bv_offset + offset;
634 if (len <= frag_len) {
636 LASSERT(dst->bv_offset + dst->bv_len <= PAGE_SIZE);
640 dst->bv_len = frag_len;
641 LASSERT(dst->bv_offset + dst->bv_len <= PAGE_SIZE);
651 EXPORT_SYMBOL(lnet_extract_kiov);
654 lnet_ni_recv(struct lnet_ni *ni, void *private, struct lnet_msg *msg,
655 int delayed, unsigned int offset, unsigned int mlen,
658 unsigned int niov = 0;
659 struct kvec *iov = NULL;
660 struct bio_vec *kiov = NULL;
663 LASSERT (!in_interrupt ());
664 LASSERT (mlen == 0 || msg != NULL);
667 LASSERT(msg->msg_receiving);
668 LASSERT(!msg->msg_sending);
669 LASSERT(rlen == msg->msg_len);
670 LASSERT(mlen <= msg->msg_len);
671 LASSERT(msg->msg_offset == offset);
672 LASSERT(msg->msg_wanted == mlen);
674 msg->msg_receiving = 0;
677 niov = msg->msg_niov;
678 kiov = msg->msg_kiov;
681 LASSERT ((iov == NULL) != (kiov == NULL));
685 rc = (ni->ni_net->net_lnd->lnd_recv)(ni, private, msg, delayed,
686 niov, kiov, offset, mlen,
689 lnet_finalize(msg, rc);
693 lnet_setpayloadbuffer(struct lnet_msg *msg)
695 struct lnet_libmd *md = msg->msg_md;
697 LASSERT(msg->msg_len > 0);
698 LASSERT(!msg->msg_routing);
700 LASSERT(msg->msg_niov == 0);
701 LASSERT(msg->msg_kiov == NULL);
703 msg->msg_niov = md->md_niov;
704 msg->msg_kiov = md->md_kiov;
708 lnet_prep_send(struct lnet_msg *msg, int type, struct lnet_process_id target,
709 unsigned int offset, unsigned int len)
711 msg->msg_type = type;
712 msg->msg_target = target;
714 msg->msg_offset = offset;
717 lnet_setpayloadbuffer(msg);
719 memset (&msg->msg_hdr, 0, sizeof (msg->msg_hdr));
720 msg->msg_hdr.type = cpu_to_le32(type);
721 /* dest_nid will be overwritten by lnet_select_pathway() */
722 msg->msg_hdr.dest_nid = cpu_to_le64(target.nid);
723 msg->msg_hdr.dest_pid = cpu_to_le32(target.pid);
724 /* src_nid will be set later */
725 msg->msg_hdr.src_pid = cpu_to_le32(the_lnet.ln_pid);
726 msg->msg_hdr.payload_length = cpu_to_le32(len);
730 lnet_ni_send(struct lnet_ni *ni, struct lnet_msg *msg)
732 void *priv = msg->msg_private;
735 LASSERT(!in_interrupt());
736 LASSERT(ni->ni_nid == LNET_NID_LO_0 ||
737 (msg->msg_txcredit && msg->msg_peertxcredit));
739 rc = (ni->ni_net->net_lnd->lnd_send)(ni, priv, msg);
741 msg->msg_no_resend = true;
742 lnet_finalize(msg, rc);
747 lnet_ni_eager_recv(struct lnet_ni *ni, struct lnet_msg *msg)
751 LASSERT(!msg->msg_sending);
752 LASSERT(msg->msg_receiving);
753 LASSERT(!msg->msg_rx_ready_delay);
754 LASSERT(ni->ni_net->net_lnd->lnd_eager_recv != NULL);
756 msg->msg_rx_ready_delay = 1;
757 rc = (ni->ni_net->net_lnd->lnd_eager_recv)(ni, msg->msg_private, msg,
760 CERROR("recv from %s / send to %s aborted: "
761 "eager_recv failed %d\n",
762 libcfs_nid2str(msg->msg_rxpeer->lpni_nid),
763 libcfs_id2str(msg->msg_target), rc);
764 LASSERT(rc < 0); /* required by my callers */
771 lnet_is_peer_deadline_passed(struct lnet_peer_ni *lpni, time64_t now)
775 deadline = lpni->lpni_last_alive +
776 lpni->lpni_net->net_tunables.lct_peer_timeout;
779 * assume peer_ni is alive as long as we're within the configured
788 /* NB: returns 1 when alive, 0 when dead, negative when error;
789 * may drop the lnet_net_lock */
791 lnet_peer_alive_locked(struct lnet_ni *ni, struct lnet_peer_ni *lpni,
792 struct lnet_msg *msg)
794 time64_t now = ktime_get_seconds();
796 if (!lnet_peer_aliveness_enabled(lpni))
800 * If we're resending a message, let's attempt to send it even if
801 * the peer is down to fulfill our resend quota on the message
803 if (msg->msg_retry_count > 0)
806 /* try and send recovery messages irregardless */
807 if (msg->msg_recovery)
810 /* always send any responses */
811 if (lnet_msg_is_response(msg))
814 if (!lnet_is_peer_deadline_passed(lpni, now))
817 return lnet_is_peer_ni_alive(lpni);
821 * \param msg The message to be sent.
822 * \param do_send True if lnet_ni_send() should be called in this function.
823 * lnet_send() is going to lnet_net_unlock immediately after this, so
824 * it sets do_send FALSE and I don't do the unlock/send/lock bit.
826 * \retval LNET_CREDIT_OK If \a msg sent or OK to send.
827 * \retval LNET_CREDIT_WAIT If \a msg blocked for credit.
828 * \retval -EHOSTUNREACH If the next hop of the message appears dead.
829 * \retval -ECANCELED If the MD of the message has been unlinked.
832 lnet_post_send_locked(struct lnet_msg *msg, int do_send)
834 struct lnet_peer_ni *lp = msg->msg_txpeer;
835 struct lnet_ni *ni = msg->msg_txni;
836 int cpt = msg->msg_tx_cpt;
837 struct lnet_tx_queue *tq = ni->ni_tx_queues[cpt];
839 /* non-lnet_send() callers have checked before */
840 LASSERT(!do_send || msg->msg_tx_delayed);
841 LASSERT(!msg->msg_receiving);
842 LASSERT(msg->msg_tx_committed);
843 /* can't get here if we're sending to the loopback interface */
844 LASSERT(lp->lpni_nid != the_lnet.ln_loni->ni_nid);
846 /* NB 'lp' is always the next hop */
847 if ((msg->msg_target.pid & LNET_PID_USERFLAG) == 0 &&
848 lnet_peer_alive_locked(ni, lp, msg) == 0) {
849 the_lnet.ln_counters[cpt]->lct_common.lcc_drop_count++;
850 the_lnet.ln_counters[cpt]->lct_common.lcc_drop_length +=
852 lnet_net_unlock(cpt);
854 lnet_incr_stats(&msg->msg_txpeer->lpni_stats,
856 LNET_STATS_TYPE_DROP);
858 lnet_incr_stats(&msg->msg_txni->ni_stats,
860 LNET_STATS_TYPE_DROP);
862 CNETERR("Dropping message for %s: peer not alive\n",
863 libcfs_id2str(msg->msg_target));
864 msg->msg_health_status = LNET_MSG_STATUS_REMOTE_DROPPED;
866 lnet_finalize(msg, -EHOSTUNREACH);
869 return -EHOSTUNREACH;
872 if (msg->msg_md != NULL &&
873 (msg->msg_md->md_flags & LNET_MD_FLAG_ABORTED) != 0) {
874 lnet_net_unlock(cpt);
876 CNETERR("Aborting message for %s: LNetM[DE]Unlink() already "
877 "called on the MD/ME.\n",
878 libcfs_id2str(msg->msg_target));
880 msg->msg_no_resend = true;
881 CDEBUG(D_NET, "msg %p to %s canceled and will not be resent\n",
882 msg, libcfs_id2str(msg->msg_target));
883 lnet_finalize(msg, -ECANCELED);
890 if (!msg->msg_peertxcredit) {
891 spin_lock(&lp->lpni_lock);
892 LASSERT((lp->lpni_txcredits < 0) ==
893 !list_empty(&lp->lpni_txq));
895 msg->msg_peertxcredit = 1;
896 lp->lpni_txqnob += msg->msg_len + sizeof(struct lnet_hdr);
897 lp->lpni_txcredits--;
899 if (lp->lpni_txcredits < lp->lpni_mintxcredits)
900 lp->lpni_mintxcredits = lp->lpni_txcredits;
902 if (lp->lpni_txcredits < 0) {
903 msg->msg_tx_delayed = 1;
904 list_add_tail(&msg->msg_list, &lp->lpni_txq);
905 spin_unlock(&lp->lpni_lock);
906 return LNET_CREDIT_WAIT;
908 spin_unlock(&lp->lpni_lock);
911 if (!msg->msg_txcredit) {
912 LASSERT((tq->tq_credits < 0) ==
913 !list_empty(&tq->tq_delayed));
915 msg->msg_txcredit = 1;
917 atomic_dec(&ni->ni_tx_credits);
919 if (tq->tq_credits < tq->tq_credits_min)
920 tq->tq_credits_min = tq->tq_credits;
922 if (tq->tq_credits < 0) {
923 msg->msg_tx_delayed = 1;
924 list_add_tail(&msg->msg_list, &tq->tq_delayed);
925 return LNET_CREDIT_WAIT;
929 /* unset the tx_delay flag as we're going to send it now */
930 msg->msg_tx_delayed = 0;
933 lnet_net_unlock(cpt);
934 lnet_ni_send(ni, msg);
937 return LNET_CREDIT_OK;
941 static struct lnet_rtrbufpool *
942 lnet_msg2bufpool(struct lnet_msg *msg)
944 struct lnet_rtrbufpool *rbp;
947 LASSERT(msg->msg_rx_committed);
949 cpt = msg->msg_rx_cpt;
950 rbp = &the_lnet.ln_rtrpools[cpt][0];
952 LASSERT(msg->msg_len <= LNET_MTU);
953 while (msg->msg_len > (unsigned int)rbp->rbp_npages * PAGE_SIZE) {
955 LASSERT(rbp < &the_lnet.ln_rtrpools[cpt][LNET_NRBPOOLS]);
962 lnet_post_routed_recv_locked(struct lnet_msg *msg, int do_recv)
964 /* lnet_parse is going to lnet_net_unlock immediately after this, so it
965 * sets do_recv FALSE and I don't do the unlock/send/lock bit.
966 * I return LNET_CREDIT_WAIT if msg blocked and LNET_CREDIT_OK if
967 * received or OK to receive */
968 struct lnet_peer_ni *lpni = msg->msg_rxpeer;
969 struct lnet_peer *lp;
970 struct lnet_rtrbufpool *rbp;
971 struct lnet_rtrbuf *rb;
973 LASSERT(msg->msg_kiov == NULL);
974 LASSERT(msg->msg_niov == 0);
975 LASSERT(msg->msg_routing);
976 LASSERT(msg->msg_receiving);
977 LASSERT(!msg->msg_sending);
978 LASSERT(lpni->lpni_peer_net);
979 LASSERT(lpni->lpni_peer_net->lpn_peer);
981 lp = lpni->lpni_peer_net->lpn_peer;
983 /* non-lnet_parse callers only receive delayed messages */
984 LASSERT(!do_recv || msg->msg_rx_delayed);
986 if (!msg->msg_peerrtrcredit) {
987 /* lpni_lock protects the credit manipulation */
988 spin_lock(&lpni->lpni_lock);
990 msg->msg_peerrtrcredit = 1;
991 lpni->lpni_rtrcredits--;
992 if (lpni->lpni_rtrcredits < lpni->lpni_minrtrcredits)
993 lpni->lpni_minrtrcredits = lpni->lpni_rtrcredits;
995 if (lpni->lpni_rtrcredits < 0) {
996 spin_unlock(&lpni->lpni_lock);
997 /* must have checked eager_recv before here */
998 LASSERT(msg->msg_rx_ready_delay);
999 msg->msg_rx_delayed = 1;
1000 /* lp_lock protects the lp_rtrq */
1001 spin_lock(&lp->lp_lock);
1002 list_add_tail(&msg->msg_list, &lp->lp_rtrq);
1003 spin_unlock(&lp->lp_lock);
1004 return LNET_CREDIT_WAIT;
1006 spin_unlock(&lpni->lpni_lock);
1009 rbp = lnet_msg2bufpool(msg);
1011 if (!msg->msg_rtrcredit) {
1012 msg->msg_rtrcredit = 1;
1014 if (rbp->rbp_credits < rbp->rbp_mincredits)
1015 rbp->rbp_mincredits = rbp->rbp_credits;
1017 if (rbp->rbp_credits < 0) {
1018 /* must have checked eager_recv before here */
1019 LASSERT(msg->msg_rx_ready_delay);
1020 msg->msg_rx_delayed = 1;
1021 list_add_tail(&msg->msg_list, &rbp->rbp_msgs);
1022 return LNET_CREDIT_WAIT;
1026 LASSERT(!list_empty(&rbp->rbp_bufs));
1027 rb = list_entry(rbp->rbp_bufs.next, struct lnet_rtrbuf, rb_list);
1028 list_del(&rb->rb_list);
1030 msg->msg_niov = rbp->rbp_npages;
1031 msg->msg_kiov = &rb->rb_kiov[0];
1033 /* unset the msg-rx_delayed flag since we're receiving the message */
1034 msg->msg_rx_delayed = 0;
1037 int cpt = msg->msg_rx_cpt;
1039 lnet_net_unlock(cpt);
1040 lnet_ni_recv(msg->msg_rxni, msg->msg_private, msg, 1,
1041 0, msg->msg_len, msg->msg_len);
1044 return LNET_CREDIT_OK;
1048 lnet_return_tx_credits_locked(struct lnet_msg *msg)
1050 struct lnet_peer_ni *txpeer = msg->msg_txpeer;
1051 struct lnet_ni *txni = msg->msg_txni;
1052 struct lnet_msg *msg2;
1054 if (msg->msg_txcredit) {
1055 struct lnet_ni *ni = msg->msg_txni;
1056 struct lnet_tx_queue *tq = ni->ni_tx_queues[msg->msg_tx_cpt];
1058 /* give back NI txcredits */
1059 msg->msg_txcredit = 0;
1061 LASSERT((tq->tq_credits < 0) ==
1062 !list_empty(&tq->tq_delayed));
1065 atomic_inc(&ni->ni_tx_credits);
1066 if (tq->tq_credits <= 0) {
1067 msg2 = list_entry(tq->tq_delayed.next,
1068 struct lnet_msg, msg_list);
1069 list_del(&msg2->msg_list);
1071 LASSERT(msg2->msg_txni == ni);
1072 LASSERT(msg2->msg_tx_delayed);
1073 LASSERT(msg2->msg_tx_cpt == msg->msg_tx_cpt);
1075 (void) lnet_post_send_locked(msg2, 1);
1079 if (msg->msg_peertxcredit) {
1080 /* give back peer txcredits */
1081 msg->msg_peertxcredit = 0;
1083 spin_lock(&txpeer->lpni_lock);
1084 LASSERT((txpeer->lpni_txcredits < 0) ==
1085 !list_empty(&txpeer->lpni_txq));
1087 txpeer->lpni_txqnob -= msg->msg_len + sizeof(struct lnet_hdr);
1088 LASSERT(txpeer->lpni_txqnob >= 0);
1090 txpeer->lpni_txcredits++;
1091 if (txpeer->lpni_txcredits <= 0) {
1094 msg2 = list_entry(txpeer->lpni_txq.next,
1095 struct lnet_msg, msg_list);
1096 list_del(&msg2->msg_list);
1097 spin_unlock(&txpeer->lpni_lock);
1099 LASSERT(msg2->msg_txpeer == txpeer);
1100 LASSERT(msg2->msg_tx_delayed);
1102 msg2_cpt = msg2->msg_tx_cpt;
1105 * The msg_cpt can be different from the msg2_cpt
1106 * so we need to make sure we lock the correct cpt
1108 * Once we call lnet_post_send_locked() it is no
1109 * longer safe to access msg2, since it could've
1110 * been freed by lnet_finalize(), but we still
1111 * need to relock the correct cpt, so we cache the
1112 * msg2_cpt for the purpose of the check that
1113 * follows the call to lnet_pose_send_locked().
1115 if (msg2_cpt != msg->msg_tx_cpt) {
1116 lnet_net_unlock(msg->msg_tx_cpt);
1117 lnet_net_lock(msg2_cpt);
1119 (void) lnet_post_send_locked(msg2, 1);
1120 if (msg2_cpt != msg->msg_tx_cpt) {
1121 lnet_net_unlock(msg2_cpt);
1122 lnet_net_lock(msg->msg_tx_cpt);
1125 spin_unlock(&txpeer->lpni_lock);
1130 msg->msg_txni = NULL;
1131 lnet_ni_decref_locked(txni, msg->msg_tx_cpt);
1134 if (txpeer != NULL) {
1135 msg->msg_txpeer = NULL;
1136 lnet_peer_ni_decref_locked(txpeer);
1141 lnet_schedule_blocked_locked(struct lnet_rtrbufpool *rbp)
1143 struct lnet_msg *msg;
1145 if (list_empty(&rbp->rbp_msgs))
1147 msg = list_entry(rbp->rbp_msgs.next,
1148 struct lnet_msg, msg_list);
1149 list_del(&msg->msg_list);
1151 (void)lnet_post_routed_recv_locked(msg, 1);
1155 lnet_drop_routed_msgs_locked(struct list_head *list, int cpt)
1157 struct lnet_msg *msg;
1158 struct lnet_msg *tmp;
1160 lnet_net_unlock(cpt);
1162 list_for_each_entry_safe(msg, tmp, list, msg_list) {
1163 lnet_ni_recv(msg->msg_rxni, msg->msg_private, NULL,
1164 0, 0, 0, msg->msg_hdr.payload_length);
1165 list_del_init(&msg->msg_list);
1166 msg->msg_no_resend = true;
1167 msg->msg_health_status = LNET_MSG_STATUS_REMOTE_ERROR;
1168 lnet_finalize(msg, -ECANCELED);
1175 lnet_return_rx_credits_locked(struct lnet_msg *msg)
1177 struct lnet_peer_ni *rxpeerni = msg->msg_rxpeer;
1178 struct lnet_peer *lp;
1179 struct lnet_ni *rxni = msg->msg_rxni;
1180 struct lnet_msg *msg2;
1182 if (msg->msg_rtrcredit) {
1183 /* give back global router credits */
1184 struct lnet_rtrbuf *rb;
1185 struct lnet_rtrbufpool *rbp;
1187 /* NB If a msg ever blocks for a buffer in rbp_msgs, it stays
1188 * there until it gets one allocated, or aborts the wait
1190 LASSERT(msg->msg_kiov != NULL);
1192 rb = list_entry(msg->msg_kiov, struct lnet_rtrbuf, rb_kiov[0]);
1195 msg->msg_kiov = NULL;
1196 msg->msg_rtrcredit = 0;
1198 LASSERT(rbp == lnet_msg2bufpool(msg));
1200 LASSERT((rbp->rbp_credits > 0) ==
1201 !list_empty(&rbp->rbp_bufs));
1203 /* If routing is now turned off, we just drop this buffer and
1204 * don't bother trying to return credits. */
1205 if (!the_lnet.ln_routing) {
1206 lnet_destroy_rtrbuf(rb, rbp->rbp_npages);
1210 /* It is possible that a user has lowered the desired number of
1211 * buffers in this pool. Make sure we never put back
1212 * more buffers than the stated number. */
1213 if (unlikely(rbp->rbp_credits >= rbp->rbp_req_nbuffers)) {
1214 /* Discard this buffer so we don't have too
1216 lnet_destroy_rtrbuf(rb, rbp->rbp_npages);
1217 rbp->rbp_nbuffers--;
1219 list_add(&rb->rb_list, &rbp->rbp_bufs);
1221 if (rbp->rbp_credits <= 0)
1222 lnet_schedule_blocked_locked(rbp);
1227 if (msg->msg_peerrtrcredit) {
1229 LASSERT(rxpeerni->lpni_peer_net);
1230 LASSERT(rxpeerni->lpni_peer_net->lpn_peer);
1232 /* give back peer router credits */
1233 msg->msg_peerrtrcredit = 0;
1235 spin_lock(&rxpeerni->lpni_lock);
1236 rxpeerni->lpni_rtrcredits++;
1237 spin_unlock(&rxpeerni->lpni_lock);
1239 lp = rxpeerni->lpni_peer_net->lpn_peer;
1240 spin_lock(&lp->lp_lock);
1242 /* drop all messages which are queued to be routed on that
1244 if (!the_lnet.ln_routing) {
1246 list_splice_init(&lp->lp_rtrq, &drop);
1247 spin_unlock(&lp->lp_lock);
1248 lnet_drop_routed_msgs_locked(&drop, msg->msg_rx_cpt);
1249 } else if (!list_empty(&lp->lp_rtrq)) {
1252 msg2 = list_entry(lp->lp_rtrq.next,
1253 struct lnet_msg, msg_list);
1254 list_del(&msg2->msg_list);
1255 msg2_cpt = msg2->msg_rx_cpt;
1256 spin_unlock(&lp->lp_lock);
1258 * messages on the lp_rtrq can be from any NID in
1259 * the peer, which means they might have different
1260 * cpts. We need to make sure we lock the right
1263 if (msg2_cpt != msg->msg_rx_cpt) {
1264 lnet_net_unlock(msg->msg_rx_cpt);
1265 lnet_net_lock(msg2_cpt);
1267 (void) lnet_post_routed_recv_locked(msg2, 1);
1268 if (msg2_cpt != msg->msg_rx_cpt) {
1269 lnet_net_unlock(msg2_cpt);
1270 lnet_net_lock(msg->msg_rx_cpt);
1273 spin_unlock(&lp->lp_lock);
1277 msg->msg_rxni = NULL;
1278 lnet_ni_decref_locked(rxni, msg->msg_rx_cpt);
1280 if (rxpeerni != NULL) {
1281 msg->msg_rxpeer = NULL;
1282 lnet_peer_ni_decref_locked(rxpeerni);
1286 static struct lnet_peer_ni *
1287 lnet_select_peer_ni(struct lnet_ni *best_ni, lnet_nid_t dst_nid,
1288 struct lnet_peer *peer,
1289 struct lnet_peer_ni *best_lpni,
1290 struct lnet_peer_net *peer_net)
1293 * Look at the peer NIs for the destination peer that connect
1294 * to the chosen net. If a peer_ni is preferred when using the
1295 * best_ni to communicate, we use that one. If there is no
1296 * preferred peer_ni, or there are multiple preferred peer_ni,
1297 * the available transmit credits are used. If the transmit
1298 * credits are equal, we round-robin over the peer_ni.
1300 struct lnet_peer_ni *lpni = NULL;
1301 int best_lpni_credits = (best_lpni) ? best_lpni->lpni_txcredits :
1303 int best_lpni_healthv = (best_lpni) ?
1304 atomic_read(&best_lpni->lpni_healthv) : 0;
1305 bool best_lpni_is_preferred = false;
1306 bool lpni_is_preferred;
1308 __u32 lpni_sel_prio;
1309 __u32 best_sel_prio = LNET_MAX_SELECTION_PRIORITY;
1311 while ((lpni = lnet_get_next_peer_ni_locked(peer, peer_net, lpni))) {
1313 * if the best_ni we've chosen aleady has this lpni
1314 * preferred, then let's use it
1317 lpni_is_preferred = lnet_peer_is_pref_nid_locked(lpni,
1319 CDEBUG(D_NET, "%s lpni_is_preferred = %d\n",
1320 libcfs_nid2str(best_ni->ni_nid),
1323 lpni_is_preferred = false;
1326 lpni_healthv = atomic_read(&lpni->lpni_healthv);
1327 lpni_sel_prio = lpni->lpni_sel_priority;
1330 CDEBUG(D_NET, "n:[%s, %s] h:[%d, %d] p:[%d, %d] c:[%d, %d] s:[%d, %d]\n",
1331 libcfs_nid2str(lpni->lpni_nid),
1332 libcfs_nid2str(best_lpni->lpni_nid),
1333 lpni_healthv, best_lpni_healthv,
1334 lpni_sel_prio, best_sel_prio,
1335 lpni->lpni_txcredits, best_lpni_credits,
1336 lpni->lpni_seq, best_lpni->lpni_seq);
1340 /* pick the healthiest peer ni */
1341 if (lpni_healthv < best_lpni_healthv)
1343 else if (lpni_healthv > best_lpni_healthv) {
1344 if (best_lpni_is_preferred)
1345 best_lpni_is_preferred = false;
1349 if (lpni_sel_prio > best_sel_prio)
1351 else if (lpni_sel_prio < best_sel_prio) {
1352 if (best_lpni_is_preferred)
1353 best_lpni_is_preferred = false;
1357 /* if this is a preferred peer use it */
1358 if (!best_lpni_is_preferred && lpni_is_preferred) {
1359 best_lpni_is_preferred = true;
1361 } else if (best_lpni_is_preferred && !lpni_is_preferred) {
1362 /* this is not the preferred peer so let's ignore
1368 if (lpni->lpni_txcredits < best_lpni_credits)
1369 /* We already have a peer that has more credits
1370 * available than this one. No need to consider
1371 * this peer further.
1374 else if (lpni->lpni_txcredits > best_lpni_credits)
1377 /* The best peer found so far and the current peer
1378 * have the same number of available credits let's
1379 * make sure to select between them using Round Robin
1381 if (best_lpni && (best_lpni->lpni_seq <= lpni->lpni_seq))
1384 best_lpni_is_preferred = lpni_is_preferred;
1385 best_lpni_healthv = lpni_healthv;
1386 best_sel_prio = lpni_sel_prio;
1388 best_lpni_credits = lpni->lpni_txcredits;
1391 /* if we still can't find a peer ni then we can't reach it */
1393 __u32 net_id = (peer_net) ? peer_net->lpn_net_id :
1394 LNET_NIDNET(dst_nid);
1395 CDEBUG(D_NET, "no peer_ni found on peer net %s\n",
1396 libcfs_net2str(net_id));
1400 CDEBUG(D_NET, "sd_best_lpni = %s\n",
1401 libcfs_nid2str(best_lpni->lpni_nid));
1407 * Prerequisite: the best_ni should already be set in the sd
1408 * Find the best lpni.
1409 * If the net id is provided then restrict lpni selection on
1410 * that particular net.
1411 * Otherwise find any reachable lpni. When dealing with an MR
1412 * gateway and it has multiple lpnis which we can use
1413 * we want to select the best one from the list of reachable
1416 static inline struct lnet_peer_ni *
1417 lnet_find_best_lpni(struct lnet_ni *lni, lnet_nid_t dst_nid,
1418 struct lnet_peer *peer, __u32 net_id)
1420 struct lnet_peer_net *peer_net;
1422 /* find the best_lpni on any local network */
1423 if (net_id == LNET_NET_ANY) {
1424 struct lnet_peer_ni *best_lpni = NULL;
1425 struct lnet_peer_net *lpn;
1426 list_for_each_entry(lpn, &peer->lp_peer_nets, lpn_peer_nets) {
1427 /* no net specified find any reachable peer ni */
1428 if (!lnet_islocalnet_locked(lpn->lpn_net_id))
1430 best_lpni = lnet_select_peer_ni(lni, dst_nid, peer,
1436 /* restrict on the specified net */
1437 peer_net = lnet_peer_get_net_locked(peer, net_id);
1439 return lnet_select_peer_ni(lni, dst_nid, peer, NULL, peer_net);
1445 lnet_compare_gw_lpnis(struct lnet_peer_ni *lpni1, struct lnet_peer_ni *lpni2)
1447 if (lpni1->lpni_txqnob < lpni2->lpni_txqnob)
1450 if (lpni1->lpni_txqnob > lpni2->lpni_txqnob)
1453 if (lpni1->lpni_txcredits > lpni2->lpni_txcredits)
1456 if (lpni1->lpni_txcredits < lpni2->lpni_txcredits)
1462 /* Compare route priorities and hop counts */
1464 lnet_compare_routes(struct lnet_route *r1, struct lnet_route *r2)
1466 int r1_hops = (r1->lr_hops == LNET_UNDEFINED_HOPS) ? 1 : r1->lr_hops;
1467 int r2_hops = (r2->lr_hops == LNET_UNDEFINED_HOPS) ? 1 : r2->lr_hops;
1469 if (r1->lr_priority < r2->lr_priority)
1472 if (r1->lr_priority > r2->lr_priority)
1475 if (r1_hops < r2_hops)
1478 if (r1_hops > r2_hops)
1484 static struct lnet_route *
1485 lnet_find_route_locked(struct lnet_remotenet *rnet, __u32 src_net,
1486 struct lnet_peer_ni *remote_lpni,
1487 struct lnet_route **prev_route,
1488 struct lnet_peer_ni **gwni)
1490 struct lnet_peer_ni *lpni, *best_gw_ni = NULL;
1491 struct lnet_route *best_route;
1492 struct lnet_route *last_route;
1493 struct lnet_route *route;
1495 bool best_rte_is_preferred = false;
1498 CDEBUG(D_NET, "Looking up a route to %s, from %s\n",
1499 libcfs_net2str(rnet->lrn_net), libcfs_net2str(src_net));
1501 best_route = last_route = NULL;
1502 list_for_each_entry(route, &rnet->lrn_routes, lr_list) {
1503 if (!lnet_is_route_alive(route))
1505 gw_pnid = route->lr_gateway->lp_primary_nid;
1507 /* no protection on below fields, but it's harmless */
1508 if (last_route && (last_route->lr_seq - route->lr_seq < 0))
1511 /* if the best route found is in the preferred list then
1512 * tag it as preferred and use it later on. But if we
1513 * didn't find any routes which are on the preferred list
1514 * then just use the best route possible.
1516 rc = lnet_peer_is_pref_rtr_locked(remote_lpni, gw_pnid);
1518 if (!best_route || (rc && !best_rte_is_preferred)) {
1519 /* Restrict the selection of the router NI on the
1520 * src_net provided. If the src_net is LNET_NID_ANY,
1521 * then select the best interface available.
1523 lpni = lnet_find_best_lpni(NULL, LNET_NID_ANY,
1528 "Gateway %s does not have a peer NI on net %s\n",
1529 libcfs_nid2str(gw_pnid),
1530 libcfs_net2str(src_net));
1535 if (rc && !best_rte_is_preferred) {
1536 /* This is the first preferred route we found,
1537 * so it beats any route found previously
1543 best_rte_is_preferred = true;
1544 CDEBUG(D_NET, "preferred gw = %s\n",
1545 libcfs_nid2str(gw_pnid));
1547 } else if ((!rc) && best_rte_is_preferred)
1548 /* The best route we found so far is in the preferred
1549 * list, so it beats any non-preferred route
1554 best_route = last_route = route;
1559 rc = lnet_compare_routes(route, best_route);
1563 /* Restrict the selection of the router NI on the
1564 * src_net provided. If the src_net is LNET_NID_ANY,
1565 * then select the best interface available.
1567 lpni = lnet_find_best_lpni(NULL, LNET_NID_ANY,
1572 "Gateway %s does not have a peer NI on net %s\n",
1573 libcfs_nid2str(gw_pnid),
1574 libcfs_net2str(src_net));
1584 rc = lnet_compare_gw_lpnis(lpni, best_gw_ni);
1588 if (rc == 1 || route->lr_seq <= best_route->lr_seq) {
1595 *prev_route = last_route;
1601 static struct lnet_ni *
1602 lnet_get_best_ni(struct lnet_net *local_net, struct lnet_ni *best_ni,
1603 struct lnet_peer *peer, struct lnet_peer_net *peer_net,
1606 struct lnet_ni *ni = NULL;
1607 unsigned int shortest_distance;
1610 __u32 best_sel_prio;
1613 * If there is no peer_ni that we can send to on this network,
1614 * then there is no point in looking for a new best_ni here.
1616 if (!lnet_get_next_peer_ni_locked(peer, peer_net, NULL))
1619 if (best_ni == NULL) {
1620 best_sel_prio = LNET_MAX_SELECTION_PRIORITY;
1621 shortest_distance = UINT_MAX;
1622 best_credits = INT_MIN;
1625 shortest_distance = cfs_cpt_distance(lnet_cpt_table(), md_cpt,
1626 best_ni->ni_dev_cpt);
1627 best_credits = atomic_read(&best_ni->ni_tx_credits);
1628 best_healthv = atomic_read(&best_ni->ni_healthv);
1629 best_sel_prio = best_ni->ni_sel_priority;
1632 while ((ni = lnet_get_next_ni_locked(local_net, ni))) {
1633 unsigned int distance;
1639 ni_credits = atomic_read(&ni->ni_tx_credits);
1640 ni_healthv = atomic_read(&ni->ni_healthv);
1641 ni_fatal = atomic_read(&ni->ni_fatal_error_on);
1642 ni_sel_prio = ni->ni_sel_priority;
1645 * calculate the distance from the CPT on which
1646 * the message memory is allocated to the CPT of
1647 * the NI's physical device
1649 distance = cfs_cpt_distance(lnet_cpt_table(),
1654 * All distances smaller than the NUMA range
1655 * are treated equally.
1657 if (distance < lnet_numa_range)
1658 distance = lnet_numa_range;
1661 * Select on health, shorter distance, available
1662 * credits, then round-robin.
1668 CDEBUG(D_NET, "compare ni %s [c:%d, d:%d, s:%d, p:%u] with best_ni %s [c:%d, d:%d, s:%d, p:%u]\n",
1669 libcfs_nid2str(ni->ni_nid), ni_credits, distance,
1670 ni->ni_seq, ni_sel_prio,
1671 (best_ni) ? libcfs_nid2str(best_ni->ni_nid)
1672 : "not selected", best_credits, shortest_distance,
1673 (best_ni) ? best_ni->ni_seq : 0,
1678 if (ni_healthv < best_healthv)
1680 else if (ni_healthv > best_healthv)
1683 if (ni_sel_prio > best_sel_prio)
1685 else if (ni_sel_prio < best_sel_prio)
1688 if (distance > shortest_distance)
1690 else if (distance < shortest_distance)
1693 if (ni_credits < best_credits)
1695 else if (ni_credits > best_credits)
1698 if (best_ni && best_ni->ni_seq <= ni->ni_seq)
1702 best_sel_prio = ni_sel_prio;
1703 shortest_distance = distance;
1704 best_healthv = ni_healthv;
1706 best_credits = ni_credits;
1709 CDEBUG(D_NET, "selected best_ni %s\n",
1710 (best_ni) ? libcfs_nid2str(best_ni->ni_nid) : "no selection");
1716 * Traffic to the LNET_RESERVED_PORTAL may not trigger peer discovery,
1717 * because such traffic is required to perform discovery. We therefore
1718 * exclude all GET and PUT on that portal. We also exclude all ACK and
1719 * REPLY traffic, but that is because the portal is not tracked in the
1720 * message structure for these message types. We could restrict this
1721 * further by also checking for LNET_PROTO_PING_MATCHBITS.
1724 lnet_msg_discovery(struct lnet_msg *msg)
1726 if (msg->msg_type == LNET_MSG_PUT) {
1727 if (msg->msg_hdr.msg.put.ptl_index != LNET_RESERVED_PORTAL)
1729 } else if (msg->msg_type == LNET_MSG_GET) {
1730 if (msg->msg_hdr.msg.get.ptl_index != LNET_RESERVED_PORTAL)
1736 #define SRC_SPEC 0x0001
1737 #define SRC_ANY 0x0002
1738 #define LOCAL_DST 0x0004
1739 #define REMOTE_DST 0x0008
1740 #define MR_DST 0x0010
1741 #define NMR_DST 0x0020
1742 #define SND_RESP 0x0040
1744 /* The following to defines are used for return codes */
1745 #define REPEAT_SEND 0x1000
1746 #define PASS_THROUGH 0x2000
1748 /* The different cases lnet_select pathway needs to handle */
1749 #define SRC_SPEC_LOCAL_MR_DST (SRC_SPEC | LOCAL_DST | MR_DST)
1750 #define SRC_SPEC_ROUTER_MR_DST (SRC_SPEC | REMOTE_DST | MR_DST)
1751 #define SRC_SPEC_LOCAL_NMR_DST (SRC_SPEC | LOCAL_DST | NMR_DST)
1752 #define SRC_SPEC_ROUTER_NMR_DST (SRC_SPEC | REMOTE_DST | NMR_DST)
1753 #define SRC_ANY_LOCAL_MR_DST (SRC_ANY | LOCAL_DST | MR_DST)
1754 #define SRC_ANY_ROUTER_MR_DST (SRC_ANY | REMOTE_DST | MR_DST)
1755 #define SRC_ANY_LOCAL_NMR_DST (SRC_ANY | LOCAL_DST | NMR_DST)
1756 #define SRC_ANY_ROUTER_NMR_DST (SRC_ANY | REMOTE_DST | NMR_DST)
1759 lnet_handle_lo_send(struct lnet_send_data *sd)
1761 struct lnet_msg *msg = sd->sd_msg;
1762 int cpt = sd->sd_cpt;
1764 /* No send credit hassles with LOLND */
1765 lnet_ni_addref_locked(the_lnet.ln_loni, cpt);
1766 msg->msg_hdr.dest_nid = cpu_to_le64(the_lnet.ln_loni->ni_nid);
1767 if (!msg->msg_routing)
1768 msg->msg_hdr.src_nid =
1769 cpu_to_le64(the_lnet.ln_loni->ni_nid);
1770 msg->msg_target.nid = the_lnet.ln_loni->ni_nid;
1771 lnet_msg_commit(msg, cpt);
1772 msg->msg_txni = the_lnet.ln_loni;
1774 return LNET_CREDIT_OK;
1778 lnet_handle_send(struct lnet_send_data *sd)
1780 struct lnet_ni *best_ni = sd->sd_best_ni;
1781 struct lnet_peer_ni *best_lpni = sd->sd_best_lpni;
1782 struct lnet_peer_ni *final_dst_lpni = sd->sd_final_dst_lpni;
1783 struct lnet_msg *msg = sd->sd_msg;
1785 __u32 send_case = sd->sd_send_case;
1787 __u32 routing = send_case & REMOTE_DST;
1788 struct lnet_rsp_tracker *rspt;
1791 * Increment sequence number of the selected peer so that we
1792 * pick the next one in Round Robin.
1794 best_lpni->lpni_seq++;
1797 * grab a reference on the peer_ni so it sticks around even if
1798 * we need to drop and relock the lnet_net_lock below.
1800 lnet_peer_ni_addref_locked(best_lpni);
1803 * Use lnet_cpt_of_nid() to determine the CPT used to commit the
1804 * message. This ensures that we get a CPT that is correct for
1805 * the NI when the NI has been restricted to a subset of all CPTs.
1806 * If the selected CPT differs from the one currently locked, we
1807 * must unlock and relock the lnet_net_lock(), and then check whether
1808 * the configuration has changed. We don't have a hold on the best_ni
1809 * yet, and it may have vanished.
1811 cpt2 = lnet_cpt_of_nid_locked(best_lpni->lpni_nid, best_ni);
1812 if (sd->sd_cpt != cpt2) {
1813 __u32 seq = lnet_get_dlc_seq_locked();
1814 lnet_net_unlock(sd->sd_cpt);
1816 lnet_net_lock(sd->sd_cpt);
1817 if (seq != lnet_get_dlc_seq_locked()) {
1818 lnet_peer_ni_decref_locked(best_lpni);
1824 * store the best_lpni in the message right away to avoid having
1825 * to do the same operation under different conditions
1827 msg->msg_txpeer = best_lpni;
1828 msg->msg_txni = best_ni;
1831 * grab a reference for the best_ni since now it's in use in this
1832 * send. The reference will be dropped in lnet_finalize()
1834 lnet_ni_addref_locked(msg->msg_txni, sd->sd_cpt);
1837 * Always set the target.nid to the best peer picked. Either the
1838 * NID will be one of the peer NIDs selected, or the same NID as
1839 * what was originally set in the target or it will be the NID of
1840 * a router if this message should be routed
1842 msg->msg_target.nid = msg->msg_txpeer->lpni_nid;
1845 * lnet_msg_commit assigns the correct cpt to the message, which
1846 * is used to decrement the correct refcount on the ni when it's
1847 * time to return the credits
1849 lnet_msg_commit(msg, sd->sd_cpt);
1852 * If we are routing the message then we keep the src_nid that was
1853 * set by the originator. If we are not routing then we are the
1854 * originator and set it here.
1856 if (!msg->msg_routing)
1857 msg->msg_hdr.src_nid = cpu_to_le64(msg->msg_txni->ni_nid);
1860 msg->msg_target_is_router = 1;
1861 msg->msg_target.pid = LNET_PID_LUSTRE;
1863 * since we're routing we want to ensure that the
1864 * msg_hdr.dest_nid is set to the final destination. When
1865 * the router receives this message it knows how to route
1868 * final_dst_lpni is set at the beginning of the
1869 * lnet_select_pathway() function and is never changed.
1870 * It's safe to use it here.
1872 msg->msg_hdr.dest_nid = cpu_to_le64(final_dst_lpni->lpni_nid);
1875 * if we're not routing set the dest_nid to the best peer
1876 * ni NID that we picked earlier in the algorithm.
1878 msg->msg_hdr.dest_nid = cpu_to_le64(msg->msg_txpeer->lpni_nid);
1882 * if we have response tracker block update it with the next hop
1886 rspt = msg->msg_md->md_rspt_ptr;
1888 rspt->rspt_next_hop_nid = msg->msg_txpeer->lpni_nid;
1889 CDEBUG(D_NET, "rspt_next_hop_nid = %s\n",
1890 libcfs_nid2str(rspt->rspt_next_hop_nid));
1894 rc = lnet_post_send_locked(msg, 0);
1897 CDEBUG(D_NET, "TRACE: %s(%s:%s) -> %s(%s:%s) %s : %s try# %d\n",
1898 libcfs_nid2str(msg->msg_hdr.src_nid),
1899 libcfs_nid2str(msg->msg_txni->ni_nid),
1900 libcfs_nid2str(sd->sd_src_nid),
1901 libcfs_nid2str(msg->msg_hdr.dest_nid),
1902 libcfs_nid2str(sd->sd_dst_nid),
1903 libcfs_nid2str(msg->msg_txpeer->lpni_nid),
1904 libcfs_nid2str(sd->sd_rtr_nid),
1905 lnet_msgtyp2str(msg->msg_type), msg->msg_retry_count);
1911 lnet_set_non_mr_pref_nid(struct lnet_peer_ni *lpni, struct lnet_ni *lni,
1912 struct lnet_msg *msg)
1914 if (!lnet_peer_is_multi_rail(lpni->lpni_peer_net->lpn_peer) &&
1915 !lnet_msg_is_response(msg) && lpni->lpni_pref_nnids == 0) {
1916 CDEBUG(D_NET, "Setting preferred local NID %s on NMR peer %s\n",
1917 libcfs_nid2str(lni->ni_nid),
1918 libcfs_nid2str(lpni->lpni_nid));
1919 lnet_peer_ni_set_non_mr_pref_nid(lpni, lni->ni_nid);
1928 * use the source and destination NIDs as the pathway
1931 lnet_handle_spec_local_nmr_dst(struct lnet_send_data *sd)
1933 /* the destination lpni is set before we get here. */
1936 sd->sd_best_ni = lnet_nid2ni_locked(sd->sd_src_nid, sd->sd_cpt);
1937 if (!sd->sd_best_ni) {
1938 CERROR("Can't send to %s: src %s is not a "
1939 "local nid\n", libcfs_nid2str(sd->sd_dst_nid),
1940 libcfs_nid2str(sd->sd_src_nid));
1944 lnet_set_non_mr_pref_nid(sd->sd_best_lpni, sd->sd_best_ni, sd->sd_msg);
1946 return lnet_handle_send(sd);
1954 * Don't run the selection algorithm on the peer NIs. By specifying the
1955 * local NID, we're also saying that we should always use the destination NID
1956 * provided. This handles the case where we should be using the same
1957 * destination NID for the all the messages which belong to the same RPC
1961 lnet_handle_spec_local_mr_dst(struct lnet_send_data *sd)
1963 sd->sd_best_ni = lnet_nid2ni_locked(sd->sd_src_nid, sd->sd_cpt);
1964 if (!sd->sd_best_ni) {
1965 CERROR("Can't send to %s: src %s is not a "
1966 "local nid\n", libcfs_nid2str(sd->sd_dst_nid),
1967 libcfs_nid2str(sd->sd_src_nid));
1971 if (sd->sd_best_lpni &&
1972 sd->sd_best_lpni->lpni_nid == the_lnet.ln_loni->ni_nid)
1973 return lnet_handle_lo_send(sd);
1974 else if (sd->sd_best_lpni)
1975 return lnet_handle_send(sd);
1977 CERROR("can't send to %s. no NI on %s\n",
1978 libcfs_nid2str(sd->sd_dst_nid),
1979 libcfs_net2str(sd->sd_best_ni->ni_net->net_id));
1981 return -EHOSTUNREACH;
1985 lnet_find_best_ni_on_spec_net(struct lnet_ni *cur_best_ni,
1986 struct lnet_peer *peer,
1987 struct lnet_peer_net *peer_net,
1991 struct lnet_net *local_net;
1992 struct lnet_ni *best_ni;
1994 local_net = lnet_get_net_locked(peer_net->lpn_net_id);
1999 * Iterate through the NIs in this local Net and select
2000 * the NI to send from. The selection is determined by
2001 * these 3 criterion in the following priority:
2003 * 2. NI available credits
2006 best_ni = lnet_get_best_ni(local_net, cur_best_ni,
2007 peer, peer_net, cpt);
2009 if (incr_seq && best_ni)
2016 lnet_initiate_peer_discovery(struct lnet_peer_ni *lpni, struct lnet_msg *msg,
2019 struct lnet_peer *peer;
2022 lnet_peer_ni_addref_locked(lpni);
2024 peer = lpni->lpni_peer_net->lpn_peer;
2026 if (lnet_peer_gw_discovery(peer)) {
2027 lnet_peer_ni_decref_locked(lpni);
2031 if (!lnet_msg_discovery(msg) || lnet_peer_is_uptodate(peer)) {
2032 lnet_peer_ni_decref_locked(lpni);
2036 rc = lnet_discover_peer_locked(lpni, cpt, false);
2038 lnet_peer_ni_decref_locked(lpni);
2041 /* The peer may have changed. */
2042 peer = lpni->lpni_peer_net->lpn_peer;
2043 spin_lock(&peer->lp_lock);
2044 if (lnet_peer_is_uptodate_locked(peer)) {
2045 spin_unlock(&peer->lp_lock);
2046 lnet_peer_ni_decref_locked(lpni);
2049 /* queue message and return */
2050 msg->msg_sending = 0;
2051 msg->msg_txpeer = NULL;
2052 list_add_tail(&msg->msg_list, &peer->lp_dc_pendq);
2053 spin_unlock(&peer->lp_lock);
2055 lnet_peer_ni_decref_locked(lpni);
2057 CDEBUG(D_NET, "msg %p delayed. %s pending discovery\n",
2058 msg, libcfs_nid2str(peer->lp_primary_nid));
2060 return LNET_DC_WAIT;
2064 lnet_handle_find_routed_path(struct lnet_send_data *sd,
2066 struct lnet_peer_ni **gw_lpni,
2067 struct lnet_peer **gw_peer)
2071 struct lnet_peer *gw;
2072 struct lnet_peer *lp;
2073 struct lnet_peer_net *lpn;
2074 struct lnet_peer_net *best_lpn = NULL;
2075 struct lnet_remotenet *rnet, *best_rnet = NULL;
2076 struct lnet_route *best_route = NULL;
2077 struct lnet_route *last_route = NULL;
2078 struct lnet_peer_ni *lpni = NULL;
2079 struct lnet_peer_ni *gwni = NULL;
2080 bool route_found = false;
2081 lnet_nid_t src_nid = (sd->sd_src_nid != LNET_NID_ANY) ? sd->sd_src_nid :
2082 (sd->sd_best_ni != NULL) ? sd->sd_best_ni->ni_nid :
2084 int best_lpn_healthv = 0;
2085 __u32 best_lpn_sel_prio = LNET_MAX_SELECTION_PRIORITY;
2087 CDEBUG(D_NET, "using src nid %s for route restriction\n",
2088 libcfs_nid2str(src_nid));
2090 /* If a router nid was specified then we are replying to a GET or
2091 * sending an ACK. In this case we use the gateway associated with the
2092 * specified router nid.
2094 if (sd->sd_rtr_nid != LNET_NID_ANY) {
2095 gwni = lnet_find_peer_ni_locked(sd->sd_rtr_nid);
2097 gw = gwni->lpni_peer_net->lpn_peer;
2098 lnet_peer_ni_decref_locked(gwni);
2099 if (gw->lp_rtr_refcount) {
2100 local_lnet = LNET_NIDNET(sd->sd_rtr_nid);
2104 CWARN("No peer NI for gateway %s. Attempting to find an alternative route.\n",
2105 libcfs_nid2str(sd->sd_rtr_nid));
2110 if (sd->sd_msg->msg_routing) {
2111 /* If I'm routing this message then I need to find the
2112 * next hop based on the destination NID
2114 best_rnet = lnet_find_rnet_locked(LNET_NIDNET(sd->sd_dst_nid));
2116 CERROR("Unable to route message to %s - Route table may be misconfigured\n",
2117 libcfs_nid2str(sd->sd_dst_nid));
2118 return -EHOSTUNREACH;
2121 /* we've already looked up the initial lpni using
2124 lpni = sd->sd_best_lpni;
2125 /* the peer tree must be in existence */
2126 LASSERT(lpni && lpni->lpni_peer_net &&
2127 lpni->lpni_peer_net->lpn_peer);
2128 lp = lpni->lpni_peer_net->lpn_peer;
2130 list_for_each_entry(lpn, &lp->lp_peer_nets, lpn_peer_nets) {
2131 /* is this remote network reachable? */
2132 rnet = lnet_find_rnet_locked(lpn->lpn_net_id);
2141 /* select the preferred peer net */
2142 if (best_lpn_healthv > lpn->lpn_healthv)
2144 else if (best_lpn_healthv < lpn->lpn_healthv)
2147 if (best_lpn_sel_prio < lpn->lpn_sel_priority)
2149 else if (best_lpn_sel_prio > lpn->lpn_sel_priority)
2152 if (best_lpn->lpn_seq <= lpn->lpn_seq)
2155 best_lpn_healthv = lpn->lpn_healthv;
2156 best_lpn_sel_prio = lpn->lpn_sel_priority;
2162 CERROR("peer %s has no available nets\n",
2163 libcfs_nid2str(sd->sd_dst_nid));
2164 return -EHOSTUNREACH;
2167 sd->sd_best_lpni = lnet_find_best_lpni(sd->sd_best_ni,
2170 best_lpn->lpn_net_id);
2171 if (!sd->sd_best_lpni) {
2172 CERROR("peer %s is unreachable\n",
2173 libcfs_nid2str(sd->sd_dst_nid));
2174 return -EHOSTUNREACH;
2177 /* We're attempting to round robin over the remote peer
2178 * NI's so update the final destination we selected
2180 sd->sd_final_dst_lpni = sd->sd_best_lpni;
2182 /* Increment the sequence number of the remote lpni so
2183 * we can round robin over the different interfaces of
2186 sd->sd_best_lpni->lpni_seq++;
2190 * find the best route. Restrict the selection on the net of the
2191 * local NI if we've already picked the local NI to send from.
2192 * Otherwise, let's pick any route we can find and then find
2193 * a local NI we can reach the route's gateway on. Any route we
2194 * select will be reachable by virtue of the restriction we have
2195 * when adding a route.
2197 best_route = lnet_find_route_locked(best_rnet,
2198 LNET_NIDNET(src_nid),
2200 &last_route, &gwni);
2203 CERROR("no route to %s from %s\n",
2204 libcfs_nid2str(dst_nid),
2205 libcfs_nid2str(src_nid));
2206 return -EHOSTUNREACH;
2210 CERROR("Internal Error. Route expected to %s from %s\n",
2211 libcfs_nid2str(dst_nid),
2212 libcfs_nid2str(src_nid));
2216 gw = best_route->lr_gateway;
2217 LASSERT(gw == gwni->lpni_peer_net->lpn_peer);
2218 local_lnet = best_route->lr_lnet;
2222 * Discover this gateway if it hasn't already been discovered.
2223 * This means we might delay the message until discovery has
2226 sd->sd_msg->msg_src_nid_param = sd->sd_src_nid;
2227 rc = lnet_initiate_peer_discovery(gwni, sd->sd_msg, sd->sd_cpt);
2231 if (!sd->sd_best_ni)
2232 sd->sd_best_ni = lnet_find_best_ni_on_spec_net(NULL, gw,
2233 lnet_peer_get_net_locked(gw,
2238 if (!sd->sd_best_ni) {
2239 CERROR("Internal Error. Expected local ni on %s but non found :%s\n",
2240 libcfs_net2str(local_lnet),
2241 libcfs_nid2str(sd->sd_src_nid));
2249 * increment the sequence numbers since now we're sure we're
2250 * going to use this path
2252 if (sd->sd_rtr_nid == LNET_NID_ANY) {
2253 LASSERT(best_route && last_route);
2254 best_route->lr_seq = last_route->lr_seq + 1;
2256 best_lpn->lpn_seq++;
2267 * Remote destination
2268 * Non-MR destination
2272 * Remote destination
2275 * The handling of these two cases is similar. Even though the destination
2276 * can be MR or non-MR, we'll deal directly with the router.
2279 lnet_handle_spec_router_dst(struct lnet_send_data *sd)
2282 struct lnet_peer_ni *gw_lpni = NULL;
2283 struct lnet_peer *gw_peer = NULL;
2286 sd->sd_best_ni = lnet_nid2ni_locked(sd->sd_src_nid, sd->sd_cpt);
2287 if (!sd->sd_best_ni) {
2288 CERROR("Can't send to %s: src %s is not a "
2289 "local nid\n", libcfs_nid2str(sd->sd_dst_nid),
2290 libcfs_nid2str(sd->sd_src_nid));
2294 rc = lnet_handle_find_routed_path(sd, sd->sd_dst_nid, &gw_lpni,
2299 if (sd->sd_send_case & NMR_DST)
2301 * since the final destination is non-MR let's set its preferred
2302 * NID before we send
2304 lnet_set_non_mr_pref_nid(sd->sd_best_lpni, sd->sd_best_ni,
2308 * We're going to send to the gw found so let's set its
2311 sd->sd_peer = gw_peer;
2312 sd->sd_best_lpni = gw_lpni;
2314 return lnet_handle_send(sd);
2318 lnet_find_best_ni_on_local_net(struct lnet_peer *peer, int md_cpt,
2321 struct lnet_peer_net *peer_net = NULL;
2322 struct lnet_ni *best_ni = NULL;
2323 int lpn_healthv = 0;
2326 * The peer can have multiple interfaces, some of them can be on
2327 * the local network and others on a routed network. We should
2328 * prefer the local network. However if the local network is not
2329 * available then we need to try the routed network
2332 /* go through all the peer nets and find the best_ni */
2333 list_for_each_entry(peer_net, &peer->lp_peer_nets, lpn_peer_nets) {
2335 * The peer's list of nets can contain non-local nets. We
2336 * want to only examine the local ones.
2338 if (!lnet_get_net_locked(peer_net->lpn_net_id))
2341 /* always select the lpn with the best health */
2342 if (lpn_healthv <= peer_net->lpn_healthv)
2343 lpn_healthv = peer_net->lpn_healthv;
2347 best_ni = lnet_find_best_ni_on_spec_net(best_ni, peer, peer_net,
2351 * if this is a discovery message and lp_disc_net_id is
2352 * specified then use that net to send the discovery on.
2354 if (peer->lp_disc_net_id == peer_net->lpn_net_id &&
2360 /* increment sequence number so we can round robin */
2366 static struct lnet_ni *
2367 lnet_find_existing_preferred_best_ni(struct lnet_peer_ni *lpni, int cpt)
2369 struct lnet_ni *best_ni = NULL;
2370 struct lnet_peer_net *peer_net = lpni->lpni_peer_net;
2371 struct lnet_peer_ni *lpni_entry;
2374 * We must use a consistent source address when sending to a
2375 * non-MR peer. However, a non-MR peer can have multiple NIDs
2376 * on multiple networks, and we may even need to talk to this
2377 * peer on multiple networks -- certain types of
2378 * load-balancing configuration do this.
2380 * So we need to pick the NI the peer prefers for this
2381 * particular network.
2384 list_for_each_entry(lpni_entry, &peer_net->lpn_peer_nis,
2386 if (lpni_entry->lpni_pref_nnids == 0)
2388 LASSERT(lpni_entry->lpni_pref_nnids == 1);
2389 best_ni = lnet_nid2ni_locked(lpni_entry->lpni_pref.nid, cpt);
2396 /* Prerequisite: sd->sd_peer and sd->sd_best_lpni should be set */
2398 lnet_select_preferred_best_ni(struct lnet_send_data *sd)
2400 struct lnet_ni *best_ni = NULL;
2401 struct lnet_peer_ni *best_lpni = sd->sd_best_lpni;
2404 * We must use a consistent source address when sending to a
2405 * non-MR peer. However, a non-MR peer can have multiple NIDs
2406 * on multiple networks, and we may even need to talk to this
2407 * peer on multiple networks -- certain types of
2408 * load-balancing configuration do this.
2410 * So we need to pick the NI the peer prefers for this
2411 * particular network.
2414 best_ni = lnet_find_existing_preferred_best_ni(sd->sd_best_lpni,
2417 /* if best_ni is still not set just pick one */
2420 lnet_find_best_ni_on_spec_net(NULL, sd->sd_peer,
2421 sd->sd_best_lpni->lpni_peer_net,
2422 sd->sd_md_cpt, true);
2423 /* If there is no best_ni we don't have a route */
2425 CERROR("no path to %s from net %s\n",
2426 libcfs_nid2str(best_lpni->lpni_nid),
2427 libcfs_net2str(best_lpni->lpni_net->net_id));
2428 return -EHOSTUNREACH;
2432 sd->sd_best_ni = best_ni;
2434 /* Set preferred NI if necessary. */
2435 lnet_set_non_mr_pref_nid(sd->sd_best_lpni, sd->sd_best_ni, sd->sd_msg);
2442 * Source not specified
2446 * always use the same source NID for NMR peers
2447 * If we've talked to that peer before then we already have a preferred
2448 * source NI associated with it. Otherwise, we select a preferred local NI
2449 * and store it in the peer
2452 lnet_handle_any_local_nmr_dst(struct lnet_send_data *sd)
2456 /* sd->sd_best_lpni is already set to the final destination */
2459 * At this point we should've created the peer ni and peer. If we
2460 * can't find it, then something went wrong. Instead of assert
2461 * output a relevant message and fail the send
2463 if (!sd->sd_best_lpni) {
2464 CERROR("Internal fault. Unable to send msg %s to %s. "
2466 lnet_msgtyp2str(sd->sd_msg->msg_type),
2467 libcfs_nid2str(sd->sd_dst_nid));
2471 if (sd->sd_msg->msg_routing) {
2472 /* If I'm forwarding this message then I can choose any NI
2473 * on the destination peer net
2475 sd->sd_best_ni = lnet_find_best_ni_on_spec_net(NULL,
2477 sd->sd_best_lpni->lpni_peer_net,
2480 if (!sd->sd_best_ni) {
2481 CERROR("Unable to forward message to %s. No local NI available\n",
2482 libcfs_nid2str(sd->sd_dst_nid));
2486 rc = lnet_select_preferred_best_ni(sd);
2489 rc = lnet_handle_send(sd);
2495 lnet_handle_any_mr_dsta(struct lnet_send_data *sd)
2498 * NOTE we've already handled the remote peer case. So we only
2499 * need to worry about the local case here.
2501 * if we're sending a response, ACK or reply, we need to send it
2502 * to the destination NID given to us. At this point we already
2503 * have the peer_ni we're suppose to send to, so just find the
2504 * best_ni on the peer net and use that. Since we're sending to an
2505 * MR peer then we can just run the selection algorithm on our
2506 * local NIs and pick the best one.
2508 if (sd->sd_send_case & SND_RESP) {
2510 lnet_find_best_ni_on_spec_net(NULL, sd->sd_peer,
2511 sd->sd_best_lpni->lpni_peer_net,
2512 sd->sd_md_cpt, true);
2514 if (!sd->sd_best_ni) {
2516 * We're not going to deal with not able to send
2517 * a response to the provided final destination
2519 CERROR("Can't send response to %s. "
2520 "No local NI available\n",
2521 libcfs_nid2str(sd->sd_dst_nid));
2522 return -EHOSTUNREACH;
2525 return lnet_handle_send(sd);
2529 * If we get here that means we're sending a fresh request, PUT or
2530 * GET, so we need to run our standard selection algorithm.
2531 * First find the best local interface that's on any of the peer's
2534 sd->sd_best_ni = lnet_find_best_ni_on_local_net(sd->sd_peer,
2536 lnet_msg_discovery(sd->sd_msg));
2537 if (sd->sd_best_ni) {
2539 lnet_find_best_lpni(sd->sd_best_ni, sd->sd_dst_nid,
2541 sd->sd_best_ni->ni_net->net_id);
2544 * if we're successful in selecting a peer_ni on the local
2545 * network, then send to it. Otherwise fall through and
2546 * try and see if we can reach it over another routed
2549 if (sd->sd_best_lpni &&
2550 sd->sd_best_lpni->lpni_nid == the_lnet.ln_loni->ni_nid) {
2552 * in case we initially started with a routed
2553 * destination, let's reset to local
2555 sd->sd_send_case &= ~REMOTE_DST;
2556 sd->sd_send_case |= LOCAL_DST;
2557 return lnet_handle_lo_send(sd);
2558 } else if (sd->sd_best_lpni) {
2560 * in case we initially started with a routed
2561 * destination, let's reset to local
2563 sd->sd_send_case &= ~REMOTE_DST;
2564 sd->sd_send_case |= LOCAL_DST;
2565 return lnet_handle_send(sd);
2568 CERROR("Internal Error. Expected to have a best_lpni: "
2570 libcfs_nid2str(sd->sd_src_nid),
2571 libcfs_nid2str(sd->sd_dst_nid));
2577 * Peer doesn't have a local network. Let's see if there is
2578 * a remote network we can reach it on.
2580 return PASS_THROUGH;
2585 * Source NID not specified
2590 * Source NID not speified
2591 * Remote destination
2594 * In both of these cases if we're sending a response, ACK or REPLY, then
2595 * we need to send to the destination NID provided.
2597 * In the remote case let's deal with MR routers.
2602 lnet_handle_any_mr_dst(struct lnet_send_data *sd)
2605 struct lnet_peer *gw_peer = NULL;
2606 struct lnet_peer_ni *gw_lpni = NULL;
2609 * handle sending a response to a remote peer here so we don't
2610 * have to worry about it if we hit lnet_handle_any_mr_dsta()
2612 if (sd->sd_send_case & REMOTE_DST &&
2613 sd->sd_send_case & SND_RESP) {
2614 struct lnet_peer_ni *gw;
2615 struct lnet_peer *gw_peer;
2617 rc = lnet_handle_find_routed_path(sd, sd->sd_dst_nid, &gw,
2620 CERROR("Can't send response to %s. "
2621 "No route available\n",
2622 libcfs_nid2str(sd->sd_dst_nid));
2623 return -EHOSTUNREACH;
2624 } else if (rc > 0) {
2628 sd->sd_best_lpni = gw;
2629 sd->sd_peer = gw_peer;
2631 return lnet_handle_send(sd);
2635 * Even though the NID for the peer might not be on a local network,
2636 * since the peer is MR there could be other interfaces on the
2637 * local network. In that case we'd still like to prefer the local
2638 * network over the routed network. If we're unable to do that
2639 * then we select the best router among the different routed networks,
2640 * and if the router is MR then we can deal with it as such.
2642 rc = lnet_handle_any_mr_dsta(sd);
2643 if (rc != PASS_THROUGH)
2647 * Now that we must route to the destination, we must consider the
2648 * MR case, where the destination has multiple interfaces, some of
2649 * which we can route to and others we do not. For this reason we
2650 * need to select the destination which we can route to and if
2651 * there are multiple, we need to round robin.
2653 rc = lnet_handle_find_routed_path(sd, sd->sd_dst_nid, &gw_lpni,
2658 sd->sd_send_case &= ~LOCAL_DST;
2659 sd->sd_send_case |= REMOTE_DST;
2661 sd->sd_peer = gw_peer;
2662 sd->sd_best_lpni = gw_lpni;
2664 return lnet_handle_send(sd);
2668 * Source not specified
2669 * Remote destination
2672 * Must send to the specified peer NID using the same source NID that
2673 * we've used before. If it's the first time to talk to that peer then
2674 * find the source NI and assign it as preferred to that peer
2677 lnet_handle_any_router_nmr_dst(struct lnet_send_data *sd)
2680 struct lnet_peer_ni *gw_lpni = NULL;
2681 struct lnet_peer *gw_peer = NULL;
2684 * Let's see if we have a preferred NI to talk to this NMR peer
2686 sd->sd_best_ni = lnet_find_existing_preferred_best_ni(sd->sd_best_lpni,
2690 * find the router and that'll find the best NI if we didn't find
2693 rc = lnet_handle_find_routed_path(sd, sd->sd_dst_nid, &gw_lpni,
2699 * set the best_ni we've chosen as the preferred one for
2702 lnet_set_non_mr_pref_nid(sd->sd_best_lpni, sd->sd_best_ni, sd->sd_msg);
2704 /* we'll be sending to the gw */
2705 sd->sd_best_lpni = gw_lpni;
2706 sd->sd_peer = gw_peer;
2708 return lnet_handle_send(sd);
2712 lnet_handle_send_case_locked(struct lnet_send_data *sd)
2715 * turn off the SND_RESP bit.
2716 * It will be checked in the case handling
2718 __u32 send_case = sd->sd_send_case &= ~SND_RESP ;
2720 CDEBUG(D_NET, "Source %s%s to %s %s %s destination\n",
2721 (send_case & SRC_SPEC) ? "Specified: " : "ANY",
2722 (send_case & SRC_SPEC) ? libcfs_nid2str(sd->sd_src_nid) : "",
2723 (send_case & MR_DST) ? "MR: " : "NMR: ",
2724 libcfs_nid2str(sd->sd_dst_nid),
2725 (send_case & LOCAL_DST) ? "local" : "routed");
2727 switch (send_case) {
2729 * For all cases where the source is specified, we should always
2730 * use the destination NID, whether it's an MR destination or not,
2731 * since we're continuing a series of related messages for the
2734 case SRC_SPEC_LOCAL_NMR_DST:
2735 return lnet_handle_spec_local_nmr_dst(sd);
2736 case SRC_SPEC_LOCAL_MR_DST:
2737 return lnet_handle_spec_local_mr_dst(sd);
2738 case SRC_SPEC_ROUTER_NMR_DST:
2739 case SRC_SPEC_ROUTER_MR_DST:
2740 return lnet_handle_spec_router_dst(sd);
2741 case SRC_ANY_LOCAL_NMR_DST:
2742 return lnet_handle_any_local_nmr_dst(sd);
2743 case SRC_ANY_LOCAL_MR_DST:
2744 case SRC_ANY_ROUTER_MR_DST:
2745 return lnet_handle_any_mr_dst(sd);
2746 case SRC_ANY_ROUTER_NMR_DST:
2747 return lnet_handle_any_router_nmr_dst(sd);
2749 CERROR("Unknown send case\n");
2755 lnet_select_pathway(lnet_nid_t src_nid, lnet_nid_t dst_nid,
2756 struct lnet_msg *msg, lnet_nid_t rtr_nid)
2758 struct lnet_peer_ni *lpni;
2759 struct lnet_peer *peer;
2760 struct lnet_send_data send_data;
2763 __u32 send_case = 0;
2765 bool mr_forwarding_allowed;
2767 memset(&send_data, 0, sizeof(send_data));
2770 * get an initial CPT to use for locking. The idea here is not to
2771 * serialize the calls to select_pathway, so that as many
2772 * operations can run concurrently as possible. To do that we use
2773 * the CPT where this call is being executed. Later on when we
2774 * determine the CPT to use in lnet_message_commit, we switch the
2775 * lock and check if there was any configuration change. If none,
2776 * then we proceed, if there is, then we restart the operation.
2778 cpt = lnet_net_lock_current();
2780 md_cpt = lnet_cpt_of_md(msg->msg_md, msg->msg_offset);
2781 if (md_cpt == CFS_CPT_ANY)
2787 * If we're being asked to send to the loopback interface, there
2788 * is no need to go through any selection. We can just shortcut
2789 * the entire process and send over lolnd
2791 send_data.sd_msg = msg;
2792 send_data.sd_cpt = cpt;
2793 if (dst_nid == LNET_NID_LO_0) {
2794 rc = lnet_handle_lo_send(&send_data);
2795 lnet_net_unlock(cpt);
2800 * find an existing peer_ni, or create one and mark it as having been
2801 * created due to network traffic. This call will create the
2802 * peer->peer_net->peer_ni tree.
2804 lpni = lnet_nid2peerni_locked(dst_nid, LNET_NID_ANY, cpt);
2806 lnet_net_unlock(cpt);
2807 return PTR_ERR(lpni);
2811 * Cache the original src_nid and rtr_nid. If we need to resend the
2812 * message then we'll need to know whether the src_nid was originally
2813 * specified for this message. If it was originally specified,
2814 * then we need to keep using the same src_nid since it's
2815 * continuing the same sequence of messages. Similarly, rtr_nid will
2816 * affect our choice of next hop.
2818 msg->msg_src_nid_param = src_nid;
2819 msg->msg_rtr_nid_param = rtr_nid;
2822 * If necessary, perform discovery on the peer that owns this peer_ni.
2823 * Note, this can result in the ownership of this peer_ni changing
2824 * to another peer object.
2826 rc = lnet_initiate_peer_discovery(lpni, msg, cpt);
2828 lnet_peer_ni_decref_locked(lpni);
2829 lnet_net_unlock(cpt);
2832 lnet_peer_ni_decref_locked(lpni);
2834 peer = lpni->lpni_peer_net->lpn_peer;
2837 * Identify the different send cases
2839 if (src_nid == LNET_NID_ANY)
2840 send_case |= SRC_ANY;
2842 send_case |= SRC_SPEC;
2844 if (lnet_get_net_locked(LNET_NIDNET(dst_nid)))
2845 send_case |= LOCAL_DST;
2847 send_case |= REMOTE_DST;
2850 if (msg->msg_routing && (send_case & LOCAL_DST))
2853 /* Determine whether to allow MR forwarding for this message.
2854 * NB: MR forwarding is allowed if the message originator and the
2855 * destination are both MR capable, and the destination lpni that was
2856 * originally chosen by the originator is unhealthy or down.
2857 * We check the MR capability of the destination further below
2859 mr_forwarding_allowed = false;
2861 struct lnet_peer *src_lp;
2862 struct lnet_peer_ni *src_lpni;
2864 src_lpni = lnet_nid2peerni_locked(msg->msg_hdr.src_nid,
2866 /* We don't fail the send if we hit any errors here. We'll just
2867 * try to send it via non-multi-rail criteria
2869 if (!IS_ERR(src_lpni)) {
2870 /* Drop ref taken by lnet_nid2peerni_locked() */
2871 lnet_peer_ni_decref_locked(src_lpni);
2872 src_lp = lpni->lpni_peer_net->lpn_peer;
2873 if (lnet_peer_is_multi_rail(src_lp) &&
2874 !lnet_is_peer_ni_alive(lpni))
2875 mr_forwarding_allowed = true;
2878 CDEBUG(D_NET, "msg %p MR forwarding %s\n", msg,
2879 mr_forwarding_allowed ? "allowed" : "not allowed");
2883 * Deal with the peer as NMR in the following cases:
2884 * 1. the peer is NMR
2885 * 2. We're trying to recover a specific peer NI
2886 * 3. I'm a router sending to the final destination and MR forwarding is
2887 * not allowed for this message (as determined above).
2888 * In this case the source of the message would've
2889 * already selected the final destination so my job
2890 * is to honor the selection.
2892 if (!lnet_peer_is_multi_rail(peer) || msg->msg_recovery ||
2893 (final_hop && !mr_forwarding_allowed))
2894 send_case |= NMR_DST;
2896 send_case |= MR_DST;
2898 if (lnet_msg_is_response(msg))
2899 send_case |= SND_RESP;
2901 /* assign parameters to the send_data */
2902 send_data.sd_rtr_nid = rtr_nid;
2903 send_data.sd_src_nid = src_nid;
2904 send_data.sd_dst_nid = dst_nid;
2905 send_data.sd_best_lpni = lpni;
2907 * keep a pointer to the final destination in case we're going to
2908 * route, so we'll need to access it later
2910 send_data.sd_final_dst_lpni = lpni;
2911 send_data.sd_peer = peer;
2912 send_data.sd_md_cpt = md_cpt;
2913 send_data.sd_send_case = send_case;
2915 rc = lnet_handle_send_case_locked(&send_data);
2918 * Update the local cpt since send_data.sd_cpt might've been
2919 * updated as a result of calling lnet_handle_send_case_locked().
2921 cpt = send_data.sd_cpt;
2923 if (rc == REPEAT_SEND)
2926 lnet_net_unlock(cpt);
2932 lnet_send(lnet_nid_t src_nid, struct lnet_msg *msg, lnet_nid_t rtr_nid)
2934 lnet_nid_t dst_nid = msg->msg_target.nid;
2938 * NB: rtr_nid is set to LNET_NID_ANY for all current use-cases,
2939 * but we might want to use pre-determined router for ACK/REPLY
2942 /* NB: ni != NULL == interface pre-determined (ACK/REPLY) */
2943 LASSERT(msg->msg_txpeer == NULL);
2944 LASSERT(msg->msg_txni == NULL);
2945 LASSERT(!msg->msg_sending);
2946 LASSERT(!msg->msg_target_is_router);
2947 LASSERT(!msg->msg_receiving);
2949 msg->msg_sending = 1;
2951 LASSERT(!msg->msg_tx_committed);
2953 rc = lnet_select_pathway(src_nid, dst_nid, msg, rtr_nid);
2955 if (rc == -EHOSTUNREACH)
2956 msg->msg_health_status = LNET_MSG_STATUS_REMOTE_ERROR;
2958 msg->msg_health_status = LNET_MSG_STATUS_LOCAL_ERROR;
2962 if (rc == LNET_CREDIT_OK)
2963 lnet_ni_send(msg->msg_txni, msg);
2965 /* rc == LNET_CREDIT_OK or LNET_CREDIT_WAIT or LNET_DC_WAIT */
2969 enum lnet_mt_event_type {
2970 MT_TYPE_LOCAL_NI = 0,
2974 struct lnet_mt_event_info {
2975 enum lnet_mt_event_type mt_type;
2979 /* called with res_lock held */
2981 lnet_detach_rsp_tracker(struct lnet_libmd *md, int cpt)
2983 struct lnet_rsp_tracker *rspt;
2986 * msg has a refcount on the MD so the MD is not going away.
2987 * The rspt queue for the cpt is protected by
2988 * the lnet_net_lock(cpt). cpt is the cpt of the MD cookie.
2990 if (!md->md_rspt_ptr)
2993 rspt = md->md_rspt_ptr;
2996 LASSERT(rspt->rspt_cpt == cpt);
2998 md->md_rspt_ptr = NULL;
3000 if (LNetMDHandleIsInvalid(rspt->rspt_mdh)) {
3002 * The monitor thread has invalidated this handle because the
3003 * response timed out, but it failed to lookup the MD. That
3004 * means this response tracker is on the zombie list. We can
3005 * safely remove it under the resource lock (held by caller) and
3006 * free the response tracker block.
3008 list_del(&rspt->rspt_on_list);
3009 lnet_rspt_free(rspt, cpt);
3012 * invalidate the handle to indicate that a response has been
3013 * received, which will then lead the monitor thread to clean up
3016 LNetInvalidateMDHandle(&rspt->rspt_mdh);
3021 lnet_clean_zombie_rstqs(void)
3023 struct lnet_rsp_tracker *rspt, *tmp;
3026 cfs_cpt_for_each(i, lnet_cpt_table()) {
3027 list_for_each_entry_safe(rspt, tmp,
3028 the_lnet.ln_mt_zombie_rstqs[i],
3030 list_del(&rspt->rspt_on_list);
3031 lnet_rspt_free(rspt, i);
3035 cfs_percpt_free(the_lnet.ln_mt_zombie_rstqs);
3039 lnet_finalize_expired_responses(void)
3041 struct lnet_libmd *md;
3042 struct lnet_rsp_tracker *rspt, *tmp;
3046 if (the_lnet.ln_mt_rstq == NULL)
3049 cfs_cpt_for_each(i, lnet_cpt_table()) {
3050 LIST_HEAD(local_queue);
3053 if (!the_lnet.ln_mt_rstq[i]) {
3057 list_splice_init(the_lnet.ln_mt_rstq[i], &local_queue);
3062 list_for_each_entry_safe(rspt, tmp, &local_queue, rspt_on_list) {
3064 * The rspt mdh will be invalidated when a response
3065 * is received or whenever we want to discard the
3066 * block the monitor thread will walk the queue
3067 * and clean up any rsts with an invalid mdh.
3068 * The monitor thread will walk the queue until
3069 * the first unexpired rspt block. This means that
3070 * some rspt blocks which received their
3071 * corresponding responses will linger in the
3072 * queue until they are cleaned up eventually.
3075 if (LNetMDHandleIsInvalid(rspt->rspt_mdh)) {
3077 list_del(&rspt->rspt_on_list);
3078 lnet_rspt_free(rspt, i);
3082 if (ktime_compare(now, rspt->rspt_deadline) >= 0 ||
3083 the_lnet.ln_mt_state == LNET_MT_STATE_SHUTDOWN) {
3084 struct lnet_peer_ni *lpni;
3087 md = lnet_handle2md(&rspt->rspt_mdh);
3089 /* MD has been queued for unlink, but
3090 * rspt hasn't been detached (Note we've
3091 * checked above that the rspt_mdh is
3092 * valid). Since we cannot lookup the MD
3093 * we're unable to detach the rspt
3094 * ourselves. Thus, move the rspt to the
3095 * zombie list where we'll wait for
3097 * 1. The remaining operations on the
3098 * MD to complete. In this case the
3099 * final operation will result in
3100 * lnet_msg_detach_md()->
3101 * lnet_detach_rsp_tracker() where
3102 * we will clean up this response
3104 * 2. LNet to shutdown. In this case
3105 * we'll wait until after all LND Nets
3106 * have shutdown and then we can
3107 * safely free any remaining response
3108 * tracker blocks on the zombie list.
3109 * Note: We need to hold the resource
3110 * lock when adding to the zombie list
3111 * because we may have concurrent access
3112 * with lnet_detach_rsp_tracker().
3114 LNetInvalidateMDHandle(&rspt->rspt_mdh);
3115 list_move(&rspt->rspt_on_list,
3116 the_lnet.ln_mt_zombie_rstqs[i]);
3120 LASSERT(md->md_rspt_ptr == rspt);
3121 md->md_rspt_ptr = NULL;
3124 LNetMDUnlink(rspt->rspt_mdh);
3126 nid = rspt->rspt_next_hop_nid;
3128 list_del(&rspt->rspt_on_list);
3129 lnet_rspt_free(rspt, i);
3131 /* If we're shutting down we just want to clean
3132 * up the rspt blocks
3134 if (the_lnet.ln_mt_state == LNET_MT_STATE_SHUTDOWN)
3138 the_lnet.ln_counters[i]->lct_health.lch_response_timeout_count++;
3142 "Response timeout: md = %p: nid = %s\n",
3143 md, libcfs_nid2str(nid));
3146 * If there is a timeout on the response
3147 * from the next hop decrement its health
3148 * value so that we don't use it
3151 lpni = lnet_find_peer_ni_locked(nid);
3153 lnet_handle_remote_failure_locked(lpni);
3154 lnet_peer_ni_decref_locked(lpni);
3163 if (!list_empty(&local_queue)) {
3165 list_splice(&local_queue, the_lnet.ln_mt_rstq[i]);
3172 lnet_resend_pending_msgs_locked(struct list_head *resendq, int cpt)
3174 struct lnet_msg *msg;
3176 while (!list_empty(resendq)) {
3177 struct lnet_peer_ni *lpni;
3179 msg = list_entry(resendq->next, struct lnet_msg,
3182 list_del_init(&msg->msg_list);
3184 lpni = lnet_find_peer_ni_locked(msg->msg_hdr.dest_nid);
3186 lnet_net_unlock(cpt);
3187 CERROR("Expected that a peer is already created for %s\n",
3188 libcfs_nid2str(msg->msg_hdr.dest_nid));
3189 msg->msg_no_resend = true;
3190 lnet_finalize(msg, -EFAULT);
3195 lnet_peer_ni_decref_locked(lpni);
3197 lnet_net_unlock(cpt);