libnl 2.0
Modules

Queueing Classes

Traffic Control

Modules

 Class Modules
 Class Object

Addition/Modification

int rtnl_class_build_add_request (struct rtnl_class *class, int flags, struct nl_msg **result)
 Build a netlink message to add a new class.
int rtnl_class_add (struct nl_sock *sk, struct rtnl_class *class, int flags)
 Add a new class.
int rtnl_class_build_delete_request (struct rtnl_class *class, struct nl_msg **result)
int rtnl_class_delete (struct nl_sock *sk, struct rtnl_class *class)
 Delete a class.

Cache Management

int rtnl_class_alloc_cache (struct nl_sock *sk, int ifindex, struct nl_cache **result)
 Build a class cache including all classes attached to the specified interface.
struct rtnl_class * rtnl_class_get (struct nl_cache *cache, int ifindex, uint32_t handle)
 Look up class by its handle in the provided cache.

Function Documentation

int rtnl_class_build_add_request ( struct rtnl_class *  class,
int  flags,
struct nl_msg **  result 
)
Parameters:
classclass to add
flagsadditional netlink message flags
resultPointer to store resulting message.

Builds a new netlink message requesting an addition of a class. The netlink message header isn't fully equipped with all relevant fields and must be sent out via nl_send_auto_complete() or supplemented as needed.

Common message flags

  • NLM_F_REPLACE - replace possibly existing classes
Returns:
0 on success or a negative error code.

Definition at line 123 of file class.c.

References NLM_F_CREATE.

Referenced by rtnl_class_add().

int rtnl_class_add ( struct nl_sock *  sk,
struct rtnl_class *  class,
int  flags 
)
Parameters:
skNetlink socket.
classclass to delete
flagsadditional netlink message flags

Builds a netlink message by calling rtnl_qdisc_build_add_request(), sends the request to the kernel and waits for the next ACK to be received and thus blocks until the request has been processed.

Common message flags

  • NLM_F_REPLACE - replace possibly existing classes
Returns:
0 on success or a negative error code

Definition at line 144 of file class.c.

References nl_send_auto_complete(), nlmsg_free(), and rtnl_class_build_add_request().

int rtnl_class_delete ( struct nl_sock *  sk,
struct rtnl_class *  class 
)
Parameters:
skNetlink socket.
classclass to delete

Builds a netlink message by calling rtnl_class_build_delete_request(), sends the request to the kernel and waits for the ACK to be received and thus blocks until the request has been processed.

Returns:
0 on success or a negative error code

Definition at line 198 of file class.c.

References nl_send_auto_complete(), and nlmsg_free().

int rtnl_class_alloc_cache ( struct nl_sock *  sk,
int  ifindex,
struct nl_cache **  result 
)
Parameters:
skNetlink socket.
ifindexinterface index of the link the classes are attached to.

Allocates a new cache, initializes it properly and updates it to include all classes attached to the specified interface.

Returns:
The cache or NULL if an error has occured.

Definition at line 232 of file class.c.

References nl_cache_alloc(), nl_cache_free(), and nl_cache_refill().

struct rtnl_class* rtnl_class_get ( struct nl_cache *  cache,
int  ifindex,
uint32_t  handle 
) [read]
Parameters:
cacheclass cache
ifindexinterface the class is attached to
handleclass handle
Returns:
pointer to class inside the cache or NULL if no match was found.

Definition at line 260 of file class.c.

References nl_object_get().