struct ipq_handle *ipq_create_handle(u_int32_t flags, u_int32_t protocol); int ipq_destroy_handle(struct ipq_handle *h);
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.
parameter is not currently used and should be set to zero by the application
for forward compatibility.
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.
function frees up resources allocated by
and should be used when the handle is no longer required by the application.
returns a pointer to a context handle.
On failure, NULL is returned.
On failure, -1 is returned.
On failure, a descriptive error message will be available