OSDN Git Service

014cd76b9e14f8e8dab30ef8b24613e1d4a19213
[linuxjm/iptables.git] / po4a / man3 / ipq_set_mode.3.ja.po
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.
5 #
6 #, fuzzy
7 msgid ""
8 msgstr ""
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"
14 "Language: \n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
18
19 #. type: TH
20 #, no-wrap
21 msgid "IPQ_SET_MODE"
22 msgstr ""
23
24 #. type: TH
25 #, no-wrap
26 msgid "16 October 2001"
27 msgstr ""
28
29 #. type: TH
30 #, no-wrap
31 msgid "Linux iptables 1.2"
32 msgstr ""
33
34 #. type: TH
35 #, no-wrap
36 msgid "Linux Programmer's Manual"
37 msgstr ""
38
39 #
40 #
41 #
42 #
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.
55 #. type: SH
56 #, no-wrap
57 msgid "NAME"
58 msgstr ""
59
60 #. type: Plain text
61 msgid "ipq_set_mode \\(em set the ip_queue queuing mode"
62 msgstr ""
63
64 #. type: SH
65 #, no-wrap
66 msgid "SYNOPSIS"
67 msgstr ""
68
69 #. type: Plain text
70 msgid "B<#include E<lt>linux/netfilter.hE<gt>>"
71 msgstr ""
72
73 #. type: Plain text
74 msgid "B<#include E<lt>libipq.hE<gt>>"
75 msgstr ""
76
77 #. type: Plain text
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<);>"
79 msgstr ""
80
81 #. type: SH
82 #, no-wrap
83 msgid "DESCRIPTION"
84 msgstr ""
85
86 #. type: Plain text
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."
88 msgstr ""
89
90 #. type: Plain text
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>."
92 msgstr ""
93
94 #. type: Plain text
95 msgid "The I<mode> parameter must be one of:"
96 msgstr ""
97
98 #. type: TP
99 #, no-wrap
100 msgid "B<IPQ_COPY_META>"
101 msgstr ""
102
103 #. type: Plain text
104 msgid "Copy only packet metadata to userspace."
105 msgstr ""
106
107 #. type: TP
108 #, no-wrap
109 msgid "B<IPQ_COPY_PACKET>"
110 msgstr ""
111
112 #. type: Plain text
113 msgid "Copy packet metadata and packet payloads to userspace."
114 msgstr ""
115
116 #. type: Plain text
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)."
118 msgstr ""
119
120 #. type: Plain text
121 msgid "B<ipq_set_mode> is usually used immediately following B<ipq_create_handle> to enable the flow of packets to userspace."
122 msgstr ""
123
124 #. type: Plain text
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."
126 msgstr ""
127
128 #. type: SH
129 #, no-wrap
130 msgid "RETURN VALUE"
131 msgstr ""
132
133 #. type: Plain text
134 msgid "On failure, -1 is returned."
135 msgstr ""
136
137 #. type: Plain text
138 msgid "On success, a non-zero positive value is returned."
139 msgstr ""
140
141 #. type: SH
142 #, no-wrap
143 msgid "ERRORS"
144 msgstr ""
145
146 #. type: Plain text
147 msgid "On failure, a descriptive error message will be available via the B<ipq_errstr> function."
148 msgstr ""
149
150 #. type: SH
151 #, no-wrap
152 msgid "DIAGNOSTICS"
153 msgstr ""
154
155 #. type: Plain text
156 msgid "A relatively common failure may occur if the ip_queue module is not loaded.  In this case, the following code excerpt:"
157 msgstr ""
158
159 #. type: Plain text
160 #, no-wrap
161 msgid ""
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"
166 "\texit(1);\n"
167 "}\n"
168 msgstr ""
169
170 #. type: Plain text
171 msgid "would generate the following output:"
172 msgstr ""
173
174 #. type: Plain text
175 msgid "I<myapp: Failed to send netlink message: Connection refused>"
176 msgstr ""
177
178 #. type: SH
179 #, no-wrap
180 msgid "BUGS"
181 msgstr ""
182
183 #. type: Plain text
184 msgid "None known."
185 msgstr ""
186
187 #. type: SH
188 #, no-wrap
189 msgid "AUTHOR"
190 msgstr ""
191
192 #. type: Plain text
193 msgid "James Morris E<lt>jmorris@intercode.com.auE<gt>"
194 msgstr ""
195
196 #. type: SH
197 #, no-wrap
198 msgid "COPYRIGHT"
199 msgstr ""
200
201 #. type: Plain text
202 msgid "Copyright (c) 2000-2001 Netfilter Core Team."
203 msgstr ""
204
205 #. type: Plain text
206 msgid "Distributed under the GNU General Public License."
207 msgstr ""
208
209 #. type: SH
210 #, no-wrap
211 msgid "SEE ALSO"
212 msgstr ""
213
214 #. type: Plain text
215 msgid "B<libipq>(3), B<iptables>(8)."
216 msgstr ""