IPQ_CREATE_HANDLE
Section: Linux Programmer's Manual (3)
Updated: 16 October 2001
Page Index
NAME
ipq_create_handle, ipq_destroy_handle --- create and destroy libipq handles.
SYNOPSIS
#include <linux/netfilter.h>
#include <libipq.h>
struct ipq_handle *ipq_create_handle(u_int32_t flags, u_int32_t protocol);
int ipq_destroy_handle(struct ipq_handle *h);
DESCRIPTION
The
ipq_create_handle
function initialises libipq for an application, attempts to bind to the
Netlink socket used by ip_queue, and returns an opaque context handle. It
should be the first libipq function to be called by an application. The
handle returned should be used in all subsequent library calls which
require a handle parameter.
The
flags
parameter is not currently used and should be set to zero by the application
for forward compatibility.
The
protocol
parameter is used to specify the protocol of the packets to be queued.
Valid values are NFPROTO_IPV4 for IPv4 and NFPROTO_IPV6 for IPv6. Currently,
only one protocol may be queued at a time for a handle.
The
ipq_destroy_handle
function frees up resources allocated by
ipq_create_handle,
and should be used when the handle is no longer required by the application.
RETURN VALUES
On success,
ipq_create_handle
returns a pointer to a context handle.
On failure, NULL is returned.
On success,
ipq_destroy_handle
returns zero.
On failure, -1 is returned.
ERRORS
On failure, a descriptive error message will be available
via the
ipq_errstr
function.
BUGS
None known.
AUTHOR
James Morris <
jmorris@intercode.com.au>
COPYRIGHT
Copyright (c) 2000-2001 Netfilter Core Team.
Distributed under the GNU General Public License.
SEE ALSO
iptables(8),
libipq(3).