In PSARC/2006/475, net_getlifflags is introduced to retrieve
the logical interface flags, which is fair enough.

Reading the man page, there are some omissions, and possibly
with the case itself too.

First, neither the man page nor the case enumerate what the
flags are. I suspect that the expectation is people will "know"
that the correct flags are found somewhere else.

One of two files needs to be documented for use with this API:
either <net/if.h> or <inet/ip_if.h>

And having chosen which file is to be documented (and thus an
appropriate commitment level given), the relevant flags need
to be pulled out and given the same treatment.

The choice here is do we publish the IPIF_* names or the IFF_*
names? The former makes the documentation easy, the latter means
we need to explicitly state that it is only possible for the
flags listed to be seen.

On a related note, it is also useful to be able to get the
"other" flags, notably those that are PHYI_* and ILLF_*.
At present my need is only for PHYI_* and thus it seems
logical to construct net_getphyflags() to get just those.
But does that leave the ILLF_* flags out in the cold?
Unless someone can come up with a definitive answer on that,
I'm not comfortable with net_getphyflags() being anything
other than a consolidation private interface.

Darren


Reply via email to