Man Linux: Main Page and Category List

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).