ipq_set_verdict(3) - Linux man page

Name

ipq_set_verdict -- issue verdict and optionally modified packet to kernel

Synopsis

#include <linux/netfilter.h>
#include <libipq.h>

int ipq_set_verdict(const struct ipq_handle *h, ipq_id_t id, unsigned int verdict, size_t data_len, unsigned char *buf);

Description

The ipq_set_verdict function issues a verdict on a packet previously obtained with ipq_read, specifing the intended disposition of the packet, and optionally supplying a modified version of the payload data.

The h parameter is a context handle which must previously have been returned successfully from a call to ipq_create_handle.

The id parameter is the packet identifier obtained via ipq_get_packet.

The verdict parameter must be one of:

NF_ACCEPT: Accept the packet and continue traversal within the kernel.
NF_DROP: Drop the packet.
NF_QUEUE: Requeue the packet.

NF_STOLEN and NF_REPEAT are kernel-internal constants and should not be used from userspace as their exact side effects have not been investigated.

The data_len parameter is the length of the data pointed to by buf, the optional replacement payload data.

If simply setting a verdict without modifying the payload data, use zero for data_len and NULL for buf.

The application is responsible for recalculating any packet checksums when modifying packets.

Return Value

On failure, -1 is returned.
On success, a non-zero positive value is returned.

Errors

On error, a descriptive error message will be available via the ipq_errstr function.

Bugs

None known.

Author

James Morris <jmorris@intercode.com.au>

Copyright

Distributed under the GNU General Public License.