From: Patrick McHardy <kaber@trash.net>
To: Florian Westphal <fw@strlen.de>
Cc: pablo@netfilter.org, netfilter-devel@vger.kernel.org
Subject: Re: nftables data type names
Date: Sat, 12 Apr 2014 13:03:53 +0200 [thread overview]
Message-ID: <20140412110352.GA15624@macbook.localnet> (raw)
In-Reply-To: <20140412105646.GJ31953@breakpoint.cc>
On Sat, Apr 12, 2014 at 12:56:46PM +0200, Florian Westphal wrote:
> Patrick McHardy <kaber@trash.net> wrote:
> > Before the upcoming release, I'd like to add some more consistency among
> > nftables data type names. We currently have the following types:
> [..]
> > In some cases we're more verbose, in other we're using abrevations.
> > I'd like to decide for either one.
> >
> > The following ones should IMO definitely be changed:
> >
> > - etheraddr => ether_address or mac_address. ether_addr would be more
> > consistent with ethertype.
> >
> > - ethertype => ether_type if ether_addr is used
>
> I like ether_type/ether_addr.
Ok, lets take those.
> > - optionally: *_address => *_addr
>
> We already have 'ip saddr/daddr' etc in nft rules,
> so I'd prefer to use _addr everywhere.
Good point.
> > - arphrd => iftype/interface_type?
>
> I read that as "arphdr"...
Yeah, same here.
> Since its used of iif/oiftype I think interface_type is good choice.
Agreed, will change.
> > If we're deciding for more verbose names (which IMO is fine for types),
> > I'd also change:
> >
> > - arp_op => arp_operation
> > - ifindex => interface_index
> > - nfproto => nf_protocol
>
> I agree iff we go for eg. _address instead of _addr.
> I would prefer _addr, i.e.
Yep.
> > otherwise:
> >
> > - inet_protocol => inet_proto
>
> inet_proto, too.
> Looking at scanner.l we also have l3proto, l4proto, nfproto keywords.
I'll also change those.
> [ I realize that there is not requirement to be consistent with
> datatype names vs. nft rules but I see no reason to differ ]
Yeah, sticking to internal data type names is a bad habit from a usability
perspective IMO. iiftype / arphrd is the best example for this.
> > Basically the should be human readable, not programmer readable, should
> > describe what they actually are (not arphrd) and should be consistent.
>
> Fully agree, more consistency would be good.
Thanks for the feedback, I'll post a patch soon.
next prev parent reply other threads:[~2014-04-12 11:03 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2014-04-12 10:29 nftables data type names Patrick McHardy
2014-04-12 10:56 ` Florian Westphal
2014-04-12 11:03 ` Patrick McHardy [this message]
2014-04-13 10:57 ` Patrick McHardy
2014-04-13 12:37 ` Pablo Neira Ayuso
2014-04-13 14:21 ` Patrick McHardy
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=20140412110352.GA15624@macbook.localnet \
--to=kaber@trash.net \
--cc=fw@strlen.de \
--cc=netfilter-devel@vger.kernel.org \
--cc=pablo@netfilter.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).