IPQ_CREATE_HANDLE(3)
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 proto- col); 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.