67aeb7474f
rtnl_link_info_ops_lookup() now returns a pointer with refcnt increment, you must return it using rtnl_link_info_ops_put()
115 lines
3.7 KiB
C
115 lines
3.7 KiB
C
/*
|
|
* netlink/route/link/api.h Link Modules API
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation version 2.1
|
|
* of the License.
|
|
*
|
|
* Copyright (c) 2003-2010 Thomas Graf <tgraf@suug.ch>
|
|
*/
|
|
|
|
#ifndef NETLINK_LINK_API_H_
|
|
#define NETLINK_LINK_API_H_
|
|
|
|
#include <netlink/netlink.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @ingroup link_info
|
|
*
|
|
* Link info operations
|
|
*/
|
|
struct rtnl_link_info_ops
|
|
{
|
|
/** Name of operations, must match name on kernel side */
|
|
char * io_name;
|
|
|
|
/** Reference count (internal, do not use) */
|
|
int io_refcnt;
|
|
|
|
/** Called to assign an info type to a link.
|
|
* Has to allocate enough resources to hold attributes. Can
|
|
* use link->l_info to store a pointer. */
|
|
int (*io_alloc)(struct rtnl_link *);
|
|
|
|
/** Called to parse the link info attribute.
|
|
* Must parse the attribute and assign all values to the link.
|
|
*/
|
|
int (*io_parse)(struct rtnl_link *,
|
|
struct nlattr *,
|
|
struct nlattr *);
|
|
|
|
/** Called when the link object is dumped.
|
|
* Must dump the info type specific attributes. */
|
|
void (*io_dump[NL_DUMP_MAX+1])(struct rtnl_link *,
|
|
struct nl_dump_params *);
|
|
|
|
/** Called when a link object is cloned.
|
|
* Must clone all info type specific attributes. */
|
|
int (*io_clone)(struct rtnl_link *, struct rtnl_link *);
|
|
|
|
/** Called when construction a link netlink message.
|
|
* Must append all info type specific attributes to the message. */
|
|
int (*io_put_attrs)(struct nl_msg *, struct rtnl_link *);
|
|
|
|
/** Called to release all resources previously allocated
|
|
* in either io_alloc() or io_parse(). */
|
|
void (*io_free)(struct rtnl_link *);
|
|
|
|
struct nl_list_head io_list;
|
|
};
|
|
|
|
extern struct rtnl_link_info_ops *rtnl_link_info_ops_lookup(const char *);
|
|
extern void rtnl_link_info_ops_put(struct rtnl_link_info_ops *);
|
|
extern int rtnl_link_register_info(struct rtnl_link_info_ops *);
|
|
extern int rtnl_link_unregister_info(struct rtnl_link_info_ops *);
|
|
|
|
|
|
struct rtnl_link_af_ops
|
|
{
|
|
/** The address family this operations set implements */
|
|
const unsigned int ao_family;
|
|
|
|
/** Number of users of this operations, DO NOT MODIFY. */
|
|
int ao_refcnt;
|
|
|
|
/** Validation policy for IFLA_PROTINFO attribute. This pointer
|
|
* can be set to a nla_policy structure describing the minimal
|
|
* requirements the attribute must meet. Failure of meeting these
|
|
* requirements will result in a parsing error. */
|
|
const struct nla_policy *ao_protinfo_policy;
|
|
|
|
/** Called after address family has been assigned to link. Must
|
|
* allocate data buffer to hold address family specific data and
|
|
* store it in link->l_af_data. */
|
|
void * (*ao_alloc)(struct rtnl_link *);
|
|
|
|
/** Called when the link is cloned, must allocate a clone of the
|
|
* address family specific buffer and return it. */
|
|
void * (*ao_clone)(struct rtnl_link *, void *);
|
|
|
|
/** Called when the link gets freed. Must free all allocated data */
|
|
void (*ao_free)(struct rtnl_link *, void *);
|
|
|
|
/** Called if a IFLA_PROTINFO attribute needs to be parsed. Typically
|
|
* stores the parsed data in the address family specific buffer. */
|
|
int (*ao_parse_protinfo)(struct rtnl_link *,
|
|
struct nlattr *, void *);
|
|
|
|
/** Dump address family specific link attributes */
|
|
void (*ao_dump[NL_DUMP_MAX+1])(struct rtnl_link *,
|
|
struct nl_dump_params *,
|
|
void *);
|
|
};
|
|
|
|
extern struct rtnl_link_af_ops *rtnl_link_af_ops_lookup(unsigned int);
|
|
extern void rtnl_link_af_ops_put(struct rtnl_link_af_ops *);
|
|
extern int rtnl_link_af_register(struct rtnl_link_af_ops *);
|
|
extern int rtnl_link_af_unregister(struct rtnl_link_af_ops *);
|
|
|
|
|
|
#endif
|