Rechercher une page de manuel
ipq_read
Langue: en
Version: 379557 (fedora - 01/12/10)
Section: 3 (Bibliothèques de fonctions)
NAME
ipq_read --- read queue messages from ip_queue and read into supplied bufferSYNOPSIS
#include <linux/netfilter.h>#include <libipq.h>
ssize_t ipq_read(const struct ipq_handle *h, unsigned char *buf, size_t len, int timeout);
DESCRIPTION
The ipq_read function reads a queue message from the kernel and copies it to the memory pointed to by buf to a maximum length of len.The h parameter is a context handle which must previously have been returned successfully from a call to ipq_create_handle.
The caller is responsible for ensuring that the memory pointed to by buf is large enough to contain len bytes.
The timeout parameter may be used to set a timeout for the operation, specified in microseconds. This is implemented internally by the library via the select system call. A value of zero provides normal, backwards-compatible blocking behaviour with no timeout. A negative value causes the function to return immediately.
Data returned via buf should not be accessed directly. Use the ipq_message_type, ipq_get_packet, and ipq_get_msgerr functions to access the queue message in the buffer.
RETURN VALUE
On failure, -1 is returned.On success, a non-zero positive value is returned when no timeout value is specified.
On success with a timeout value specified, zero is returned if no data was available to read, or if a non-blocked signal was caught. In the latter case, the global errno value will be set to EINTR.
ERRORS
On error, a descriptive error message will be available via the ipq_errstr function.DIAGNOSTICS
While the ipq_read function may return successfully, the queue message copied to the buffer may itself be an error message from a higher level kernel component. Use ipq_message_type to determine if it is an error message, and ipq_get_msgerr to access the value of the message.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.
CREDITS
Joost Remijn implemented the timeout feature, which appeared in the 1.2.4 release of iptables.SEE ALSO
iptables(8), libipq(3), select(2).Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre