Commit 357c45ad authored by David Ward's avatar David Ward Committed by Stephen Hemminger

tc: gred: Adopt the term VQ in the command syntax and output

In the GRED kernel source code, both of the terms "drop parameters"
(DP) and "virtual queue" (VQ) are used to refer to the same thing.
Each "DP" is better understood as a "set of drop parameters", since
it has values for limit, min, max, avpkt, etc. This terminology can
result in confusion when creating a GRED qdisc having multiple DPs.
Netlink attributes and struct members with the DP name seem to have
been left intact for compatibility, while the term VQ was otherwise
adopted in the code, which is more intuitive.

Use the VQ term in the tc command syntax and output (but maintain
compatibility with the old syntax).

Rewrite the usage text to be concise and similar to other qdiscs.
Signed-off-by: default avatarDavid Ward <david.ward@ll.mit.edu>
parent eb6d7d6a
...@@ -37,14 +37,11 @@ ...@@ -37,14 +37,11 @@
static void explain(void) static void explain(void)
{ {
fprintf(stderr, "Usage: ... gred DP drop-probability limit BYTES " fprintf(stderr, "Usage: tc qdisc { add | replace | change } ... gred setup vqs NUMBER\n");
"min BYTES max BYTES\n"); fprintf(stderr, " default DEFAULT_VQ [ grio ]\n");
fprintf(stderr, " avpkt BYTES burst PACKETS probability PROBABILITY " fprintf(stderr, " tc qdisc change ... gred vq VQ [ prio VALUE ] limit BYTES\n");
"bandwidth KBPS\n"); fprintf(stderr, " min BYTES max BYTES avpkt BYTES [ burst PACKETS ]\n");
fprintf(stderr, " [prio value]\n"); fprintf(stderr, " [ probability PROBABILITY ] [ bandwidth KBPS ]\n");
fprintf(stderr," OR ...\n");
fprintf(stderr," gred setup DPs <num of DPs> default <default DP> "
"[grio]\n");
} }
static int init_gred(struct qdisc_util *qu, int argc, char **argv, static int init_gred(struct qdisc_util *qu, int argc, char **argv,
...@@ -58,20 +55,21 @@ static int init_gred(struct qdisc_util *qu, int argc, char **argv, ...@@ -58,20 +55,21 @@ static int init_gred(struct qdisc_util *qu, int argc, char **argv,
while (argc > 0) { while (argc > 0) {
DPRINTF(stderr,"init_gred: invoked with %s\n",*argv); DPRINTF(stderr,"init_gred: invoked with %s\n",*argv);
if (strcmp(*argv, "DPs") == 0) { if (strcmp(*argv, "vqs") == 0 ||
strcmp(*argv, "DPs") == 0) {
NEXT_ARG(); NEXT_ARG();
if (get_unsigned(&opt.DPs, *argv, 10)) { if (get_unsigned(&opt.DPs, *argv, 10)) {
fprintf(stderr, "Illegal \"DPs\"\n"); fprintf(stderr, "Illegal \"vqs\"\n");
return -1; return -1;
} else if (opt.DPs > MAX_DPs) { } else if (opt.DPs > MAX_DPs) {
fprintf(stderr, "GRED: only %u DPs are " fprintf(stderr, "GRED: only %u VQs are "
"currently supported\n", MAX_DPs); "currently supported\n", MAX_DPs);
return -1; return -1;
} }
} else if (strcmp(*argv, "default") == 0) { } else if (strcmp(*argv, "default") == 0) {
if (opt.DPs == 0) { if (opt.DPs == 0) {
fprintf(stderr, "\"default\" must be defined " fprintf(stderr, "\"default\" must be defined "
"after \"DPs\"\n"); "after \"vqs\"\n");
return -1; return -1;
} }
NEXT_ARG(); NEXT_ARG();
...@@ -80,7 +78,7 @@ static int init_gred(struct qdisc_util *qu, int argc, char **argv, ...@@ -80,7 +78,7 @@ static int init_gred(struct qdisc_util *qu, int argc, char **argv,
return -1; return -1;
} else if (opt.def_DP >= opt.DPs) { } else if (opt.def_DP >= opt.DPs) {
fprintf(stderr, "\"default\" must be less than " fprintf(stderr, "\"default\" must be less than "
"\"DPs\"\n"); "\"vqs\"\n");
return -1; return -1;
} }
} else if (strcmp(*argv, "grio") == 0) { } else if (strcmp(*argv, "grio") == 0) {
...@@ -155,13 +153,14 @@ static int gred_parse_opt(struct qdisc_util *qu, int argc, char **argv, struct n ...@@ -155,13 +153,14 @@ static int gred_parse_opt(struct qdisc_util *qu, int argc, char **argv, struct n
return -1; return -1;
} }
ok++; ok++;
} else if (strcmp(*argv, "DP") == 0) { } else if (strcmp(*argv, "vq") == 0 ||
strcmp(*argv, "DP") == 0) {
NEXT_ARG(); NEXT_ARG();
if (get_unsigned(&opt.DP, *argv, 10)) { if (get_unsigned(&opt.DP, *argv, 10)) {
fprintf(stderr, "Illegal \"DP\"\n"); fprintf(stderr, "Illegal \"vq\"\n");
return -1; return -1;
} else if (opt.DP >= MAX_DPs) { } else if (opt.DP >= MAX_DPs) {
fprintf(stderr, "GRED: only %u DPs are " fprintf(stderr, "GRED: only %u VQs are "
"currently supported\n", MAX_DPs); "currently supported\n", MAX_DPs);
return -1; return -1;
} /* need a better error check */ } /* need a better error check */
...@@ -216,7 +215,7 @@ static int gred_parse_opt(struct qdisc_util *qu, int argc, char **argv, struct n ...@@ -216,7 +215,7 @@ static int gred_parse_opt(struct qdisc_util *qu, int argc, char **argv, struct n
} }
if (opt.DP == MAX_DPs || !opt.limit || !opt.qth_min || !opt.qth_max || if (opt.DP == MAX_DPs || !opt.limit || !opt.qth_min || !opt.qth_max ||
!avpkt) { !avpkt) {
fprintf(stderr, "Required parameter (DP, limit, min, max, " fprintf(stderr, "Required parameter (vq, limit, min, max, "
"avpkt) is missing\n"); "avpkt) is missing\n");
return -1; return -1;
} }
...@@ -292,14 +291,14 @@ static int gred_print_opt(struct qdisc_util *qu, FILE *f, struct rtattr *opt) ...@@ -292,14 +291,14 @@ static int gred_print_opt(struct qdisc_util *qu, FILE *f, struct rtattr *opt)
/* Bad hack! should really return a proper message as shown above*/ /* Bad hack! should really return a proper message as shown above*/
fprintf(f, "DPs %u default %u %s", fprintf(f, "vqs %u default %u %s",
sopt->DPs, sopt->DPs,
sopt->def_DP, sopt->def_DP,
sopt->grio ? "grio " : ""); sopt->grio ? "grio " : "");
for (i=0;i<MAX_DPs;i++, qopt++) { for (i=0;i<MAX_DPs;i++, qopt++) {
if (qopt->DP >= MAX_DPs) continue; if (qopt->DP >= MAX_DPs) continue;
fprintf(f, "\n DP %u prio %hhu limit %s min %s max %s ", fprintf(f, "\n vq %u prio %hhu limit %s min %s max %s ",
qopt->DP, qopt->DP,
qopt->prio, qopt->prio,
sprint_size(qopt->limit, b1), sprint_size(qopt->limit, b1),
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment