The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

ipq_read (3)
  • >> ipq_read (3) ( Linux man: Библиотечные вызовы )
  •  

    NAME

    ipq_read - read queue messages from ip_queue and read into supplied buffer
     
    

    SYNOPSIS

    #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 <[email protected]>  

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


     

    Index

    NAME
    SYNOPSIS
    DESCRIPTION
    RETURN VALUE
    ERRORS
    DIAGNOSTICS
    BUGS
    AUTHOR
    COPYRIGHT
    CREDITS
    SEE ALSO


    Поиск по тексту MAN-ов: 




    Партнёры:
    PostgresPro
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2024 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру