Man Pages

ipq_create_handle(3) - phpMan ipq_create_handle(3) - phpMan

Command: man perldoc info search(apropos)  


IPQ_CREATE_HANDLE(3)       Linux Programmer's Manual      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 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  compatibil-
       ity.

       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 <jmorrisATintercode.au>

COPYRIGHT
       Copyright (c) 2000-2001 Netfilter Core Team.

       Distributed under the GNU General Public License.

SEE ALSO
       iptables(8), libipq(3).



Linux iptables 1.2              16 October 2001           IPQ_CREATE_HANDLE(3)