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,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License version 2 for more details. A copy is
14 * included in the COPYING file that accompanied this code.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 * Copyright (C) 2013 DataDirect Networks, Inc.
27 * lustre/ptlrpc/nrs_tbf.c
29 * Network Request Scheduler (NRS) Token Bucket Filter(TBF) policy
33 #ifdef HAVE_SERVER_SUPPORT
40 #define DEBUG_SUBSYSTEM S_RPC
42 #include <liblustre.h>
44 #include <obd_support.h>
45 #include <obd_class.h>
46 #include <libcfs/libcfs.h>
47 #include "ptlrpc_internal.h"
52 * Token Bucket Filter over client NIDs
57 #define NRS_POL_NAME_TBF "tbf"
59 int tbf_jobid_cache_size = 8192;
60 CFS_MODULE_PARM(tbf_jobid_cache_size, "i", int, 0644,
61 "The size of jobid cache");
64 CFS_MODULE_PARM(tbf_rate, "i", int, 0644,
65 "Default rate limit in RPCs/s");
68 CFS_MODULE_PARM(tbf_depth, "i", int, 0644,
69 "How many tokens that a client can save up");
71 static enum hrtimer_restart nrs_tbf_timer_cb(struct hrtimer *timer)
73 struct nrs_tbf_head *head = container_of(timer, struct nrs_tbf_head,
75 struct ptlrpc_nrs *nrs = head->th_res.res_policy->pol_nrs;
76 struct ptlrpc_service_part *svcpt = nrs->nrs_svcpt;
78 spin_lock(&nrs->nrs_lock);
79 nrs->nrs_throttling = 0;
80 spin_unlock(&nrs->nrs_lock);
81 wake_up(&svcpt->scp_waitq);
83 return HRTIMER_NORESTART;
86 #define NRS_TBF_DEFAULT_RULE "default"
88 static void nrs_tbf_rule_fini(struct nrs_tbf_rule *rule)
90 LASSERT(atomic_read(&rule->tr_ref) == 0);
91 LASSERT(list_empty(&rule->tr_cli_list));
92 LASSERT(list_empty(&rule->tr_linkage));
94 rule->tr_head->th_ops->o_rule_fini(rule);
99 * Decreases the rule's usage reference count, and stops the rule in case it
100 * was already stopping and have no more outstanding usage references (which
101 * indicates it has no more queued or started requests, and can be safely
104 static void nrs_tbf_rule_put(struct nrs_tbf_rule *rule)
106 if (atomic_dec_and_test(&rule->tr_ref))
107 nrs_tbf_rule_fini(rule);
111 * Increases the rule's usage reference count.
113 static inline void nrs_tbf_rule_get(struct nrs_tbf_rule *rule)
115 atomic_inc(&rule->tr_ref);
119 nrs_tbf_cli_rule_put(struct nrs_tbf_client *cli)
121 LASSERT(!list_empty(&cli->tc_linkage));
122 LASSERT(cli->tc_rule);
123 list_del_init(&cli->tc_linkage);
124 nrs_tbf_rule_put(cli->tc_rule);
129 nrs_tbf_cli_reset_value(struct nrs_tbf_head *head,
130 struct nrs_tbf_client *cli)
133 struct nrs_tbf_rule *rule = cli->tc_rule;
135 cli->tc_rpc_rate = rule->tr_rpc_rate;
136 cli->tc_nsecs = rule->tr_nsecs;
137 cli->tc_depth = rule->tr_depth;
138 cli->tc_ntoken = rule->tr_depth;
139 cli->tc_check_time = ktime_to_ns(ktime_get());
140 cli->tc_rule_sequence = atomic_read(&head->th_rule_sequence);
141 cli->tc_rule_generation = rule->tr_generation;
144 cfs_binheap_relocate(head->th_binheap,
149 nrs_tbf_cli_reset(struct nrs_tbf_head *head,
150 struct nrs_tbf_rule *rule,
151 struct nrs_tbf_client *cli)
153 if (!list_empty(&cli->tc_linkage)) {
154 LASSERT(rule != cli->tc_rule);
155 nrs_tbf_cli_rule_put(cli);
157 LASSERT(cli->tc_rule == NULL);
158 LASSERT(list_empty(&cli->tc_linkage));
159 /* Rule's ref is added before called */
161 list_add_tail(&cli->tc_linkage, &rule->tr_cli_list);
162 nrs_tbf_cli_reset_value(head, cli);
166 nrs_tbf_rule_dump(struct nrs_tbf_rule *rule, struct seq_file *m)
168 return rule->tr_head->th_ops->o_rule_dump(rule, m);
172 nrs_tbf_rule_dump_all(struct nrs_tbf_head *head, struct seq_file *m)
174 struct nrs_tbf_rule *rule;
177 LASSERT(head != NULL);
178 spin_lock(&head->th_rule_lock);
179 /* List the rules from newest to oldest */
180 list_for_each_entry(rule, &head->th_list, tr_linkage) {
181 LASSERT((rule->tr_flags & NTRS_STOPPING) == 0);
182 rc = nrs_tbf_rule_dump(rule, m);
188 spin_unlock(&head->th_rule_lock);
193 static struct nrs_tbf_rule *
194 nrs_tbf_rule_find_nolock(struct nrs_tbf_head *head,
197 struct nrs_tbf_rule *rule;
199 LASSERT(head != NULL);
200 list_for_each_entry(rule, &head->th_list, tr_linkage) {
201 LASSERT((rule->tr_flags & NTRS_STOPPING) == 0);
202 if (strcmp(rule->tr_name, name) == 0) {
203 nrs_tbf_rule_get(rule);
210 static struct nrs_tbf_rule *
211 nrs_tbf_rule_find(struct nrs_tbf_head *head,
214 struct nrs_tbf_rule *rule;
216 LASSERT(head != NULL);
217 spin_lock(&head->th_rule_lock);
218 rule = nrs_tbf_rule_find_nolock(head, name);
219 spin_unlock(&head->th_rule_lock);
223 static struct nrs_tbf_rule *
224 nrs_tbf_rule_match(struct nrs_tbf_head *head,
225 struct nrs_tbf_client *cli)
227 struct nrs_tbf_rule *rule = NULL;
228 struct nrs_tbf_rule *tmp_rule;
230 spin_lock(&head->th_rule_lock);
231 /* Match the newest rule in the list */
232 list_for_each_entry(tmp_rule, &head->th_list, tr_linkage) {
233 LASSERT((tmp_rule->tr_flags & NTRS_STOPPING) == 0);
234 if (head->th_ops->o_rule_match(tmp_rule, cli)) {
241 rule = head->th_rule;
243 nrs_tbf_rule_get(rule);
244 spin_unlock(&head->th_rule_lock);
249 nrs_tbf_cli_init(struct nrs_tbf_head *head,
250 struct nrs_tbf_client *cli,
251 struct ptlrpc_request *req)
253 struct nrs_tbf_rule *rule;
255 cli->tc_in_heap = false;
256 head->th_ops->o_cli_init(cli, req);
257 INIT_LIST_HEAD(&cli->tc_list);
258 INIT_LIST_HEAD(&cli->tc_linkage);
259 atomic_set(&cli->tc_ref, 1);
260 rule = nrs_tbf_rule_match(head, cli);
261 nrs_tbf_cli_reset(head, rule, cli);
265 nrs_tbf_cli_fini(struct nrs_tbf_client *cli)
267 LASSERT(list_empty(&cli->tc_list));
268 LASSERT(!cli->tc_in_heap);
269 LASSERT(atomic_read(&cli->tc_ref) == 0);
270 nrs_tbf_cli_rule_put(cli);
275 nrs_tbf_rule_start(struct ptlrpc_nrs_policy *policy,
276 struct nrs_tbf_head *head,
277 struct nrs_tbf_cmd *start)
279 struct nrs_tbf_rule *rule, *tmp_rule;
282 rule = nrs_tbf_rule_find(head, start->tc_name);
284 nrs_tbf_rule_put(rule);
288 OBD_CPT_ALLOC_PTR(rule, nrs_pol2cptab(policy), nrs_pol2cptid(policy));
292 memcpy(rule->tr_name, start->tc_name, strlen(start->tc_name));
293 rule->tr_rpc_rate = start->tc_rpc_rate;
294 rule->tr_nsecs = NSEC_PER_SEC / rule->tr_rpc_rate;
295 rule->tr_depth = tbf_depth;
296 atomic_set(&rule->tr_ref, 1);
297 INIT_LIST_HEAD(&rule->tr_cli_list);
298 INIT_LIST_HEAD(&rule->tr_nids);
300 rc = head->th_ops->o_rule_init(policy, rule, start);
306 /* Add as the newest rule */
307 spin_lock(&head->th_rule_lock);
308 tmp_rule = nrs_tbf_rule_find_nolock(head, start->tc_name);
310 spin_unlock(&head->th_rule_lock);
311 nrs_tbf_rule_put(tmp_rule);
312 nrs_tbf_rule_put(rule);
315 list_add(&rule->tr_linkage, &head->th_list);
316 rule->tr_head = head;
317 spin_unlock(&head->th_rule_lock);
318 atomic_inc(&head->th_rule_sequence);
319 if (start->tc_rule_flags & NTRS_DEFAULT) {
320 rule->tr_flags |= NTRS_DEFAULT;
321 LASSERT(head->th_rule == NULL);
322 head->th_rule = rule;
329 nrs_tbf_rule_change(struct ptlrpc_nrs_policy *policy,
330 struct nrs_tbf_head *head,
331 struct nrs_tbf_cmd *change)
333 struct nrs_tbf_rule *rule;
335 assert_spin_locked(&policy->pol_nrs->nrs_lock);
337 rule = nrs_tbf_rule_find(head, change->tc_name);
341 rule->tr_rpc_rate = change->tc_rpc_rate;
342 rule->tr_nsecs = NSEC_PER_SEC / rule->tr_rpc_rate;
343 rule->tr_generation++;
344 nrs_tbf_rule_put(rule);
350 nrs_tbf_rule_stop(struct ptlrpc_nrs_policy *policy,
351 struct nrs_tbf_head *head,
352 struct nrs_tbf_cmd *stop)
354 struct nrs_tbf_rule *rule;
356 assert_spin_locked(&policy->pol_nrs->nrs_lock);
358 if (strcmp(stop->tc_name, NRS_TBF_DEFAULT_RULE) == 0)
361 rule = nrs_tbf_rule_find(head, stop->tc_name);
365 list_del_init(&rule->tr_linkage);
366 rule->tr_flags |= NTRS_STOPPING;
367 nrs_tbf_rule_put(rule);
368 nrs_tbf_rule_put(rule);
374 nrs_tbf_command(struct ptlrpc_nrs_policy *policy,
375 struct nrs_tbf_head *head,
376 struct nrs_tbf_cmd *cmd)
380 assert_spin_locked(&policy->pol_nrs->nrs_lock);
382 switch (cmd->tc_cmd) {
383 case NRS_CTL_TBF_START_RULE:
384 if (!(cmd->tc_valid_types & head->th_type_flag))
387 spin_unlock(&policy->pol_nrs->nrs_lock);
388 rc = nrs_tbf_rule_start(policy, head, cmd);
389 spin_lock(&policy->pol_nrs->nrs_lock);
391 case NRS_CTL_TBF_CHANGE_RATE:
392 rc = nrs_tbf_rule_change(policy, head, cmd);
394 case NRS_CTL_TBF_STOP_RULE:
395 rc = nrs_tbf_rule_stop(policy, head, cmd);
396 /* Take it as a success, if not exists at all */
397 return rc == -ENOENT ? 0 : rc;
404 * Binary heap predicate.
406 * \param[in] e1 the first binheap node to compare
407 * \param[in] e2 the second binheap node to compare
412 static int tbf_cli_compare(cfs_binheap_node_t *e1, cfs_binheap_node_t *e2)
414 struct nrs_tbf_client *cli1;
415 struct nrs_tbf_client *cli2;
417 cli1 = container_of(e1, struct nrs_tbf_client, tc_node);
418 cli2 = container_of(e2, struct nrs_tbf_client, tc_node);
420 if (cli1->tc_check_time + cli1->tc_nsecs <
421 cli2->tc_check_time + cli2->tc_nsecs)
423 else if (cli1->tc_check_time + cli1->tc_nsecs >
424 cli2->tc_check_time + cli2->tc_nsecs)
427 if (cli1->tc_check_time < cli2->tc_check_time)
429 else if (cli1->tc_check_time > cli2->tc_check_time)
432 /* Maybe need more comparasion, e.g. request number in the rules */
437 * TBF binary heap operations
439 static cfs_binheap_ops_t nrs_tbf_heap_ops = {
442 .hop_compare = tbf_cli_compare,
445 static unsigned nrs_tbf_jobid_hop_hash(cfs_hash_t *hs, const void *key,
448 return cfs_hash_djb2_hash(key, strlen(key), mask);
451 static int nrs_tbf_jobid_hop_keycmp(const void *key, struct hlist_node *hnode)
453 struct nrs_tbf_client *cli = hlist_entry(hnode,
454 struct nrs_tbf_client,
457 return (strcmp(cli->tc_jobid, key) == 0);
460 static void *nrs_tbf_jobid_hop_key(struct hlist_node *hnode)
462 struct nrs_tbf_client *cli = hlist_entry(hnode,
463 struct nrs_tbf_client,
466 return cli->tc_jobid;
469 static void *nrs_tbf_jobid_hop_object(struct hlist_node *hnode)
471 return hlist_entry(hnode, struct nrs_tbf_client, tc_hnode);
474 static void nrs_tbf_jobid_hop_get(cfs_hash_t *hs, struct hlist_node *hnode)
476 struct nrs_tbf_client *cli = hlist_entry(hnode,
477 struct nrs_tbf_client,
480 atomic_inc(&cli->tc_ref);
483 static void nrs_tbf_jobid_hop_put(cfs_hash_t *hs, struct hlist_node *hnode)
485 struct nrs_tbf_client *cli = hlist_entry(hnode,
486 struct nrs_tbf_client,
489 atomic_dec(&cli->tc_ref);
492 static void nrs_tbf_jobid_hop_exit(cfs_hash_t *hs, struct hlist_node *hnode)
495 struct nrs_tbf_client *cli = hlist_entry(hnode,
496 struct nrs_tbf_client,
499 LASSERT(atomic_read(&cli->tc_ref) == 0);
500 nrs_tbf_cli_fini(cli);
503 static cfs_hash_ops_t nrs_tbf_jobid_hash_ops = {
504 .hs_hash = nrs_tbf_jobid_hop_hash,
505 .hs_keycmp = nrs_tbf_jobid_hop_keycmp,
506 .hs_key = nrs_tbf_jobid_hop_key,
507 .hs_object = nrs_tbf_jobid_hop_object,
508 .hs_get = nrs_tbf_jobid_hop_get,
509 .hs_put = nrs_tbf_jobid_hop_put,
510 .hs_put_locked = nrs_tbf_jobid_hop_put,
511 .hs_exit = nrs_tbf_jobid_hop_exit,
514 #define NRS_TBF_JOBID_HASH_FLAGS (CFS_HASH_SPIN_BKTLOCK | \
515 CFS_HASH_NO_ITEMREF | \
518 static struct nrs_tbf_client *
519 nrs_tbf_jobid_hash_lookup(cfs_hash_t *hs,
523 struct hlist_node *hnode;
524 struct nrs_tbf_client *cli;
526 /* cfs_hash_bd_peek_locked is a somehow "internal" function
527 * of cfs_hash, it doesn't add refcount on object. */
528 hnode = cfs_hash_bd_peek_locked(hs, bd, (void *)jobid);
532 cfs_hash_get(hs, hnode);
533 cli = container_of0(hnode, struct nrs_tbf_client, tc_hnode);
534 if (!list_empty(&cli->tc_lru))
535 list_del_init(&cli->tc_lru);
539 #define NRS_TBF_JOBID_NULL ""
541 static struct nrs_tbf_client *
542 nrs_tbf_jobid_cli_find(struct nrs_tbf_head *head,
543 struct ptlrpc_request *req)
546 struct nrs_tbf_client *cli;
547 cfs_hash_t *hs = head->th_cli_hash;
550 jobid = lustre_msg_get_jobid(req->rq_reqmsg);
552 jobid = NRS_TBF_JOBID_NULL;
553 cfs_hash_bd_get_and_lock(hs, (void *)jobid, &bd, 1);
554 cli = nrs_tbf_jobid_hash_lookup(hs, &bd, jobid);
555 cfs_hash_bd_unlock(hs, &bd, 1);
560 static struct nrs_tbf_client *
561 nrs_tbf_jobid_cli_findadd(struct nrs_tbf_head *head,
562 struct nrs_tbf_client *cli)
565 struct nrs_tbf_client *ret;
566 cfs_hash_t *hs = head->th_cli_hash;
569 jobid = cli->tc_jobid;
570 cfs_hash_bd_get_and_lock(hs, (void *)jobid, &bd, 1);
571 ret = nrs_tbf_jobid_hash_lookup(hs, &bd, jobid);
573 cfs_hash_bd_add_locked(hs, &bd, &cli->tc_hnode);
576 cfs_hash_bd_unlock(hs, &bd, 1);
582 nrs_tbf_jobid_cli_put(struct nrs_tbf_head *head,
583 struct nrs_tbf_client *cli)
586 cfs_hash_t *hs = head->th_cli_hash;
587 struct nrs_tbf_bucket *bkt;
589 struct list_head zombies;
591 INIT_LIST_HEAD(&zombies);
592 cfs_hash_bd_get(hs, &cli->tc_jobid, &bd);
593 bkt = cfs_hash_bd_extra_get(hs, &bd);
594 if (!cfs_hash_bd_dec_and_lock(hs, &bd, &cli->tc_ref))
596 LASSERT(list_empty(&cli->tc_lru));
597 list_add_tail(&cli->tc_lru, &bkt->ntb_lru);
600 * Check and purge the LRU, there is at least one client in the LRU.
602 hw = tbf_jobid_cache_size >>
603 (hs->hs_cur_bits - hs->hs_bkt_bits);
604 while (cfs_hash_bd_count_get(&bd) > hw) {
605 if (unlikely(list_empty(&bkt->ntb_lru)))
607 cli = list_entry(bkt->ntb_lru.next,
608 struct nrs_tbf_client,
610 LASSERT(atomic_read(&cli->tc_ref) == 0);
611 cfs_hash_bd_del_locked(hs, &bd, &cli->tc_hnode);
612 list_move(&cli->tc_lru, &zombies);
614 cfs_hash_bd_unlock(head->th_cli_hash, &bd, 1);
616 while (!list_empty(&zombies)) {
617 cli = container_of0(zombies.next,
618 struct nrs_tbf_client, tc_lru);
619 list_del_init(&cli->tc_lru);
620 nrs_tbf_cli_fini(cli);
625 nrs_tbf_jobid_cli_init(struct nrs_tbf_client *cli,
626 struct ptlrpc_request *req)
628 char *jobid = lustre_msg_get_jobid(req->rq_reqmsg);
631 jobid = NRS_TBF_JOBID_NULL;
632 LASSERT(strlen(jobid) < JOBSTATS_JOBID_SIZE);
633 INIT_LIST_HEAD(&cli->tc_lru);
634 memcpy(cli->tc_jobid, jobid, strlen(jobid));
637 static int nrs_tbf_jobid_hash_order(void)
641 for (bits = 1; (1 << bits) < tbf_jobid_cache_size; ++bits)
647 #define NRS_TBF_JOBID_BKT_BITS 10
650 nrs_tbf_jobid_startup(struct ptlrpc_nrs_policy *policy,
651 struct nrs_tbf_head *head)
653 struct nrs_tbf_cmd start;
654 struct nrs_tbf_bucket *bkt;
660 bits = nrs_tbf_jobid_hash_order();
661 if (bits < NRS_TBF_JOBID_BKT_BITS)
662 bits = NRS_TBF_JOBID_BKT_BITS;
663 head->th_cli_hash = cfs_hash_create("nrs_tbf_hash",
666 NRS_TBF_JOBID_BKT_BITS,
670 &nrs_tbf_jobid_hash_ops,
671 NRS_TBF_JOBID_HASH_FLAGS);
672 if (head->th_cli_hash == NULL)
675 cfs_hash_for_each_bucket(head->th_cli_hash, &bd, i) {
676 bkt = cfs_hash_bd_extra_get(head->th_cli_hash, &bd);
677 INIT_LIST_HEAD(&bkt->ntb_lru);
680 memset(&start, 0, sizeof(start));
681 start.tc_jobids_str = "*";
683 start.tc_rpc_rate = tbf_rate;
684 start.tc_rule_flags = NTRS_DEFAULT;
685 start.tc_name = NRS_TBF_DEFAULT_RULE;
686 INIT_LIST_HEAD(&start.tc_jobids);
687 rc = nrs_tbf_rule_start(policy, head, &start);
693 * Frees jobid of \a list.
697 nrs_tbf_jobid_list_free(struct list_head *jobid_list)
699 struct nrs_tbf_jobid *jobid, *n;
701 list_for_each_entry_safe(jobid, n, jobid_list, tj_linkage) {
702 OBD_FREE(jobid->tj_id, strlen(jobid->tj_id) + 1);
703 list_del(&jobid->tj_linkage);
704 OBD_FREE(jobid, sizeof(struct nrs_tbf_jobid));
709 nrs_tbf_jobid_list_add(const struct cfs_lstr *id, struct list_head *jobid_list)
711 struct nrs_tbf_jobid *jobid;
713 OBD_ALLOC(jobid, sizeof(struct nrs_tbf_jobid));
717 OBD_ALLOC(jobid->tj_id, id->ls_len + 1);
718 if (jobid->tj_id == NULL) {
719 OBD_FREE(jobid, sizeof(struct nrs_tbf_jobid));
723 memcpy(jobid->tj_id, id->ls_str, id->ls_len);
724 list_add_tail(&jobid->tj_linkage, jobid_list);
729 nrs_tbf_jobid_list_match(struct list_head *jobid_list, char *id)
731 struct nrs_tbf_jobid *jobid;
733 list_for_each_entry(jobid, jobid_list, tj_linkage) {
734 if (strcmp(id, jobid->tj_id) == 0)
741 nrs_tbf_jobid_list_parse(char *str, int len, struct list_head *jobid_list)
750 INIT_LIST_HEAD(jobid_list);
752 rc = cfs_gettok(&src, ' ', &res);
757 rc = nrs_tbf_jobid_list_add(&res, jobid_list);
762 nrs_tbf_jobid_list_free(jobid_list);
766 static void nrs_tbf_jobid_cmd_fini(struct nrs_tbf_cmd *cmd)
768 if (!list_empty(&cmd->tc_jobids))
769 nrs_tbf_jobid_list_free(&cmd->tc_jobids);
770 if (cmd->tc_jobids_str)
771 OBD_FREE(cmd->tc_jobids_str, strlen(cmd->tc_jobids_str) + 1);
774 static int nrs_tbf_jobid_parse(struct nrs_tbf_cmd *cmd, const char *id)
778 OBD_ALLOC(cmd->tc_jobids_str, strlen(id) + 1);
779 if (cmd->tc_jobids_str == NULL)
782 memcpy(cmd->tc_jobids_str, id, strlen(id));
784 /* parse jobid list */
785 rc = nrs_tbf_jobid_list_parse(cmd->tc_jobids_str,
786 strlen(cmd->tc_jobids_str),
789 nrs_tbf_jobid_cmd_fini(cmd);
794 static int nrs_tbf_jobid_rule_init(struct ptlrpc_nrs_policy *policy,
795 struct nrs_tbf_rule *rule,
796 struct nrs_tbf_cmd *start)
800 LASSERT(start->tc_jobids_str);
801 OBD_ALLOC(rule->tr_jobids_str,
802 strlen(start->tc_jobids_str) + 1);
803 if (rule->tr_jobids_str == NULL)
806 memcpy(rule->tr_jobids_str,
807 start->tc_jobids_str,
808 strlen(start->tc_jobids_str));
810 INIT_LIST_HEAD(&rule->tr_jobids);
811 if (!list_empty(&start->tc_jobids)) {
812 rc = nrs_tbf_jobid_list_parse(rule->tr_jobids_str,
813 strlen(rule->tr_jobids_str),
816 CERROR("jobids {%s} illegal\n", rule->tr_jobids_str);
819 OBD_FREE(rule->tr_jobids_str,
820 strlen(start->tc_jobids_str) + 1);
825 nrs_tbf_jobid_rule_dump(struct nrs_tbf_rule *rule, struct seq_file *m)
827 return seq_printf(m, "%s {%s} %llu, ref %d\n", rule->tr_name,
828 rule->tr_jobids_str, rule->tr_rpc_rate,
829 atomic_read(&rule->tr_ref) - 1);
833 nrs_tbf_jobid_rule_match(struct nrs_tbf_rule *rule,
834 struct nrs_tbf_client *cli)
836 return nrs_tbf_jobid_list_match(&rule->tr_jobids, cli->tc_jobid);
839 static void nrs_tbf_jobid_rule_fini(struct nrs_tbf_rule *rule)
841 if (!list_empty(&rule->tr_jobids))
842 nrs_tbf_jobid_list_free(&rule->tr_jobids);
843 LASSERT(rule->tr_jobids_str != NULL);
844 OBD_FREE(rule->tr_jobids_str, strlen(rule->tr_jobids_str) + 1);
847 struct nrs_tbf_ops nrs_tbf_jobid_ops = {
848 .o_name = NRS_TBF_TYPE_JOBID,
849 .o_startup = nrs_tbf_jobid_startup,
850 .o_cli_find = nrs_tbf_jobid_cli_find,
851 .o_cli_findadd = nrs_tbf_jobid_cli_findadd,
852 .o_cli_put = nrs_tbf_jobid_cli_put,
853 .o_cli_init = nrs_tbf_jobid_cli_init,
854 .o_rule_init = nrs_tbf_jobid_rule_init,
855 .o_rule_dump = nrs_tbf_jobid_rule_dump,
856 .o_rule_match = nrs_tbf_jobid_rule_match,
857 .o_rule_fini = nrs_tbf_jobid_rule_fini,
861 * libcfs_hash operations for nrs_tbf_net::cn_cli_hash
863 * This uses ptlrpc_request::rq_peer.nid as its key, in order to hash
864 * nrs_tbf_client objects.
866 #define NRS_TBF_NID_BKT_BITS 8
867 #define NRS_TBF_NID_BITS 16
869 static unsigned nrs_tbf_nid_hop_hash(cfs_hash_t *hs, const void *key,
872 return cfs_hash_djb2_hash(key, sizeof(lnet_nid_t), mask);
875 static int nrs_tbf_nid_hop_keycmp(const void *key, struct hlist_node *hnode)
877 lnet_nid_t *nid = (lnet_nid_t *)key;
878 struct nrs_tbf_client *cli = hlist_entry(hnode,
879 struct nrs_tbf_client,
882 return *nid == cli->tc_nid;
885 static void *nrs_tbf_nid_hop_key(struct hlist_node *hnode)
887 struct nrs_tbf_client *cli = hlist_entry(hnode,
888 struct nrs_tbf_client,
894 static void *nrs_tbf_nid_hop_object(struct hlist_node *hnode)
896 return hlist_entry(hnode, struct nrs_tbf_client, tc_hnode);
899 static void nrs_tbf_nid_hop_get(cfs_hash_t *hs, struct hlist_node *hnode)
901 struct nrs_tbf_client *cli = hlist_entry(hnode,
902 struct nrs_tbf_client,
905 atomic_inc(&cli->tc_ref);
908 static void nrs_tbf_nid_hop_put(cfs_hash_t *hs, struct hlist_node *hnode)
910 struct nrs_tbf_client *cli = hlist_entry(hnode,
911 struct nrs_tbf_client,
914 atomic_dec(&cli->tc_ref);
917 static void nrs_tbf_nid_hop_exit(cfs_hash_t *hs, struct hlist_node *hnode)
919 struct nrs_tbf_client *cli = hlist_entry(hnode,
920 struct nrs_tbf_client,
923 LASSERTF(atomic_read(&cli->tc_ref) == 0,
924 "Busy TBF object from client with NID %s, with %d refs\n",
925 libcfs_nid2str(cli->tc_nid), atomic_read(&cli->tc_ref));
927 nrs_tbf_cli_fini(cli);
930 static cfs_hash_ops_t nrs_tbf_nid_hash_ops = {
931 .hs_hash = nrs_tbf_nid_hop_hash,
932 .hs_keycmp = nrs_tbf_nid_hop_keycmp,
933 .hs_key = nrs_tbf_nid_hop_key,
934 .hs_object = nrs_tbf_nid_hop_object,
935 .hs_get = nrs_tbf_nid_hop_get,
936 .hs_put = nrs_tbf_nid_hop_put,
937 .hs_put_locked = nrs_tbf_nid_hop_put,
938 .hs_exit = nrs_tbf_nid_hop_exit,
941 static struct nrs_tbf_client *
942 nrs_tbf_nid_cli_find(struct nrs_tbf_head *head,
943 struct ptlrpc_request *req)
945 return cfs_hash_lookup(head->th_cli_hash, &req->rq_peer.nid);
948 static struct nrs_tbf_client *
949 nrs_tbf_nid_cli_findadd(struct nrs_tbf_head *head,
950 struct nrs_tbf_client *cli)
952 return cfs_hash_findadd_unique(head->th_cli_hash, &cli->tc_nid,
957 nrs_tbf_nid_cli_put(struct nrs_tbf_head *head,
958 struct nrs_tbf_client *cli)
960 cfs_hash_put(head->th_cli_hash, &cli->tc_hnode);
964 nrs_tbf_nid_startup(struct ptlrpc_nrs_policy *policy,
965 struct nrs_tbf_head *head)
967 struct nrs_tbf_cmd start;
970 head->th_cli_hash = cfs_hash_create("nrs_tbf_hash",
973 NRS_TBF_NID_BKT_BITS, 0,
976 &nrs_tbf_nid_hash_ops,
977 CFS_HASH_RW_BKTLOCK);
978 if (head->th_cli_hash == NULL)
981 memset(&start, 0, sizeof(start));
982 start.tc_nids_str = "*";
984 start.tc_rpc_rate = tbf_rate;
985 start.tc_rule_flags = NTRS_DEFAULT;
986 start.tc_name = NRS_TBF_DEFAULT_RULE;
987 INIT_LIST_HEAD(&start.tc_nids);
988 rc = nrs_tbf_rule_start(policy, head, &start);
994 nrs_tbf_nid_cli_init(struct nrs_tbf_client *cli,
995 struct ptlrpc_request *req)
997 cli->tc_nid = req->rq_peer.nid;
1000 static int nrs_tbf_nid_rule_init(struct ptlrpc_nrs_policy *policy,
1001 struct nrs_tbf_rule *rule,
1002 struct nrs_tbf_cmd *start)
1004 LASSERT(start->tc_nids_str);
1005 OBD_ALLOC(rule->tr_nids_str,
1006 strlen(start->tc_nids_str) + 1);
1007 if (rule->tr_nids_str == NULL)
1010 memcpy(rule->tr_nids_str,
1012 strlen(start->tc_nids_str));
1014 INIT_LIST_HEAD(&rule->tr_nids);
1015 if (!list_empty(&start->tc_nids)) {
1016 if (cfs_parse_nidlist(rule->tr_nids_str,
1017 strlen(rule->tr_nids_str),
1018 &rule->tr_nids) <= 0) {
1019 CERROR("nids {%s} illegal\n",
1021 OBD_FREE(rule->tr_nids_str,
1022 strlen(start->tc_nids_str) + 1);
1030 nrs_tbf_nid_rule_dump(struct nrs_tbf_rule *rule, struct seq_file *m)
1032 return seq_printf(m, "%s {%s} %llu, ref %d\n", rule->tr_name,
1033 rule->tr_nids_str, rule->tr_rpc_rate,
1034 atomic_read(&rule->tr_ref) - 1);
1038 nrs_tbf_nid_rule_match(struct nrs_tbf_rule *rule,
1039 struct nrs_tbf_client *cli)
1041 return cfs_match_nid(cli->tc_nid, &rule->tr_nids);
1044 static void nrs_tbf_nid_rule_fini(struct nrs_tbf_rule *rule)
1046 if (!list_empty(&rule->tr_nids))
1047 cfs_free_nidlist(&rule->tr_nids);
1048 LASSERT(rule->tr_nids_str != NULL);
1049 OBD_FREE(rule->tr_nids_str, strlen(rule->tr_nids_str) + 1);
1052 static void nrs_tbf_nid_cmd_fini(struct nrs_tbf_cmd *cmd)
1054 if (!list_empty(&cmd->tc_nids))
1055 cfs_free_nidlist(&cmd->tc_nids);
1056 if (cmd->tc_nids_str)
1057 OBD_FREE(cmd->tc_nids_str, strlen(cmd->tc_nids_str) + 1);
1060 static int nrs_tbf_nid_parse(struct nrs_tbf_cmd *cmd, const char *id)
1062 OBD_ALLOC(cmd->tc_nids_str, strlen(id) + 1);
1063 if (cmd->tc_nids_str == NULL)
1066 memcpy(cmd->tc_nids_str, id, strlen(id));
1068 /* parse NID list */
1069 if (cfs_parse_nidlist(cmd->tc_nids_str,
1070 strlen(cmd->tc_nids_str),
1071 &cmd->tc_nids) <= 0) {
1072 nrs_tbf_nid_cmd_fini(cmd);
1079 struct nrs_tbf_ops nrs_tbf_nid_ops = {
1080 .o_name = NRS_TBF_TYPE_NID,
1081 .o_startup = nrs_tbf_nid_startup,
1082 .o_cli_find = nrs_tbf_nid_cli_find,
1083 .o_cli_findadd = nrs_tbf_nid_cli_findadd,
1084 .o_cli_put = nrs_tbf_nid_cli_put,
1085 .o_cli_init = nrs_tbf_nid_cli_init,
1086 .o_rule_init = nrs_tbf_nid_rule_init,
1087 .o_rule_dump = nrs_tbf_nid_rule_dump,
1088 .o_rule_match = nrs_tbf_nid_rule_match,
1089 .o_rule_fini = nrs_tbf_nid_rule_fini,
1093 * Is called before the policy transitions into
1094 * ptlrpc_nrs_pol_state::NRS_POL_STATE_STARTED; allocates and initializes a
1095 * policy-specific private data structure.
1097 * \param[in] policy The policy to start
1099 * \retval -ENOMEM OOM error
1102 * \see nrs_policy_register()
1103 * \see nrs_policy_ctl()
1105 static int nrs_tbf_start(struct ptlrpc_nrs_policy *policy, char *arg)
1107 struct nrs_tbf_head *head;
1108 struct nrs_tbf_ops *ops;
1112 if (arg == NULL || strlen(arg) > NRS_TBF_TYPE_MAX_LEN)
1113 GOTO(out, rc = -EINVAL);
1115 if (strcmp(arg, NRS_TBF_TYPE_NID) == 0) {
1116 ops = &nrs_tbf_nid_ops;
1117 type = NRS_TBF_FLAG_NID;
1118 } else if (strcmp(arg, NRS_TBF_TYPE_JOBID) == 0) {
1119 ops = &nrs_tbf_jobid_ops;
1120 type = NRS_TBF_FLAG_JOBID;
1122 GOTO(out, rc = -ENOTSUPP);
1124 OBD_CPT_ALLOC_PTR(head, nrs_pol2cptab(policy), nrs_pol2cptid(policy));
1126 GOTO(out, rc = -ENOMEM);
1128 memcpy(head->th_type, arg, strlen(arg));
1129 head->th_type[strlen(arg)] = '\0';
1131 head->th_type_flag = type;
1133 head->th_binheap = cfs_binheap_create(&nrs_tbf_heap_ops,
1134 CBH_FLAG_ATOMIC_GROW, 4096, NULL,
1135 nrs_pol2cptab(policy),
1136 nrs_pol2cptid(policy));
1137 if (head->th_binheap == NULL)
1138 GOTO(out_free_head, rc = -ENOMEM);
1140 atomic_set(&head->th_rule_sequence, 0);
1141 spin_lock_init(&head->th_rule_lock);
1142 INIT_LIST_HEAD(&head->th_list);
1143 hrtimer_init(&head->th_timer, CLOCK_MONOTONIC, HRTIMER_MODE_ABS);
1144 head->th_timer.function = nrs_tbf_timer_cb;
1145 rc = head->th_ops->o_startup(policy, head);
1147 GOTO(out_free_heap, rc);
1149 policy->pol_private = head;
1152 cfs_binheap_destroy(head->th_binheap);
1160 * Is called before the policy transitions into
1161 * ptlrpc_nrs_pol_state::NRS_POL_STATE_STOPPED; deallocates the policy-specific
1162 * private data structure.
1164 * \param[in] policy The policy to stop
1166 * \see nrs_policy_stop0()
1168 static void nrs_tbf_stop(struct ptlrpc_nrs_policy *policy)
1170 struct nrs_tbf_head *head = policy->pol_private;
1171 struct ptlrpc_nrs *nrs = policy->pol_nrs;
1172 struct nrs_tbf_rule *rule, *n;
1174 LASSERT(head != NULL);
1175 LASSERT(head->th_cli_hash != NULL);
1176 hrtimer_cancel(&head->th_timer);
1177 /* Should cleanup hash first before free rules */
1178 cfs_hash_putref(head->th_cli_hash);
1179 list_for_each_entry_safe(rule, n, &head->th_list, tr_linkage) {
1180 list_del_init(&rule->tr_linkage);
1181 nrs_tbf_rule_put(rule);
1183 LASSERT(list_empty(&head->th_list));
1184 LASSERT(head->th_binheap != NULL);
1185 LASSERT(cfs_binheap_is_empty(head->th_binheap));
1186 cfs_binheap_destroy(head->th_binheap);
1188 spin_lock(&nrs->nrs_lock);
1189 nrs->nrs_throttling = 0;
1190 spin_unlock(&nrs->nrs_lock);
1191 wake_up(&policy->pol_nrs->nrs_svcpt->scp_waitq);
1195 * Performs a policy-specific ctl function on TBF policy instances; similar
1198 * \param[in] policy the policy instance
1199 * \param[in] opc the opcode
1200 * \param[in,out] arg used for passing parameters and information
1202 * \pre assert_spin_locked(&policy->pol_nrs->->nrs_lock)
1203 * \post assert_spin_locked(&policy->pol_nrs->->nrs_lock)
1205 * \retval 0 operation carried out successfully
1208 int nrs_tbf_ctl(struct ptlrpc_nrs_policy *policy, enum ptlrpc_nrs_ctl opc,
1214 assert_spin_locked(&policy->pol_nrs->nrs_lock);
1216 switch ((enum nrs_ctl_tbf)opc) {
1221 * Read RPC rate size of a policy instance.
1223 case NRS_CTL_TBF_RD_RULE: {
1224 struct nrs_tbf_head *head = policy->pol_private;
1225 struct seq_file *m = (struct seq_file *) arg;
1226 struct ptlrpc_service_part *svcpt;
1228 svcpt = policy->pol_nrs->nrs_svcpt;
1229 seq_printf(m, "CPT %d:\n", svcpt->scp_cpt);
1231 rc = nrs_tbf_rule_dump_all(head, m);
1236 * Write RPC rate of a policy instance.
1238 case NRS_CTL_TBF_WR_RULE: {
1239 struct nrs_tbf_head *head = policy->pol_private;
1240 struct nrs_tbf_cmd *cmd;
1242 cmd = (struct nrs_tbf_cmd *)arg;
1243 rc = nrs_tbf_command(policy,
1254 * Is called for obtaining a TBF policy resource.
1256 * \param[in] policy The policy on which the request is being asked for
1257 * \param[in] nrq The request for which resources are being taken
1258 * \param[in] parent Parent resource, unused in this policy
1259 * \param[out] resp Resources references are placed in this array
1260 * \param[in] moving_req Signifies limited caller context; unused in this
1264 * \see nrs_resource_get_safe()
1266 static int nrs_tbf_res_get(struct ptlrpc_nrs_policy *policy,
1267 struct ptlrpc_nrs_request *nrq,
1268 const struct ptlrpc_nrs_resource *parent,
1269 struct ptlrpc_nrs_resource **resp,
1272 struct nrs_tbf_head *head;
1273 struct nrs_tbf_client *cli;
1274 struct nrs_tbf_client *tmp;
1275 struct ptlrpc_request *req;
1277 if (parent == NULL) {
1278 *resp = &((struct nrs_tbf_head *)policy->pol_private)->th_res;
1282 head = container_of(parent, struct nrs_tbf_head, th_res);
1283 req = container_of(nrq, struct ptlrpc_request, rq_nrq);
1284 cli = head->th_ops->o_cli_find(head, req);
1286 spin_lock(&policy->pol_nrs->nrs_svcpt->scp_req_lock);
1287 LASSERT(cli->tc_rule);
1288 if (cli->tc_rule_sequence !=
1289 atomic_read(&head->th_rule_sequence) ||
1290 cli->tc_rule->tr_flags & NTRS_STOPPING) {
1291 struct nrs_tbf_rule *rule;
1293 rule = nrs_tbf_rule_match(head, cli);
1294 if (rule != cli->tc_rule)
1295 nrs_tbf_cli_reset(head, rule, cli);
1297 nrs_tbf_rule_put(rule);
1298 } else if (cli->tc_rule_generation !=
1299 cli->tc_rule->tr_generation) {
1300 nrs_tbf_cli_reset_value(head, cli);
1302 spin_unlock(&policy->pol_nrs->nrs_svcpt->scp_req_lock);
1306 OBD_CPT_ALLOC_GFP(cli, nrs_pol2cptab(policy), nrs_pol2cptid(policy),
1307 sizeof(*cli), moving_req ? GFP_ATOMIC : __GFP_IO);
1310 nrs_tbf_cli_init(head, cli, req);
1311 tmp = head->th_ops->o_cli_findadd(head, cli);
1313 atomic_dec(&cli->tc_ref);
1314 nrs_tbf_cli_fini(cli);
1318 *resp = &cli->tc_res;
1324 * Called when releasing references to the resource hierachy obtained for a
1325 * request for scheduling using the TBF policy.
1327 * \param[in] policy the policy the resource belongs to
1328 * \param[in] res the resource to be released
1330 static void nrs_tbf_res_put(struct ptlrpc_nrs_policy *policy,
1331 const struct ptlrpc_nrs_resource *res)
1333 struct nrs_tbf_head *head;
1334 struct nrs_tbf_client *cli;
1337 * Do nothing for freeing parent, nrs_tbf_net resources
1339 if (res->res_parent == NULL)
1342 cli = container_of(res, struct nrs_tbf_client, tc_res);
1343 head = container_of(res->res_parent, struct nrs_tbf_head, th_res);
1345 head->th_ops->o_cli_put(head, cli);
1349 * Called when getting a request from the TBF policy for handling, or just
1350 * peeking; removes the request from the policy when it is to be handled.
1352 * \param[in] policy The policy
1353 * \param[in] peek When set, signifies that we just want to examine the
1354 * request, and not handle it, so the request is not removed
1356 * \param[in] force Force the policy to return a request; unused in this
1359 * \retval The request to be handled; this is the next request in the TBF
1362 * \see ptlrpc_nrs_req_get_nolock()
1363 * \see nrs_request_get()
1366 struct ptlrpc_nrs_request *nrs_tbf_req_get(struct ptlrpc_nrs_policy *policy,
1367 bool peek, bool force)
1369 struct nrs_tbf_head *head = policy->pol_private;
1370 struct ptlrpc_nrs_request *nrq = NULL;
1371 struct nrs_tbf_client *cli;
1372 cfs_binheap_node_t *node;
1374 assert_spin_locked(&policy->pol_nrs->nrs_svcpt->scp_req_lock);
1376 if (!peek && policy->pol_nrs->nrs_throttling)
1379 node = cfs_binheap_root(head->th_binheap);
1380 if (unlikely(node == NULL))
1383 cli = container_of(node, struct nrs_tbf_client, tc_node);
1384 LASSERT(cli->tc_in_heap);
1386 nrq = list_entry(cli->tc_list.next,
1387 struct ptlrpc_nrs_request,
1390 __u64 now = ktime_to_ns(ktime_get());
1395 deadline = cli->tc_check_time +
1397 LASSERT(now >= cli->tc_check_time);
1398 passed = now - cli->tc_check_time;
1399 ntoken = (passed * cli->tc_rpc_rate) / NSEC_PER_SEC;
1400 ntoken += cli->tc_ntoken;
1401 if (ntoken > cli->tc_depth)
1402 ntoken = cli->tc_depth;
1404 struct ptlrpc_request *req;
1405 nrq = list_entry(cli->tc_list.next,
1406 struct ptlrpc_nrs_request,
1408 req = container_of(nrq,
1409 struct ptlrpc_request,
1412 cli->tc_ntoken = ntoken;
1413 cli->tc_check_time = now;
1414 list_del_init(&nrq->nr_u.tbf.tr_list);
1415 if (list_empty(&cli->tc_list)) {
1416 cfs_binheap_remove(head->th_binheap,
1418 cli->tc_in_heap = false;
1420 cfs_binheap_relocate(head->th_binheap,
1424 "NRS start %s request from %s, "
1426 policy->pol_desc->pd_name,
1427 libcfs_id2str(req->rq_peer),
1428 nrq->nr_u.tbf.tr_sequence);
1432 spin_lock(&policy->pol_nrs->nrs_lock);
1433 policy->pol_nrs->nrs_throttling = 1;
1434 spin_unlock(&policy->pol_nrs->nrs_lock);
1435 head->th_deadline = deadline;
1436 time = ktime_set(0, 0);
1437 time = ktime_add_ns(time, deadline);
1438 hrtimer_start(&head->th_timer, time, HRTIMER_MODE_ABS);
1446 * Adds request \a nrq to \a policy's list of queued requests
1448 * \param[in] policy The policy
1449 * \param[in] nrq The request to add
1451 * \retval 0 success; nrs_request_enqueue() assumes this function will always
1454 static int nrs_tbf_req_add(struct ptlrpc_nrs_policy *policy,
1455 struct ptlrpc_nrs_request *nrq)
1457 struct nrs_tbf_head *head;
1458 struct nrs_tbf_client *cli;
1461 assert_spin_locked(&policy->pol_nrs->nrs_svcpt->scp_req_lock);
1463 cli = container_of(nrs_request_resource(nrq),
1464 struct nrs_tbf_client, tc_res);
1465 head = container_of(nrs_request_resource(nrq)->res_parent,
1466 struct nrs_tbf_head, th_res);
1467 if (list_empty(&cli->tc_list)) {
1468 LASSERT(!cli->tc_in_heap);
1469 rc = cfs_binheap_insert(head->th_binheap, &cli->tc_node);
1471 cli->tc_in_heap = true;
1472 nrq->nr_u.tbf.tr_sequence = head->th_sequence++;
1473 list_add_tail(&nrq->nr_u.tbf.tr_list,
1475 if (policy->pol_nrs->nrs_throttling) {
1476 __u64 deadline = cli->tc_check_time +
1478 if ((head->th_deadline > deadline) &&
1479 (hrtimer_try_to_cancel(&head->th_timer)
1482 head->th_deadline = deadline;
1483 time = ktime_set(0, 0);
1484 time = ktime_add_ns(time, deadline);
1485 hrtimer_start(&head->th_timer, time,
1491 LASSERT(cli->tc_in_heap);
1492 nrq->nr_u.tbf.tr_sequence = head->th_sequence++;
1493 list_add_tail(&nrq->nr_u.tbf.tr_list,
1500 * Removes request \a nrq from \a policy's list of queued requests.
1502 * \param[in] policy The policy
1503 * \param[in] nrq The request to remove
1505 static void nrs_tbf_req_del(struct ptlrpc_nrs_policy *policy,
1506 struct ptlrpc_nrs_request *nrq)
1508 struct nrs_tbf_head *head;
1509 struct nrs_tbf_client *cli;
1511 assert_spin_locked(&policy->pol_nrs->nrs_svcpt->scp_req_lock);
1513 cli = container_of(nrs_request_resource(nrq),
1514 struct nrs_tbf_client, tc_res);
1515 head = container_of(nrs_request_resource(nrq)->res_parent,
1516 struct nrs_tbf_head, th_res);
1518 LASSERT(!list_empty(&nrq->nr_u.tbf.tr_list));
1519 list_del_init(&nrq->nr_u.tbf.tr_list);
1520 if (list_empty(&cli->tc_list)) {
1521 cfs_binheap_remove(head->th_binheap,
1523 cli->tc_in_heap = false;
1525 cfs_binheap_relocate(head->th_binheap,
1531 * Prints a debug statement right before the request \a nrq stops being
1534 * \param[in] policy The policy handling the request
1535 * \param[in] nrq The request being handled
1537 * \see ptlrpc_server_finish_request()
1538 * \see ptlrpc_nrs_req_stop_nolock()
1540 static void nrs_tbf_req_stop(struct ptlrpc_nrs_policy *policy,
1541 struct ptlrpc_nrs_request *nrq)
1543 struct ptlrpc_request *req = container_of(nrq, struct ptlrpc_request,
1546 assert_spin_locked(&policy->pol_nrs->nrs_svcpt->scp_req_lock);
1548 CDEBUG(D_RPCTRACE, "NRS stop %s request from %s, seq: "LPU64"\n",
1549 policy->pol_desc->pd_name, libcfs_id2str(req->rq_peer),
1550 nrq->nr_u.tbf.tr_sequence);
1560 * The maximum RPC rate.
1562 #define LPROCFS_NRS_RATE_MAX 65535
1565 ptlrpc_lprocfs_nrs_tbf_rule_seq_show(struct seq_file *m, void *data)
1567 struct ptlrpc_service *svc = m->private;
1570 seq_printf(m, "regular_requests:\n");
1572 * Perform two separate calls to this as only one of the NRS heads'
1573 * policies may be in the ptlrpc_nrs_pol_state::NRS_POL_STATE_STARTED or
1574 * ptlrpc_nrs_pol_state::NRS_POL_STATE_STOPPING state.
1576 rc = ptlrpc_nrs_policy_control(svc, PTLRPC_NRS_QUEUE_REG,
1578 NRS_CTL_TBF_RD_RULE,
1582 * -ENOSPC means buf in the parameter m is overflow, return 0
1583 * here to let upper layer function seq_read alloc a larger
1584 * memory area and do this process again.
1586 } else if (rc == -ENOSPC) {
1590 * Ignore -ENODEV as the regular NRS head's policy may be in the
1591 * ptlrpc_nrs_pol_state::NRS_POL_STATE_STOPPED state.
1593 } else if (rc != -ENODEV) {
1597 if (!nrs_svc_has_hp(svc))
1600 seq_printf(m, "high_priority_requests:\n");
1601 rc = ptlrpc_nrs_policy_control(svc, PTLRPC_NRS_QUEUE_HP,
1603 NRS_CTL_TBF_RD_RULE,
1607 * -ENOSPC means buf in the parameter m is overflow, return 0
1608 * here to let upper layer function seq_read alloc a larger
1609 * memory area and do this process again.
1611 } else if (rc == -ENOSPC) {
1620 static int nrs_tbf_id_parse(struct nrs_tbf_cmd *cmd, char **val)
1625 token = strsep(val, "}");
1627 GOTO(out, rc = -EINVAL);
1629 if (strlen(token) <= 1 ||
1631 GOTO(out, rc = -EINVAL);
1635 /* Should be followed by ' ' or nothing */
1636 if ((*val)[0] == '\0')
1638 else if ((*val)[0] == ' ')
1641 GOTO(out, rc = -EINVAL);
1643 rc = nrs_tbf_jobid_parse(cmd, token);
1645 cmd->tc_valid_types |= NRS_TBF_FLAG_JOBID;
1647 rc = nrs_tbf_nid_parse(cmd, token);
1649 cmd->tc_valid_types |= NRS_TBF_FLAG_NID;
1651 if (!cmd->tc_valid_types)
1660 static void nrs_tbf_cmd_fini(struct nrs_tbf_cmd *cmd)
1662 if (cmd->tc_valid_types & NRS_TBF_FLAG_JOBID)
1663 nrs_tbf_jobid_cmd_fini(cmd);
1664 if (cmd->tc_valid_types & NRS_TBF_FLAG_NID)
1665 nrs_tbf_nid_cmd_fini(cmd);
1668 static struct nrs_tbf_cmd *
1669 nrs_tbf_parse_cmd(char *buffer, unsigned long count)
1671 static struct nrs_tbf_cmd *cmd;
1679 GOTO(out, rc = -ENOMEM);
1682 token = strsep(&val, " ");
1683 if (val == NULL || strlen(val) == 0)
1684 GOTO(out_free_cmd, rc = -EINVAL);
1686 /* Type of the command */
1687 if (strcmp(token, "start") == 0)
1688 cmd->tc_cmd = NRS_CTL_TBF_START_RULE;
1689 else if (strcmp(token, "stop") == 0)
1690 cmd->tc_cmd = NRS_CTL_TBF_STOP_RULE;
1691 else if (strcmp(token, "change") == 0)
1692 cmd->tc_cmd = NRS_CTL_TBF_CHANGE_RATE;
1694 GOTO(out_free_cmd, rc = -EINVAL);
1696 /* Name of the rule */
1697 token = strsep(&val, " ");
1700 * Stop comand only need name argument,
1701 * But other commands need ID or rate argument.
1703 if (cmd->tc_cmd != NRS_CTL_TBF_STOP_RULE)
1704 GOTO(out_free_cmd, rc = -EINVAL);
1707 for (i = 0; i < strlen(token); i++) {
1708 if ((!isalnum(token[i])) &&
1710 GOTO(out_free_cmd, rc = -EINVAL);
1712 cmd->tc_name = token;
1714 if (cmd->tc_cmd == NRS_CTL_TBF_START_RULE) {
1717 rc = nrs_tbf_id_parse(cmd, &val);
1719 GOTO(out_free_cmd, rc);
1723 if (cmd->tc_cmd == NRS_CTL_TBF_STOP_RULE ||
1724 strlen(val) == 0 || !isdigit(val[0]))
1725 GOTO(out_free_nid, rc = -EINVAL);
1727 cmd->tc_rpc_rate = simple_strtoull(val, NULL, 10);
1728 if (cmd->tc_rpc_rate <= 0 ||
1729 cmd->tc_rpc_rate >= LPROCFS_NRS_RATE_MAX)
1730 GOTO(out_free_nid, rc = -EINVAL);
1732 if (cmd->tc_cmd == NRS_CTL_TBF_CHANGE_RATE)
1733 GOTO(out_free_nid, rc = -EINVAL);
1734 /* No RPC rate given */
1735 cmd->tc_rpc_rate = tbf_rate;
1739 nrs_tbf_cmd_fini(cmd);
1748 extern struct nrs_core nrs_core;
1749 #define LPROCFS_WR_NRS_TBF_MAX_CMD (4096)
1751 ptlrpc_lprocfs_nrs_tbf_rule_seq_write(struct file *file, const char *buffer,
1752 size_t count, loff_t *off)
1754 struct seq_file *m = file->private_data;
1755 struct ptlrpc_service *svc = m->private;
1759 static struct nrs_tbf_cmd *cmd;
1760 enum ptlrpc_nrs_queue_type queue = PTLRPC_NRS_QUEUE_BOTH;
1761 unsigned long length;
1764 OBD_ALLOC(kernbuf, LPROCFS_WR_NRS_TBF_MAX_CMD);
1765 if (kernbuf == NULL)
1766 GOTO(out, rc = -ENOMEM);
1768 if (count > LPROCFS_WR_NRS_TBF_MAX_CMD - 1)
1769 GOTO(out_free_kernbuff, rc = -EINVAL);
1771 if (copy_from_user(kernbuf, buffer, count))
1772 GOTO(out_free_kernbuff, rc = -EFAULT);
1775 token = strsep(&val, " ");
1777 GOTO(out_free_kernbuff, rc = -EINVAL);
1779 if (strcmp(token, "reg") == 0) {
1780 queue = PTLRPC_NRS_QUEUE_REG;
1781 } else if (strcmp(token, "hp") == 0) {
1782 queue = PTLRPC_NRS_QUEUE_HP;
1784 kernbuf[strlen(token)] = ' ';
1787 length = strlen(val);
1790 GOTO(out_free_kernbuff, rc = -EINVAL);
1792 if (queue == PTLRPC_NRS_QUEUE_HP && !nrs_svc_has_hp(svc))
1793 GOTO(out_free_kernbuff, rc = -ENODEV);
1794 else if (queue == PTLRPC_NRS_QUEUE_BOTH && !nrs_svc_has_hp(svc))
1795 queue = PTLRPC_NRS_QUEUE_REG;
1797 cmd = nrs_tbf_parse_cmd(val, length);
1799 GOTO(out_free_kernbuff, rc = PTR_ERR(cmd));
1802 * Serialize NRS core lprocfs operations with policy registration/
1805 mutex_lock(&nrs_core.nrs_mutex);
1806 rc = ptlrpc_nrs_policy_control(svc, queue,
1808 NRS_CTL_TBF_WR_RULE,
1810 mutex_unlock(&nrs_core.nrs_mutex);
1812 nrs_tbf_cmd_fini(cmd);
1815 OBD_FREE(kernbuf, LPROCFS_WR_NRS_TBF_MAX_CMD);
1817 return rc ? rc : count;
1819 LPROC_SEQ_FOPS(ptlrpc_lprocfs_nrs_tbf_rule);
1822 * Initializes a TBF policy's lprocfs interface for service \a svc
1824 * \param[in] svc the service
1827 * \retval != 0 error
1829 int nrs_tbf_lprocfs_init(struct ptlrpc_service *svc)
1831 struct lprocfs_seq_vars nrs_tbf_lprocfs_vars[] = {
1832 { .name = "nrs_tbf_rule",
1833 .fops = &ptlrpc_lprocfs_nrs_tbf_rule_fops,
1838 if (svc->srv_procroot == NULL)
1841 return lprocfs_seq_add_vars(svc->srv_procroot, nrs_tbf_lprocfs_vars,
1846 * Cleans up a TBF policy's lprocfs interface for service \a svc
1848 * \param[in] svc the service
1850 void nrs_tbf_lprocfs_fini(struct ptlrpc_service *svc)
1852 if (svc->srv_procroot == NULL)
1855 lprocfs_remove_proc_entry("nrs_tbf_rule", svc->srv_procroot);
1858 #endif /* LPROCFS */
1861 * TBF policy operations
1863 static const struct ptlrpc_nrs_pol_ops nrs_tbf_ops = {
1864 .op_policy_start = nrs_tbf_start,
1865 .op_policy_stop = nrs_tbf_stop,
1866 .op_policy_ctl = nrs_tbf_ctl,
1867 .op_res_get = nrs_tbf_res_get,
1868 .op_res_put = nrs_tbf_res_put,
1869 .op_req_get = nrs_tbf_req_get,
1870 .op_req_enqueue = nrs_tbf_req_add,
1871 .op_req_dequeue = nrs_tbf_req_del,
1872 .op_req_stop = nrs_tbf_req_stop,
1874 .op_lprocfs_init = nrs_tbf_lprocfs_init,
1875 .op_lprocfs_fini = nrs_tbf_lprocfs_fini,
1880 * TBF policy configuration
1882 struct ptlrpc_nrs_pol_conf nrs_conf_tbf = {
1883 .nc_name = NRS_POL_NAME_TBF,
1884 .nc_ops = &nrs_tbf_ops,
1885 .nc_compat = nrs_policy_compat_all,
1892 #endif /* HAVE_SERVER_SUPPORT */