All of lore.kernel.org
 help / color / mirror / Atom feed
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.

  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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.