Provide nl_object_dump_buf() to easily dump to buffers

Initialize dump buffer in case caller missed it

(Set an end to all the bug reports of applications failing
to do so.)

Provide TC_HANDLE(maj, min) macro to generate tc handles

Move to asciidoc

The core library documentation has been converted to use asciidoc. It
provides better flexibility in creating documentation such as tables
and more powerful formatting rules.

The doxygen based API reference remains and three scripts have been
added to:
 - gen-tags.sh: extract tag information from doxygen reference
 - tags2dict.sh: generate a name=link dictionary file
 - doxygen-link.py: replace all references in the asciidoc documentation
                    refering to API functions, struct, etc. with a link
    into the doxygen API reference.

'make gendoc' continue to generate all documentation.

The following tools are required to generate documentation:
 - asciidoc
 - mscgen
 - asciidoc mscgen plugin
 - pygments
 - xmlstarlet

trafic class/classifer API improvements and documentation

- removed dead functions in header files
- deprecated rtnl_class_foreach_*() functions due to their missing
  handling possibility of OOM situations
- improved API documentation

Qdisc API improvements and documentation

Deprecated the functions rtnl_qdisc_change() and
rtnl_qdisc_build_change_request() for their lack of being able to
specify flags. The new functions rtnl_qdisc_update() and
rtnl_qdisc_build_update_request() may be used instead. The old
functions are still available though. However, rtnl_qdisc_update()
no longer implies NLM_F_REPLACE, it has to specified implicitely
to allow updating a qdisc without risking to replace another qdisc.

Included detailed documentation of qdisc addition/update/deletion.

Introduced APPBUG() macro to let application developer know of
API abuse.

Add nl_send_sync()

Function which sends message using nl_send_auto(), frees the message and
waits for ACK/error message (if auto-ack is not disabled).

correctly handle the object not found case

