1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
9 "Project-Id-Version: PACKAGE VERSION\n"
10 "POT-Creation-Date: 2013-04-08 14:07+0900\n"
11 "PO-Revision-Date: 2013-04-08 14:29+0900\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
26 msgid "16 October 2001"
31 msgid "Linux iptables 1.2"
36 msgid "Linux Programmer's Manual"
43 #. Copyright (c) 2000-2001 Netfilter Core Team
44 #. This program is free software; you can redistribute it and/or modify
45 #. it under the terms of the GNU General Public License as published by
46 #. the Free Software Foundation; either version 2 of the License, or
47 #. (at your option) any later version.
48 #. This program is distributed in the hope that it will be useful,
49 #. but WITHOUT ANY WARRANTY; without even the implied warranty of
50 #. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
51 #. GNU General Public License for more details.
52 #. You should have received a copy of the GNU General Public License
53 #. along with this program; if not, write to the Free Software
54 #. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
61 msgid "ipq_set_mode \\(em set the ip_queue queuing mode"
70 msgid "B<#include E<lt>linux/netfilter.hE<gt>>"
74 msgid "B<#include E<lt>libipq.hE<gt>>"
78 msgid "B<int ipq_set_mode(const struct ipq_handle *>I<h>B<, u_int8_t >I<mode>B<, size_t >I<range>B<);>"
87 msgid "The B<ipq_set_mode> function sends a message to the kernel ip_queue module, specifying whether packet metadata only, or packet payloads as well as metadata should be copied to userspace."
91 msgid "The I<h> parameter is a context handle which must previously have been returned successfully from a call to B<ipq_create_handle>."
95 msgid "The I<mode> parameter must be one of:"
100 msgid "B<IPQ_COPY_META>"
104 msgid "Copy only packet metadata to userspace."
109 msgid "B<IPQ_COPY_PACKET>"
113 msgid "Copy packet metadata and packet payloads to userspace."
117 msgid "The I<range> parameter is used to specify how many bytes of the payload to copy to userspace. It is only valid for B<IPQ_COPY_PACKET> mode and is otherwise ignored. The maximum useful value for I<range> is 65535 (greater values will be clamped to this by ip_queue)."
121 msgid "B<ipq_set_mode> is usually used immediately following B<ipq_create_handle> to enable the flow of packets to userspace."
125 msgid "Note that as the underlying Netlink messaging transport is connectionless, the ip_queue module does not know that a userspace application is ready to communicate until it receives a message such as this."
134 msgid "On failure, -1 is returned."
138 msgid "On success, a non-zero positive value is returned."
147 msgid "On failure, a descriptive error message will be available via the B<ipq_errstr> function."
156 msgid "A relatively common failure may occur if the ip_queue module is not loaded. In this case, the following code excerpt:"
162 "status = ipq_set_mode(h, IPQ_COPY_META, 0);\n"
163 "if (status E<lt> 0) {\n"
164 "\tipq_perror(\"myapp\");\n"
165 "\tipq_destroy_handle(h);\n"
171 msgid "would generate the following output:"
175 msgid "I<myapp: Failed to send netlink message: Connection refused>"
193 msgid "James Morris E<lt>jmorris@intercode.com.auE<gt>"
202 msgid "Copyright (c) 2000-2001 Netfilter Core Team."
206 msgid "Distributed under the GNU General Public License."
215 msgid "B<libipq>(3), B<iptables>(8)."