From patchwork Sun Jan 13 22:49:35 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: [libnetfilter_queue,1/2] doxygen: improve fail-open documentation. Date: Sun, 13 Jan 2013 12:49:35 -0000 From: Eric Leblond X-Patchwork-Id: 211660 Message-Id: <1358117376-7522-1-git-send-email-eric@regit.org> To: netfilter@vger.kernel.org Cc: netfilter-devel@vger.kernel.org, pablo@netfilter.org, Eric Leblond --- src/libnetfilter_queue.c | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/src/libnetfilter_queue.c b/src/libnetfilter_queue.c index 9fe9dfa..f93ac66 100644 --- a/src/libnetfilter_queue.c +++ b/src/libnetfilter_queue.c @@ -87,6 +87,8 @@ * (requires Linux kernel >= 2.6.30). * - see --queue-balance option in NFQUEUE target for multi-threaded apps * (it requires Linux kernel >= 2.6.31). + * - consider using fail-open option see nfq_set_queue_flags() (it requires + * Linux kernel >= 3.6) */ struct nfq_handle @@ -620,6 +622,12 @@ int nfq_set_mode(struct nfq_q_handle *qh, flags &= ~NFQA_CFG_F_FAIL_OPEN; err = nfq_set_queue_flags(qh, mask, flags); \endverbatim + * + * If NFQA_CFG_F_FAIL_OPEN is used, the kernel will accept instead of + * drop packets that should have been enqueued to a full queue. This + * results in the system being able to handle high network load but at + * the depend of the control on the packets. + * * \return -1 on error with errno set appropriately; =0 otherwise. */ int nfq_set_queue_flags(struct nfq_q_handle *qh,