lnet/lnet/api-ni.c

   1 /*
   2  * GPL HEADER START
   3  *
   4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   5  *
   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.
   9  *
  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).
  15  *
  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
  19  *
  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
  22  * have any questions.
  23  *
  24  * GPL HEADER END
  25  */
  26 /*
  27  * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
  28  * Use is subject to license terms.
  29  *
  30  * Copyright (c) 2011, Whamcloud, Inc.
  31  */
  32 /*
  33  * This file is part of Lustre, http://www.lustre.org/
  34  * Lustre is a trademark of Sun Microsystems, Inc.
  35  */
  36
  37 #define DEBUG_SUBSYSTEM S_LNET
  38 #include <lnet/lib-lnet.h>
  39
  40 #ifdef __KERNEL__
  41 #define D_LNI D_CONSOLE
  42 #else
  43 #define D_LNI D_CONFIG
  44 #endif
  45
  46 lnet_t      the_lnet;                           /* THE state of the network */
  47
  48 #ifdef __KERNEL__
  49
  50 static char *ip2nets = "";
  51 CFS_MODULE_PARM(ip2nets, "s", charp, 0444,
  52                 "LNET network <- IP table");
  53
  54 static char *networks = "";
  55 CFS_MODULE_PARM(networks, "s", charp, 0444,
  56                 "local networks");
  57
  58 static char *routes = "";
  59 CFS_MODULE_PARM(routes, "s", charp, 0444,
  60                 "routes to non-local networks");
  61
  62 char *
  63 lnet_get_routes(void)
  64 {
  65         return routes;
  66 }
  67
  68 char *
  69 lnet_get_networks(void)
  70 {
  71         char   *nets;
  72         int     rc;
  73
  74         if (*networks != 0 && *ip2nets != 0) {
  75                 LCONSOLE_ERROR_MSG(0x101, "Please specify EITHER 'networks' or "
  76                                    "'ip2nets' but not both at once\n");
  77                 return NULL;
  78         }
  79
  80         if (*ip2nets != 0) {
  81                 rc = lnet_parse_ip2nets(&nets, ip2nets);
  82                 return (rc == 0) ? nets : NULL;
  83         }
  84
  85         if (*networks != 0)
  86                 return networks;
  87
  88         return "tcp";
  89 }
  90
  91 void
  92 lnet_init_locks(void)
  93 {
  94         cfs_spin_lock_init (&the_lnet.ln_lock);
  95         cfs_waitq_init (&the_lnet.ln_waitq);
  96         cfs_mutex_init(&the_lnet.ln_lnd_mutex);
  97         cfs_mutex_init(&the_lnet.ln_api_mutex);
  98 }
  99
 100 void
 101 lnet_fini_locks(void)
 102 {
 103 }
 104
 105 #else
 106
 107 char *
 108 lnet_get_routes(void)
 109 {
 110         char *str = getenv("LNET_ROUTES");
 111
 112         return (str == NULL) ? "" : str;
 113 }
 114
 115 char *
 116 lnet_get_networks (void)
 117 {
 118         static char       default_networks[256];
 119         char             *networks = getenv ("LNET_NETWORKS");
 120         char             *ip2nets  = getenv ("LNET_IP2NETS");
 121         char             *str;
 122         char             *sep;
 123         int               len;
 124         int               nob;
 125         int               rc;
 126         cfs_list_t       *tmp;
 127
 128 #ifdef NOT_YET
 129         if (networks != NULL && ip2nets != NULL) {
 130                 LCONSOLE_ERROR_MSG(0x103, "Please set EITHER 'LNET_NETWORKS' or"
 131                                    " 'LNET_IP2NETS' but not both at once\n");
 132                 return NULL;
 133         }
 134
 135         if (ip2nets != NULL) {
 136                 rc = lnet_parse_ip2nets(&networks, ip2nets);
 137                 return (rc == 0) ? networks : NULL;
 138         }
 139 #else
 140         SET_BUT_UNUSED(ip2nets);
 141         SET_BUT_UNUSED(rc);
 142 #endif
 143         if (networks != NULL)
 144                 return networks;
 145
 146         /* In userland, the default 'networks=' is the list of known net types */
 147
 148         len = sizeof(default_networks);
 149         str = default_networks;
 150         *str = 0;
 151         sep = "";
 152
 153         cfs_list_for_each (tmp, &the_lnet.ln_lnds) {
 154                 lnd_t *lnd = cfs_list_entry(tmp, lnd_t, lnd_list);
 155
 156                 nob = snprintf(str, len, "%s%s", sep,
 157                                libcfs_lnd2str(lnd->lnd_type));
 158                 len -= nob;
 159                 if (len < 0) {
 160                         /* overflowed the string; leave it where it was */
 161                         *str = 0;
 162                         break;
 163                 }
 164
 165                 str += nob;
 166                 sep = ",";
 167         }
 168
 169         return default_networks;
 170 }
 171
 172 # ifndef HAVE_LIBPTHREAD
 173
 174 void lnet_init_locks(void)
 175 {
 176         the_lnet.ln_lock = 0;
 177         the_lnet.ln_lnd_mutex = 0;
 178         the_lnet.ln_api_mutex = 0;
 179 }
 180
 181 void lnet_fini_locks(void)
 182 {
 183         LASSERT (the_lnet.ln_api_mutex == 0);
 184         LASSERT (the_lnet.ln_lnd_mutex == 0);
 185         LASSERT (the_lnet.ln_lock == 0);
 186 }
 187
 188 # else
 189
 190 void lnet_init_locks(void)
 191 {
 192         pthread_cond_init(&the_lnet.ln_cond, NULL);
 193         pthread_mutex_init(&the_lnet.ln_lock, NULL);
 194         pthread_mutex_init(&the_lnet.ln_lnd_mutex, NULL);
 195         pthread_mutex_init(&the_lnet.ln_api_mutex, NULL);
 196 }
 197
 198 void lnet_fini_locks(void)
 199 {
 200         pthread_mutex_destroy(&the_lnet.ln_api_mutex);
 201         pthread_mutex_destroy(&the_lnet.ln_lnd_mutex);
 202         pthread_mutex_destroy(&the_lnet.ln_lock);
 203         pthread_cond_destroy(&the_lnet.ln_cond);
 204 }
 205
 206 # endif
 207 #endif
 208
 209 void lnet_assert_wire_constants (void)
 210 {
 211         /* Wire protocol assertions generated by 'wirecheck'
 212          * running on Linux robert.bartonsoftware.com 2.6.8-1.521
 213          * #1 Mon Aug 16 09:01:18 EDT 2004 i686 athlon i386 GNU/Linux
 214          * with gcc version 3.3.3 20040412 (Red Hat Linux 3.3.3-7) */
 215
 216         /* Constants... */
 217         CLASSERT (LNET_PROTO_TCP_MAGIC == 0xeebc0ded);
 218         CLASSERT (LNET_PROTO_TCP_VERSION_MAJOR == 1);
 219         CLASSERT (LNET_PROTO_TCP_VERSION_MINOR == 0);
 220         CLASSERT (LNET_MSG_ACK == 0);
 221         CLASSERT (LNET_MSG_PUT == 1);
 222         CLASSERT (LNET_MSG_GET == 2);
 223         CLASSERT (LNET_MSG_REPLY == 3);
 224         CLASSERT (LNET_MSG_HELLO == 4);
 225
 226         /* Checks for struct ptl_handle_wire_t */
 227         CLASSERT ((int)sizeof(lnet_handle_wire_t) == 16);
 228         CLASSERT ((int)offsetof(lnet_handle_wire_t, wh_interface_cookie) == 0);
 229         CLASSERT ((int)sizeof(((lnet_handle_wire_t *)0)->wh_interface_cookie) == 8);
 230         CLASSERT ((int)offsetof(lnet_handle_wire_t, wh_object_cookie) == 8);
 231         CLASSERT ((int)sizeof(((lnet_handle_wire_t *)0)->wh_object_cookie) == 8);
 232
 233         /* Checks for struct lnet_magicversion_t */
 234         CLASSERT ((int)sizeof(lnet_magicversion_t) == 8);
 235         CLASSERT ((int)offsetof(lnet_magicversion_t, magic) == 0);
 236         CLASSERT ((int)sizeof(((lnet_magicversion_t *)0)->magic) == 4);
 237         CLASSERT ((int)offsetof(lnet_magicversion_t, version_major) == 4);
 238         CLASSERT ((int)sizeof(((lnet_magicversion_t *)0)->version_major) == 2);
 239         CLASSERT ((int)offsetof(lnet_magicversion_t, version_minor) == 6);
 240         CLASSERT ((int)sizeof(((lnet_magicversion_t *)0)->version_minor) == 2);
 241
 242         /* Checks for struct lnet_hdr_t */
 243         CLASSERT ((int)sizeof(lnet_hdr_t) == 72);
 244         CLASSERT ((int)offsetof(lnet_hdr_t, dest_nid) == 0);
 245         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->dest_nid) == 8);
 246         CLASSERT ((int)offsetof(lnet_hdr_t, src_nid) == 8);
 247         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->src_nid) == 8);
 248         CLASSERT ((int)offsetof(lnet_hdr_t, dest_pid) == 16);
 249         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->dest_pid) == 4);
 250         CLASSERT ((int)offsetof(lnet_hdr_t, src_pid) == 20);
 251         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->src_pid) == 4);
 252         CLASSERT ((int)offsetof(lnet_hdr_t, type) == 24);
 253         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->type) == 4);
 254         CLASSERT ((int)offsetof(lnet_hdr_t, payload_length) == 28);
 255         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->payload_length) == 4);
 256         CLASSERT ((int)offsetof(lnet_hdr_t, msg) == 32);
 257         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg) == 40);
 258
 259         /* Ack */
 260         CLASSERT ((int)offsetof(lnet_hdr_t, msg.ack.dst_wmd) == 32);
 261         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.ack.dst_wmd) == 16);
 262         CLASSERT ((int)offsetof(lnet_hdr_t, msg.ack.match_bits) == 48);
 263         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.ack.match_bits) == 8);
 264         CLASSERT ((int)offsetof(lnet_hdr_t, msg.ack.mlength) == 56);
 265         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.ack.mlength) == 4);
 266
 267         /* Put */
 268         CLASSERT ((int)offsetof(lnet_hdr_t, msg.put.ack_wmd) == 32);
 269         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.put.ack_wmd) == 16);
 270         CLASSERT ((int)offsetof(lnet_hdr_t, msg.put.match_bits) == 48);
 271         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.put.match_bits) == 8);
 272         CLASSERT ((int)offsetof(lnet_hdr_t, msg.put.hdr_data) == 56);
 273         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.put.hdr_data) == 8);
 274         CLASSERT ((int)offsetof(lnet_hdr_t, msg.put.ptl_index) == 64);
 275         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.put.ptl_index) == 4);
 276         CLASSERT ((int)offsetof(lnet_hdr_t, msg.put.offset) == 68);
 277         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.put.offset) == 4);
 278
 279         /* Get */
 280         CLASSERT ((int)offsetof(lnet_hdr_t, msg.get.return_wmd) == 32);
 281         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.get.return_wmd) == 16);
 282         CLASSERT ((int)offsetof(lnet_hdr_t, msg.get.match_bits) == 48);
 283         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.get.match_bits) == 8);
 284         CLASSERT ((int)offsetof(lnet_hdr_t, msg.get.ptl_index) == 56);
 285         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.get.ptl_index) == 4);
 286         CLASSERT ((int)offsetof(lnet_hdr_t, msg.get.src_offset) == 60);
 287         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.get.src_offset) == 4);
 288         CLASSERT ((int)offsetof(lnet_hdr_t, msg.get.sink_length) == 64);
 289         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.get.sink_length) == 4);
 290
 291         /* Reply */
 292         CLASSERT ((int)offsetof(lnet_hdr_t, msg.reply.dst_wmd) == 32);
 293         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.reply.dst_wmd) == 16);
 294
 295         /* Hello */
 296         CLASSERT ((int)offsetof(lnet_hdr_t, msg.hello.incarnation) == 32);
 297         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.hello.incarnation) == 8);
 298         CLASSERT ((int)offsetof(lnet_hdr_t, msg.hello.type) == 40);
 299         CLASSERT ((int)sizeof(((lnet_hdr_t *)0)->msg.hello.type) == 4);
 300 }
 301
 302 lnd_t *
 303 lnet_find_lnd_by_type (int type)
 304 {
 305         lnd_t              *lnd;
 306         cfs_list_t         *tmp;
 307
 308         /* holding lnd mutex */
 309         cfs_list_for_each (tmp, &the_lnet.ln_lnds) {
 310                 lnd = cfs_list_entry(tmp, lnd_t, lnd_list);
 311
 312                 if ((int)lnd->lnd_type == type)
 313                         return lnd;
 314         }
 315
 316         return NULL;
 317 }
 318
 319 void
 320 lnet_register_lnd (lnd_t *lnd)
 321 {
 322         LNET_MUTEX_LOCK(&the_lnet.ln_lnd_mutex);
 323
 324         LASSERT (the_lnet.ln_init);
 325         LASSERT (libcfs_isknown_lnd(lnd->lnd_type));
 326         LASSERT (lnet_find_lnd_by_type(lnd->lnd_type) == NULL);
 327
 328         cfs_list_add_tail (&lnd->lnd_list, &the_lnet.ln_lnds);
 329         lnd->lnd_refcount = 0;
 330
 331         CDEBUG(D_NET, "%s LND registered\n", libcfs_lnd2str(lnd->lnd_type));
 332
 333         LNET_MUTEX_UNLOCK(&the_lnet.ln_lnd_mutex);
 334 }
 335
 336 void
 337 lnet_unregister_lnd (lnd_t *lnd)
 338 {
 339         LNET_MUTEX_LOCK(&the_lnet.ln_lnd_mutex);
 340
 341         LASSERT (the_lnet.ln_init);
 342         LASSERT (lnet_find_lnd_by_type(lnd->lnd_type) == lnd);
 343         LASSERT (lnd->lnd_refcount == 0);
 344
 345         cfs_list_del (&lnd->lnd_list);
 346         CDEBUG(D_NET, "%s LND unregistered\n", libcfs_lnd2str(lnd->lnd_type));
 347
 348         LNET_MUTEX_UNLOCK(&the_lnet.ln_lnd_mutex);
 349 }
 350
 351 #ifndef LNET_USE_LIB_FREELIST
 352
 353 int
 354 lnet_descriptor_setup (void)
 355 {
 356         return 0;
 357 }
 358
 359 void
 360 lnet_descriptor_cleanup (void)
 361 {
 362 }
 363
 364 #else
 365
 366 int
 367 lnet_freelist_init (lnet_freelist_t *fl, int n, int size)
 368 {
 369         char *space;
 370
 371         LASSERT (n > 0);
 372
 373         size += offsetof (lnet_freeobj_t, fo_contents);
 374
 375         LIBCFS_ALLOC(space, n * size);
 376         if (space == NULL)
 377                 return (-ENOMEM);
 378
 379         CFS_INIT_LIST_HEAD (&fl->fl_list);
 380         fl->fl_objs = space;
 381         fl->fl_nobjs = n;
 382         fl->fl_objsize = size;
 383
 384         do
 385         {
 386                 memset (space, 0, size);
 387                 cfs_list_add ((cfs_list_t *)space, &fl->fl_list);
 388                 space += size;
 389         } while (--n != 0);
 390
 391         return (0);
 392 }
 393
 394 void
 395 lnet_freelist_fini (lnet_freelist_t *fl)
 396 {
 397         cfs_list_t       *el;
 398         int               count;
 399
 400         if (fl->fl_nobjs == 0)
 401                 return;
 402
 403         count = 0;
 404         for (el = fl->fl_list.next; el != &fl->fl_list; el = el->next)
 405                 count++;
 406
 407         LASSERT (count == fl->fl_nobjs);
 408
 409         LIBCFS_FREE(fl->fl_objs, fl->fl_nobjs * fl->fl_objsize);
 410         memset (fl, 0, sizeof (*fl));
 411 }
 412
 413 int
 414 lnet_descriptor_setup (void)
 415 {
 416         /* NB on failure caller must still call lnet_descriptor_cleanup */
 417         /*               ******                                         */
 418         int        rc;
 419
 420         memset (&the_lnet.ln_free_msgs, 0, sizeof (the_lnet.ln_free_msgs));
 421         rc = lnet_freelist_init(&the_lnet.ln_free_msgs,
 422                                 LNET_FL_MAX_MSGS, sizeof(lnet_msg_t));
 423         if (rc != 0)
 424                 return (rc);
 425         return (rc);
 426 }
 427
 428 void
 429 lnet_descriptor_cleanup (void)
 430 {
 431         lnet_freelist_fini (&the_lnet.ln_free_msgs);
 432 }
 433
 434 #endif /* LNET_USE_LIB_FREELIST */
 435
 436 __u64
 437 lnet_create_interface_cookie (void)
 438 {
 439         /* NB the interface cookie in wire handles guards against delayed
 440          * replies and ACKs appearing valid after reboot. Initialisation time,
 441          * even if it's only implemented to millisecond resolution is probably
 442          * easily good enough. */
 443         struct timeval tv;
 444         __u64          cookie;
 445 #ifndef __KERNEL__
 446         int            rc = gettimeofday (&tv, NULL);
 447         LASSERT (rc == 0);
 448 #else
 449         cfs_gettimeofday(&tv);
 450 #endif
 451         cookie = tv.tv_sec;
 452         cookie *= 1000000;
 453         cookie += tv.tv_usec;
 454         return cookie;
 455 }
 456
 457 static char *
 458 lnet_res_type2str(int type)
 459 {
 460         switch (type) {
 461         default:
 462                 LBUG();
 463         case LNET_COOKIE_TYPE_MD:
 464                 return "MD";
 465         case LNET_COOKIE_TYPE_ME:
 466                 return "ME";
 467         case LNET_COOKIE_TYPE_EQ:
 468                 return "EQ";
 469         }
 470 }
 471
 472 void
 473 lnet_res_container_cleanup(struct lnet_res_container *rec)
 474 {
 475         int     count = 0;
 476
 477         if (rec->rec_type == 0) /* not set yet, it's a uninitialized */
 478                 return;
 479
 480         while (!cfs_list_empty(&rec->rec_active)) {
 481                 cfs_list_t *e = rec->rec_active.next;
 482
 483                 cfs_list_del_init(e);
 484                 if (rec->rec_type == LNET_COOKIE_TYPE_EQ) {
 485                         lnet_eq_free(cfs_list_entry(e, lnet_eq_t, eq_list));
 486
 487                 } else if (rec->rec_type == LNET_COOKIE_TYPE_MD) {
 488                         lnet_md_free(cfs_list_entry(e, lnet_libmd_t, md_list));
 489
 490                 } else { /* NB: Active MEs should be attached on portals */
 491                         LBUG();
 492                 }
 493                 count++;
 494         }
 495
 496         if (count > 0) {
 497                 /* Found alive MD/ME/EQ, user really should unlink/free
 498                  * all of them before finalize LNet, but if someone didn't,
 499                  * we have to recycle garbage for him */
 500                 CERROR("%d active elements on exit of %s container\n",
 501                        count, lnet_res_type2str(rec->rec_type));
 502         }
 503
 504 #ifdef LNET_USE_LIB_FREELIST
 505         lnet_freelist_fini(&rec->rec_freelist);
 506 #endif
 507         if (rec->rec_lh_hash != NULL) {
 508                 LIBCFS_FREE(rec->rec_lh_hash,
 509                             LNET_LH_HASH_SIZE * sizeof(rec->rec_lh_hash[0]));
 510                 rec->rec_lh_hash = NULL;
 511         }
 512
 513         rec->rec_type = 0; /* mark it as finalized */
 514 }
 515
 516 int
 517 lnet_res_container_setup(struct lnet_res_container *rec,
 518                          int type, int objnum, int objsz)
 519 {
 520         int     rc = 0;
 521         int     i;
 522
 523         LASSERT(rec->rec_type == 0);
 524
 525         rec->rec_type = type;
 526         CFS_INIT_LIST_HEAD(&rec->rec_active);
 527
 528 #ifdef LNET_USE_LIB_FREELIST
 529         memset(&rec->rec_freelist, 0, sizeof(rec->rec_freelist));
 530         rc = lnet_freelist_init(&rec->rec_freelist, objnum, objsz);
 531         if (rc != 0)
 532                 goto out;
 533 #endif
 534         rec->rec_lh_cookie = type;
 535
 536         /* Arbitrary choice of hash table size */
 537         LIBCFS_ALLOC(rec->rec_lh_hash,
 538                      LNET_LH_HASH_SIZE * sizeof(rec->rec_lh_hash[0]));
 539         if (rec->rec_lh_hash == NULL) {
 540                 rc = -ENOMEM;
 541                 goto out;
 542         }
 543
 544         for (i = 0; i < LNET_LH_HASH_SIZE; i++)
 545                 CFS_INIT_LIST_HEAD(&rec->rec_lh_hash[i]);
 546
 547         return 0;
 548
 549 out:
 550         CERROR("Failed to setup %s resource container\n",
 551                lnet_res_type2str(type));
 552         lnet_res_container_cleanup(rec);
 553         return rc;
 554 }
 555
 556 lnet_libhandle_t *
 557 lnet_res_lh_lookup(struct lnet_res_container *rec, __u64 cookie)
 558 {
 559         /* ALWAYS called with lnet_res_lock held */
 560         cfs_list_t              *head;
 561         lnet_libhandle_t        *lh;
 562         unsigned int            hash;
 563
 564         if ((cookie & (LNET_COOKIE_TYPES - 1)) != rec->rec_type)
 565                 return NULL;
 566
 567         hash = cookie >> LNET_COOKIE_TYPE_BITS;
 568         head = &rec->rec_lh_hash[hash & LNET_LH_HASH_MASK];
 569
 570         cfs_list_for_each_entry(lh, head, lh_hash_chain) {
 571                 if (lh->lh_cookie == cookie)
 572                         return lh;
 573         }
 574
 575         return NULL;
 576 }
 577
 578 void
 579 lnet_res_lh_initialize(struct lnet_res_container *rec, lnet_libhandle_t *lh)
 580 {
 581         /* ALWAYS called with lnet_res_lock held */
 582         unsigned int    ibits = LNET_COOKIE_TYPE_BITS;
 583         unsigned int    hash;
 584
 585         lh->lh_cookie = rec->rec_lh_cookie;
 586         rec->rec_lh_cookie += 1 << ibits;
 587
 588         hash = (lh->lh_cookie >> ibits) & LNET_LH_HASH_MASK;
 589
 590         cfs_list_add(&lh->lh_hash_chain, &rec->rec_lh_hash[hash]);
 591 }
 592
 593 cfs_list_t *
 594 lnet_portal_mhash_alloc(void)
 595 {
 596         cfs_list_t       *mhash;
 597         int               i;
 598
 599         LIBCFS_ALLOC(mhash, sizeof(cfs_list_t) * LNET_PORTAL_HASH_SIZE);
 600         if (mhash == NULL)
 601                 return NULL;
 602
 603         for (i = 0; i < LNET_PORTAL_HASH_SIZE; i++)
 604                 CFS_INIT_LIST_HEAD(&mhash[i]);
 605
 606         return mhash;
 607 }
 608
 609 void
 610 lnet_portal_mhash_free(cfs_list_t *mhash)
 611 {
 612         int     i;
 613
 614         for (i = 0; i < LNET_PORTAL_HASH_SIZE; i++) {
 615                 while (!cfs_list_empty(&mhash[i])) {
 616                         lnet_me_t *me = cfs_list_entry(mhash[i].next,
 617                                                        lnet_me_t, me_list);
 618                         CERROR ("Active ME %p on exit portal mhash\n", me);
 619                         cfs_list_del(&me->me_list);
 620                         lnet_me_free(me);
 621                 }
 622         }
 623         LIBCFS_FREE(mhash, sizeof(cfs_list_t) * LNET_PORTAL_HASH_SIZE);
 624 }
 625
 626 int
 627 lnet_init_finalizers(void)
 628 {
 629 #ifdef __KERNEL__
 630         int    i;
 631
 632         the_lnet.ln_nfinalizers = (int) cfs_num_online_cpus();
 633
 634         LIBCFS_ALLOC(the_lnet.ln_finalizers,
 635                      the_lnet.ln_nfinalizers *
 636                      sizeof(*the_lnet.ln_finalizers));
 637         if (the_lnet.ln_finalizers == NULL) {
 638                 CERROR("Can't allocate ln_finalizers\n");
 639                 return -ENOMEM;
 640         }
 641
 642         for (i = 0; i < the_lnet.ln_nfinalizers; i++)
 643                 the_lnet.ln_finalizers[i] = NULL;
 644 #else
 645         the_lnet.ln_finalizing = 0;
 646 #endif
 647
 648         CFS_INIT_LIST_HEAD(&the_lnet.ln_finalizeq);
 649         return 0;
 650 }
 651
 652 void
 653 lnet_fini_finalizers(void)
 654 {
 655 #ifdef __KERNEL__
 656         int    i;
 657
 658         for (i = 0; i < the_lnet.ln_nfinalizers; i++)
 659                 LASSERT (the_lnet.ln_finalizers[i] == NULL);
 660
 661         LIBCFS_FREE(the_lnet.ln_finalizers,
 662                     the_lnet.ln_nfinalizers *
 663                     sizeof(*the_lnet.ln_finalizers));
 664 #else
 665         LASSERT (!the_lnet.ln_finalizing);
 666 #endif
 667         LASSERT (cfs_list_empty(&the_lnet.ln_finalizeq));
 668 }
 669
 670 #ifndef __KERNEL__
 671 /**
 672  * Reserved API - do not use.
 673  * Temporary workaround to allow uOSS and test programs force server
 674  * mode in userspace. See comments near ln_server_mode_flag in
 675  * lnet/lib-types.h */
 676
 677 void
 678 lnet_server_mode() {
 679         the_lnet.ln_server_mode_flag = 1;
 680 }
 681 #endif
 682
 683 int
 684 lnet_prepare(lnet_pid_t requested_pid)
 685 {
 686         /* Prepare to bring up the network */
 687         int               rc = 0;
 688         int               i;
 689
 690         LASSERT (the_lnet.ln_refcount == 0);
 691
 692         the_lnet.ln_routing = 0;
 693
 694 #ifdef __KERNEL__
 695         LASSERT ((requested_pid & LNET_PID_USERFLAG) == 0);
 696         the_lnet.ln_pid = requested_pid;
 697 #else
 698         if (the_lnet.ln_server_mode_flag) {/* server case (uOSS) */
 699                 LASSERT ((requested_pid & LNET_PID_USERFLAG) == 0);
 700
 701                 if (cfs_curproc_uid())/* Only root can run user-space server */
 702                         return -EPERM;
 703                 the_lnet.ln_pid = requested_pid;
 704
 705         } else {/* client case (liblustre) */
 706
 707                 /* My PID must be unique on this node and flag I'm userspace */
 708                 the_lnet.ln_pid = getpid() | LNET_PID_USERFLAG;
 709         }
 710 #endif
 711
 712         rc = lnet_descriptor_setup();
 713         if (rc != 0)
 714                 return -ENOMEM;
 715
 716         memset(&the_lnet.ln_counters, 0,
 717                sizeof(the_lnet.ln_counters));
 718
 719         CFS_INIT_LIST_HEAD (&the_lnet.ln_active_msgs);
 720         CFS_INIT_LIST_HEAD (&the_lnet.ln_test_peers);
 721         CFS_INIT_LIST_HEAD (&the_lnet.ln_nis);
 722         CFS_INIT_LIST_HEAD (&the_lnet.ln_zombie_nis);
 723         CFS_INIT_LIST_HEAD (&the_lnet.ln_remote_nets);
 724         CFS_INIT_LIST_HEAD (&the_lnet.ln_routers);
 725
 726         the_lnet.ln_interface_cookie = lnet_create_interface_cookie();
 727
 728         lnet_init_rtrpools();
 729
 730         rc = lnet_create_peer_table();
 731         if (rc != 0)
 732                 goto failed0;
 733
 734         rc = lnet_init_finalizers();
 735         if (rc != 0)
 736                 goto failed1;
 737
 738         rc = lnet_res_container_setup(&the_lnet.ln_eq_container,
 739                                       LNET_COOKIE_TYPE_EQ, LNET_FL_MAX_EQS,
 740                                       sizeof(lnet_eq_t));
 741         if (rc != 0) {
 742                 CERROR("Failed to create EQ container for LNet: %d\n", rc);
 743                 goto failed2;
 744         }
 745
 746         /* NB: we will have instance of ME container per CPT soon */
 747         rc = lnet_res_container_setup(&the_lnet.ln_me_container,
 748                                       LNET_COOKIE_TYPE_ME, LNET_FL_MAX_MES,
 749                                       sizeof(lnet_me_t));
 750         if (rc != 0) {
 751                 CERROR("Failed to create ME container for LNet: %d\n", rc);
 752                 goto failed3;
 753         }
 754
 755         /* NB: we will have instance of MD container per CPT soon */
 756         rc = lnet_res_container_setup(&the_lnet.ln_md_container,
 757                                       LNET_COOKIE_TYPE_MD, LNET_FL_MAX_MDS,
 758                                       sizeof(lnet_libmd_t));
 759         if (rc != 0) {
 760                 CERROR("Failed to create MD container for LNet: %d\n", rc);
 761                 goto failed3;
 762         }
 763
 764         the_lnet.ln_nportals = MAX_PORTALS;
 765         LIBCFS_ALLOC(the_lnet.ln_portals,
 766                      the_lnet.ln_nportals *
 767                      sizeof(*the_lnet.ln_portals));
 768         if (the_lnet.ln_portals == NULL) {
 769                 rc = -ENOMEM;
 770                 goto failed3;
 771         }
 772
 773         for (i = 0; i < the_lnet.ln_nportals; i++) {
 774                 CFS_INIT_LIST_HEAD(&(the_lnet.ln_portals[i].ptl_mlist));
 775                 CFS_INIT_LIST_HEAD(&(the_lnet.ln_portals[i].ptl_msgq));
 776                 the_lnet.ln_portals[i].ptl_options = 0;
 777         }
 778
 779         return 0;
 780
 781  failed3:
 782         /* NB: lnet_res_container_cleanup is safe to call for
 783          * uninitialized container */
 784         lnet_res_container_cleanup(&the_lnet.ln_md_container);
 785         lnet_res_container_cleanup(&the_lnet.ln_me_container);
 786         lnet_res_container_cleanup(&the_lnet.ln_eq_container);
 787  failed2:
 788         lnet_fini_finalizers();
 789  failed1:
 790         lnet_destroy_peer_table();
 791  failed0:
 792         lnet_descriptor_cleanup();
 793         return rc;
 794 }
 795
 796 int
 797 lnet_unprepare (void)
 798 {
 799         int       idx;
 800
 801         /* NB no LNET_LOCK since this is the last reference.  All LND instances
 802          * have shut down already, so it is safe to unlink and free all
 803          * descriptors, even those that appear committed to a network op (eg MD
 804          * with non-zero pending count) */
 805
 806         lnet_fail_nid(LNET_NID_ANY, 0);
 807
 808         LASSERT (cfs_list_empty(&the_lnet.ln_test_peers));
 809         LASSERT (the_lnet.ln_refcount == 0);
 810         LASSERT (cfs_list_empty(&the_lnet.ln_nis));
 811         LASSERT (cfs_list_empty(&the_lnet.ln_zombie_nis));
 812         LASSERT (the_lnet.ln_nzombie_nis == 0);
 813
 814         for (idx = 0; idx < the_lnet.ln_nportals; idx++) {
 815                 lnet_portal_t *ptl = &the_lnet.ln_portals[idx];
 816
 817                 LASSERT (cfs_list_empty(&ptl->ptl_msgq));
 818
 819                 while (!cfs_list_empty(&ptl->ptl_mlist)) {
 820                         lnet_me_t *me = cfs_list_entry(ptl->ptl_mlist.next,
 821                                                        lnet_me_t, me_list);
 822                         CERROR ("Active ME %p on exit\n", me);
 823                         cfs_list_del (&me->me_list);
 824                         lnet_me_free (me);
 825                 }
 826
 827                 if (ptl->ptl_mhash != NULL) {
 828                         LASSERT (lnet_portal_is_unique(ptl));
 829                         lnet_portal_mhash_free(ptl->ptl_mhash);
 830                 }
 831         }
 832
 833         lnet_res_container_cleanup(&the_lnet.ln_md_container);
 834         lnet_res_container_cleanup(&the_lnet.ln_me_container);
 835         lnet_res_container_cleanup(&the_lnet.ln_eq_container);
 836
 837         while (!cfs_list_empty (&the_lnet.ln_active_msgs)) {
 838                 lnet_msg_t *msg = cfs_list_entry (the_lnet.ln_active_msgs.next,
 839                                                   lnet_msg_t, msg_activelist);
 840
 841                 CERROR ("Active msg %p on exit\n", msg);
 842                 LASSERT (msg->msg_onactivelist);
 843                 msg->msg_onactivelist = 0;
 844                 cfs_list_del (&msg->msg_activelist);
 845                 lnet_msg_free (msg);
 846         }
 847
 848         LIBCFS_FREE(the_lnet.ln_portals,
 849                     the_lnet.ln_nportals * sizeof(*the_lnet.ln_portals));
 850
 851         lnet_free_rtrpools();
 852         lnet_fini_finalizers();
 853         lnet_destroy_peer_table();
 854         lnet_descriptor_cleanup();
 855
 856         return (0);
 857 }
 858
 859 lnet_ni_t  *
 860 lnet_net2ni_locked (__u32 net)
 861 {
 862         cfs_list_t       *tmp;
 863         lnet_ni_t        *ni;
 864
 865         cfs_list_for_each (tmp, &the_lnet.ln_nis) {
 866                 ni = cfs_list_entry(tmp, lnet_ni_t, ni_list);
 867
 868                 if (LNET_NIDNET(ni->ni_nid) == net) {
 869                         lnet_ni_addref_locked(ni);
 870                         return ni;
 871                 }
 872         }
 873
 874         return NULL;
 875 }
 876
 877 int
 878 lnet_islocalnet (__u32 net)
 879 {
 880         lnet_ni_t        *ni;
 881
 882         LNET_LOCK();
 883         ni = lnet_net2ni_locked(net);
 884         if (ni != NULL)
 885                 lnet_ni_decref_locked(ni);
 886         LNET_UNLOCK();
 887
 888         return ni != NULL;
 889 }
 890
 891 lnet_ni_t  *
 892 lnet_nid2ni_locked (lnet_nid_t nid)
 893 {
 894         cfs_list_t       *tmp;
 895         lnet_ni_t        *ni;
 896
 897         cfs_list_for_each (tmp, &the_lnet.ln_nis) {
 898                 ni = cfs_list_entry(tmp, lnet_ni_t, ni_list);
 899
 900                 if (ni->ni_nid == nid) {
 901                         lnet_ni_addref_locked(ni);
 902                         return ni;
 903                 }
 904         }
 905
 906         return NULL;
 907 }
 908
 909 int
 910 lnet_islocalnid (lnet_nid_t nid)
 911 {
 912         lnet_ni_t     *ni;
 913
 914         LNET_LOCK();
 915         ni = lnet_nid2ni_locked(nid);
 916         if (ni != NULL)
 917                 lnet_ni_decref_locked(ni);
 918         LNET_UNLOCK();
 919
 920         return ni != NULL;
 921 }
 922
 923 int
 924 lnet_count_acceptor_nis (void)
 925 {
 926         /* Return the # of NIs that need the acceptor. */
 927         int            count = 0;
 928 #if defined(__KERNEL__) || defined(HAVE_LIBPTHREAD)
 929         cfs_list_t    *tmp;
 930         lnet_ni_t     *ni;
 931
 932         LNET_LOCK();
 933         cfs_list_for_each (tmp, &the_lnet.ln_nis) {
 934                 ni = cfs_list_entry(tmp, lnet_ni_t, ni_list);
 935
 936                 if (ni->ni_lnd->lnd_accept != NULL)
 937                         count++;
 938         }
 939
 940         LNET_UNLOCK();
 941
 942 #endif /* defined(__KERNEL__) || defined(HAVE_LIBPTHREAD) */
 943         return count;
 944 }
 945
 946 void
 947 lnet_shutdown_lndnis (void)
 948 {
 949         int                i;
 950         int                islo;
 951         lnet_ni_t         *ni;
 952
 953         /* NB called holding the global mutex */
 954
 955         /* All quiet on the API front */
 956         LASSERT (!the_lnet.ln_shutdown);
 957         LASSERT (the_lnet.ln_refcount == 0);
 958         LASSERT (cfs_list_empty(&the_lnet.ln_zombie_nis));
 959         LASSERT (the_lnet.ln_nzombie_nis == 0);
 960         LASSERT (cfs_list_empty(&the_lnet.ln_remote_nets));
 961
 962         LNET_LOCK();
 963         the_lnet.ln_shutdown = 1;               /* flag shutdown */
 964
 965         /* Unlink NIs from the global table */
 966         while (!cfs_list_empty(&the_lnet.ln_nis)) {
 967                 ni = cfs_list_entry(the_lnet.ln_nis.next,
 968                                     lnet_ni_t, ni_list);
 969                 cfs_list_del (&ni->ni_list);
 970
 971                 the_lnet.ln_nzombie_nis++;
 972                 lnet_ni_decref_locked(ni); /* drop ln_nis' ref */
 973         }
 974
 975         /* Drop the cached eqwait NI. */
 976         if (the_lnet.ln_eqwaitni != NULL) {
 977                 lnet_ni_decref_locked(the_lnet.ln_eqwaitni);
 978                 the_lnet.ln_eqwaitni = NULL;
 979         }
 980
 981         /* Drop the cached loopback NI. */
 982         if (the_lnet.ln_loni != NULL) {
 983                 lnet_ni_decref_locked(the_lnet.ln_loni);
 984                 the_lnet.ln_loni = NULL;
 985         }
 986
 987         LNET_UNLOCK();
 988
 989         /* Clear lazy portals and drop delayed messages which hold refs
 990          * on their lnet_msg_t::msg_rxpeer */
 991         for (i = 0; i < the_lnet.ln_nportals; i++)
 992                 LNetClearLazyPortal(i);
 993
 994         /* Clear the peer table and wait for all peers to go (they hold refs on
 995          * their NIs) */
 996         lnet_clear_peer_table();
 997
 998         LNET_LOCK();
 999         /* Now wait for the NI's I just nuked to show up on ln_zombie_nis
1000          * and shut them down in guaranteed thread context */
1001         i = 2;
1002         while (the_lnet.ln_nzombie_nis != 0) {
1003
1004                 while (cfs_list_empty(&the_lnet.ln_zombie_nis)) {
1005                         LNET_UNLOCK();
1006                         ++i;
1007                         if ((i & (-i)) == i)
1008                                 CDEBUG(D_WARNING,"Waiting for %d zombie NIs\n",
1009                                        the_lnet.ln_nzombie_nis);
1010                         cfs_pause(cfs_time_seconds(1));
1011                         LNET_LOCK();
1012                 }
1013
1014                 ni = cfs_list_entry(the_lnet.ln_zombie_nis.next,
1015                                     lnet_ni_t, ni_list);
1016                 cfs_list_del(&ni->ni_list);
1017                 ni->ni_lnd->lnd_refcount--;
1018
1019                 LNET_UNLOCK();
1020
1021                 islo = ni->ni_lnd->lnd_type == LOLND;
1022
1023                 LASSERT (!cfs_in_interrupt ());
1024                 (ni->ni_lnd->lnd_shutdown)(ni);
1025
1026                 /* can't deref lnd anymore now; it might have unregistered
1027                  * itself...  */
1028
1029                 if (!islo)
1030                         CDEBUG(D_LNI, "Removed LNI %s\n",
1031                                libcfs_nid2str(ni->ni_nid));
1032
1033                 LIBCFS_FREE(ni, sizeof(*ni));
1034
1035                 LNET_LOCK();
1036                 the_lnet.ln_nzombie_nis--;
1037         }
1038
1039         the_lnet.ln_shutdown = 0;
1040         LNET_UNLOCK();
1041
1042         if (the_lnet.ln_network_tokens != NULL) {
1043                 LIBCFS_FREE(the_lnet.ln_network_tokens,
1044                             the_lnet.ln_network_tokens_nob);
1045                 the_lnet.ln_network_tokens = NULL;
1046         }
1047 }
1048
1049 int
1050 lnet_startup_lndnis (void)
1051 {
1052         lnd_t             *lnd;
1053         lnet_ni_t         *ni;
1054         cfs_list_t         nilist;
1055         int                rc = 0;
1056         int                lnd_type;
1057         int                nicount = 0;
1058         char              *nets = lnet_get_networks();
1059
1060         CFS_INIT_LIST_HEAD(&nilist);
1061
1062         if (nets == NULL)
1063                 goto failed;
1064
1065         rc = lnet_parse_networks(&nilist, nets);
1066         if (rc != 0)
1067                 goto failed;
1068
1069         while (!cfs_list_empty(&nilist)) {
1070                 ni = cfs_list_entry(nilist.next, lnet_ni_t, ni_list);
1071                 lnd_type = LNET_NETTYP(LNET_NIDNET(ni->ni_nid));
1072
1073                 LASSERT (libcfs_isknown_lnd(lnd_type));
1074
1075                 if (lnd_type == CIBLND    ||
1076                     lnd_type == OPENIBLND ||
1077                     lnd_type == IIBLND    ||
1078                     lnd_type == VIBLND) {
1079                         CERROR("LND %s obsoleted\n",
1080                                libcfs_lnd2str(lnd_type));
1081                         goto failed;
1082                 }
1083
1084                 LNET_MUTEX_LOCK(&the_lnet.ln_lnd_mutex);
1085                 lnd = lnet_find_lnd_by_type(lnd_type);
1086
1087 #ifdef __KERNEL__
1088                 if (lnd == NULL) {
1089                         LNET_MUTEX_UNLOCK(&the_lnet.ln_lnd_mutex);
1090                         rc = cfs_request_module("%s",
1091                                                 libcfs_lnd2modname(lnd_type));
1092                         LNET_MUTEX_LOCK(&the_lnet.ln_lnd_mutex);
1093
1094                         lnd = lnet_find_lnd_by_type(lnd_type);
1095                         if (lnd == NULL) {
1096                                 LNET_MUTEX_UNLOCK(&the_lnet.ln_lnd_mutex);
1097                                 CERROR("Can't load LND %s, module %s, rc=%d\n",
1098                                        libcfs_lnd2str(lnd_type),
1099                                        libcfs_lnd2modname(lnd_type), rc);
1100 #ifndef HAVE_MODULE_LOADING_SUPPORT
1101                                 LCONSOLE_ERROR_MSG(0x104, "Your kernel must be "
1102                                          "compiled with kernel module "
1103                                          "loading support.");
1104 #endif
1105                                 goto failed;
1106                         }
1107                 }
1108 #else
1109                 if (lnd == NULL) {
1110                         LNET_MUTEX_UNLOCK(&the_lnet.ln_lnd_mutex);
1111                         CERROR("LND %s not supported\n",
1112                                libcfs_lnd2str(lnd_type));
1113                         goto failed;
1114                 }
1115 #endif
1116
1117                 ni->ni_refcount = 1;
1118
1119                 LNET_LOCK();
1120                 lnd->lnd_refcount++;
1121                 LNET_UNLOCK();
1122
1123                 ni->ni_lnd = lnd;
1124
1125                 rc = (lnd->lnd_startup)(ni);
1126
1127                 LNET_MUTEX_UNLOCK(&the_lnet.ln_lnd_mutex);
1128
1129                 if (rc != 0) {
1130                         LCONSOLE_ERROR_MSG(0x105, "Error %d starting up LNI %s"
1131                                            "\n",
1132                                            rc, libcfs_lnd2str(lnd->lnd_type));
1133                         LNET_LOCK();
1134                         lnd->lnd_refcount--;
1135                         LNET_UNLOCK();
1136                         goto failed;
1137                 }
1138
1139                 LASSERT (ni->ni_peertimeout <= 0 || lnd->lnd_query != NULL);
1140
1141                 cfs_list_del(&ni->ni_list);
1142
1143                 LNET_LOCK();
1144                 cfs_list_add_tail(&ni->ni_list, &the_lnet.ln_nis);
1145                 LNET_UNLOCK();
1146
1147                 if (lnd->lnd_type == LOLND) {
1148                         lnet_ni_addref(ni);
1149                         LASSERT (the_lnet.ln_loni == NULL);
1150                         the_lnet.ln_loni = ni;
1151                         continue;
1152                 }
1153
1154 #ifndef __KERNEL__
1155                 if (lnd->lnd_wait != NULL) {
1156                         if (the_lnet.ln_eqwaitni == NULL) {
1157                                 lnet_ni_addref(ni);
1158                                 the_lnet.ln_eqwaitni = ni;
1159                         }
1160                 } else {
1161 # ifndef HAVE_LIBPTHREAD
1162                         LCONSOLE_ERROR_MSG(0x106, "LND %s not supported in a "
1163                                            "single-threaded runtime\n",
1164                                            libcfs_lnd2str(lnd_type));
1165                         goto failed;
1166 # endif
1167                 }
1168 #endif
1169                 if (ni->ni_peertxcredits == 0 ||
1170                     ni->ni_maxtxcredits == 0) {
1171                         LCONSOLE_ERROR_MSG(0x107, "LNI %s has no %scredits\n",
1172                                            libcfs_lnd2str(lnd->lnd_type),
1173                                            ni->ni_peertxcredits == 0 ?
1174                                            "" : "per-peer ");
1175                         goto failed;
1176                 }
1177
1178                 ni->ni_txcredits = ni->ni_mintxcredits = ni->ni_maxtxcredits;
1179
1180                 CDEBUG(D_LNI, "Added LNI %s [%d/%d/%d/%d]\n",
1181                        libcfs_nid2str(ni->ni_nid),
1182                        ni->ni_peertxcredits, ni->ni_txcredits,
1183                        ni->ni_peerrtrcredits, ni->ni_peertimeout);
1184
1185                 nicount++;
1186         }
1187
1188         if (the_lnet.ln_eqwaitni != NULL && nicount > 1) {
1189                 lnd_type = the_lnet.ln_eqwaitni->ni_lnd->lnd_type;
1190                 LCONSOLE_ERROR_MSG(0x109, "LND %s can only run single-network"
1191                                    "\n",
1192                                    libcfs_lnd2str(lnd_type));
1193                 goto failed;
1194         }
1195
1196         return 0;
1197
1198  failed:
1199         lnet_shutdown_lndnis();
1200
1201         while (!cfs_list_empty(&nilist)) {
1202                 ni = cfs_list_entry(nilist.next, lnet_ni_t, ni_list);
1203                 cfs_list_del(&ni->ni_list);
1204                 LIBCFS_FREE(ni, sizeof(*ni));
1205         }
1206
1207         return -ENETDOWN;
1208 }
1209
1210 /**
1211  * Initialize LNet library.
1212  *
1213  * Only userspace program needs to call this function - it's automatically
1214  * called in the kernel at module loading time. Caller has to call LNetFini()
1215  * after a call to LNetInit(), if and only if the latter returned 0. It must
1216  * be called exactly once.
1217  *
1218  * \return 0 on success, and -ve on failures.
1219  */
1220 int
1221 LNetInit(void)
1222 {
1223         lnet_assert_wire_constants ();
1224         LASSERT (!the_lnet.ln_init);
1225
1226         memset(&the_lnet, 0, sizeof(the_lnet));
1227
1228         lnet_init_locks();
1229         the_lnet.ln_refcount = 0;
1230         the_lnet.ln_init = 1;
1231         LNetInvalidateHandle(&the_lnet.ln_rc_eqh);
1232         CFS_INIT_LIST_HEAD(&the_lnet.ln_lnds);
1233         CFS_INIT_LIST_HEAD(&the_lnet.ln_zombie_rcd);
1234
1235 #ifdef __KERNEL__
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 #else
1240         /* Register LNDs
1241          * NB the order here determines default 'networks=' order */
1242 # ifdef CRAY_XT3
1243         LNET_REGISTER_ULND(the_ptllnd);
1244 # endif
1245 # ifdef HAVE_LIBPTHREAD
1246         LNET_REGISTER_ULND(the_tcplnd);
1247 # endif
1248 #endif
1249         lnet_register_lnd(&the_lolnd);
1250         return 0;
1251 }
1252
1253 /**
1254  * Finalize LNet library.
1255  *
1256  * Only userspace program needs to call this function. It can be called
1257  * at most once.
1258  *
1259  * \pre LNetInit() called with success.
1260  * \pre All LNet users called LNetNIFini() for matching LNetNIInit() calls.
1261  */
1262 void
1263 LNetFini(void)
1264 {
1265         LASSERT (the_lnet.ln_init);
1266         LASSERT (the_lnet.ln_refcount == 0);
1267
1268         while (!cfs_list_empty(&the_lnet.ln_lnds))
1269                 lnet_unregister_lnd(cfs_list_entry(the_lnet.ln_lnds.next,
1270                                                    lnd_t, lnd_list));
1271         lnet_fini_locks();
1272
1273         the_lnet.ln_init = 0;
1274 }
1275
1276 /**
1277  * Set LNet PID and start LNet interfaces, routing, and forwarding.
1278  *
1279  * Userspace program should call this after a successful call to LNetInit().
1280  * Users must call this function at least once before any other functions.
1281  * For each successful call there must be a corresponding call to
1282  * LNetNIFini(). For subsequent calls to LNetNIInit(), \a requested_pid is
1283  * ignored.
1284  *
1285  * The PID used by LNet may be different from the one requested.
1286  * See LNetGetId().
1287  *
1288  * \param requested_pid PID requested by the caller.
1289  *
1290  * \return >= 0 on success, and < 0 error code on failures.
1291  */
1292 int
1293 LNetNIInit(lnet_pid_t requested_pid)
1294 {
1295         int         im_a_router = 0;
1296         int         rc;
1297
1298         LNET_MUTEX_LOCK(&the_lnet.ln_api_mutex);
1299
1300         LASSERT (the_lnet.ln_init);
1301         CDEBUG(D_OTHER, "refs %d\n", the_lnet.ln_refcount);
1302
1303         if (the_lnet.ln_refcount > 0) {
1304                 rc = the_lnet.ln_refcount++;
1305                 goto out;
1306         }
1307
1308         lnet_get_tunables();
1309
1310         if (requested_pid == LNET_PID_ANY) {
1311                 /* Don't instantiate LNET just for me */
1312                 rc = -ENETDOWN;
1313                 goto failed0;
1314         }
1315
1316         rc = lnet_prepare(requested_pid);
1317         if (rc != 0)
1318                 goto failed0;
1319
1320         rc = lnet_startup_lndnis();
1321         if (rc != 0)
1322                 goto failed1;
1323
1324         rc = lnet_parse_routes(lnet_get_routes(), &im_a_router);
1325         if (rc != 0)
1326                 goto failed2;
1327
1328         rc = lnet_check_routes();
1329         if (rc != 0)
1330                 goto failed2;
1331
1332         rc = lnet_alloc_rtrpools(im_a_router);
1333         if (rc != 0)
1334                 goto failed2;
1335
1336         rc = lnet_acceptor_start();
1337         if (rc != 0)
1338                 goto failed2;
1339
1340         the_lnet.ln_refcount = 1;
1341         /* Now I may use my own API functions... */
1342
1343         /* NB router checker needs the_lnet.ln_ping_info in
1344          * lnet_router_checker -> lnet_update_ni_status */
1345         rc = lnet_ping_target_init();
1346         if (rc != 0)
1347                 goto failed3;
1348
1349         rc = lnet_router_checker_start();
1350         if (rc != 0)
1351                 goto failed4;
1352
1353         lnet_proc_init();
1354         goto out;
1355
1356  failed4:
1357         lnet_ping_target_fini();
1358  failed3:
1359         the_lnet.ln_refcount = 0;
1360         lnet_acceptor_stop();
1361  failed2:
1362         lnet_destroy_routes();
1363         lnet_shutdown_lndnis();
1364  failed1:
1365         lnet_unprepare();
1366  failed0:
1367         LASSERT (rc < 0);
1368  out:
1369         LNET_MUTEX_UNLOCK(&the_lnet.ln_api_mutex);
1370         return rc;
1371 }
1372
1373 /**
1374  * Stop LNet interfaces, routing, and forwarding.
1375  *
1376  * Users must call this function once for each successful call to LNetNIInit().
1377  * Once the LNetNIFini() operation has been started, the results of pending
1378  * API operations are undefined.
1379  *
1380  * \return always 0 for current implementation.
1381  */
1382 int
1383 LNetNIFini()
1384 {
1385         LNET_MUTEX_LOCK(&the_lnet.ln_api_mutex);
1386
1387         LASSERT (the_lnet.ln_init);
1388         LASSERT (the_lnet.ln_refcount > 0);
1389
1390         if (the_lnet.ln_refcount != 1) {
1391                 the_lnet.ln_refcount--;
1392         } else {
1393                 LASSERT (!the_lnet.ln_niinit_self);
1394
1395                 lnet_proc_fini();
1396                 lnet_router_checker_stop();
1397                 lnet_ping_target_fini();
1398
1399                 /* Teardown fns that use my own API functions BEFORE here */
1400                 the_lnet.ln_refcount = 0;
1401
1402                 lnet_acceptor_stop();
1403                 lnet_destroy_routes();
1404                 lnet_shutdown_lndnis();
1405                 lnet_unprepare();
1406         }
1407
1408         LNET_MUTEX_UNLOCK(&the_lnet.ln_api_mutex);
1409         return 0;
1410 }
1411
1412 /**
1413  * This is an ugly hack to export IOC_LIBCFS_DEBUG_PEER and
1414  * IOC_LIBCFS_PORTALS_COMPATIBILITY commands to users, by tweaking the LNet
1415  * internal ioctl handler.
1416  *
1417  * IOC_LIBCFS_PORTALS_COMPATIBILITY is now deprecated, don't use it.
1418  *
1419  * \param cmd IOC_LIBCFS_DEBUG_PEER to print debugging data about a peer.
1420  * The data will be printed to system console. Don't use it excessively.
1421  * \param arg A pointer to lnet_process_id_t, process ID of the peer.
1422  *
1423  * \return Always return 0 when called by users directly (i.e., not via ioctl).
1424  */
1425 int
1426 LNetCtl(unsigned int cmd, void *arg)
1427 {
1428         struct libcfs_ioctl_data *data = arg;
1429         lnet_process_id_t         id = {0};
1430         lnet_ni_t                *ni;
1431         int                       rc;
1432
1433         LASSERT (the_lnet.ln_init);
1434         LASSERT (the_lnet.ln_refcount > 0);
1435
1436         switch (cmd) {
1437         case IOC_LIBCFS_GET_NI:
1438                 rc = LNetGetId(data->ioc_count, &id);
1439                 data->ioc_nid = id.nid;
1440                 return rc;
1441
1442         case IOC_LIBCFS_FAIL_NID:
1443                 return lnet_fail_nid(data->ioc_nid, data->ioc_count);
1444
1445         case IOC_LIBCFS_ADD_ROUTE:
1446                 rc = lnet_add_route(data->ioc_net, data->ioc_count,
1447                                     data->ioc_nid);
1448                 return (rc != 0) ? rc : lnet_check_routes();
1449
1450         case IOC_LIBCFS_DEL_ROUTE:
1451                 return lnet_del_route(data->ioc_net, data->ioc_nid);
1452
1453         case IOC_LIBCFS_GET_ROUTE:
1454                 return lnet_get_route(data->ioc_count,
1455                                       &data->ioc_net, &data->ioc_count,
1456                                       &data->ioc_nid, &data->ioc_flags);
1457         case IOC_LIBCFS_NOTIFY_ROUTER:
1458                 return lnet_notify(NULL, data->ioc_nid, data->ioc_flags,
1459                                    cfs_time_current() -
1460                                    cfs_time_seconds(cfs_time_current_sec() -
1461                                                     (time_t)data->ioc_u64[0]));
1462
1463         case IOC_LIBCFS_PORTALS_COMPATIBILITY:
1464                 /* This can be removed once lustre stops calling it */
1465                 return 0;
1466
1467         case IOC_LIBCFS_LNET_DIST:
1468                 rc = LNetDist(data->ioc_nid, &data->ioc_nid, &data->ioc_u32[1]);
1469                 if (rc < 0 && rc != -EHOSTUNREACH)
1470                         return rc;
1471
1472                 data->ioc_u32[0] = rc;
1473                 return 0;
1474
1475         case IOC_LIBCFS_TESTPROTOCOMPAT:
1476                 LNET_LOCK();
1477                 the_lnet.ln_testprotocompat = data->ioc_flags;
1478                 LNET_UNLOCK();
1479                 return 0;
1480
1481         case IOC_LIBCFS_PING:
1482                 id.nid = data->ioc_nid;
1483                 id.pid = data->ioc_u32[0];
1484                 rc = lnet_ping(id, data->ioc_u32[1], /* timeout */
1485                                (lnet_process_id_t *)data->ioc_pbuf1,
1486                                data->ioc_plen1/sizeof(lnet_process_id_t));
1487                 if (rc < 0)
1488                         return rc;
1489                 data->ioc_count = rc;
1490                 return 0;
1491
1492         case IOC_LIBCFS_DEBUG_PEER: {
1493                 /* CAVEAT EMPTOR: this one designed for calling directly; not
1494                  * via an ioctl */
1495                 id = *((lnet_process_id_t *) arg);
1496
1497                 lnet_debug_peer(id.nid);
1498
1499                 ni = lnet_net2ni(LNET_NIDNET(id.nid));
1500                 if (ni == NULL) {
1501                         CDEBUG(D_WARNING, "No NI for %s\n", libcfs_id2str(id));
1502                 } else {
1503                         if (ni->ni_lnd->lnd_ctl == NULL) {
1504                                 CDEBUG(D_WARNING, "No ctl for %s\n",
1505                                        libcfs_id2str(id));
1506                         } else {
1507                                 (void)ni->ni_lnd->lnd_ctl(ni, cmd, arg);
1508                         }
1509
1510                         lnet_ni_decref(ni);
1511                 }
1512                 return 0;
1513         }
1514
1515         default:
1516                 ni = lnet_net2ni(data->ioc_net);
1517                 if (ni == NULL)
1518                         return -EINVAL;
1519
1520                 if (ni->ni_lnd->lnd_ctl == NULL)
1521                         rc = -EINVAL;
1522                 else
1523                         rc = ni->ni_lnd->lnd_ctl(ni, cmd, arg);
1524
1525                 lnet_ni_decref(ni);
1526                 return rc;
1527         }
1528         /* not reached */
1529 }
1530
1531 /**
1532  * Retrieve the lnet_process_id_t ID of LNet interface at \a index. Note that
1533  * all interfaces share a same PID, as requested by LNetNIInit().
1534  *
1535  * \param index Index of the interface to look up.
1536  * \param id On successful return, this location will hold the
1537  * lnet_process_id_t ID of the interface.
1538  *
1539  * \retval 0 If an interface exists at \a index.
1540  * \retval -ENOENT If no interface has been found.
1541  */
1542 int
1543 LNetGetId(unsigned int index, lnet_process_id_t *id)
1544 {
1545         lnet_ni_t        *ni;
1546         cfs_list_t       *tmp;
1547         int               rc = -ENOENT;
1548
1549         LASSERT (the_lnet.ln_init);
1550         LASSERT (the_lnet.ln_refcount > 0);
1551
1552         LNET_LOCK();
1553
1554         cfs_list_for_each(tmp, &the_lnet.ln_nis) {
1555                 if (index-- != 0)
1556                         continue;
1557
1558                 ni = cfs_list_entry(tmp, lnet_ni_t, ni_list);
1559
1560                 id->nid = ni->ni_nid;
1561                 id->pid = the_lnet.ln_pid;
1562                 rc = 0;
1563                 break;
1564         }
1565
1566         LNET_UNLOCK();
1567
1568         return rc;
1569 }
1570
1571 /**
1572  * Print a string representation of handle \a h into buffer \a str of
1573  * \a len bytes.
1574  */
1575 void
1576 LNetSnprintHandle(char *str, int len, lnet_handle_any_t h)
1577 {
1578         snprintf(str, len, LPX64, h.cookie);
1579 }
1580
1581 static int
1582 lnet_create_ping_info(void)
1583 {
1584         int               i;
1585         int               n;
1586         int               rc;
1587         unsigned int      infosz;
1588         lnet_ni_t        *ni;
1589         lnet_process_id_t id;
1590         lnet_ping_info_t *pinfo;
1591
1592         for (n = 0; ; n++) {
1593                 rc = LNetGetId(n, &id);
1594                 if (rc == -ENOENT)
1595                         break;
1596
1597                 LASSERT (rc == 0);
1598         }
1599
1600         infosz = offsetof(lnet_ping_info_t, pi_ni[n]);
1601         LIBCFS_ALLOC(pinfo, infosz);
1602         if (pinfo == NULL) {
1603                 CERROR("Can't allocate ping info[%d]\n", n);
1604                 return -ENOMEM;
1605         }
1606
1607         pinfo->pi_nnis    = n;
1608         pinfo->pi_pid     = the_lnet.ln_pid;
1609         pinfo->pi_magic   = LNET_PROTO_PING_MAGIC;
1610         pinfo->pi_version = LNET_PROTO_PING_VERSION;
1611
1612         for (i = 0; i < n; i++) {
1613                 lnet_ni_status_t *ns = &pinfo->pi_ni[i];
1614
1615                 rc = LNetGetId(i, &id);
1616                 LASSERT (rc == 0);
1617
1618                 ns->ns_nid    = id.nid;
1619                 ns->ns_status = LNET_NI_STATUS_UP;
1620
1621                 LNET_LOCK();
1622
1623                 ni = lnet_nid2ni_locked(id.nid);
1624                 LASSERT (ni != NULL);
1625                 LASSERT (ni->ni_status == NULL);
1626                 ni->ni_status = ns;
1627                 lnet_ni_decref_locked(ni);
1628
1629                 LNET_UNLOCK();
1630         }
1631
1632         the_lnet.ln_ping_info = pinfo;
1633         return 0;
1634 }
1635
1636 static void
1637 lnet_destroy_ping_info(void)
1638 {
1639         lnet_ni_t *ni;
1640
1641         LNET_LOCK();
1642
1643         cfs_list_for_each_entry (ni, &the_lnet.ln_nis, ni_list) {
1644                 ni->ni_status = NULL;
1645         }
1646
1647         LNET_UNLOCK();
1648
1649         LIBCFS_FREE(the_lnet.ln_ping_info,
1650                     offsetof(lnet_ping_info_t,
1651                              pi_ni[the_lnet.ln_ping_info->pi_nnis]));
1652         the_lnet.ln_ping_info = NULL;
1653         return;
1654 }
1655
1656 int
1657 lnet_ping_target_init(void)
1658 {
1659         lnet_md_t         md = {0};
1660         lnet_handle_me_t  meh;
1661         lnet_process_id_t id;
1662         int               rc;
1663         int               rc2;
1664         int               infosz;
1665
1666         rc = lnet_create_ping_info();
1667         if (rc != 0)
1668                 return rc;
1669
1670         /* We can have a tiny EQ since we only need to see the unlink event on
1671          * teardown, which by definition is the last one! */
1672         rc = LNetEQAlloc(2, LNET_EQ_HANDLER_NONE, &the_lnet.ln_ping_target_eq);
1673         if (rc != 0) {
1674                 CERROR("Can't allocate ping EQ: %d\n", rc);
1675                 goto failed_0;
1676         }
1677
1678         memset(&id, 0, sizeof(lnet_process_id_t));
1679         id.nid = LNET_NID_ANY;
1680         id.pid = LNET_PID_ANY;
1681
1682         rc = LNetMEAttach(LNET_RESERVED_PORTAL, id,
1683                           LNET_PROTO_PING_MATCHBITS, 0,
1684                           LNET_UNLINK, LNET_INS_AFTER,
1685                           &meh);
1686         if (rc != 0) {
1687                 CERROR("Can't create ping ME: %d\n", rc);
1688                 goto failed_1;
1689         }
1690
1691         /* initialize md content */
1692         infosz = offsetof(lnet_ping_info_t,
1693                           pi_ni[the_lnet.ln_ping_info->pi_nnis]);
1694         md.start     = the_lnet.ln_ping_info;
1695         md.length    = infosz;
1696         md.threshold = LNET_MD_THRESH_INF;
1697         md.max_size  = 0;
1698         md.options   = LNET_MD_OP_GET | LNET_MD_TRUNCATE |
1699                        LNET_MD_MANAGE_REMOTE;
1700         md.user_ptr  = NULL;
1701         md.eq_handle = the_lnet.ln_ping_target_eq;
1702
1703         rc = LNetMDAttach(meh, md,
1704                           LNET_RETAIN,
1705                           &the_lnet.ln_ping_target_md);
1706         if (rc != 0) {
1707                 CERROR("Can't attach ping MD: %d\n", rc);
1708                 goto failed_2;
1709         }
1710
1711         return 0;
1712
1713  failed_2:
1714         rc2 = LNetMEUnlink(meh);
1715         LASSERT (rc2 == 0);
1716  failed_1:
1717         rc2 = LNetEQFree(the_lnet.ln_ping_target_eq);
1718         LASSERT (rc2 == 0);
1719  failed_0:
1720         lnet_destroy_ping_info();
1721         return rc;
1722 }
1723
1724 void
1725 lnet_ping_target_fini(void)
1726 {
1727         lnet_event_t    event;
1728         int             rc;
1729         int             which;
1730         int             timeout_ms = 1000;
1731         cfs_sigset_t    blocked = cfs_block_allsigs();
1732
1733         LNetMDUnlink(the_lnet.ln_ping_target_md);
1734         /* NB md could be busy; this just starts the unlink */
1735
1736         for (;;) {
1737                 rc = LNetEQPoll(&the_lnet.ln_ping_target_eq, 1,
1738                                 timeout_ms, &event, &which);
1739
1740                 /* I expect overflow... */
1741                 LASSERT (rc >= 0 || rc == -EOVERFLOW);
1742
1743                 if (rc == 0) {
1744                         /* timed out: provide a diagnostic */
1745                         CWARN("Still waiting for ping MD to unlink\n");
1746                         timeout_ms *= 2;
1747                         continue;
1748                 }
1749
1750                 /* Got a valid event */
1751                 if (event.unlinked)
1752                         break;
1753         }
1754
1755         rc = LNetEQFree(the_lnet.ln_ping_target_eq);
1756         LASSERT (rc == 0);
1757         lnet_destroy_ping_info();
1758         cfs_restore_sigs(blocked);
1759 }
1760
1761 int
1762 lnet_ping (lnet_process_id_t id, int timeout_ms, lnet_process_id_t *ids, int n_ids)
1763 {
1764         lnet_handle_eq_t     eqh;
1765         lnet_handle_md_t     mdh;
1766         lnet_event_t         event;
1767         lnet_md_t            md = {0};
1768         int                  which;
1769         int                  unlinked = 0;
1770         int                  replied = 0;
1771         const int            a_long_time = 60000; /* mS */
1772         int                  infosz = offsetof(lnet_ping_info_t, pi_ni[n_ids]);
1773         lnet_ping_info_t    *info;
1774         lnet_process_id_t    tmpid;
1775         int                  i;
1776         int                  nob;
1777         int                  rc;
1778         int                  rc2;
1779         cfs_sigset_t         blocked;
1780
1781         if (n_ids <= 0 ||
1782             id.nid == LNET_NID_ANY ||
1783             timeout_ms > 500000 ||              /* arbitrary limit! */
1784             n_ids > 20)                         /* arbitrary limit! */
1785                 return -EINVAL;
1786
1787         if (id.pid == LNET_PID_ANY)
1788                 id.pid = LUSTRE_SRV_LNET_PID;
1789
1790         LIBCFS_ALLOC(info, infosz);
1791         if (info == NULL)
1792                 return -ENOMEM;
1793
1794         /* NB 2 events max (including any unlink event) */
1795         rc = LNetEQAlloc(2, LNET_EQ_HANDLER_NONE, &eqh);
1796         if (rc != 0) {
1797                 CERROR("Can't allocate EQ: %d\n", rc);
1798                 goto out_0;
1799         }
1800
1801         /* initialize md content */
1802         md.start     = info;
1803         md.length    = infosz;
1804         md.threshold = 2; /*GET/REPLY*/
1805         md.max_size  = 0;
1806         md.options   = LNET_MD_TRUNCATE;
1807         md.user_ptr  = NULL;
1808         md.eq_handle = eqh;
1809
1810         rc = LNetMDBind(md, LNET_UNLINK, &mdh);
1811         if (rc != 0) {
1812                 CERROR("Can't bind MD: %d\n", rc);
1813                 goto out_1;
1814         }
1815
1816         rc = LNetGet(LNET_NID_ANY, mdh, id,
1817                      LNET_RESERVED_PORTAL,
1818                      LNET_PROTO_PING_MATCHBITS, 0);
1819
1820         if (rc != 0) {
1821                 /* Don't CERROR; this could be deliberate! */
1822
1823                 rc2 = LNetMDUnlink(mdh);
1824                 LASSERT (rc2 == 0);
1825
1826                 /* NB must wait for the UNLINK event below... */
1827                 unlinked = 1;
1828                 timeout_ms = a_long_time;
1829         }
1830
1831         do {
1832                 /* MUST block for unlink to complete */
1833                 if (unlinked)
1834                         blocked = cfs_block_allsigs();
1835
1836                 rc2 = LNetEQPoll(&eqh, 1, timeout_ms, &event, &which);
1837
1838                 if (unlinked)
1839                         cfs_restore_sigs(blocked);
1840
1841                 CDEBUG(D_NET, "poll %d(%d %d)%s\n", rc2,
1842                        (rc2 <= 0) ? -1 : event.type,
1843                        (rc2 <= 0) ? -1 : event.status,
1844                        (rc2 > 0 && event.unlinked) ? " unlinked" : "");
1845
1846                 LASSERT (rc2 != -EOVERFLOW);     /* can't miss anything */
1847
1848                 if (rc2 <= 0 || event.status != 0) {
1849                         /* timeout or error */
1850                         if (!replied && rc == 0)
1851                                 rc = (rc2 < 0) ? rc2 :
1852                                      (rc2 == 0) ? -ETIMEDOUT :
1853                                      event.status;
1854
1855                         if (!unlinked) {
1856                                 /* Ensure completion in finite time... */
1857                                 LNetMDUnlink(mdh);
1858                                 /* No assertion (racing with network) */
1859                                 unlinked = 1;
1860                                 timeout_ms = a_long_time;
1861                         } else if (rc2 == 0) {
1862                                 /* timed out waiting for unlink */
1863                                 CWARN("ping %s: late network completion\n",
1864                                       libcfs_id2str(id));
1865                         }
1866                 } else if (event.type == LNET_EVENT_REPLY) {
1867                         replied = 1;
1868                         rc = event.mlength;
1869                 }
1870
1871         } while (rc2 <= 0 || !event.unlinked);
1872
1873         if (!replied) {
1874                 if (rc >= 0)
1875                         CWARN("%s: Unexpected rc >= 0 but no reply!\n",
1876                               libcfs_id2str(id));
1877                 rc = -EIO;
1878                 goto out_1;
1879         }
1880
1881         nob = rc;
1882         LASSERT (nob >= 0 && nob <= infosz);
1883
1884         rc = -EPROTO;                           /* if I can't parse... */
1885
1886         if (nob < 8) {
1887                 /* can't check magic/version */
1888                 CERROR("%s: ping info too short %d\n",
1889                        libcfs_id2str(id), nob);
1890                 goto out_1;
1891         }
1892
1893         if (info->pi_magic == __swab32(LNET_PROTO_PING_MAGIC)) {
1894                 lnet_swap_pinginfo(info);
1895         } else if (info->pi_magic != LNET_PROTO_PING_MAGIC) {
1896                 CERROR("%s: Unexpected magic %08x\n",
1897                        libcfs_id2str(id), info->pi_magic);
1898                 goto out_1;
1899         }
1900
1901         if (info->pi_version != LNET_PROTO_PING_VERSION) {
1902                 CERROR("%s: Unexpected version 0x%x\n",
1903                        libcfs_id2str(id), info->pi_version);
1904                 goto out_1;
1905         }
1906
1907         if (nob < offsetof(lnet_ping_info_t, pi_ni[0])) {
1908                 CERROR("%s: Short reply %d(%d min)\n", libcfs_id2str(id),
1909                        nob, (int)offsetof(lnet_ping_info_t, pi_ni[0]));
1910                 goto out_1;
1911         }
1912
1913         if (info->pi_nnis < n_ids)
1914                 n_ids = info->pi_nnis;
1915
1916         if (nob < offsetof(lnet_ping_info_t, pi_ni[n_ids])) {
1917                 CERROR("%s: Short reply %d(%d expected)\n", libcfs_id2str(id),
1918                        nob, (int)offsetof(lnet_ping_info_t, pi_ni[n_ids]));
1919                 goto out_1;
1920         }
1921
1922         rc = -EFAULT;                           /* If I SEGV... */
1923
1924         for (i = 0; i < n_ids; i++) {
1925                 tmpid.pid = info->pi_pid;
1926                 tmpid.nid = info->pi_ni[i].ns_nid;
1927 #ifdef __KERNEL__
1928                 if (cfs_copy_to_user(&ids[i], &tmpid, sizeof(tmpid)))
1929                         goto out_1;
1930 #else
1931                 ids[i] = tmpid;
1932 #endif
1933         }
1934         rc = info->pi_nnis;
1935
1936  out_1:
1937         rc2 = LNetEQFree(eqh);
1938         if (rc2 != 0)
1939                 CERROR("rc2 %d\n", rc2);
1940         LASSERT (rc2 == 0);
1941
1942  out_0:
1943         LIBCFS_FREE(info, infosz);
1944         return rc;
1945 }