2 * Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
4 * Copyright (c) 2011, 2015, Intel Corporation.
6 * This file is part of Lustre, https://wiki.hpdd.intel.com/
8 * Portals is free software; you can redistribute it and/or
9 * modify it under the terms of version 2 of the GNU General Public
10 * License as published by the Free Software Foundation.
12 * Portals is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with Portals; if not, write to the Free Software
19 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
23 #define DEBUG_SUBSYSTEM S_LNET
24 #include <libcfs/libcfs.h>
25 #include <lnet/lib-lnet.h>
27 /* This is really lnet_proc.c. You might need to update sanity test 215
28 * if any file format is changed. */
30 static struct ctl_table_header *lnet_table_header = NULL;
32 #define LNET_LOFFT_BITS (sizeof(loff_t) * 8)
34 * NB: max allowed LNET_CPT_BITS is 8 on 64-bit system and 2 on 32-bit system
36 #define LNET_PROC_CPT_BITS (LNET_CPT_BITS + 1)
37 /* change version, 16 bits or 8 bits */
38 #define LNET_PROC_VER_BITS MAX(((MIN(LNET_LOFFT_BITS, 64)) / 4), 8)
40 #define LNET_PROC_HASH_BITS LNET_PEER_HASH_BITS
42 * bits for peer hash offset
43 * NB: we don't use the highest bit of *ppos because it's signed
45 #define LNET_PROC_HOFF_BITS (LNET_LOFFT_BITS - \
46 LNET_PROC_CPT_BITS - \
47 LNET_PROC_VER_BITS - \
48 LNET_PROC_HASH_BITS - 1)
49 /* bits for hash index + position */
50 #define LNET_PROC_HPOS_BITS (LNET_PROC_HASH_BITS + LNET_PROC_HOFF_BITS)
51 /* bits for peer hash table + hash version */
52 #define LNET_PROC_VPOS_BITS (LNET_PROC_HPOS_BITS + LNET_PROC_VER_BITS)
54 #define LNET_PROC_CPT_MASK ((1ULL << LNET_PROC_CPT_BITS) - 1)
55 #define LNET_PROC_VER_MASK ((1ULL << LNET_PROC_VER_BITS) - 1)
56 #define LNET_PROC_HASH_MASK ((1ULL << LNET_PROC_HASH_BITS) - 1)
57 #define LNET_PROC_HOFF_MASK ((1ULL << LNET_PROC_HOFF_BITS) - 1)
59 #define LNET_PROC_CPT_GET(pos) \
60 (int)(((pos) >> LNET_PROC_VPOS_BITS) & LNET_PROC_CPT_MASK)
62 #define LNET_PROC_VER_GET(pos) \
63 (int)(((pos) >> LNET_PROC_HPOS_BITS) & LNET_PROC_VER_MASK)
65 #define LNET_PROC_HASH_GET(pos) \
66 (int)(((pos) >> LNET_PROC_HOFF_BITS) & LNET_PROC_HASH_MASK)
68 #define LNET_PROC_HOFF_GET(pos) \
69 (int)((pos) & LNET_PROC_HOFF_MASK)
71 #define LNET_PROC_POS_MAKE(cpt, ver, hash, off) \
72 (((((loff_t)(cpt)) & LNET_PROC_CPT_MASK) << LNET_PROC_VPOS_BITS) | \
73 ((((loff_t)(ver)) & LNET_PROC_VER_MASK) << LNET_PROC_HPOS_BITS) | \
74 ((((loff_t)(hash)) & LNET_PROC_HASH_MASK) << LNET_PROC_HOFF_BITS) | \
75 ((off) & LNET_PROC_HOFF_MASK))
77 #define LNET_PROC_VERSION(v) ((unsigned int)((v) & LNET_PROC_VER_MASK))
79 static int __proc_lnet_stats(void *data, int write,
80 loff_t pos, void __user *buffer, int nob)
83 lnet_counters_t *ctrs;
86 const int tmpsiz = 256; /* 7 %u and 4 __u64 */
89 lnet_counters_reset();
95 LIBCFS_ALLOC(ctrs, sizeof(*ctrs));
99 LIBCFS_ALLOC(tmpstr, tmpsiz);
100 if (tmpstr == NULL) {
101 LIBCFS_FREE(ctrs, sizeof(*ctrs));
105 lnet_counters_get(ctrs);
107 len = snprintf(tmpstr, tmpsiz,
108 "%u %u %u %u %u %u %u %llu %llu "
110 ctrs->msgs_alloc, ctrs->msgs_max,
112 ctrs->send_count, ctrs->recv_count,
113 ctrs->route_count, ctrs->drop_count,
114 ctrs->send_length, ctrs->recv_length,
115 ctrs->route_length, ctrs->drop_length);
117 if (pos >= min_t(int, len, strlen(tmpstr)))
120 rc = cfs_trace_copyout_string(buffer, nob,
123 LIBCFS_FREE(tmpstr, tmpsiz);
124 LIBCFS_FREE(ctrs, sizeof(*ctrs));
129 proc_lnet_stats(struct ctl_table *table, int write, void __user *buffer,
130 size_t *lenp, loff_t *ppos)
132 return lprocfs_call_handler(table->data, write, ppos, buffer, lenp,
137 proc_lnet_routes(struct ctl_table *table, int write, void __user *buffer,
138 size_t *lenp, loff_t *ppos)
140 const int tmpsiz = 256;
148 CLASSERT(sizeof(loff_t) >= 4);
150 off = LNET_PROC_HOFF_GET(*ppos);
151 ver = LNET_PROC_VER_GET(*ppos);
158 LIBCFS_ALLOC(tmpstr, tmpsiz);
162 s = tmpstr; /* points to current position in tmpstr[] */
165 s += snprintf(s, tmpstr + tmpsiz - s, "Routing %s\n",
166 the_lnet.ln_routing ? "enabled" : "disabled");
167 LASSERT(tmpstr + tmpsiz - s > 0);
169 s += snprintf(s, tmpstr + tmpsiz - s, "%-8s %4s %8s %7s %s\n",
170 "net", "hops", "priority", "state", "router");
171 LASSERT(tmpstr + tmpsiz - s > 0);
174 ver = (unsigned int)the_lnet.ln_remote_nets_version;
176 *ppos = LNET_PROC_POS_MAKE(0, ver, 0, off);
180 lnet_route_t *route = NULL;
181 lnet_remotenet_t *rnet = NULL;
183 struct list_head *rn_list;
188 if (ver != LNET_PROC_VERSION(the_lnet.ln_remote_nets_version)) {
190 LIBCFS_FREE(tmpstr, tmpsiz);
194 for (i = 0; i < LNET_REMOTE_NETS_HASH_SIZE && route == NULL;
196 rn_list = &the_lnet.ln_remote_nets_hash[i];
200 while (n != rn_list && route == NULL) {
201 rnet = list_entry(n, lnet_remotenet_t,
204 r = rnet->lrn_routes.next;
206 while (r != &rnet->lrn_routes) {
208 list_entry(r, lnet_route_t,
224 __u32 net = rnet->lrn_net;
225 __u32 hops = route->lr_hops;
226 unsigned int priority = route->lr_priority;
227 lnet_nid_t nid = route->lr_gateway->lpni_nid;
228 int alive = lnet_is_route_alive(route);
230 s += snprintf(s, tmpstr + tmpsiz - s,
231 "%-8s %4u %8u %7s %s\n",
232 libcfs_net2str(net), hops,
234 alive ? "up" : "down",
235 libcfs_nid2str(nid));
236 LASSERT(tmpstr + tmpsiz - s > 0);
242 len = s - tmpstr; /* how many bytes was written */
244 if (len > *lenp) { /* linux-supplied buffer is too small */
246 } else if (len > 0) { /* wrote something */
247 if (copy_to_user(buffer, tmpstr, len))
251 *ppos = LNET_PROC_POS_MAKE(0, ver, 0, off);
255 LIBCFS_FREE(tmpstr, tmpsiz);
264 proc_lnet_routers(struct ctl_table *table, int write, void __user *buffer,
265 size_t *lenp, loff_t *ppos)
270 const int tmpsiz = 256;
275 off = LNET_PROC_HOFF_GET(*ppos);
276 ver = LNET_PROC_VER_GET(*ppos);
283 LIBCFS_ALLOC(tmpstr, tmpsiz);
287 s = tmpstr; /* points to current position in tmpstr[] */
290 s += snprintf(s, tmpstr + tmpsiz - s,
291 "%-4s %7s %9s %6s %12s %9s %8s %7s %s\n",
292 "ref", "rtr_ref", "alive_cnt", "state",
293 "last_ping", "ping_sent", "deadline",
294 "down_ni", "router");
295 LASSERT(tmpstr + tmpsiz - s > 0);
298 ver = (unsigned int)the_lnet.ln_routers_version;
300 *ppos = LNET_PROC_POS_MAKE(0, ver, 0, off);
303 struct lnet_peer_ni *peer = NULL;
308 if (ver != LNET_PROC_VERSION(the_lnet.ln_routers_version)) {
311 LIBCFS_FREE(tmpstr, tmpsiz);
315 r = the_lnet.ln_routers.next;
317 while (r != &the_lnet.ln_routers) {
318 struct lnet_peer_ni *lp =
319 list_entry(r, struct lnet_peer_ni,
332 lnet_nid_t nid = peer->lpni_nid;
333 cfs_time_t now = cfs_time_current();
334 cfs_time_t deadline = peer->lpni_ping_deadline;
335 int nrefs = atomic_read(&peer->lpni_refcount);
336 int nrtrrefs = peer->lpni_rtr_refcount;
337 int alive_cnt = peer->lpni_alive_count;
338 int alive = peer->lpni_alive;
339 int pingsent = !peer->lpni_ping_notsent;
340 int last_ping = cfs_duration_sec(cfs_time_sub(now,
341 peer->lpni_ping_timestamp));
345 if ((peer->lpni_ping_feats &
346 LNET_PING_FEAT_NI_STATUS) != 0) {
347 list_for_each_entry(rtr, &peer->lpni_routes,
349 /* downis on any route should be the
350 * number of downis on the gateway */
351 if (rtr->lr_downis != 0) {
352 down_ni = rtr->lr_downis;
359 s += snprintf(s, tmpstr + tmpsiz - s,
360 "%-4d %7d %9d %6s %12d %9d %8s %7d %s\n",
361 nrefs, nrtrrefs, alive_cnt,
362 alive ? "up" : "down", last_ping,
363 pingsent, "NA", down_ni,
364 libcfs_nid2str(nid));
366 s += snprintf(s, tmpstr + tmpsiz - s,
367 "%-4d %7d %9d %6s %12d %9d %8lu %7d %s\n",
368 nrefs, nrtrrefs, alive_cnt,
369 alive ? "up" : "down", last_ping,
371 cfs_duration_sec(cfs_time_sub(deadline, now)),
372 down_ni, libcfs_nid2str(nid));
373 LASSERT(tmpstr + tmpsiz - s > 0);
379 len = s - tmpstr; /* how many bytes was written */
381 if (len > *lenp) { /* linux-supplied buffer is too small */
383 } else if (len > 0) { /* wrote something */
384 if (copy_to_user(buffer, tmpstr, len))
388 *ppos = LNET_PROC_POS_MAKE(0, ver, 0, off);
392 LIBCFS_FREE(tmpstr, tmpsiz);
400 /* TODO: there should be no direct access to ptable. We should add a set
401 * of APIs that give access to the ptable and its members */
403 proc_lnet_peers(struct ctl_table *table, int write, void __user *buffer,
404 size_t *lenp, loff_t *ppos)
406 const int tmpsiz = 256;
407 struct lnet_peer_table *ptable;
410 int cpt = LNET_PROC_CPT_GET(*ppos);
411 int ver = LNET_PROC_VER_GET(*ppos);
412 int hash = LNET_PROC_HASH_GET(*ppos);
413 int hoff = LNET_PROC_HOFF_GET(*ppos);
417 CLASSERT(LNET_PROC_HASH_BITS >= LNET_PEER_HASH_BITS);
423 if (cpt >= LNET_CPT_NUMBER) {
428 LIBCFS_ALLOC(tmpstr, tmpsiz);
432 s = tmpstr; /* points to current position in tmpstr[] */
435 s += snprintf(s, tmpstr + tmpsiz - s,
436 "%-24s %4s %5s %5s %5s %5s %5s %5s %5s %s\n",
437 "nid", "refs", "state", "last", "max",
438 "rtr", "min", "tx", "min", "queue");
439 LASSERT(tmpstr + tmpsiz - s > 0);
443 struct lnet_peer_ni *peer;
452 ptable = the_lnet.ln_peer_tables[cpt];
454 ver = LNET_PROC_VERSION(ptable->pt_version);
456 if (ver != LNET_PROC_VERSION(ptable->pt_version)) {
457 lnet_net_unlock(cpt);
458 LIBCFS_FREE(tmpstr, tmpsiz);
462 while (hash < LNET_PEER_HASH_SIZE) {
464 p = ptable->pt_hash[hash].next;
466 while (p != &ptable->pt_hash[hash]) {
467 struct lnet_peer_ni *lp =
468 list_entry(p, struct lnet_peer_ni,
473 /* minor optimization: start from idx+1
474 * on next iteration if we've just
475 * drained lpni_hashlist */
476 if (lp->lpni_hashlist.next ==
477 &ptable->pt_hash[hash]) {
488 p = lp->lpni_hashlist.next;
500 lnet_nid_t nid = peer->lpni_nid;
501 int nrefs = atomic_read(&peer->lpni_refcount);
503 char *aliveness = "NA";
504 int maxcr = peer->lpni_net->net_tunables.lct_peer_tx_credits;
505 int txcr = peer->lpni_txcredits;
506 int mintxcr = peer->lpni_mintxcredits;
507 int rtrcr = peer->lpni_rtrcredits;
508 int minrtrcr = peer->lpni_minrtrcredits;
509 int txqnob = peer->lpni_txqnob;
511 if (lnet_isrouter(peer) ||
512 lnet_peer_aliveness_enabled(peer))
513 aliveness = peer->lpni_alive ? "up" : "down";
515 if (lnet_peer_aliveness_enabled(peer)) {
516 cfs_time_t now = cfs_time_current();
517 cfs_duration_t delta;
519 delta = cfs_time_sub(now, peer->lpni_last_alive);
520 lastalive = cfs_duration_sec(delta);
522 /* No need to mess up peers contents with
523 * arbitrarily long integers - it suffices to
524 * know that lastalive is more than 10000s old
526 if (lastalive >= 10000)
530 lnet_net_unlock(cpt);
532 s += snprintf(s, tmpstr + tmpsiz - s,
533 "%-24s %4d %5s %5d %5d %5d %5d %5d %5d %d\n",
534 libcfs_nid2str(nid), nrefs, aliveness,
535 lastalive, maxcr, rtrcr, minrtrcr, txcr,
537 LASSERT(tmpstr + tmpsiz - s > 0);
539 } else { /* peer is NULL */
540 lnet_net_unlock(cpt);
543 if (hash == LNET_PEER_HASH_SIZE) {
547 if (peer == NULL && cpt < LNET_CPT_NUMBER)
552 len = s - tmpstr; /* how many bytes was written */
554 if (len > *lenp) { /* linux-supplied buffer is too small */
556 } else if (len > 0) { /* wrote something */
557 if (copy_to_user(buffer, tmpstr, len))
560 *ppos = LNET_PROC_POS_MAKE(cpt, ver, hash, hoff);
563 LIBCFS_FREE(tmpstr, tmpsiz);
571 static int __proc_lnet_buffers(void *data, int write,
572 loff_t pos, void __user *buffer, int nob)
584 /* (4 %d) * 4 * LNET_CPT_NUMBER */
585 tmpsiz = 64 * (LNET_NRBPOOLS + 1) * LNET_CPT_NUMBER;
586 LIBCFS_ALLOC(tmpstr, tmpsiz);
590 s = tmpstr; /* points to current position in tmpstr[] */
592 s += snprintf(s, tmpstr + tmpsiz - s,
594 "pages", "count", "credits", "min");
595 LASSERT(tmpstr + tmpsiz - s > 0);
597 if (the_lnet.ln_rtrpools == NULL)
598 goto out; /* I'm not a router */
600 for (idx = 0; idx < LNET_NRBPOOLS; idx++) {
601 lnet_rtrbufpool_t *rbp;
603 lnet_net_lock(LNET_LOCK_EX);
604 cfs_percpt_for_each(rbp, i, the_lnet.ln_rtrpools) {
605 s += snprintf(s, tmpstr + tmpsiz - s,
608 rbp[idx].rbp_nbuffers,
609 rbp[idx].rbp_credits,
610 rbp[idx].rbp_mincredits);
611 LASSERT(tmpstr + tmpsiz - s > 0);
613 lnet_net_unlock(LNET_LOCK_EX);
619 if (pos >= min_t(int, len, strlen(tmpstr)))
622 rc = cfs_trace_copyout_string(buffer, nob,
625 LIBCFS_FREE(tmpstr, tmpsiz);
630 proc_lnet_buffers(struct ctl_table *table, int write, void __user *buffer,
631 size_t *lenp, loff_t *ppos)
633 return lprocfs_call_handler(table->data, write, ppos, buffer, lenp,
634 __proc_lnet_buffers);
638 proc_lnet_nis(struct ctl_table *table, int write, void __user *buffer,
639 size_t *lenp, loff_t *ppos)
641 int tmpsiz = 128 * LNET_CPT_NUMBER;
652 LIBCFS_ALLOC(tmpstr, tmpsiz);
656 s = tmpstr; /* points to current position in tmpstr[] */
659 s += snprintf(s, tmpstr + tmpsiz - s,
660 "%-24s %6s %5s %4s %4s %4s %5s %5s %5s\n",
661 "nid", "status", "alive", "refs", "peer",
662 "rtr", "max", "tx", "min");
663 LASSERT (tmpstr + tmpsiz - s > 0);
665 lnet_ni_t *ni = NULL;
666 int skip = *ppos - 1;
670 ni = lnet_get_ni_idx_locked(skip);
673 struct lnet_tx_queue *tq;
675 time64_t now = ktime_get_real_seconds();
680 if (the_lnet.ln_routing)
681 last_alive = now - ni->ni_last_alive;
683 /* @lo forever alive */
684 if (ni->ni_net->net_lnd->lnd_type == LOLND)
688 LASSERT(ni->ni_status != NULL);
689 stat = (ni->ni_status->ns_status ==
690 LNET_NI_STATUS_UP) ? "up" : "down";
693 /* we actually output credits information for
694 * TX queue of each partition */
695 cfs_percpt_for_each(tq, i, ni->ni_tx_queues) {
696 for (j = 0; ni->ni_cpts != NULL &&
697 j < ni->ni_ncpts; j++) {
698 if (i == ni->ni_cpts[j])
702 if (j == ni->ni_ncpts)
708 s += snprintf(s, tmpstr + tmpsiz - s,
709 "%-24s %6s %5d %4d %4d %4d %5d %5d %5d\n",
710 libcfs_nid2str(ni->ni_nid), stat,
711 last_alive, *ni->ni_refs[i],
712 ni->ni_net->net_tunables.lct_peer_tx_credits,
713 ni->ni_net->net_tunables.lct_peer_rtr_credits,
715 tq->tq_credits, tq->tq_credits_min);
719 LASSERT(tmpstr + tmpsiz - s > 0);
725 len = s - tmpstr; /* how many bytes was written */
727 if (len > *lenp) { /* linux-supplied buffer is too small */
729 } else if (len > 0) { /* wrote something */
730 if (copy_to_user(buffer, tmpstr, len))
736 LIBCFS_FREE(tmpstr, tmpsiz);
744 struct lnet_portal_rotors {
750 static struct lnet_portal_rotors portal_rotors[] = {
752 .pr_value = LNET_PTL_ROTOR_OFF,
754 .pr_desc = "Turn off message rotor for wildcard portals"
757 .pr_value = LNET_PTL_ROTOR_ON,
759 .pr_desc = "round-robin dispatch all PUT messages for "
763 .pr_value = LNET_PTL_ROTOR_RR_RT,
765 .pr_desc = "round-robin dispatch routed PUT message for "
769 .pr_value = LNET_PTL_ROTOR_HASH_RT,
770 .pr_name = "HASH_RT",
771 .pr_desc = "dispatch routed PUT message by hashing source "
772 "NID for wildcard portals"
781 static int __proc_lnet_portal_rotor(void *data, int write,
782 loff_t pos, void __user *buffer, int nob)
784 const int buf_len = 128;
790 LIBCFS_ALLOC(buf, buf_len);
797 for (i = 0; portal_rotors[i].pr_value >= 0; i++) {
798 if (portal_rotors[i].pr_value == portal_rotor)
802 LASSERT(portal_rotors[i].pr_value == portal_rotor);
805 rc = snprintf(buf, buf_len,
806 "{\n\tportals: all\n"
807 "\trotor: %s\n\tdescription: %s\n}",
808 portal_rotors[i].pr_name,
809 portal_rotors[i].pr_desc);
811 if (pos >= min_t(int, rc, buf_len)) {
814 rc = cfs_trace_copyout_string(buffer, nob,
820 rc = cfs_trace_copyin_string(buf, buf_len, buffer, nob);
824 tmp = cfs_trimwhite(buf);
828 for (i = 0; portal_rotors[i].pr_name != NULL; i++) {
829 if (strncasecmp(portal_rotors[i].pr_name, tmp,
830 strlen(portal_rotors[i].pr_name)) == 0) {
831 portal_rotor = portal_rotors[i].pr_value;
838 LIBCFS_FREE(buf, buf_len);
843 proc_lnet_portal_rotor(struct ctl_table *table, int write, void __user *buffer,
844 size_t *lenp, loff_t *ppos)
846 return lprocfs_call_handler(table->data, write, ppos, buffer, lenp,
847 __proc_lnet_portal_rotor);
851 static struct ctl_table lnet_table[] = {
853 * NB No .strategy entries have been provided since sysctl(8) prefers
854 * to go via /proc for portability.
860 .proc_handler = &proc_lnet_stats,
864 .procname = "routes",
866 .proc_handler = &proc_lnet_routes,
870 .procname = "routers",
872 .proc_handler = &proc_lnet_routers,
878 .proc_handler = &proc_lnet_peers,
882 .procname = "buffers",
884 .proc_handler = &proc_lnet_buffers,
890 .proc_handler = &proc_lnet_nis,
894 .procname = "portal_rotor",
896 .proc_handler = &proc_lnet_portal_rotor,
901 static struct ctl_table top_table[] = {
917 if (lnet_table_header == NULL)
918 lnet_table_header = register_sysctl_table(top_table);
926 if (lnet_table_header != NULL)
927 unregister_sysctl_table(lnet_table_header);
929 lnet_table_header = NULL;