stv0g/libnl
1
0
Fork 0
Code Issues Pull requests Releases Wiki Activity
libnl/include/netlink/netlink.h

104 lines
3.1 KiB
C
Raw Permalink Normal View History

Initial import
2007-09-15 01:28:01 +02:00
/*
* netlink/netlink.h Netlink Interface
*
* 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.
*
netlink: Forward declare frequent libnl types to ease inclusion deps Signed-off-by: Thomas Graf <tgraf@suug.ch>
2013-02-14 12:37:10 +01:00
* Copyright (c) 2003-2013 Thomas Graf <tgraf@suug.ch>
Initial import
2007-09-15 01:28:01 +02:00
*/
#ifndef NETLINK_NETLINK_H_
#define NETLINK_NETLINK_H_
#include <stdio.h>
#include <stdint.h>
#include <string.h>
#include <stdlib.h>
netlink/netlink.h: fix build including <poll.h> with the musl C library https://github.com/thom311/libnl/pull/64 Signed-off-by: Thomas Haller <thaller@redhat.com>
2014-09-01 12:38:10 +02:00
#include <poll.h>
Initial import
2007-09-15 01:28:01 +02:00
#include <sys/socket.h>
#include <sys/types.h>
#include <sys/time.h>
<netlink/addr.h> requires <netdb.h>
2008-06-17 02:09:38 +02:00
#include <netdb.h>
Initial import
2007-09-15 01:28:01 +02:00
#include <netlink/netlink-compat.h>
#include <linux/netlink.h>
#include <linux/rtnetlink.h>
#include <linux/genetlink.h>
#include <linux/netfilter/nfnetlink.h>
Add support for inet diag Netlink protocol. - Inet diag allows users to gather low-level socket information. - This library provides a higher-level API for creating inetdiag requests (via idiagnl_connect and idiagnl_send_simple) and parsing the replies (via idiagnl_msg_parse). A cache is also provided (via idiagnl_msg_alloc_cache). - Request and message objects provide APIs for accessing and setting the various properties of each. - This library also allows the user to parse the inetdiag response attributes which contain information about traffic class, TOS, congestion, socket memory info, and more depending on the kernel version used. - Includes doxygen documentation.
2013-07-03 18:40:58 -07:00
#include <netinet/tcp.h>
Provide libnl version in <netlink/version.h>
2008-04-30 15:43:42 +02:00
#include <netlink/version.h>
Thread-safe error handling In order for the interface to become more thread safe, the error handling was revised to no longer depend on a static errno and error string buffer. This patch converts all error paths to return a libnl specific error code which can be translated to a error message using nl_geterror(int error). The functions nl_error() and nl_get_errno() are therefore obsolete. This change required various sets of function prototypes to be changed in order to return an error code, the most prominent are: struct nl_cache *foo_alloc_cache(...); changed to: int foo_alloc_cache(..., struct nl_cache **); struct nl_msg *foo_build_request(...); changed to: int foo_build_request(..., struct nl_msg **); struct foo *foo_parse(...); changed to: int foo_parse(..., struct foo **); This pretty much only leaves trivial allocation functions to still return a pointer object which can still return NULL to signal out of memory. This change is a serious API and ABI breaker, sorry!
2008-05-14 17:49:44 +02:00
#include <netlink/errno.h>
Initial import
2007-09-15 01:28:01 +02:00
#include <netlink/types.h>
#include <netlink/handlers.h>
#include <netlink/socket.h>
API to issue direct GET requests to the kernel Provide nl_pickup() to pick up an answer from a netlink request and parse it using the supplied parser. Add rtnl_link_get_kernel() which sends an RTM_GETLINK to the kernel to fetch a single link directly from the kernel. This can be faster than dumping the whole table, especially if lots of links are configured.
2011-04-11 12:34:01 +02:00
#include <netlink/object.h>
Initial import
2007-09-15 01:28:01 +02:00
#ifdef __cplusplus
extern "C" {
#endif
Declare struct ucred in handlers.h and netlink.h Both files refer to it. The sources including those files are not guaranteed to include sys/socket.h to ensure that struct ucred is defined.
2009-07-06 15:13:28 -04:00
struct ucred;
fix includes after removing some headers commit f20bbe1f07fcff1509425884f5ed72ca8d5fb6ab Author: Thomas Graf <tgraf@suug.ch> Date: Tue Jan 22 19:10:38 2013 +0100 No longer install module API headers This commit causes a regression so no app using libnl can be compiled against it. This patch fixes it by removing includes of no-longe existing headers. Signed-off-by: Jiri Pirko <jiri@resnulli.us> Signed-off-by: Thomas Graf <tgraf@suug.ch>
2013-01-23 13:17:43 +01:00
struct nl_cache_ops;
struct nl_parser_param;
netlink: Forward declare frequent libnl types to ease inclusion deps Signed-off-by: Thomas Graf <tgraf@suug.ch>
2013-02-14 12:37:10 +01:00
struct nl_object;
struct nl_sock;
Declare struct ucred in handlers.h and netlink.h Both files refer to it. The sources including those files are not guaranteed to include sys/socket.h to ensure that struct ucred is defined.
2009-07-06 15:13:28 -04:00
Initial import
2007-09-15 01:28:01 +02:00
extern int nl_debug;
extern struct nl_dump_params nl_debug_dp;
/* Connection Management */
Rename struct nl_handle to struct nl_sock The idea of a common handle is long revised and only misleading, nl_handle really represents a socket with some additional action handlers assigned to it. Alias for nl_handle is kept for backwards compatibility.
2008-05-15 13:26:32 +02:00
extern int nl_connect(struct nl_sock *, int);
extern void nl_close(struct nl_sock *);
Initial import
2007-09-15 01:28:01 +02:00
/* Send */
Rename struct nl_handle to struct nl_sock The idea of a common handle is long revised and only misleading, nl_handle really represents a socket with some additional action handlers assigned to it. Alias for nl_handle is kept for backwards compatibility.
2008-05-15 13:26:32 +02:00
extern int nl_sendto(struct nl_sock *, void *, size_t);
extern int nl_sendmsg(struct nl_sock *, struct nl_msg *,
Initial import
2007-09-15 01:28:01 +02:00
struct msghdr *);
Rename struct nl_handle to struct nl_sock The idea of a common handle is long revised and only misleading, nl_handle really represents a socket with some additional action handlers assigned to it. Alias for nl_handle is kept for backwards compatibility.
2008-05-15 13:26:32 +02:00
extern int nl_send(struct nl_sock *, struct nl_msg *);
new feature nl_send_iovec(), nl_auto_complete() and code refactoring. Create new function nl_send_iovec() to be used to send multiple 'struct iovec' through the netlink socket. This will be used for NF_QUEUE, to send packet payload of a modified packet. Refactor nl_send() to use nl_send_iovec() sending a single struct iovec. Create new function nl_auto_complete() by refactoring nl_send_auto_complete(), so other functions that call nl_send may also use nl_auto_complete() Signed-off-by: Karl Hiramoto <karl@hiramoto.org>
2010-02-24 21:29:13 +01:00
extern int nl_send_iovec(struct nl_sock *, struct nl_msg *,
Fix compile warning in nl.c
2010-07-03 15:14:13 +02:00
struct iovec *, unsigned);
rename nl_send_auto_complete() -> nl_send_auto(), nl_auto_complete -> nl_complete_msg() Old symbols left to maintain backwards compatibility
2010-11-18 14:13:49 +01:00
extern void nl_complete_msg(struct nl_sock *,
struct nl_msg *);
new feature nl_send_iovec(), nl_auto_complete() and code refactoring. Create new function nl_send_iovec() to be used to send multiple 'struct iovec' through the netlink socket. This will be used for NF_QUEUE, to send packet payload of a modified packet. Refactor nl_send() to use nl_send_iovec() sending a single struct iovec. Create new function nl_auto_complete() by refactoring nl_send_auto_complete(), so other functions that call nl_send may also use nl_auto_complete() Signed-off-by: Karl Hiramoto <karl@hiramoto.org>
2010-02-24 21:29:13 +01:00
extern void nl_auto_complete(struct nl_sock *,
rename nl_send_auto_complete() -> nl_send_auto(), nl_auto_complete -> nl_complete_msg() Old symbols left to maintain backwards compatibility
2010-11-18 14:13:49 +01:00
struct nl_msg *);
extern int nl_send_auto(struct nl_sock *, struct nl_msg *);
Rename struct nl_handle to struct nl_sock The idea of a common handle is long revised and only misleading, nl_handle really represents a socket with some additional action handlers assigned to it. Alias for nl_handle is kept for backwards compatibility.
2008-05-15 13:26:32 +02:00
extern int nl_send_auto_complete(struct nl_sock *,
Initial import
2007-09-15 01:28:01 +02:00
struct nl_msg *);
Add nl_send_sync() Function which sends message using nl_send_auto(), frees the message and waits for ACK/error message (if auto-ack is not disabled).
2011-03-25 18:11:52 +01:00
extern int nl_send_sync(struct nl_sock *, struct nl_msg *);
Rename struct nl_handle to struct nl_sock The idea of a common handle is long revised and only misleading, nl_handle really represents a socket with some additional action handlers assigned to it. Alias for nl_handle is kept for backwards compatibility.
2008-05-15 13:26:32 +02:00
extern int nl_send_simple(struct nl_sock *, int, int,
Initial import
2007-09-15 01:28:01 +02:00
void *, size_t);
/* Receive */
Rename struct nl_handle to struct nl_sock The idea of a common handle is long revised and only misleading, nl_handle really represents a socket with some additional action handlers assigned to it. Alias for nl_handle is kept for backwards compatibility.
2008-05-15 13:26:32 +02:00
extern int nl_recv(struct nl_sock *,
Initial import
2007-09-15 01:28:01 +02:00
struct sockaddr_nl *, unsigned char **,
struct ucred **);
Rename struct nl_handle to struct nl_sock The idea of a common handle is long revised and only misleading, nl_handle really represents a socket with some additional action handlers assigned to it. Alias for nl_handle is kept for backwards compatibility.
2008-05-15 13:26:32 +02:00
extern int nl_recvmsgs(struct nl_sock *, struct nl_cb *);
nl: Fix return value of nl_recvmsgs() Apparently the change to have nl_recvmsgs() return the number of parsed messages broke nl_wait_for_ack() among other applications. This patch reverts to the old behaviour and provides a new function nl_recvmsgs_report() which provides the additional information for use by the cache manager and possibly other applications. Reported-by: Scott Bonar <sbonar@cradlepoint.com> Signed-off-by: Thomas Graf <tgraf@redhat.com>
2012-05-08 22:48:00 +02:00
extern int nl_recvmsgs_report(struct nl_sock *, struct nl_cb *);
Initial import
2007-09-15 01:28:01 +02:00
Rename struct nl_handle to struct nl_sock The idea of a common handle is long revised and only misleading, nl_handle really represents a socket with some additional action handlers assigned to it. Alias for nl_handle is kept for backwards compatibility.
2008-05-15 13:26:32 +02:00
extern int nl_recvmsgs_default(struct nl_sock *);
Initial import
2007-09-15 01:28:01 +02:00
Rename struct nl_handle to struct nl_sock The idea of a common handle is long revised and only misleading, nl_handle really represents a socket with some additional action handlers assigned to it. Alias for nl_handle is kept for backwards compatibility.
2008-05-15 13:26:32 +02:00
extern int nl_wait_for_ack(struct nl_sock *);
Initial import
2007-09-15 01:28:01 +02:00
API to issue direct GET requests to the kernel Provide nl_pickup() to pick up an answer from a netlink request and parse it using the supplied parser. Add rtnl_link_get_kernel() which sends an RTM_GETLINK to the kernel to fetch a single link directly from the kernel. This can be faster than dumping the whole table, especially if lots of links are configured.
2011-04-11 12:34:01 +02:00
extern int nl_pickup(struct nl_sock *,
int (*parser)(struct nl_cache_ops *,
struct sockaddr_nl *,
struct nlmsghdr *,
struct nl_parser_param *),
struct nl_object **);
nl: add function nl_pickup_keep_syserr() nl_pickup() converts error codes from netlink into nl error codes using nl_syserr2nlerr(). The latter function mangles different error codes to the same nl error code. Add a new function, that returns both the nl error code and the original error code. Acked-by: Thomas Graf <tgraf@suug.ch> Signed-off-by: Thomas Haller <thaller@redhat.com>
2014-11-26 18:13:37 +01:00
extern int nl_pickup_keep_syserr(struct nl_sock *sk,
int (*parser)(struct nl_cache_ops *, struct sockaddr_nl *,
struct nlmsghdr *, struct nl_parser_param *),
struct nl_object **result,
int *syserror);
Initial import
2007-09-15 01:28:01 +02:00
/* Netlink Family Translations */
extern char * nl_nlfamily2str(int, char *, size_t);
extern int nl_str2nlfamily(const char *);
#ifdef __cplusplus
}
#endif
#endif
Reference in a new issue Copy permalink