Removing non existent route (both ipv4 and ipv6) using
rtnl_route_delete return NLE_FAILURE generic error code. After
investigation, it seems the linux kernel return -ESRCH in that case
(see http://lxr.linux.no/linux+v2.6.38/net/ipv6/route.c#L1367). Same
behaviour apply for removing non existent address. The function
nl_syserr2nlerr (lib/error.c) which is responsible for translating
from kernel error to libnl error doesn't handle ESRCH.

Deprecate rtnl_qdisc_foreach_child() and rtnl_qdisc_foreach_cls()

Their usage is not completely safe, it is not possible to handle
the out of memory situation of the allocate filter. It is very
unlikely for this to cause any problem though.

The functions are still accessible but gcc will warn about their
deprecation.

Allow NLSYSCONFDIR environment variable to overwrite built-in sysconfdir

Cleanup <netlink/route/qdisc.h>
- remove dead prototypes
- reformat

Check if all mandatory attributes are present in rtnl_tc_msg_build()

TCA_ATTR_IFINDEX | TCA_ATTR_PARENT | TCA_ATTR_KIND

Add NLE_NODEV error

Set default MTU to 1500

Fix "make distcheck".

This commit adds some missing files (some header files, the files below
/etc and the bison/flex files) to the distribution tarball to ensure
that libnl can be built from the tarballs created using "make dist".

It also adds some incantations to properly generate the flex and bison
output since the generated output is no longer shipped in the tarball.

Fix out-of-tree build.

This patch fixes out-of-tree build, that is, when building with
$builddir != $srcdir. In such a case, some generated header files are
not found because they live in a different tree and can be fixed by
adding the directories to the compiler's include search path.

Omit empty nested attributes

Check for empty nested attributes in nla_nest_end() and omit the
attribute alltogether if is is the case.

add missing nl_cache_search in cache.h

fix missing declaration of nl_cache_search

add missing checks for ROUTE_ATTR_MULTIPATH

attached patch adds missing checks for ROUTE_ATTR_MULTIPATH
when dealing with multipath routing.

Affected functions

rtnl_route_remove_nexthop
rtnl_route_get_nexthops
rtnl_route_get_nnexthops

Documentation updates

Mostly killing doxygen warnings, some doc updates to caching

libnl-3.0

fix module parent references

rename sch -> qdisc

Unified TC API

Finally got rid of all the qdisc/class/cls code duplication in
the tc module API. The API takes care of allocation/freeing the
tc object specific data.

I hope I got it right this time.

provide function to retrieve htb rate

Hold reference to obj while calling callback of cache iterator

Print debugging info while iterating a cache based on a filter

Fix off-by-one when reading IFLA_INET6_CONF and IFLA_INET6_STATS

__nlmsg_alloc(): Guarantee minimal message size of at least the header

Make struct nl_object public, NLHDR_COMMON has been public anyway

Add missing argument in rtnl_link_change example

Signed-off-by: Miguel Di Ciurcio Filho <miguel.filho@gmail.com>

Provide numeric version defines

allowing silent rules in build

Fix function nfnl_ct_del name

This function is named nfnl_nl_del in lib/netfilter/ct.c, while it was
declared nfnl_ct_delete in the header.

Include <linux/pkt_cls.h> and <linux/pkt_sched.h> in <netlink/route/tc.h> for convenience

prefix ipv6 link statistics identifiers with IP6

use linux/netlink.h instead of netlink/netlink-kernel.h

Tons of documentation

addr: hide nl_addr_destroy()

everyone should use nl_addr_put()

rename NL_AUTO_PID to NL_AUTO_PORT

Old name is kept for compatibility.

Rename nlmsg_for_each_msg() to nlmsg_for_each()

Also put remaining variable on local stack instead of requiring the user
to supply it. Old interface is kept for compatibility.

nl_recv(): Zero out sockaddr in case the caller forgot

nl_recv(): Make passing creds pointer optional

nl: rename nlmsg_msg_size() to nlmsg_size(), nlmsg_len() -> nlmsg_datalen()

The old symbols are left around for compatibility.

Documentation updates
 - moved documentation from lib/doc.c to doc/src/
 - splitted pages into separate files
 - worked over core sections, explaining the receiving and sending
   behaviour in much more details including the the available
   mechanisms to customize the behaviour
 - updated the html stylesheet file for increased readability, probably
   needs some doxygen patching to achieve what I am looking for.
 - enabled call graphs, not expanded by default

Inherit return code of NL_CB_MSG_OUT in nl_sendmsg()

If NL_CB_MSG_OUT() returns anything != NL_OK, return that value
to let any caller of nl_sendmsg() know that the message has not
been sent.

rename nl_send_auto_complete() -> nl_send_auto(), nl_auto_complete -> nl_complete_msg()

Old symbols left to maintain backwards compatibility

only perform automatic sequence checking if auto-ack mode is enabled

Don't build doc.c, there is no real code in it

socket: constify interface

constify struct trans_tbl

link/inet6: pretty printing

New function nl_size2str()

Rename nl_get_hz() to nl_get_user_hz() to indicate it's not the in-kernel HZ value

sfq: perturb period is in seconds, not jiffies

link/inet: pretty printing, make output more readable

update Doxyfile to latest version

Make syntax of nl-link-list consistent and install it

link/inet: documentation: add examples

link: define RTM_SETLINK to allow pretty printing

link: Add missing IFLA_AF_SPEC container attribute

link/inet: Fix array access

link: Fix typo, use rtnl_link_af_alloc() to make sure data buffer is allocated

link: AF_INET link module

Note: The code for this is not upstream yet.

Extends the link api to allow address family modules to fill a link
message and implements a AF_INET address family link module which
uses the new interface.

link: Support for IFLA_AF_SPEC

This feature isn't upstream yet. It's required to test a patch in
my local tree.

Makes the link parser understand IFLA_AF_SPEC and call the address
family specific parser.

link: Add support for IPv6 specific link data
 - parses IFLA_PROTINFO
 - dumps flags, cacheinfo, devconf and all statistics

Add support for per interface ICMPv6 statistics

Add local copies of linux/ipv6.h and linux/snmp.h

Add all libraries for libtool to improve linkage

This will fix finding libs while link, by adding them to LDFLAGS

[It's no ideal but it's less of a mess than what we have now. -tgraf]

Signed-off-by: Gery Kahn <geryk@ti.com>

Extend rtnl_link_alloc_cache() to support address families

Adds a family argument which allows to request link dumps for a certain
address family. This allows to f.e. dump ipv6 specific statistics and data.

nl-link-list --family inet6

Make nl_str2af return a negative value if parsing fails

link/api: Improve API documentation.

link/api: Convert link info ops to use nl_list_head

rtnl_link_info_ops_lookup() now returns a pointer with refcnt increment,
you must return it using rtnl_link_info_ops_put()

link: Support for AF_BRIDGE address family

Supports parsing of IFLA_PROTINFO returned when dumping with PF_BRIDGE

link/api: Check for null pointer in rtnl_link_af_ops_put()

link: API for address family specific link data

Introduces a new API to handle address familiy specific link data such as
IFLA_PROTINFO. It provides entry hooks for parsing IFLA_PROTINFO attributes
and allows to include the parsed data when a link object is dumped.

link: Support IFLA_NUM_VF attribute
- parses attribute if available
- provides API to access value
    rtnl_link_get_num_vf(link, num_vf)

link: Support IFLA_IFALIAS attribute

- parse IFLA_IFALIAS if available
- provides API to access/change ifalias
     rtnl_link_get_ifalias(link)
     rtnl_link_set_ifalias(link, alias)
- extends nl-link-set to test functionality

pktloc: support to specify a shift operator for packet locations

no users yet though.

Correctly state the process of sending a netlink message. A message
passes through nl_send_iovec() before hitting nl_sendmsg()

nl-qdisc-delete: Do not attempt to delete default qdiscs

ematch/meta: id definitions

nl-classid-lookup: Added --raw option to print classid without pretty printing it

nl-qdisc-list: --recursive - print tc objects recursively

Correctly parse and generate classids

Make sure to parse strings starting with a hex represention letter
but not representing a valid number as tc names.

Fix typo while generating classid.

classid auto generation if provided tc name does not exist

Manually editing etc/libnl/classid before adding tc objects is a pain.
This patch adds code to attempt auto generating a unique tc id which
will then be assigned to the provided name and added to the classid
file.

This will make the following commands work with prior definitions of
the names "top" and "test"
sudo sbin/nl-qdisc-add --dev eth0 --parent root --id top htb
sudo sbin/nl-class-add --dev eth0 --parent top --id test htb --rate 100mbit

It will generate the following ids automatically:
4001: top
4001:1 test

Support for meta match

Syntax:
meta(pktlen > 768)

text ematch support

attr: Add padding if nested data does not end at an alignment boundry

This could happen if a user put an unaligned amount of data inside
an attribute with nlmsg_append().

Improved debugging messages while constructing messages/attributes

routing rules: adapt to unified routing rules

- Use FRA_ definitions
- Removed obsoleted fields
- Added fwmask and goto support

Revert "routing rules: mark support"

This reverts commit ee88c71d16a6b777c916275401a971eea78871d6.

Revert "Include RTA_MARK in routing rule messages"

This reverts commit 6862c6592ad598dde0d827039b30df1a947822d1.

Support RT_TABLE_COMPAT

Support neighbour flag NTF_USE

Support for 64bit link counters IFLA_STATS64

Updated arp and ethernet codes

Include RTA_MARK in routing rule messages

routing rules: mark support

Obsolete RTA_PROTOINFO code and parse RTA_MARK

rtnl_rule_set_mark(rule, mark)
rtnl_rule_get_mark(rule)

now access the mark as in firewall mark

src/nf-queue: revert nonsensical change

The only part of commit d378220c (src/nf-queue.c: cleanup and improve
performance of test program for NF_QUEUE) that actually makes sense is
the increase in receive buffer size. Issuing verdicts for IDs not delivered
to userspace is a wasted effort since the kernel drops packets itself when
netlink message delivery fails. This would actually have been noticed
by a return value of -ENOENT if the result of nfnl_queue_msg_send_verdict()
would have been checked.

Signed-off-by: Patrick McHardy <kaber@trash.net>