netdev.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Phil Sutter <phil@nwl.cc>
To: Jamal Hadi Salim <jhs@mojatatu.com>
Cc: stephen@networkplumber.org, netdev@vger.kernel.org,
	Jamal Hadi Salim <hadi@mojatatu.com>
Subject: Re: [net-next PATCH iproute2 1/1] tc: introduce IFE action
Date: Tue, 8 Mar 2016 14:22:15 +0100	[thread overview]
Message-ID: <20160308132215.GC6517@orbyte.nwl.cc> (raw)
In-Reply-To: <1457440783-8526-1-git-send-email-jhs@emojatatu.com>

On Tue, Mar 08, 2016 at 07:39:43AM -0500, Jamal Hadi Salim wrote:
>  tc/Makefile |   1 +
>  tc/m_ife.c  | 336 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  2 files changed, 337 insertions(+)
>  create mode 100644 tc/m_ife.c

Seems like you forgot to add man/man8/tc-ife.8 before committing. ;)

> +static void ife_explain(void)
> +{
> +	fprintf(stderr,
> +		"Usage:... ife <decode|encode> [dst <DMAC>] [src <SMAC>] [type <TYPE> [CONTROL] [INDEX]\n");

Although there is no written style guide for help texts, I'd suggest
sticking more to how others look like:
- 'decode' and 'encode' are terminals, so lowercase is correct but the
  angled brackets should be curly ones (to emphasize them being
  mandatory).
- Angled brackets for DMAC, SMAC and TYPE are redundant. IMO written in
  all uppercase already points out they are non-terminal, like CONTROL
  and INDEX.
- Missing closing bracket after <TYPE>.
- INDEX alone is not allowed, that should read '[index INDEX]'.

> +		} else if (matches(*argv, "allow") == 0) {

Undocumented feature?

> +		} else if (matches(*argv, "use") == 0) {

Same here?!

> +	if (argc) {
> +		if (matches(*argv, "reclassify") == 0) {
> +			p.action = TC_ACT_RECLASSIFY;
> +			argc--;
> +			argv++;
> +		} else if (matches(*argv, "pipe") == 0) {
> +			p.action = TC_ACT_PIPE;
> +			argc--;
> +			argv++;
> +		} else if (matches(*argv, "drop") == 0 ||
> +			   matches(*argv, "shot") == 0) {
> +			p.action = TC_ACT_SHOT;
> +			argc--;
> +			argv++;
> +		} else if (matches(*argv, "continue") == 0) {
> +			p.action = TC_ACT_UNSPEC;
> +			argc--;
> +			argv++;
> +		} else if (matches(*argv, "pass") == 0) {
> +			p.action = TC_ACT_OK;
> +			argc--;
> +			argv++;
> +		}
> +	}

This should really be made generic at some point. Potentially every
action wants to support his, and tc/m_gact.c does the same.

> +	if (has_optional)
> +		fprintf(f, "\n ");

Is that space after newline intended? Because ...

> +	if (tb[TCA_IFE_METALST]) {
> +		struct rtattr *metalist[IFE_META_MAX + 1];
> +		int len = 0;
> +
> +		parse_rtattr_nested(metalist, IFE_META_MAX,
> +				    tb[TCA_IFE_METALST]);
> +
> +		fprintf(f, "\t Metadata: ");

... this then adds tab after space.

> +		if (metalist[IFE_META_SKBMARK]) {
> +			len = RTA_PAYLOAD(metalist[IFE_META_SKBMARK]);
> +			if (len) {
> +				__u32 *mmark = RTA_DATA(metalist[IFE_META_SKBMARK]);
> +				fprintf(f, "use mark %d ", *mmark);
> +			} else
> +				fprintf(f, "allow mark ");
> +		}
> +
> +		if (metalist[IFE_META_HASHID]) {
> +			len = RTA_PAYLOAD(metalist[IFE_META_HASHID]);
> +			if (len) {
> +				__u32 *mhash = RTA_DATA(metalist[IFE_META_HASHID]);
> +				fprintf(f, "use hash %d ", *mhash);
> +			} else
> +				fprintf(f, "allow hash ");
> +		}
> +
> +		if (metalist[IFE_META_PRIO]) {
> +			len = RTA_PAYLOAD(metalist[IFE_META_PRIO]);
> +			if (len) {
> +				__u32 *mprio = RTA_DATA(metalist[IFE_META_PRIO]);
> +				fprintf(f, "use prio %d ", *mprio);
> +			} else
> +				fprintf(f, "allow prio ");
> +		}

I would always go with "every optional part prints it's leading space".
Doing it the other way round has led to some confusion in ip/ already.

> +
> +	}
> +
> +	fprintf(f, "\n ");

Here again, whitespace after newline? Also, in case of TCA_IFE_METALST
not being part of the message, this leads to double linefeed at the end.
Not sure if intended or not.

Cheers, Phil

      reply	other threads:[~2016-03-08 13:22 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2016-03-08 12:39 [net-next PATCH iproute2 1/1] tc: introduce IFE action Jamal Hadi Salim
2016-03-08 13:22 ` Phil Sutter [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20160308132215.GC6517@orbyte.nwl.cc \
    --to=phil@nwl.cc \
    --cc=hadi@mojatatu.com \
    --cc=jhs@mojatatu.com \
    --cc=netdev@vger.kernel.org \
    --cc=stephen@networkplumber.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).