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.

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

rtnl_route_alloc_cache()

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.

{
        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;
}

References nl_cache_alloc(), and nl_cache_refill().

rtnl_route_build_add_request()

struct nl_msg * rtnl_route_build_add_request	(	struct rtnl_route *	tmpl,
		int	flags
	)

Definition at line 366 of file route.c.

{
        return build_route_msg(tmpl, RTM_NEWROUTE, NLM_F_CREATE | flags);
}

rtnl_route_add()

int rtnl_route_add	(	struct nl_handle *	handle,
		struct rtnl_route *	route,
		int	flags
	)

Definition at line 371 of file route.c.

{
        struct nl_msg *msg;
        int err;
 
        msg = rtnl_route_build_add_request(route, flags);
        if (!msg)
                return nl_get_errno();
 
        err = nl_send_auto_complete(handle, msg);
        nlmsg_free(msg);
        if (err < 0)
                return err;
 
        return nl_wait_for_ack(handle);
}

rtnl_route_build_del_request()

struct nl_msg * rtnl_route_build_del_request	(	struct rtnl_route *	tmpl,
		int	flags
	)

Definition at line 389 of file route.c.

{
        return build_route_msg(tmpl, RTM_DELROUTE, flags);
}

rtnl_route_del()

int rtnl_route_del	(	struct nl_handle *	handle,
		struct rtnl_route *	route,
		int	flags
	)

Definition at line 394 of file route.c.

{
        struct nl_msg *msg;
        int err;
 
        msg = rtnl_route_build_del_request(route, flags);
        if (!msg)
                return nl_get_errno();
 
        err = nl_send_auto_complete(handle, msg);
        nlmsg_free(msg);
        if (err < 0)
                return err;
 
        return nl_wait_for_ack(handle);
}