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.sun.com/software/products/lustre/docs/GPLv2.pdf
20 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
21 * CA 95054 USA or visit www.sun.com if you need additional information or
27 * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
28 * Use is subject to license terms.
30 * Copyright (c) 2011, 2012, Intel Corporation.
33 * This file is part of Lustre, http://www.lustre.org/
34 * Lustre is a trademark of Sun Microsystems, Inc.
37 #define DEBUG_SUBSYSTEM S_LNET
38 #include "../../include/linux/lnet/lib-lnet.h"
39 #include <linux/log2.h>
41 #define D_LNI D_CONSOLE
43 lnet_t the_lnet; /* THE state of the network */
44 EXPORT_SYMBOL(the_lnet);
47 static char *ip2nets = "";
48 module_param(ip2nets, charp, 0444);
49 MODULE_PARM_DESC(ip2nets, "LNET network <- IP table");
51 static char *networks = "";
52 module_param(networks, charp, 0444);
53 MODULE_PARM_DESC(networks, "local networks");
55 static char *routes = "";
56 module_param(routes, charp, 0444);
57 MODULE_PARM_DESC(routes, "routes to non-local networks");
59 static int rnet_htable_size = LNET_REMOTE_NETS_HASH_DEFAULT;
60 module_param(rnet_htable_size, int, 0444);
61 MODULE_PARM_DESC(rnet_htable_size, "size of remote network hash table");
70 lnet_get_networks(void)
75 if (*networks != 0 && *ip2nets != 0) {
76 LCONSOLE_ERROR_MSG(0x101, "Please specify EITHER 'networks' or "
77 "'ip2nets' but not both at once\n");
82 rc = lnet_parse_ip2nets(&nets, ip2nets);
83 return (rc == 0) ? nets : NULL;
95 spin_lock_init(&the_lnet.ln_eq_wait_lock);
96 init_waitqueue_head(&the_lnet.ln_eq_waitq);
97 mutex_init(&the_lnet.ln_lnd_mutex);
98 mutex_init(&the_lnet.ln_api_mutex);
102 lnet_fini_locks(void)
108 lnet_create_remote_nets_table(void)
111 struct list_head *hash;
113 LASSERT(the_lnet.ln_remote_nets_hash == NULL);
114 LASSERT(the_lnet.ln_remote_nets_hbits > 0);
115 LIBCFS_ALLOC(hash, LNET_REMOTE_NETS_HASH_SIZE * sizeof(*hash));
117 CERROR("Failed to create remote nets hash table\n");
121 for (i = 0; i < LNET_REMOTE_NETS_HASH_SIZE; i++)
122 INIT_LIST_HEAD(&hash[i]);
123 the_lnet.ln_remote_nets_hash = hash;
128 lnet_destroy_remote_nets_table(void)
132 if (the_lnet.ln_remote_nets_hash == NULL)
135 for (i = 0; i < LNET_REMOTE_NETS_HASH_SIZE; i++)
136 LASSERT(list_empty(&the_lnet.ln_remote_nets_hash[i]));
138 LIBCFS_FREE(the_lnet.ln_remote_nets_hash,
139 LNET_REMOTE_NETS_HASH_SIZE *
140 sizeof(the_lnet.ln_remote_nets_hash[0]));
141 the_lnet.ln_remote_nets_hash = NULL;
145 lnet_destroy_locks(void)
147 if (the_lnet.ln_res_lock != NULL) {
148 cfs_percpt_lock_free(the_lnet.ln_res_lock);
149 the_lnet.ln_res_lock = NULL;
152 if (the_lnet.ln_net_lock != NULL) {
153 cfs_percpt_lock_free(the_lnet.ln_net_lock);
154 the_lnet.ln_net_lock = NULL;
161 lnet_create_locks(void)
165 the_lnet.ln_res_lock = cfs_percpt_lock_alloc(lnet_cpt_table());
166 if (the_lnet.ln_res_lock == NULL)
169 the_lnet.ln_net_lock = cfs_percpt_lock_alloc(lnet_cpt_table());
170 if (the_lnet.ln_net_lock == NULL)
176 lnet_destroy_locks();
180 static void lnet_assert_wire_constants (void)
182 /* Wire protocol assertions generated by 'wirecheck'
183 * running on Linux robert.bartonsoftware.com 2.6.8-1.521
184 * #1 Mon Aug 16 09:01:18 EDT 2004 i686 athlon i386 GNU/Linux
185 * with gcc version 3.3.3 20040412 (Red Hat Linux 3.3.3-7) */
188 CLASSERT (LNET_PROTO_TCP_MAGIC == 0xeebc0ded);
189 CLASSERT (LNET_PROTO_TCP_VERSION_MAJOR == 1);
190 CLASSERT (LNET_PROTO_TCP_VERSION_MINOR == 0);
191 CLASSERT (LNET_MSG_ACK == 0);
192 CLASSERT (LNET_MSG_PUT == 1);
193 CLASSERT (LNET_MSG_GET == 2);
194 CLASSERT (LNET_MSG_REPLY == 3);
195 CLASSERT (LNET_MSG_HELLO == 4);
197 /* Checks for struct ptl_handle_wire_t */
198 CLASSERT ((int)sizeof(lnet_handle_wire_t) == 16);
199 CLASSERT ((int)offsetof(lnet_handle_wire_t, wh_interface_cookie) == 0);
200 CLASSERT ((int)sizeof(((lnet_handle_wire_t *)0)->wh_interface_cookie) == 8);
201 CLASSERT ((int)offsetof(lnet_handle_wire_t, wh_object_cookie) == 8);
202 CLASSERT ((int)sizeof(((lnet_handle_wire_t *)0)->wh_object_cookie) == 8);
204 /* Checks for struct lnet_magicversion_t */
205 CLASSERT ((int)sizeof(lnet_magicversion_t) == 8);
206 CLASSERT ((int)offsetof(lnet_magicversion_t, magic) == 0);
207 CLASSERT ((int)sizeof(((lnet_magicversion_t *)0)->magic) == 4);
208 CLASSERT ((int)offsetof(lnet_magicversion_t, version_major) == 4);
209 CLASSERT ((int)sizeof(((lnet_magicversion_t *)0)->version_major) == 2);
210 CLASSERT ((int)offsetof(lnet_magicversion_t, version_minor) == 6);
211 CLASSERT ((int)sizeof(((lnet_magicversion_t *)0)->version_minor) == 2);
213 /* Checks for struct lnet_hdr_t */
214 CLASSERT ((int)sizeof(lnet_hdr_t) == 72);
215 CLASSERT ((int)offsetof(lnet_hdr_t, dest_nid) == 0);
216 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->dest_nid) == 8);
217 CLASSERT ((int)offsetof(lnet_hdr_t, src_nid) == 8);
218 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->src_nid) == 8);
219 CLASSERT ((int)offsetof(lnet_hdr_t, dest_pid) == 16);
220 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->dest_pid) == 4);
221 CLASSERT ((int)offsetof(lnet_hdr_t, src_pid) == 20);
222 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->src_pid) == 4);
223 CLASSERT ((int)offsetof(lnet_hdr_t, type) == 24);
224 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->type) == 4);
225 CLASSERT ((int)offsetof(lnet_hdr_t, payload_length) == 28);
226 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->payload_length) == 4);
227 CLASSERT ((int)offsetof(lnet_hdr_t, msg) == 32);
228 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg) == 40);
231 CLASSERT ((int)offsetof(lnet_hdr_t, msg.ack.dst_wmd) == 32);
232 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.ack.dst_wmd) == 16);
233 CLASSERT ((int)offsetof(lnet_hdr_t, msg.ack.match_bits) == 48);
234 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.ack.match_bits) == 8);
235 CLASSERT ((int)offsetof(lnet_hdr_t, msg.ack.mlength) == 56);
236 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.ack.mlength) == 4);
239 CLASSERT ((int)offsetof(lnet_hdr_t, msg.put.ack_wmd) == 32);
240 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.put.ack_wmd) == 16);
241 CLASSERT ((int)offsetof(lnet_hdr_t, msg.put.match_bits) == 48);
242 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.put.match_bits) == 8);
243 CLASSERT ((int)offsetof(lnet_hdr_t, msg.put.hdr_data) == 56);
244 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.put.hdr_data) == 8);
245 CLASSERT ((int)offsetof(lnet_hdr_t, msg.put.ptl_index) == 64);
246 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.put.ptl_index) == 4);
247 CLASSERT ((int)offsetof(lnet_hdr_t, msg.put.offset) == 68);
248 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.put.offset) == 4);
251 CLASSERT ((int)offsetof(lnet_hdr_t, msg.get.return_wmd) == 32);
252 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.get.return_wmd) == 16);
253 CLASSERT ((int)offsetof(lnet_hdr_t, msg.get.match_bits) == 48);
254 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.get.match_bits) == 8);
255 CLASSERT ((int)offsetof(lnet_hdr_t, msg.get.ptl_index) == 56);
256 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.get.ptl_index) == 4);
257 CLASSERT ((int)offsetof(lnet_hdr_t, msg.get.src_offset) == 60);
258 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.get.src_offset) == 4);
259 CLASSERT ((int)offsetof(lnet_hdr_t, msg.get.sink_length) == 64);
260 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.get.sink_length) == 4);
263 CLASSERT ((int)offsetof(lnet_hdr_t, msg.reply.dst_wmd) == 32);
264 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.reply.dst_wmd) == 16);
267 CLASSERT ((int)offsetof(lnet_hdr_t, msg.hello.incarnation) == 32);
268 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.hello.incarnation) == 8);
269 CLASSERT ((int)offsetof(lnet_hdr_t, msg.hello.type) == 40);
270 CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.hello.type) == 4);
274 lnet_find_lnd_by_type (int type)
277 struct list_head *tmp;
279 /* holding lnd mutex */
280 list_for_each (tmp, &the_lnet.ln_lnds) {
281 lnd = list_entry(tmp, lnd_t, lnd_list);
283 if ((int)lnd->lnd_type == type)
291 lnet_register_lnd (lnd_t *lnd)
293 LNET_MUTEX_LOCK(&the_lnet.ln_lnd_mutex);
295 LASSERT (the_lnet.ln_init);
296 LASSERT (libcfs_isknown_lnd(lnd->lnd_type));
297 LASSERT (lnet_find_lnd_by_type(lnd->lnd_type) == NULL);
299 list_add_tail (&lnd->lnd_list, &the_lnet.ln_lnds);
300 lnd->lnd_refcount = 0;
302 CDEBUG(D_NET, "%s LND registered\n", libcfs_lnd2str(lnd->lnd_type));
304 LNET_MUTEX_UNLOCK(&the_lnet.ln_lnd_mutex);
306 EXPORT_SYMBOL(lnet_register_lnd);
309 lnet_unregister_lnd (lnd_t *lnd)
311 LNET_MUTEX_LOCK(&the_lnet.ln_lnd_mutex);
313 LASSERT (the_lnet.ln_init);
314 LASSERT (lnet_find_lnd_by_type(lnd->lnd_type) == lnd);
315 LASSERT (lnd->lnd_refcount == 0);
317 list_del (&lnd->lnd_list);
318 CDEBUG(D_NET, "%s LND unregistered\n", libcfs_lnd2str(lnd->lnd_type));
320 LNET_MUTEX_UNLOCK(&the_lnet.ln_lnd_mutex);
322 EXPORT_SYMBOL(lnet_unregister_lnd);
325 lnet_counters_get(lnet_counters_t *counters)
327 lnet_counters_t *ctr;
330 memset(counters, 0, sizeof(*counters));
332 lnet_net_lock(LNET_LOCK_EX);
334 cfs_percpt_for_each(ctr, i, the_lnet.ln_counters) {
335 counters->msgs_max += ctr->msgs_max;
336 counters->msgs_alloc += ctr->msgs_alloc;
337 counters->errors += ctr->errors;
338 counters->send_count += ctr->send_count;
339 counters->recv_count += ctr->recv_count;
340 counters->route_count += ctr->route_count;
341 counters->drop_count += ctr->drop_count;
342 counters->send_length += ctr->send_length;
343 counters->recv_length += ctr->recv_length;
344 counters->route_length += ctr->route_length;
345 counters->drop_length += ctr->drop_length;
348 lnet_net_unlock(LNET_LOCK_EX);
350 EXPORT_SYMBOL(lnet_counters_get);
353 lnet_counters_reset(void)
355 lnet_counters_t *counters;
358 lnet_net_lock(LNET_LOCK_EX);
360 cfs_percpt_for_each(counters, i, the_lnet.ln_counters)
361 memset(counters, 0, sizeof(lnet_counters_t));
363 lnet_net_unlock(LNET_LOCK_EX);
365 EXPORT_SYMBOL(lnet_counters_reset);
367 #ifdef LNET_USE_LIB_FREELIST
370 lnet_freelist_init (lnet_freelist_t *fl, int n, int size)
376 size += offsetof (lnet_freeobj_t, fo_contents);
378 LIBCFS_ALLOC(space, n * size);
382 INIT_LIST_HEAD (&fl->fl_list);
385 fl->fl_objsize = size;
388 memset (space, 0, size);
389 list_add ((struct list_head *)space, &fl->fl_list);
397 lnet_freelist_fini (lnet_freelist_t *fl)
399 struct list_head *el;
402 if (fl->fl_nobjs == 0)
406 for (el = fl->fl_list.next; el != &fl->fl_list; el = el->next)
409 LASSERT (count == fl->fl_nobjs);
411 LIBCFS_FREE(fl->fl_objs, fl->fl_nobjs * fl->fl_objsize);
412 memset (fl, 0, sizeof (*fl));
415 #endif /* LNET_USE_LIB_FREELIST */
418 lnet_create_interface_cookie (void)
420 /* NB the interface cookie in wire handles guards against delayed
421 * replies and ACKs appearing valid after reboot. Initialisation time,
422 * even if it's only implemented to millisecond resolution is probably
423 * easily good enough. */
427 do_gettimeofday(&tv);
430 cookie += tv.tv_usec;
435 lnet_res_type2str(int type)
440 case LNET_COOKIE_TYPE_MD:
442 case LNET_COOKIE_TYPE_ME:
444 case LNET_COOKIE_TYPE_EQ:
450 lnet_res_container_cleanup(struct lnet_res_container *rec)
454 if (rec->rec_type == 0) /* not set yet, it's uninitialized */
457 while (!list_empty(&rec->rec_active)) {
458 struct list_head *e = rec->rec_active.next;
461 if (rec->rec_type == LNET_COOKIE_TYPE_EQ) {
462 lnet_eq_free(list_entry(e, lnet_eq_t, eq_list));
464 } else if (rec->rec_type == LNET_COOKIE_TYPE_MD) {
465 lnet_md_free(list_entry(e, lnet_libmd_t, md_list));
467 } else { /* NB: Active MEs should be attached on portals */
474 /* Found alive MD/ME/EQ, user really should unlink/free
475 * all of them before finalize LNet, but if someone didn't,
476 * we have to recycle garbage for him */
477 CERROR("%d active elements on exit of %s container\n",
478 count, lnet_res_type2str(rec->rec_type));
481 #ifdef LNET_USE_LIB_FREELIST
482 lnet_freelist_fini(&rec->rec_freelist);
484 if (rec->rec_lh_hash != NULL) {
485 LIBCFS_FREE(rec->rec_lh_hash,
486 LNET_LH_HASH_SIZE * sizeof(rec->rec_lh_hash[0]));
487 rec->rec_lh_hash = NULL;
490 rec->rec_type = 0; /* mark it as finalized */
494 lnet_res_container_setup(struct lnet_res_container *rec,
495 int cpt, int type, int objnum, int objsz)
500 LASSERT(rec->rec_type == 0);
502 rec->rec_type = type;
503 INIT_LIST_HEAD(&rec->rec_active);
505 #ifdef LNET_USE_LIB_FREELIST
506 memset(&rec->rec_freelist, 0, sizeof(rec->rec_freelist));
507 rc = lnet_freelist_init(&rec->rec_freelist, objnum, objsz);
511 rec->rec_lh_cookie = (cpt << LNET_COOKIE_TYPE_BITS) | type;
513 /* Arbitrary choice of hash table size */
514 LIBCFS_CPT_ALLOC(rec->rec_lh_hash, lnet_cpt_table(), cpt,
515 LNET_LH_HASH_SIZE * sizeof(rec->rec_lh_hash[0]));
516 if (rec->rec_lh_hash == NULL) {
521 for (i = 0; i < LNET_LH_HASH_SIZE; i++)
522 INIT_LIST_HEAD(&rec->rec_lh_hash[i]);
527 CERROR("Failed to setup %s resource container\n",
528 lnet_res_type2str(type));
529 lnet_res_container_cleanup(rec);
534 lnet_res_containers_destroy(struct lnet_res_container **recs)
536 struct lnet_res_container *rec;
539 cfs_percpt_for_each(rec, i, recs)
540 lnet_res_container_cleanup(rec);
542 cfs_percpt_free(recs);
545 static struct lnet_res_container **
546 lnet_res_containers_create(int type, int objnum, int objsz)
548 struct lnet_res_container **recs;
549 struct lnet_res_container *rec;
553 recs = cfs_percpt_alloc(lnet_cpt_table(), sizeof(*rec));
555 CERROR("Failed to allocate %s resource containers\n",
556 lnet_res_type2str(type));
560 cfs_percpt_for_each(rec, i, recs) {
561 rc = lnet_res_container_setup(rec, i, type, objnum, objsz);
563 lnet_res_containers_destroy(recs);
572 lnet_res_lh_lookup(struct lnet_res_container *rec, __u64 cookie)
574 /* ALWAYS called with lnet_res_lock held */
575 struct list_head *head;
576 lnet_libhandle_t *lh;
579 if ((cookie & LNET_COOKIE_MASK) != rec->rec_type)
582 hash = cookie >> (LNET_COOKIE_TYPE_BITS + LNET_CPT_BITS);
583 head = &rec->rec_lh_hash[hash & LNET_LH_HASH_MASK];
585 list_for_each_entry(lh, head, lh_hash_chain) {
586 if (lh->lh_cookie == cookie)
594 lnet_res_lh_initialize(struct lnet_res_container *rec, lnet_libhandle_t *lh)
596 /* ALWAYS called with lnet_res_lock held */
597 unsigned int ibits = LNET_COOKIE_TYPE_BITS + LNET_CPT_BITS;
600 lh->lh_cookie = rec->rec_lh_cookie;
601 rec->rec_lh_cookie += 1 << ibits;
603 hash = (lh->lh_cookie >> ibits) & LNET_LH_HASH_MASK;
605 list_add(&lh->lh_hash_chain, &rec->rec_lh_hash[hash]);
609 int lnet_unprepare(void);
612 lnet_prepare(lnet_pid_t requested_pid)
614 /* Prepare to bring up the network */
615 struct lnet_res_container **recs;
618 LASSERT (the_lnet.ln_refcount == 0);
620 the_lnet.ln_routing = 0;
622 LASSERT ((requested_pid & LNET_PID_USERFLAG) == 0);
623 the_lnet.ln_pid = requested_pid;
625 INIT_LIST_HEAD(&the_lnet.ln_test_peers);
626 INIT_LIST_HEAD(&the_lnet.ln_nis);
627 INIT_LIST_HEAD(&the_lnet.ln_nis_cpt);
628 INIT_LIST_HEAD(&the_lnet.ln_nis_zombie);
629 INIT_LIST_HEAD(&the_lnet.ln_routers);
631 rc = lnet_create_remote_nets_table();
635 the_lnet.ln_interface_cookie = lnet_create_interface_cookie();
637 the_lnet.ln_counters = cfs_percpt_alloc(lnet_cpt_table(),
638 sizeof(lnet_counters_t));
639 if (the_lnet.ln_counters == NULL) {
640 CERROR("Failed to allocate counters for LNet\n");
645 rc = lnet_peer_tables_create();
649 rc = lnet_msg_containers_create();
653 rc = lnet_res_container_setup(&the_lnet.ln_eq_container, 0,
654 LNET_COOKIE_TYPE_EQ, LNET_FL_MAX_EQS,
659 recs = lnet_res_containers_create(LNET_COOKIE_TYPE_ME, LNET_FL_MAX_MES,
664 the_lnet.ln_me_containers = recs;
666 recs = lnet_res_containers_create(LNET_COOKIE_TYPE_MD, LNET_FL_MAX_MDS,
667 sizeof(lnet_libmd_t));
671 the_lnet.ln_md_containers = recs;
673 rc = lnet_portals_create();
675 CERROR("Failed to create portals for LNet: %d\n", rc);
687 lnet_unprepare (void)
689 /* NB no LNET_LOCK since this is the last reference. All LND instances
690 * have shut down already, so it is safe to unlink and free all
691 * descriptors, even those that appear committed to a network op (eg MD
692 * with non-zero pending count) */
694 lnet_fail_nid(LNET_NID_ANY, 0);
696 LASSERT(the_lnet.ln_refcount == 0);
697 LASSERT(list_empty(&the_lnet.ln_test_peers));
698 LASSERT(list_empty(&the_lnet.ln_nis));
699 LASSERT(list_empty(&the_lnet.ln_nis_cpt));
700 LASSERT(list_empty(&the_lnet.ln_nis_zombie));
702 lnet_portals_destroy();
704 if (the_lnet.ln_md_containers != NULL) {
705 lnet_res_containers_destroy(the_lnet.ln_md_containers);
706 the_lnet.ln_md_containers = NULL;
709 if (the_lnet.ln_me_containers != NULL) {
710 lnet_res_containers_destroy(the_lnet.ln_me_containers);
711 the_lnet.ln_me_containers = NULL;
714 lnet_res_container_cleanup(&the_lnet.ln_eq_container);
716 lnet_msg_containers_destroy();
717 lnet_peer_tables_destroy();
718 lnet_rtrpools_free();
720 if (the_lnet.ln_counters != NULL) {
721 cfs_percpt_free(the_lnet.ln_counters);
722 the_lnet.ln_counters = NULL;
724 lnet_destroy_remote_nets_table();
730 lnet_net2ni_locked(__u32 net, int cpt)
732 struct list_head *tmp;
735 LASSERT(cpt != LNET_LOCK_EX);
737 list_for_each(tmp, &the_lnet.ln_nis) {
738 ni = list_entry(tmp, lnet_ni_t, ni_list);
740 if (LNET_NIDNET(ni->ni_nid) == net) {
741 lnet_ni_addref_locked(ni, cpt);
750 lnet_net2ni(__u32 net)
755 ni = lnet_net2ni_locked(net, 0);
760 EXPORT_SYMBOL(lnet_net2ni);
763 lnet_nid_cpt_hash(lnet_nid_t nid, unsigned int number)
768 LASSERT(number >= 1 && number <= LNET_CPT_NUMBER);
773 val = hash_long(key, LNET_CPT_BITS);
774 /* NB: LNET_CP_NUMBER doesn't have to be PO2 */
778 return (unsigned int)(key + val + (val >> 1)) % number;
782 lnet_cpt_of_nid_locked(lnet_nid_t nid)
786 /* must called with hold of lnet_net_lock */
787 if (LNET_CPT_NUMBER == 1)
788 return 0; /* the only one */
790 /* take lnet_net_lock(any) would be OK */
791 if (!list_empty(&the_lnet.ln_nis_cpt)) {
792 list_for_each_entry(ni, &the_lnet.ln_nis_cpt, ni_cptlist) {
793 if (LNET_NIDNET(ni->ni_nid) != LNET_NIDNET(nid))
796 LASSERT(ni->ni_cpts != NULL);
797 return ni->ni_cpts[lnet_nid_cpt_hash
798 (nid, ni->ni_ncpts)];
802 return lnet_nid_cpt_hash(nid, LNET_CPT_NUMBER);
806 lnet_cpt_of_nid(lnet_nid_t nid)
811 if (LNET_CPT_NUMBER == 1)
812 return 0; /* the only one */
814 if (list_empty(&the_lnet.ln_nis_cpt))
815 return lnet_nid_cpt_hash(nid, LNET_CPT_NUMBER);
817 cpt = lnet_net_lock_current();
818 cpt2 = lnet_cpt_of_nid_locked(nid);
819 lnet_net_unlock(cpt);
823 EXPORT_SYMBOL(lnet_cpt_of_nid);
826 lnet_islocalnet(__u32 net)
831 cpt = lnet_net_lock_current();
833 ni = lnet_net2ni_locked(net, cpt);
835 lnet_ni_decref_locked(ni, cpt);
837 lnet_net_unlock(cpt);
843 lnet_nid2ni_locked(lnet_nid_t nid, int cpt)
846 struct list_head *tmp;
848 LASSERT(cpt != LNET_LOCK_EX);
850 list_for_each(tmp, &the_lnet.ln_nis) {
851 ni = list_entry(tmp, lnet_ni_t, ni_list);
853 if (ni->ni_nid == nid) {
854 lnet_ni_addref_locked(ni, cpt);
863 lnet_islocalnid(lnet_nid_t nid)
868 cpt = lnet_net_lock_current();
869 ni = lnet_nid2ni_locked(nid, cpt);
871 lnet_ni_decref_locked(ni, cpt);
872 lnet_net_unlock(cpt);
878 lnet_count_acceptor_nis (void)
880 /* Return the # of NIs that need the acceptor. */
882 struct list_head *tmp;
886 cpt = lnet_net_lock_current();
887 list_for_each(tmp, &the_lnet.ln_nis) {
888 ni = list_entry(tmp, lnet_ni_t, ni_list);
890 if (ni->ni_lnd->lnd_accept != NULL)
894 lnet_net_unlock(cpt);
900 lnet_ni_tq_credits(lnet_ni_t *ni)
904 LASSERT(ni->ni_ncpts >= 1);
906 if (ni->ni_ncpts == 1)
907 return ni->ni_maxtxcredits;
909 credits = ni->ni_maxtxcredits / ni->ni_ncpts;
910 credits = max(credits, 8 * ni->ni_peertxcredits);
911 credits = min(credits, ni->ni_maxtxcredits);
917 lnet_shutdown_lndnis (void)
923 /* NB called holding the global mutex */
925 /* All quiet on the API front */
926 LASSERT(!the_lnet.ln_shutdown);
927 LASSERT(the_lnet.ln_refcount == 0);
928 LASSERT(list_empty(&the_lnet.ln_nis_zombie));
930 lnet_net_lock(LNET_LOCK_EX);
931 the_lnet.ln_shutdown = 1; /* flag shutdown */
933 /* Unlink NIs from the global table */
934 while (!list_empty(&the_lnet.ln_nis)) {
935 ni = list_entry(the_lnet.ln_nis.next,
937 /* move it to zombie list and nobody can find it anymore */
938 list_move(&ni->ni_list, &the_lnet.ln_nis_zombie);
939 lnet_ni_decref_locked(ni, 0); /* drop ln_nis' ref */
941 if (!list_empty(&ni->ni_cptlist)) {
942 list_del_init(&ni->ni_cptlist);
943 lnet_ni_decref_locked(ni, 0);
947 /* Drop the cached eqwait NI. */
948 if (the_lnet.ln_eq_waitni != NULL) {
949 lnet_ni_decref_locked(the_lnet.ln_eq_waitni, 0);
950 the_lnet.ln_eq_waitni = NULL;
953 /* Drop the cached loopback NI. */
954 if (the_lnet.ln_loni != NULL) {
955 lnet_ni_decref_locked(the_lnet.ln_loni, 0);
956 the_lnet.ln_loni = NULL;
959 lnet_net_unlock(LNET_LOCK_EX);
961 /* Clear lazy portals and drop delayed messages which hold refs
962 * on their lnet_msg_t::msg_rxpeer */
963 for (i = 0; i < the_lnet.ln_nportals; i++)
964 LNetClearLazyPortal(i);
966 /* Clear the peer table and wait for all peers to go (they hold refs on
968 lnet_peer_tables_cleanup();
970 lnet_net_lock(LNET_LOCK_EX);
971 /* Now wait for the NI's I just nuked to show up on ln_zombie_nis
972 * and shut them down in guaranteed thread context */
974 while (!list_empty(&the_lnet.ln_nis_zombie)) {
978 ni = list_entry(the_lnet.ln_nis_zombie.next,
980 list_del_init(&ni->ni_list);
981 cfs_percpt_for_each(ref, j, ni->ni_refs) {
984 /* still busy, add it back to zombie list */
985 list_add(&ni->ni_list, &the_lnet.ln_nis_zombie);
989 if (!list_empty(&ni->ni_list)) {
990 lnet_net_unlock(LNET_LOCK_EX);
992 if ((i & (-i)) == i) {
993 CDEBUG(D_WARNING, "Waiting for zombie LNI %s\n",
994 libcfs_nid2str(ni->ni_nid));
996 set_current_state(TASK_UNINTERRUPTIBLE);
997 schedule_timeout(cfs_time_seconds(1));
998 lnet_net_lock(LNET_LOCK_EX);
1002 ni->ni_lnd->lnd_refcount--;
1003 lnet_net_unlock(LNET_LOCK_EX);
1005 islo = ni->ni_lnd->lnd_type == LOLND;
1007 LASSERT (!in_interrupt ());
1008 (ni->ni_lnd->lnd_shutdown)(ni);
1010 /* can't deref lnd anymore now; it might have unregistered
1014 CDEBUG(D_LNI, "Removed LNI %s\n",
1015 libcfs_nid2str(ni->ni_nid));
1020 lnet_net_lock(LNET_LOCK_EX);
1023 the_lnet.ln_shutdown = 0;
1024 lnet_net_unlock(LNET_LOCK_EX);
1026 if (the_lnet.ln_network_tokens != NULL) {
1027 LIBCFS_FREE(the_lnet.ln_network_tokens,
1028 the_lnet.ln_network_tokens_nob);
1029 the_lnet.ln_network_tokens = NULL;
1034 lnet_startup_lndnis (void)
1038 struct lnet_tx_queue *tq;
1039 struct list_head nilist;
1044 char *nets = lnet_get_networks();
1046 INIT_LIST_HEAD(&nilist);
1051 rc = lnet_parse_networks(&nilist, nets);
1055 while (!list_empty(&nilist)) {
1056 ni = list_entry(nilist.next, lnet_ni_t, ni_list);
1057 lnd_type = LNET_NETTYP(LNET_NIDNET(ni->ni_nid));
1059 LASSERT (libcfs_isknown_lnd(lnd_type));
1061 if (lnd_type == CIBLND ||
1062 lnd_type == OPENIBLND ||
1063 lnd_type == IIBLND ||
1064 lnd_type == VIBLND) {
1065 CERROR("LND %s obsoleted\n",
1066 libcfs_lnd2str(lnd_type));
1070 LNET_MUTEX_LOCK(&the_lnet.ln_lnd_mutex);
1071 lnd = lnet_find_lnd_by_type(lnd_type);
1074 LNET_MUTEX_UNLOCK(&the_lnet.ln_lnd_mutex);
1075 rc = request_module("%s",
1076 libcfs_lnd2modname(lnd_type));
1077 LNET_MUTEX_LOCK(&the_lnet.ln_lnd_mutex);
1079 lnd = lnet_find_lnd_by_type(lnd_type);
1081 LNET_MUTEX_UNLOCK(&the_lnet.ln_lnd_mutex);
1082 CERROR("Can't load LND %s, module %s, rc=%d\n",
1083 libcfs_lnd2str(lnd_type),
1084 libcfs_lnd2modname(lnd_type), rc);
1089 lnet_net_lock(LNET_LOCK_EX);
1090 lnd->lnd_refcount++;
1091 lnet_net_unlock(LNET_LOCK_EX);
1095 rc = (lnd->lnd_startup)(ni);
1097 LNET_MUTEX_UNLOCK(&the_lnet.ln_lnd_mutex);
1100 LCONSOLE_ERROR_MSG(0x105, "Error %d starting up LNI %s"
1102 rc, libcfs_lnd2str(lnd->lnd_type));
1103 lnet_net_lock(LNET_LOCK_EX);
1104 lnd->lnd_refcount--;
1105 lnet_net_unlock(LNET_LOCK_EX);
1109 LASSERT (ni->ni_peertimeout <= 0 || lnd->lnd_query != NULL);
1111 list_del(&ni->ni_list);
1113 lnet_net_lock(LNET_LOCK_EX);
1114 /* refcount for ln_nis */
1115 lnet_ni_addref_locked(ni, 0);
1116 list_add_tail(&ni->ni_list, &the_lnet.ln_nis);
1117 if (ni->ni_cpts != NULL) {
1118 list_add_tail(&ni->ni_cptlist,
1119 &the_lnet.ln_nis_cpt);
1120 lnet_ni_addref_locked(ni, 0);
1123 lnet_net_unlock(LNET_LOCK_EX);
1125 if (lnd->lnd_type == LOLND) {
1127 LASSERT (the_lnet.ln_loni == NULL);
1128 the_lnet.ln_loni = ni;
1132 if (ni->ni_peertxcredits == 0 ||
1133 ni->ni_maxtxcredits == 0) {
1134 LCONSOLE_ERROR_MSG(0x107, "LNI %s has no %scredits\n",
1135 libcfs_lnd2str(lnd->lnd_type),
1136 ni->ni_peertxcredits == 0 ?
1141 cfs_percpt_for_each(tq, i, ni->ni_tx_queues) {
1142 tq->tq_credits_min =
1143 tq->tq_credits_max =
1144 tq->tq_credits = lnet_ni_tq_credits(ni);
1147 CDEBUG(D_LNI, "Added LNI %s [%d/%d/%d/%d]\n",
1148 libcfs_nid2str(ni->ni_nid), ni->ni_peertxcredits,
1149 lnet_ni_tq_credits(ni) * LNET_CPT_NUMBER,
1150 ni->ni_peerrtrcredits, ni->ni_peertimeout);
1155 if (the_lnet.ln_eq_waitni != NULL && nicount > 1) {
1156 lnd_type = the_lnet.ln_eq_waitni->ni_lnd->lnd_type;
1157 LCONSOLE_ERROR_MSG(0x109, "LND %s can only run single-network"
1159 libcfs_lnd2str(lnd_type));
1166 lnet_shutdown_lndnis();
1168 while (!list_empty(&nilist)) {
1169 ni = list_entry(nilist.next, lnet_ni_t, ni_list);
1170 list_del(&ni->ni_list);
1178 * Initialize LNet library.
1180 * Only userspace program needs to call this function - it's automatically
1181 * called in the kernel at module loading time. Caller has to call LNetFini()
1182 * after a call to LNetInit(), if and only if the latter returned 0. It must
1183 * be called exactly once.
1185 * \return 0 on success, and -ve on failures.
1192 lnet_assert_wire_constants();
1193 LASSERT(!the_lnet.ln_init);
1195 memset(&the_lnet, 0, sizeof(the_lnet));
1197 /* refer to global cfs_cpt_table for now */
1198 the_lnet.ln_cpt_table = cfs_cpt_table;
1199 the_lnet.ln_cpt_number = cfs_cpt_number(cfs_cpt_table);
1201 LASSERT(the_lnet.ln_cpt_number > 0);
1202 if (the_lnet.ln_cpt_number > LNET_CPT_MAX) {
1203 /* we are under risk of consuming all lh_cookie */
1204 CERROR("Can't have %d CPTs for LNet (max allowed is %d), "
1205 "please change setting of CPT-table and retry\n",
1206 the_lnet.ln_cpt_number, LNET_CPT_MAX);
1210 while ((1 << the_lnet.ln_cpt_bits) < the_lnet.ln_cpt_number)
1211 the_lnet.ln_cpt_bits++;
1213 rc = lnet_create_locks();
1215 CERROR("Can't create LNet global locks: %d\n", rc);
1219 the_lnet.ln_refcount = 0;
1220 the_lnet.ln_init = 1;
1221 LNetInvalidateHandle(&the_lnet.ln_rc_eqh);
1222 INIT_LIST_HEAD(&the_lnet.ln_lnds);
1223 INIT_LIST_HEAD(&the_lnet.ln_rcd_zombie);
1224 INIT_LIST_HEAD(&the_lnet.ln_rcd_deathrow);
1226 /* The hash table size is the number of bits it takes to express the set
1227 * ln_num_routes, minus 1 (better to under estimate than over so we
1228 * don't waste memory). */
1229 if (rnet_htable_size <= 0)
1230 rnet_htable_size = LNET_REMOTE_NETS_HASH_DEFAULT;
1231 else if (rnet_htable_size > LNET_REMOTE_NETS_HASH_MAX)
1232 rnet_htable_size = LNET_REMOTE_NETS_HASH_MAX;
1233 the_lnet.ln_remote_nets_hbits = max_t(int, 1,
1234 order_base_2(rnet_htable_size) - 1);
1236 /* All LNDs apart from the LOLND are in separate modules. They
1237 * register themselves when their module loads, and unregister
1238 * themselves when their module is unloaded. */
1239 lnet_register_lnd(&the_lolnd);
1242 EXPORT_SYMBOL(LNetInit);
1245 * Finalize LNet library.
1247 * Only userspace program needs to call this function. It can be called
1250 * \pre LNetInit() called with success.
1251 * \pre All LNet users called LNetNIFini() for matching LNetNIInit() calls.
1256 LASSERT(the_lnet.ln_init);
1257 LASSERT(the_lnet.ln_refcount == 0);
1259 while (!list_empty(&the_lnet.ln_lnds))
1260 lnet_unregister_lnd(list_entry(the_lnet.ln_lnds.next,
1262 lnet_destroy_locks();
1264 the_lnet.ln_init = 0;
1266 EXPORT_SYMBOL(LNetFini);
1269 * Set LNet PID and start LNet interfaces, routing, and forwarding.
1271 * Userspace program should call this after a successful call to LNetInit().
1272 * Users must call this function at least once before any other functions.
1273 * For each successful call there must be a corresponding call to
1274 * LNetNIFini(). For subsequent calls to LNetNIInit(), \a requested_pid is
1277 * The PID used by LNet may be different from the one requested.
1280 * \param requested_pid PID requested by the caller.
1282 * \return >= 0 on success, and < 0 error code on failures.
1285 LNetNIInit(lnet_pid_t requested_pid)
1287 int im_a_router = 0;
1290 LNET_MUTEX_LOCK(&the_lnet.ln_api_mutex);
1292 LASSERT (the_lnet.ln_init);
1293 CDEBUG(D_OTHER, "refs %d\n", the_lnet.ln_refcount);
1295 if (the_lnet.ln_refcount > 0) {
1296 rc = the_lnet.ln_refcount++;
1300 lnet_get_tunables();
1302 if (requested_pid == LNET_PID_ANY) {
1303 /* Don't instantiate LNET just for me */
1308 rc = lnet_prepare(requested_pid);
1312 rc = lnet_startup_lndnis();
1316 rc = lnet_parse_routes(lnet_get_routes(), &im_a_router);
1320 rc = lnet_check_routes();
1324 rc = lnet_rtrpools_alloc(im_a_router);
1328 rc = lnet_acceptor_start();
1332 the_lnet.ln_refcount = 1;
1333 /* Now I may use my own API functions... */
1335 /* NB router checker needs the_lnet.ln_ping_info in
1336 * lnet_router_checker -> lnet_update_ni_status_locked */
1337 rc = lnet_ping_target_init();
1341 rc = lnet_router_checker_start();
1349 lnet_ping_target_fini();
1351 the_lnet.ln_refcount = 0;
1352 lnet_acceptor_stop();
1354 lnet_destroy_routes();
1355 lnet_shutdown_lndnis();
1361 LNET_MUTEX_UNLOCK(&the_lnet.ln_api_mutex);
1364 EXPORT_SYMBOL(LNetNIInit);
1367 * Stop LNet interfaces, routing, and forwarding.
1369 * Users must call this function once for each successful call to LNetNIInit().
1370 * Once the LNetNIFini() operation has been started, the results of pending
1371 * API operations are undefined.
1373 * \return always 0 for current implementation.
1378 LNET_MUTEX_LOCK(&the_lnet.ln_api_mutex);
1380 LASSERT (the_lnet.ln_init);
1381 LASSERT (the_lnet.ln_refcount > 0);
1383 if (the_lnet.ln_refcount != 1) {
1384 the_lnet.ln_refcount--;
1386 LASSERT (!the_lnet.ln_niinit_self);
1389 lnet_router_checker_stop();
1390 lnet_ping_target_fini();
1392 /* Teardown fns that use my own API functions BEFORE here */
1393 the_lnet.ln_refcount = 0;
1395 lnet_acceptor_stop();
1396 lnet_destroy_routes();
1397 lnet_shutdown_lndnis();
1401 LNET_MUTEX_UNLOCK(&the_lnet.ln_api_mutex);
1404 EXPORT_SYMBOL(LNetNIFini);
1407 * This is an ugly hack to export IOC_LIBCFS_DEBUG_PEER and
1408 * IOC_LIBCFS_PORTALS_COMPATIBILITY commands to users, by tweaking the LNet
1409 * internal ioctl handler.
1411 * IOC_LIBCFS_PORTALS_COMPATIBILITY is now deprecated, don't use it.
1413 * \param cmd IOC_LIBCFS_DEBUG_PEER to print debugging data about a peer.
1414 * The data will be printed to system console. Don't use it excessively.
1415 * \param arg A pointer to lnet_process_id_t, process ID of the peer.
1417 * \return Always return 0 when called by users directly (i.e., not via ioctl).
1420 LNetCtl(unsigned int cmd, void *arg)
1422 struct libcfs_ioctl_data *data = arg;
1423 lnet_process_id_t id = {0};
1427 LASSERT (the_lnet.ln_init);
1428 LASSERT (the_lnet.ln_refcount > 0);
1431 case IOC_LIBCFS_GET_NI:
1432 rc = LNetGetId(data->ioc_count, &id);
1433 data->ioc_nid = id.nid;
1436 case IOC_LIBCFS_FAIL_NID:
1437 return lnet_fail_nid(data->ioc_nid, data->ioc_count);
1439 case IOC_LIBCFS_ADD_ROUTE:
1440 rc = lnet_add_route(data->ioc_net, data->ioc_count,
1441 data->ioc_nid, data->ioc_priority);
1442 return (rc != 0) ? rc : lnet_check_routes();
1444 case IOC_LIBCFS_DEL_ROUTE:
1445 return lnet_del_route(data->ioc_net, data->ioc_nid);
1447 case IOC_LIBCFS_GET_ROUTE:
1448 return lnet_get_route(data->ioc_count,
1449 &data->ioc_net, &data->ioc_count,
1450 &data->ioc_nid, &data->ioc_flags,
1451 &data->ioc_priority);
1452 case IOC_LIBCFS_NOTIFY_ROUTER:
1453 return lnet_notify(NULL, data->ioc_nid, data->ioc_flags,
1454 cfs_time_current() -
1455 cfs_time_seconds(get_seconds() -
1456 (time_t)data->ioc_u64[0]));
1458 case IOC_LIBCFS_PORTALS_COMPATIBILITY:
1459 /* This can be removed once lustre stops calling it */
1462 case IOC_LIBCFS_LNET_DIST:
1463 rc = LNetDist(data->ioc_nid, &data->ioc_nid, &data->ioc_u32[1]);
1464 if (rc < 0 && rc != -EHOSTUNREACH)
1467 data->ioc_u32[0] = rc;
1470 case IOC_LIBCFS_TESTPROTOCOMPAT:
1471 lnet_net_lock(LNET_LOCK_EX);
1472 the_lnet.ln_testprotocompat = data->ioc_flags;
1473 lnet_net_unlock(LNET_LOCK_EX);
1476 case IOC_LIBCFS_PING:
1477 id.nid = data->ioc_nid;
1478 id.pid = data->ioc_u32[0];
1479 rc = lnet_ping(id, data->ioc_u32[1], /* timeout */
1480 (lnet_process_id_t *)data->ioc_pbuf1,
1481 data->ioc_plen1/sizeof(lnet_process_id_t));
1484 data->ioc_count = rc;
1487 case IOC_LIBCFS_DEBUG_PEER: {
1488 /* CAVEAT EMPTOR: this one designed for calling directly; not
1490 id = *((lnet_process_id_t *) arg);
1492 lnet_debug_peer(id.nid);
1494 ni = lnet_net2ni(LNET_NIDNET(id.nid));
1496 CDEBUG(D_WARNING, "No NI for %s\n", libcfs_id2str(id));
1498 if (ni->ni_lnd->lnd_ctl == NULL) {
1499 CDEBUG(D_WARNING, "No ctl for %s\n",
1502 (void)ni->ni_lnd->lnd_ctl(ni, cmd, arg);
1511 ni = lnet_net2ni(data->ioc_net);
1515 if (ni->ni_lnd->lnd_ctl == NULL)
1518 rc = ni->ni_lnd->lnd_ctl(ni, cmd, arg);
1525 EXPORT_SYMBOL(LNetCtl);
1528 * Retrieve the lnet_process_id_t ID of LNet interface at \a index. Note that
1529 * all interfaces share a same PID, as requested by LNetNIInit().
1531 * \param index Index of the interface to look up.
1532 * \param id On successful return, this location will hold the
1533 * lnet_process_id_t ID of the interface.
1535 * \retval 0 If an interface exists at \a index.
1536 * \retval -ENOENT If no interface has been found.
1539 LNetGetId(unsigned int index, lnet_process_id_t *id)
1542 struct list_head *tmp;
1546 LASSERT(the_lnet.ln_init);
1548 /* LNetNI initilization failed? */
1549 if (the_lnet.ln_refcount == 0)
1552 cpt = lnet_net_lock_current();
1554 list_for_each(tmp, &the_lnet.ln_nis) {
1558 ni = list_entry(tmp, lnet_ni_t, ni_list);
1560 id->nid = ni->ni_nid;
1561 id->pid = the_lnet.ln_pid;
1566 lnet_net_unlock(cpt);
1569 EXPORT_SYMBOL(LNetGetId);
1572 * Print a string representation of handle \a h into buffer \a str of
1576 LNetSnprintHandle(char *str, int len, lnet_handle_any_t h)
1578 snprintf(str, len, "%#llx", h.cookie);
1580 EXPORT_SYMBOL(LNetSnprintHandle);
1583 lnet_create_ping_info(void)
1588 unsigned int infosz;
1590 lnet_process_id_t id;
1591 lnet_ping_info_t *pinfo;
1593 for (n = 0; ; n++) {
1594 rc = LNetGetId(n, &id);
1601 infosz = offsetof(lnet_ping_info_t, pi_ni[n]);
1602 LIBCFS_ALLOC(pinfo, infosz);
1603 if (pinfo == NULL) {
1604 CERROR("Can't allocate ping info[%d]\n", n);
1609 pinfo->pi_pid = the_lnet.ln_pid;
1610 pinfo->pi_magic = LNET_PROTO_PING_MAGIC;
1611 pinfo->pi_features = LNET_PING_FEAT_NI_STATUS;
1613 for (i = 0; i < n; i++) {
1614 lnet_ni_status_t *ns = &pinfo->pi_ni[i];
1616 rc = LNetGetId(i, &id);
1619 ns->ns_nid = id.nid;
1620 ns->ns_status = LNET_NI_STATUS_UP;
1624 ni = lnet_nid2ni_locked(id.nid, 0);
1625 LASSERT(ni != NULL);
1628 LASSERT(ni->ni_status == NULL);
1632 lnet_ni_decref_locked(ni, 0);
1636 the_lnet.ln_ping_info = pinfo;
1641 lnet_destroy_ping_info(void)
1647 list_for_each_entry(ni, &the_lnet.ln_nis, ni_list) {
1649 ni->ni_status = NULL;
1655 LIBCFS_FREE(the_lnet.ln_ping_info,
1656 offsetof(lnet_ping_info_t,
1657 pi_ni[the_lnet.ln_ping_info->pi_nnis]));
1658 the_lnet.ln_ping_info = NULL;
1663 lnet_ping_target_init(void)
1665 lnet_md_t md = { NULL };
1666 lnet_handle_me_t meh;
1667 lnet_process_id_t id;
1672 rc = lnet_create_ping_info();
1676 /* We can have a tiny EQ since we only need to see the unlink event on
1677 * teardown, which by definition is the last one! */
1678 rc = LNetEQAlloc(2, LNET_EQ_HANDLER_NONE, &the_lnet.ln_ping_target_eq);
1680 CERROR("Can't allocate ping EQ: %d\n", rc);
1684 memset(&id, 0, sizeof(lnet_process_id_t));
1685 id.nid = LNET_NID_ANY;
1686 id.pid = LNET_PID_ANY;
1688 rc = LNetMEAttach(LNET_RESERVED_PORTAL, id,
1689 LNET_PROTO_PING_MATCHBITS, 0,
1690 LNET_UNLINK, LNET_INS_AFTER,
1693 CERROR("Can't create ping ME: %d\n", rc);
1697 /* initialize md content */
1698 infosz = offsetof(lnet_ping_info_t,
1699 pi_ni[the_lnet.ln_ping_info->pi_nnis]);
1700 md.start = the_lnet.ln_ping_info;
1702 md.threshold = LNET_MD_THRESH_INF;
1704 md.options = LNET_MD_OP_GET | LNET_MD_TRUNCATE |
1705 LNET_MD_MANAGE_REMOTE;
1707 md.eq_handle = the_lnet.ln_ping_target_eq;
1709 rc = LNetMDAttach(meh, md,
1711 &the_lnet.ln_ping_target_md);
1713 CERROR("Can't attach ping MD: %d\n", rc);
1720 rc2 = LNetMEUnlink(meh);
1723 rc2 = LNetEQFree(the_lnet.ln_ping_target_eq);
1726 lnet_destroy_ping_info();
1731 lnet_ping_target_fini(void)
1736 int timeout_ms = 1000;
1737 sigset_t blocked = cfs_block_allsigs();
1739 LNetMDUnlink(the_lnet.ln_ping_target_md);
1740 /* NB md could be busy; this just starts the unlink */
1743 rc = LNetEQPoll(&the_lnet.ln_ping_target_eq, 1,
1744 timeout_ms, &event, &which);
1746 /* I expect overflow... */
1747 LASSERT (rc >= 0 || rc == -EOVERFLOW);
1750 /* timed out: provide a diagnostic */
1751 CWARN("Still waiting for ping MD to unlink\n");
1756 /* Got a valid event */
1761 rc = LNetEQFree(the_lnet.ln_ping_target_eq);
1763 lnet_destroy_ping_info();
1764 cfs_restore_sigs(blocked);
1768 lnet_ping (lnet_process_id_t id, int timeout_ms, lnet_process_id_t *ids, int n_ids)
1770 lnet_handle_eq_t eqh;
1771 lnet_handle_md_t mdh;
1773 lnet_md_t md = { NULL };
1777 const int a_long_time = 60000; /* mS */
1778 int infosz = offsetof(lnet_ping_info_t, pi_ni[n_ids]);
1779 lnet_ping_info_t *info;
1780 lnet_process_id_t tmpid;
1788 id.nid == LNET_NID_ANY ||
1789 timeout_ms > 500000 || /* arbitrary limit! */
1790 n_ids > 20) /* arbitrary limit! */
1793 if (id.pid == LNET_PID_ANY)
1794 id.pid = LUSTRE_SRV_LNET_PID;
1796 LIBCFS_ALLOC(info, infosz);
1800 /* NB 2 events max (including any unlink event) */
1801 rc = LNetEQAlloc(2, LNET_EQ_HANDLER_NONE, &eqh);
1803 CERROR("Can't allocate EQ: %d\n", rc);
1807 /* initialize md content */
1810 md.threshold = 2; /*GET/REPLY*/
1812 md.options = LNET_MD_TRUNCATE;
1816 rc = LNetMDBind(md, LNET_UNLINK, &mdh);
1818 CERROR("Can't bind MD: %d\n", rc);
1822 rc = LNetGet(LNET_NID_ANY, mdh, id,
1823 LNET_RESERVED_PORTAL,
1824 LNET_PROTO_PING_MATCHBITS, 0);
1827 /* Don't CERROR; this could be deliberate! */
1829 rc2 = LNetMDUnlink(mdh);
1832 /* NB must wait for the UNLINK event below... */
1834 timeout_ms = a_long_time;
1838 /* MUST block for unlink to complete */
1840 blocked = cfs_block_allsigs();
1842 rc2 = LNetEQPoll(&eqh, 1, timeout_ms, &event, &which);
1845 cfs_restore_sigs(blocked);
1847 CDEBUG(D_NET, "poll %d(%d %d)%s\n", rc2,
1848 (rc2 <= 0) ? -1 : event.type,
1849 (rc2 <= 0) ? -1 : event.status,
1850 (rc2 > 0 && event.unlinked) ? " unlinked" : "");
1852 LASSERT (rc2 != -EOVERFLOW); /* can't miss anything */
1854 if (rc2 <= 0 || event.status != 0) {
1855 /* timeout or error */
1856 if (!replied && rc == 0)
1857 rc = (rc2 < 0) ? rc2 :
1858 (rc2 == 0) ? -ETIMEDOUT :
1862 /* Ensure completion in finite time... */
1864 /* No assertion (racing with network) */
1866 timeout_ms = a_long_time;
1867 } else if (rc2 == 0) {
1868 /* timed out waiting for unlink */
1869 CWARN("ping %s: late network completion\n",
1872 } else if (event.type == LNET_EVENT_REPLY) {
1877 } while (rc2 <= 0 || !event.unlinked);
1881 CWARN("%s: Unexpected rc >= 0 but no reply!\n",
1888 LASSERT (nob >= 0 && nob <= infosz);
1890 rc = -EPROTO; /* if I can't parse... */
1893 /* can't check magic/version */
1894 CERROR("%s: ping info too short %d\n",
1895 libcfs_id2str(id), nob);
1899 if (info->pi_magic == __swab32(LNET_PROTO_PING_MAGIC)) {
1900 lnet_swap_pinginfo(info);
1901 } else if (info->pi_magic != LNET_PROTO_PING_MAGIC) {
1902 CERROR("%s: Unexpected magic %08x\n",
1903 libcfs_id2str(id), info->pi_magic);
1907 if ((info->pi_features & LNET_PING_FEAT_NI_STATUS) == 0) {
1908 CERROR("%s: ping w/o NI status: 0x%x\n",
1909 libcfs_id2str(id), info->pi_features);
1913 if (nob < offsetof(lnet_ping_info_t, pi_ni[0])) {
1914 CERROR("%s: Short reply %d(%d min)\n", libcfs_id2str(id),
1915 nob, (int)offsetof(lnet_ping_info_t, pi_ni[0]));
1919 if (info->pi_nnis < n_ids)
1920 n_ids = info->pi_nnis;
1922 if (nob < offsetof(lnet_ping_info_t, pi_ni[n_ids])) {
1923 CERROR("%s: Short reply %d(%d expected)\n", libcfs_id2str(id),
1924 nob, (int)offsetof(lnet_ping_info_t, pi_ni[n_ids]));
1928 rc = -EFAULT; /* If I SEGV... */
1930 memset(&tmpid, 0, sizeof(tmpid));
1931 for (i = 0; i < n_ids; i++) {
1932 tmpid.pid = info->pi_pid;
1933 tmpid.nid = info->pi_ni[i].ns_nid;
1934 if (copy_to_user(&ids[i], &tmpid, sizeof(tmpid)))
1940 rc2 = LNetEQFree(eqh);
1942 CERROR("rc2 %d\n", rc2);
1946 LIBCFS_FREE(info, infosz);