Routing

Modules
	Route Object
	Utilities
	Routing Utility Functions.

Cache Management
struct nl_cache *	rtnl_route_alloc_cache (struct nl_handle *handle)
	Build a route cache holding all routes currently configured in the kernel. More...

Route Addition
struct nl_msg *	rtnl_route_build_add_request (struct rtnl_route *tmpl, int flags)
int	rtnl_route_add (struct nl_handle *handle, struct rtnl_route *route, int flags)
struct nl_msg *	rtnl_route_build_del_request (struct rtnl_route *tmpl, int flags)
int	rtnl_route_del (struct nl_handle *handle, struct rtnl_route *route, int flags)

Detailed Description

Function Documentation

struct nl_cache* rtnl_route_alloc_cache

(

struct nl_handle *

handle

)

Parameters

handle

netlink handle

Allocates a new cache, initializes it properly and updates it to contain all routes currently configured in the kernel.

Note

The caller is responsible for destroying and freeing the cache after using it.

Returns

The cache or NULL if an error has occured.

Definition at line 241 of file route.c.

References nl_cache_alloc(), nl_cache_mngt_register(), nl_cache_mngt_unregister(), nl_cache_refill(), nl_send_auto_complete(), nl_wait_for_ack(), nla_nest_end(), nla_nest_start(), NLA_PUT_ADDR, NLA_PUT_U32, NLM_F_CREATE, nlmsg_alloc_simple(), nlmsg_append(), nlmsg_free(), and RTNL_LINK_NOT_FOUND.

{
        struct nl_cache *cache;

        cache = nl_cache_alloc(&rtnl_route_ops);
        if (!cache)
                return NULL;

        if (handle && nl_cache_refill(handle, cache) < 0) {
                free(cache);
                return NULL;
        }

        return cache;
}