Controller

Functions
int	genl_ctrl_resolve (struct nl_handle *handle, const char *name)
	Resolve generic netlink family name to its identifier.

Cache Management
struct nl_cache *	genl_ctrl_alloc_cache (struct nl_handle *handle)
struct genl_family *	genl_ctrl_search (struct nl_cache *cache, int id)
	Look up generic netlink family by id in the provided cache.

Resolver
struct genl_family *	genl_ctrl_search_by_name (struct nl_cache *cache, const char *name)
	Look up generic netlink family by family name in the provided cache.

Detailed Description

Function Documentation

genl_ctrl_alloc_cache()

struct nl_cache * genl_ctrl_alloc_cache

(

struct nl_handle *

handle

)

Definition at line 146 of file ctrl.c.

{
        struct nl_cache * cache;
        
        cache = nl_cache_alloc(&genl_ctrl_ops);
        if (cache == NULL)
                return NULL;
        
        if (handle && nl_cache_refill(handle, cache) < 0) {
                nl_cache_free(cache);
                return NULL;
        }
 
        return cache;
}

genl_ctrl_search()

struct genl_family * genl_ctrl_search	(	struct nl_cache *	cache,
		int	id
	)

Parameters

cache	Generic netlink family cache.
id	Family identifier.

Searches through the cache looking for a registered family matching the specified identifier. The caller will own a reference on the returned object which needs to be given back after usage using genl_family_put().

Returns

Generic netlink family object or NULL if no match was found.

Definition at line 174 of file ctrl.c.

{
        struct genl_family *fam;
 
        if (cache->c_ops != &genl_ctrl_ops)
                BUG();
 
        nl_list_for_each_entry(fam, &cache->c_items, ce_list) {
                if (fam->gf_id == id) {
                        nl_object_get((struct nl_object *) fam);
                        return fam;
                }
        }
 
        return NULL;
}

References nl_object_get().

genl_ctrl_search_by_name()

struct genl_family * genl_ctrl_search_by_name	(	struct nl_cache *	cache,
		const char *	name
	)

Parameters

cache	Generic netlink family cache.
name	Family name.

Searches through the cache looking for a registered family matching the specified name. The caller will own a reference on the returned object which needs to be given back after usage using genl_family_put().

Returns

Generic netlink family object or NULL if no match was found.

Definition at line 208 of file ctrl.c.

{
        struct genl_family *fam;
 
        if (cache->c_ops != &genl_ctrl_ops)
                BUG();
 
        nl_list_for_each_entry(fam, &cache->c_items, ce_list) {
                if (!strcmp(name, fam->gf_name)) {
                        nl_object_get((struct nl_object *) fam);
                        return fam;
                }
        }
 
        return NULL;
}

References nl_object_get().

Referenced by genl_ctrl_resolve().

genl_ctrl_resolve()

int genl_ctrl_resolve	(	struct nl_handle *	handle,
		const char *	name
	)

Parameters

handle	Netlink Handle
name	Name of generic netlink family

Resolves the generic netlink family name to its identifer and returns it.

Returns

A positive identifier or a negative error code.

Definition at line 238 of file ctrl.c.

{
        struct nl_cache *cache;
        struct genl_family *family;
        int err;
 
        cache = genl_ctrl_alloc_cache(handle);
        if (cache == NULL)
                return nl_get_errno();
 
        family = genl_ctrl_search_by_name(cache, name);
        if (family == NULL) {
                err = nl_error(ENOENT, "Generic Netlink Family not found");
                goto errout;
        }
 
        err = genl_family_get_id(family);
        genl_family_put(family);
errout:
        nl_cache_free(cache);
 
        return err;
}

References genl_ctrl_search_by_name(), and nl_cache_free().