diff options
author | Linus Torvalds <torvalds@linux-foundation.org> | 2010-10-23 14:47:02 -0400 |
---|---|---|
committer | Linus Torvalds <torvalds@linux-foundation.org> | 2010-10-23 14:47:02 -0400 |
commit | 5f05647dd81c11a6a165ccc8f0c1370b16f3bcb0 (patch) | |
tree | 7851ef1c93aa1aba7ef327ca4b75fd35e6d10f29 /Documentation | |
parent | 02f36038c568111ad4fc433f6fa760ff5e38fab4 (diff) | |
parent | ec37a48d1d16c30b655ac5280209edf52a6775d4 (diff) |
Merge git://git.kernel.org/pub/scm/linux/kernel/git/davem/net-next-2.6
* git://git.kernel.org/pub/scm/linux/kernel/git/davem/net-next-2.6: (1699 commits)
bnx2/bnx2x: Unsupported Ethtool operations should return -EINVAL.
vlan: Calling vlan_hwaccel_do_receive() is always valid.
tproxy: use the interface primary IP address as a default value for --on-ip
tproxy: added IPv6 support to the socket match
cxgb3: function namespace cleanup
tproxy: added IPv6 support to the TPROXY target
tproxy: added IPv6 socket lookup function to nf_tproxy_core
be2net: Changes to use only priority codes allowed by f/w
tproxy: allow non-local binds of IPv6 sockets if IP_TRANSPARENT is enabled
tproxy: added tproxy sockopt interface in the IPV6 layer
tproxy: added udp6_lib_lookup function
tproxy: added const specifiers to udp lookup functions
tproxy: split off ipv6 defragmentation to a separate module
l2tp: small cleanup
nf_nat: restrict ICMP translation for embedded header
can: mcp251x: fix generation of error frames
can: mcp251x: fix endless loop in interrupt handler if CANINTF_MERRF is set
can-raw: add msg_flags to distinguish local traffic
9p: client code cleanup
rds: make local functions/variables static
...
Fix up conflicts in net/core/dev.c, drivers/net/pcmcia/smc91c92_cs.c and
drivers/net/wireless/ath/ath9k/debug.c as per David
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/DocBook/80211.tmpl | 495 | ||||
-rw-r--r-- | Documentation/DocBook/Makefile | 2 | ||||
-rw-r--r-- | Documentation/DocBook/mac80211.tmpl | 337 | ||||
-rw-r--r-- | Documentation/feature-removal-schedule.txt | 9 | ||||
-rw-r--r-- | Documentation/networking/bonding.txt | 8 | ||||
-rw-r--r-- | Documentation/networking/can.txt | 12 | ||||
-rw-r--r-- | Documentation/networking/dccp.txt | 29 | ||||
-rw-r--r-- | Documentation/networking/ip-sysctl.txt | 27 | ||||
-rw-r--r-- | Documentation/networking/phonet.txt | 56 | ||||
-rw-r--r-- | Documentation/networking/timestamping.txt | 22 |
10 files changed, 639 insertions, 358 deletions
diff --git a/Documentation/DocBook/80211.tmpl b/Documentation/DocBook/80211.tmpl new file mode 100644 index 000000000000..19a1210c2530 --- /dev/null +++ b/Documentation/DocBook/80211.tmpl | |||
@@ -0,0 +1,495 @@ | |||
1 | <?xml version="1.0" encoding="UTF-8"?> | ||
2 | <!DOCTYPE set PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" | ||
3 | "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" []> | ||
4 | <set> | ||
5 | <setinfo> | ||
6 | <title>The 802.11 subsystems – for kernel developers</title> | ||
7 | <subtitle> | ||
8 | Explaining wireless 802.11 networking in the Linux kernel | ||
9 | </subtitle> | ||
10 | |||
11 | <copyright> | ||
12 | <year>2007-2009</year> | ||
13 | <holder>Johannes Berg</holder> | ||
14 | </copyright> | ||
15 | |||
16 | <authorgroup> | ||
17 | <author> | ||
18 | <firstname>Johannes</firstname> | ||
19 | <surname>Berg</surname> | ||
20 | <affiliation> | ||
21 | <address><email>johannes@sipsolutions.net</email></address> | ||
22 | </affiliation> | ||
23 | </author> | ||
24 | </authorgroup> | ||
25 | |||
26 | <legalnotice> | ||
27 | <para> | ||
28 | This documentation is free software; you can redistribute | ||
29 | it and/or modify it under the terms of the GNU General Public | ||
30 | License version 2 as published by the Free Software Foundation. | ||
31 | </para> | ||
32 | <para> | ||
33 | This documentation is distributed in the hope that it will be | ||
34 | useful, but WITHOUT ANY WARRANTY; without even the implied | ||
35 | warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | ||
36 | See the GNU General Public License for more details. | ||
37 | </para> | ||
38 | <para> | ||
39 | You should have received a copy of the GNU General Public | ||
40 | License along with this documentation; if not, write to the Free | ||
41 | Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, | ||
42 | MA 02111-1307 USA | ||
43 | </para> | ||
44 | <para> | ||
45 | For more details see the file COPYING in the source | ||
46 | distribution of Linux. | ||
47 | </para> | ||
48 | </legalnotice> | ||
49 | |||
50 | <abstract> | ||
51 | <para> | ||
52 | These books attempt to give a description of the | ||
53 | various subsystems that play a role in 802.11 wireless | ||
54 | networking in Linux. Since these books are for kernel | ||
55 | developers they attempts to document the structures | ||
56 | and functions used in the kernel as well as giving a | ||
57 | higher-level overview. | ||
58 | </para> | ||
59 | <para> | ||
60 | The reader is expected to be familiar with the 802.11 | ||
61 | standard as published by the IEEE in 802.11-2007 (or | ||
62 | possibly later versions). References to this standard | ||
63 | will be given as "802.11-2007 8.1.5". | ||
64 | </para> | ||
65 | </abstract> | ||
66 | </setinfo> | ||
67 | <book id="cfg80211-developers-guide"> | ||
68 | <bookinfo> | ||
69 | <title>The cfg80211 subsystem</title> | ||
70 | |||
71 | <abstract> | ||
72 | !Pinclude/net/cfg80211.h Introduction | ||
73 | </abstract> | ||
74 | </bookinfo> | ||
75 | <chapter> | ||
76 | <title>Device registration</title> | ||
77 | !Pinclude/net/cfg80211.h Device registration | ||
78 | !Finclude/net/cfg80211.h ieee80211_band | ||
79 | !Finclude/net/cfg80211.h ieee80211_channel_flags | ||
80 | !Finclude/net/cfg80211.h ieee80211_channel | ||
81 | !Finclude/net/cfg80211.h ieee80211_rate_flags | ||
82 | !Finclude/net/cfg80211.h ieee80211_rate | ||
83 | !Finclude/net/cfg80211.h ieee80211_sta_ht_cap | ||
84 | !Finclude/net/cfg80211.h ieee80211_supported_band | ||
85 | !Finclude/net/cfg80211.h cfg80211_signal_type | ||
86 | !Finclude/net/cfg80211.h wiphy_params_flags | ||
87 | !Finclude/net/cfg80211.h wiphy_flags | ||
88 | !Finclude/net/cfg80211.h wiphy | ||
89 | !Finclude/net/cfg80211.h wireless_dev | ||
90 | !Finclude/net/cfg80211.h wiphy_new | ||
91 | !Finclude/net/cfg80211.h wiphy_register | ||
92 | !Finclude/net/cfg80211.h wiphy_unregister | ||
93 | !Finclude/net/cfg80211.h wiphy_free | ||
94 | |||
95 | !Finclude/net/cfg80211.h wiphy_name | ||
96 | !Finclude/net/cfg80211.h wiphy_dev | ||
97 | !Finclude/net/cfg80211.h wiphy_priv | ||
98 | !Finclude/net/cfg80211.h priv_to_wiphy | ||
99 | !Finclude/net/cfg80211.h set_wiphy_dev | ||
100 | !Finclude/net/cfg80211.h wdev_priv | ||
101 | </chapter> | ||
102 | <chapter> | ||
103 | <title>Actions and configuration</title> | ||
104 | !Pinclude/net/cfg80211.h Actions and configuration | ||
105 | !Finclude/net/cfg80211.h cfg80211_ops | ||
106 | !Finclude/net/cfg80211.h vif_params | ||
107 | !Finclude/net/cfg80211.h key_params | ||
108 | !Finclude/net/cfg80211.h survey_info_flags | ||
109 | !Finclude/net/cfg80211.h survey_info | ||
110 | !Finclude/net/cfg80211.h beacon_parameters | ||
111 | !Finclude/net/cfg80211.h plink_actions | ||
112 | !Finclude/net/cfg80211.h station_parameters | ||
113 | !Finclude/net/cfg80211.h station_info_flags | ||
114 | !Finclude/net/cfg80211.h rate_info_flags | ||
115 | !Finclude/net/cfg80211.h rate_info | ||
116 | !Finclude/net/cfg80211.h station_info | ||
117 | !Finclude/net/cfg80211.h monitor_flags | ||
118 | !Finclude/net/cfg80211.h mpath_info_flags | ||
119 | !Finclude/net/cfg80211.h mpath_info | ||
120 | !Finclude/net/cfg80211.h bss_parameters | ||
121 | !Finclude/net/cfg80211.h ieee80211_txq_params | ||
122 | !Finclude/net/cfg80211.h cfg80211_crypto_settings | ||
123 | !Finclude/net/cfg80211.h cfg80211_auth_request | ||
124 | !Finclude/net/cfg80211.h cfg80211_assoc_request | ||
125 | !Finclude/net/cfg80211.h cfg80211_deauth_request | ||
126 | !Finclude/net/cfg80211.h cfg80211_disassoc_request | ||
127 | !Finclude/net/cfg80211.h cfg80211_ibss_params | ||
128 | !Finclude/net/cfg80211.h cfg80211_connect_params | ||
129 | !Finclude/net/cfg80211.h cfg80211_pmksa | ||
130 | !Finclude/net/cfg80211.h cfg80211_send_rx_auth | ||
131 | !Finclude/net/cfg80211.h cfg80211_send_auth_timeout | ||
132 | !Finclude/net/cfg80211.h __cfg80211_auth_canceled | ||
133 | !Finclude/net/cfg80211.h cfg80211_send_rx_assoc | ||
134 | !Finclude/net/cfg80211.h cfg80211_send_assoc_timeout | ||
135 | !Finclude/net/cfg80211.h cfg80211_send_deauth | ||
136 | !Finclude/net/cfg80211.h __cfg80211_send_deauth | ||
137 | !Finclude/net/cfg80211.h cfg80211_send_disassoc | ||
138 | !Finclude/net/cfg80211.h __cfg80211_send_disassoc | ||
139 | !Finclude/net/cfg80211.h cfg80211_ibss_joined | ||
140 | !Finclude/net/cfg80211.h cfg80211_connect_result | ||
141 | !Finclude/net/cfg80211.h cfg80211_roamed | ||
142 | !Finclude/net/cfg80211.h cfg80211_disconnected | ||
143 | !Finclude/net/cfg80211.h cfg80211_ready_on_channel | ||
144 | !Finclude/net/cfg80211.h cfg80211_remain_on_channel_expired | ||
145 | !Finclude/net/cfg80211.h cfg80211_new_sta | ||
146 | !Finclude/net/cfg80211.h cfg80211_rx_mgmt | ||
147 | !Finclude/net/cfg80211.h cfg80211_mgmt_tx_status | ||
148 | !Finclude/net/cfg80211.h cfg80211_cqm_rssi_notify | ||
149 | !Finclude/net/cfg80211.h cfg80211_michael_mic_failure | ||
150 | </chapter> | ||
151 | <chapter> | ||
152 | <title>Scanning and BSS list handling</title> | ||
153 | !Pinclude/net/cfg80211.h Scanning and BSS list handling | ||
154 | !Finclude/net/cfg80211.h cfg80211_ssid | ||
155 | !Finclude/net/cfg80211.h cfg80211_scan_request | ||
156 | !Finclude/net/cfg80211.h cfg80211_scan_done | ||
157 | !Finclude/net/cfg80211.h cfg80211_bss | ||
158 | !Finclude/net/cfg80211.h cfg80211_inform_bss_frame | ||
159 | !Finclude/net/cfg80211.h cfg80211_inform_bss | ||
160 | !Finclude/net/cfg80211.h cfg80211_unlink_bss | ||
161 | !Finclude/net/cfg80211.h cfg80211_find_ie | ||
162 | !Finclude/net/cfg80211.h ieee80211_bss_get_ie | ||
163 | </chapter> | ||
164 | <chapter> | ||
165 | <title>Utility functions</title> | ||
166 | !Pinclude/net/cfg80211.h Utility functions | ||
167 | !Finclude/net/cfg80211.h ieee80211_channel_to_frequency | ||
168 | !Finclude/net/cfg80211.h ieee80211_frequency_to_channel | ||
169 | !Finclude/net/cfg80211.h ieee80211_get_channel | ||
170 | !Finclude/net/cfg80211.h ieee80211_get_response_rate | ||
171 | !Finclude/net/cfg80211.h ieee80211_hdrlen | ||
172 | !Finclude/net/cfg80211.h ieee80211_get_hdrlen_from_skb | ||
173 | !Finclude/net/cfg80211.h ieee80211_radiotap_iterator | ||
174 | </chapter> | ||
175 | <chapter> | ||
176 | <title>Data path helpers</title> | ||
177 | !Pinclude/net/cfg80211.h Data path helpers | ||
178 | !Finclude/net/cfg80211.h ieee80211_data_to_8023 | ||
179 | !Finclude/net/cfg80211.h ieee80211_data_from_8023 | ||
180 | !Finclude/net/cfg80211.h ieee80211_amsdu_to_8023s | ||
181 | !Finclude/net/cfg80211.h cfg80211_classify8021d | ||
182 | </chapter> | ||
183 | <chapter> | ||
184 | <title>Regulatory enforcement infrastructure</title> | ||
185 | !Pinclude/net/cfg80211.h Regulatory enforcement infrastructure | ||
186 | !Finclude/net/cfg80211.h regulatory_hint | ||
187 | !Finclude/net/cfg80211.h wiphy_apply_custom_regulatory | ||
188 | !Finclude/net/cfg80211.h freq_reg_info | ||
189 | </chapter> | ||
190 | <chapter> | ||
191 | <title>RFkill integration</title> | ||
192 | !Pinclude/net/cfg80211.h RFkill integration | ||
193 | !Finclude/net/cfg80211.h wiphy_rfkill_set_hw_state | ||
194 | !Finclude/net/cfg80211.h wiphy_rfkill_start_polling | ||
195 | !Finclude/net/cfg80211.h wiphy_rfkill_stop_polling | ||
196 | </chapter> | ||
197 | <chapter> | ||
198 | <title>Test mode</title> | ||
199 | !Pinclude/net/cfg80211.h Test mode | ||
200 | !Finclude/net/cfg80211.h cfg80211_testmode_alloc_reply_skb | ||
201 | !Finclude/net/cfg80211.h cfg80211_testmode_reply | ||
202 | !Finclude/net/cfg80211.h cfg80211_testmode_alloc_event_skb | ||
203 | !Finclude/net/cfg80211.h cfg80211_testmode_event | ||
204 | </chapter> | ||
205 | </book> | ||
206 | <book id="mac80211-developers-guide"> | ||
207 | <bookinfo> | ||
208 | <title>The mac80211 subsystem</title> | ||
209 | <abstract> | ||
210 | !Pinclude/net/mac80211.h Introduction | ||
211 | !Pinclude/net/mac80211.h Warning | ||
212 | </abstract> | ||
213 | </bookinfo> | ||
214 | |||
215 | <toc></toc> | ||
216 | |||
217 | <!-- | ||
218 | Generally, this document shall be ordered by increasing complexity. | ||
219 | It is important to note that readers should be able to read only | ||
220 | the first few sections to get a working driver and only advanced | ||
221 | usage should require reading the full document. | ||
222 | --> | ||
223 | |||
224 | <part> | ||
225 | <title>The basic mac80211 driver interface</title> | ||
226 | <partintro> | ||
227 | <para> | ||
228 | You should read and understand the information contained | ||
229 | within this part of the book while implementing a driver. | ||
230 | In some chapters, advanced usage is noted, that may be | ||
231 | skipped at first. | ||
232 | </para> | ||
233 | <para> | ||
234 | This part of the book only covers station and monitor mode | ||
235 | functionality, additional information required to implement | ||
236 | the other modes is covered in the second part of the book. | ||
237 | </para> | ||
238 | </partintro> | ||
239 | |||
240 | <chapter id="basics"> | ||
241 | <title>Basic hardware handling</title> | ||
242 | <para>TBD</para> | ||
243 | <para> | ||
244 | This chapter shall contain information on getting a hw | ||
245 | struct allocated and registered with mac80211. | ||
246 | </para> | ||
247 | <para> | ||
248 | Since it is required to allocate rates/modes before registering | ||
249 | a hw struct, this chapter shall also contain information on setting | ||
250 | up the rate/mode structs. | ||
251 | </para> | ||
252 | <para> | ||
253 | Additionally, some discussion about the callbacks and | ||
254 | the general programming model should be in here, including | ||
255 | the definition of ieee80211_ops which will be referred to | ||
256 | a lot. | ||
257 | </para> | ||
258 | <para> | ||
259 | Finally, a discussion of hardware capabilities should be done | ||
260 | with references to other parts of the book. | ||
261 | </para> | ||
262 | <!-- intentionally multiple !F lines to get proper order --> | ||
263 | !Finclude/net/mac80211.h ieee80211_hw | ||
264 | !Finclude/net/mac80211.h ieee80211_hw_flags | ||
265 | !Finclude/net/mac80211.h SET_IEEE80211_DEV | ||
266 | !Finclude/net/mac80211.h SET_IEEE80211_PERM_ADDR | ||
267 | !Finclude/net/mac80211.h ieee80211_ops | ||
268 | !Finclude/net/mac80211.h ieee80211_alloc_hw | ||
269 | !Finclude/net/mac80211.h ieee80211_register_hw | ||
270 | !Finclude/net/mac80211.h ieee80211_get_tx_led_name | ||
271 | !Finclude/net/mac80211.h ieee80211_get_rx_led_name | ||
272 | !Finclude/net/mac80211.h ieee80211_get_assoc_led_name | ||
273 | !Finclude/net/mac80211.h ieee80211_get_radio_led_name | ||
274 | !Finclude/net/mac80211.h ieee80211_unregister_hw | ||
275 | !Finclude/net/mac80211.h ieee80211_free_hw | ||
276 | </chapter> | ||
277 | |||
278 | <chapter id="phy-handling"> | ||
279 | <title>PHY configuration</title> | ||
280 | <para>TBD</para> | ||
281 | <para> | ||
282 | This chapter should describe PHY handling including | ||
283 | start/stop callbacks and the various structures used. | ||
284 | </para> | ||
285 | !Finclude/net/mac80211.h ieee80211_conf | ||
286 | !Finclude/net/mac80211.h ieee80211_conf_flags | ||
287 | </chapter> | ||
288 | |||
289 | <chapter id="iface-handling"> | ||
290 | <title>Virtual interfaces</title> | ||
291 | <para>TBD</para> | ||
292 | <para> | ||
293 | This chapter should describe virtual interface basics | ||
294 | that are relevant to the driver (VLANs, MGMT etc are not.) | ||
295 | It should explain the use of the add_iface/remove_iface | ||
296 | callbacks as well as the interface configuration callbacks. | ||
297 | </para> | ||
298 | <para>Things related to AP mode should be discussed there.</para> | ||
299 | <para> | ||
300 | Things related to supporting multiple interfaces should be | ||
301 | in the appropriate chapter, a BIG FAT note should be here about | ||
302 | this though and the recommendation to allow only a single | ||
303 | interface in STA mode at first! | ||
304 | </para> | ||
305 | !Finclude/net/mac80211.h ieee80211_vif | ||
306 | </chapter> | ||
307 | |||
308 | <chapter id="rx-tx"> | ||
309 | <title>Receive and transmit processing</title> | ||
310 | <sect1> | ||
311 | <title>what should be here</title> | ||
312 | <para>TBD</para> | ||
313 | <para> | ||
314 | This should describe the receive and transmit | ||
315 | paths in mac80211/the drivers as well as | ||
316 | transmit status handling. | ||
317 | </para> | ||
318 | </sect1> | ||
319 | <sect1> | ||
320 | <title>Frame format</title> | ||
321 | !Pinclude/net/mac80211.h Frame format | ||
322 | </sect1> | ||
323 | <sect1> | ||
324 | <title>Packet alignment</title> | ||
325 | !Pnet/mac80211/rx.c Packet alignment | ||
326 | </sect1> | ||
327 | <sect1> | ||
328 | <title>Calling into mac80211 from interrupts</title> | ||
329 | !Pinclude/net/mac80211.h Calling mac80211 from interrupts | ||
330 | </sect1> | ||
331 | <sect1> | ||
332 | <title>functions/definitions</title> | ||
333 | !Finclude/net/mac80211.h ieee80211_rx_status | ||
334 | !Finclude/net/mac80211.h mac80211_rx_flags | ||
335 | !Finclude/net/mac80211.h ieee80211_tx_info | ||
336 | !Finclude/net/mac80211.h ieee80211_rx | ||
337 | !Finclude/net/mac80211.h ieee80211_rx_irqsafe | ||
338 | !Finclude/net/mac80211.h ieee80211_tx_status | ||
339 | !Finclude/net/mac80211.h ieee80211_tx_status_irqsafe | ||
340 | !Finclude/net/mac80211.h ieee80211_rts_get | ||
341 | !Finclude/net/mac80211.h ieee80211_rts_duration | ||
342 | !Finclude/net/mac80211.h ieee80211_ctstoself_get | ||
343 | !Finclude/net/mac80211.h ieee80211_ctstoself_duration | ||
344 | !Finclude/net/mac80211.h ieee80211_generic_frame_duration | ||
345 | !Finclude/net/mac80211.h ieee80211_wake_queue | ||
346 | !Finclude/net/mac80211.h ieee80211_stop_queue | ||
347 | !Finclude/net/mac80211.h ieee80211_wake_queues | ||
348 | !Finclude/net/mac80211.h ieee80211_stop_queues | ||
349 | </sect1> | ||
350 | </chapter> | ||
351 | |||
352 | <chapter id="filters"> | ||
353 | <title>Frame filtering</title> | ||
354 | !Pinclude/net/mac80211.h Frame filtering | ||
355 | !Finclude/net/mac80211.h ieee80211_filter_flags | ||
356 | </chapter> | ||
357 | </part> | ||
358 | |||
359 | <part id="advanced"> | ||
360 | <title>Advanced driver interface</title> | ||
361 | <partintro> | ||
362 | <para> | ||
363 | Information contained within this part of the book is | ||
364 | of interest only for advanced interaction of mac80211 | ||
365 | with drivers to exploit more hardware capabilities and | ||
366 | improve performance. | ||
367 | </para> | ||
368 | </partintro> | ||
369 | |||
370 | <chapter id="hardware-crypto-offload"> | ||
371 | <title>Hardware crypto acceleration</title> | ||
372 | !Pinclude/net/mac80211.h Hardware crypto acceleration | ||
373 | <!-- intentionally multiple !F lines to get proper order --> | ||
374 | !Finclude/net/mac80211.h set_key_cmd | ||
375 | !Finclude/net/mac80211.h ieee80211_key_conf | ||
376 | !Finclude/net/mac80211.h ieee80211_key_flags | ||
377 | </chapter> | ||
378 | |||
379 | <chapter id="powersave"> | ||
380 | <title>Powersave support</title> | ||
381 | !Pinclude/net/mac80211.h Powersave support | ||
382 | </chapter> | ||
383 | |||
384 | <chapter id="beacon-filter"> | ||
385 | <title>Beacon filter support</title> | ||
386 | !Pinclude/net/mac80211.h Beacon filter support | ||
387 | !Finclude/net/mac80211.h ieee80211_beacon_loss | ||
388 | </chapter> | ||
389 | |||
390 | <chapter id="qos"> | ||
391 | <title>Multiple queues and QoS support</title> | ||
392 | <para>TBD</para> | ||
393 | !Finclude/net/mac80211.h ieee80211_tx_queue_params | ||
394 | </chapter> | ||
395 | |||
396 | <chapter id="AP"> | ||
397 | <title>Access point mode support</title> | ||
398 | <para>TBD</para> | ||
399 | <para>Some parts of the if_conf should be discussed here instead</para> | ||
400 | <para> | ||
401 | Insert notes about VLAN interfaces with hw crypto here or | ||
402 | in the hw crypto chapter. | ||
403 | </para> | ||
404 | !Finclude/net/mac80211.h ieee80211_get_buffered_bc | ||
405 | !Finclude/net/mac80211.h ieee80211_beacon_get | ||
406 | </chapter> | ||
407 | |||
408 | <chapter id="multi-iface"> | ||
409 | <title>Supporting multiple virtual interfaces</title> | ||
410 | <para>TBD</para> | ||
411 | <para> | ||
412 | Note: WDS with identical MAC address should almost always be OK | ||
413 | </para> | ||
414 | <para> | ||
415 | Insert notes about having multiple virtual interfaces with | ||
416 | different MAC addresses here, note which configurations are | ||
417 | supported by mac80211, add notes about supporting hw crypto | ||
418 | with it. | ||
419 | </para> | ||
420 | </chapter> | ||
421 | |||
422 | <chapter id="hardware-scan-offload"> | ||
423 | <title>Hardware scan offload</title> | ||
424 | <para>TBD</para> | ||
425 | !Finclude/net/mac80211.h ieee80211_scan_completed | ||
426 | </chapter> | ||
427 | </part> | ||
428 | |||
429 | <part id="rate-control"> | ||
430 | <title>Rate control interface</title> | ||
431 | <partintro> | ||
432 | <para>TBD</para> | ||
433 | <para> | ||
434 | This part of the book describes the rate control algorithm | ||
435 | interface and how it relates to mac80211 and drivers. | ||
436 | </para> | ||
437 | </partintro> | ||
438 | <chapter id="dummy"> | ||
439 | <title>dummy chapter</title> | ||
440 | <para>TBD</para> | ||
441 | </chapter> | ||
442 | </part> | ||
443 | |||
444 | <part id="internal"> | ||
445 | <title>Internals</title> | ||
446 | <partintro> | ||
447 | <para>TBD</para> | ||
448 | <para> | ||
449 | This part of the book describes mac80211 internals. | ||
450 | </para> | ||
451 | </partintro> | ||
452 | |||
453 | <chapter id="key-handling"> | ||
454 | <title>Key handling</title> | ||
455 | <sect1> | ||
456 | <title>Key handling basics</title> | ||
457 | !Pnet/mac80211/key.c Key handling basics | ||
458 | </sect1> | ||
459 | <sect1> | ||
460 | <title>MORE TBD</title> | ||
461 | <para>TBD</para> | ||
462 | </sect1> | ||
463 | </chapter> | ||
464 | |||
465 | <chapter id="rx-processing"> | ||
466 | <title>Receive processing</title> | ||
467 | <para>TBD</para> | ||
468 | </chapter> | ||
469 | |||
470 | <chapter id="tx-processing"> | ||
471 | <title>Transmit processing</title> | ||
472 | <para>TBD</para> | ||
473 | </chapter> | ||
474 | |||
475 | <chapter id="sta-info"> | ||
476 | <title>Station info handling</title> | ||
477 | <sect1> | ||
478 | <title>Programming information</title> | ||
479 | !Fnet/mac80211/sta_info.h sta_info | ||
480 | !Fnet/mac80211/sta_info.h ieee80211_sta_info_flags | ||
481 | </sect1> | ||
482 | <sect1> | ||
483 | <title>STA information lifetime rules</title> | ||
484 | !Pnet/mac80211/sta_info.c STA information lifetime rules | ||
485 | </sect1> | ||
486 | </chapter> | ||
487 | |||
488 | <chapter id="synchronisation"> | ||
489 | <title>Synchronisation</title> | ||
490 | <para>TBD</para> | ||
491 | <para>Locking, lots of RCU</para> | ||
492 | </chapter> | ||
493 | </part> | ||
494 | </book> | ||
495 | </set> | ||
diff --git a/Documentation/DocBook/Makefile b/Documentation/DocBook/Makefile index 34929f24c284..8b6e00a71034 100644 --- a/Documentation/DocBook/Makefile +++ b/Documentation/DocBook/Makefile | |||
@@ -12,7 +12,7 @@ DOCBOOKS := z8530book.xml mcabook.xml device-drivers.xml \ | |||
12 | kernel-api.xml filesystems.xml lsm.xml usb.xml kgdb.xml \ | 12 | kernel-api.xml filesystems.xml lsm.xml usb.xml kgdb.xml \ |
13 | gadget.xml libata.xml mtdnand.xml librs.xml rapidio.xml \ | 13 | gadget.xml libata.xml mtdnand.xml librs.xml rapidio.xml \ |
14 | genericirq.xml s390-drivers.xml uio-howto.xml scsi.xml \ | 14 | genericirq.xml s390-drivers.xml uio-howto.xml scsi.xml \ |
15 | mac80211.xml debugobjects.xml sh.xml regulator.xml \ | 15 | 80211.xml debugobjects.xml sh.xml regulator.xml \ |
16 | alsa-driver-api.xml writing-an-alsa-driver.xml \ | 16 | alsa-driver-api.xml writing-an-alsa-driver.xml \ |
17 | tracepoint.xml media.xml drm.xml | 17 | tracepoint.xml media.xml drm.xml |
18 | 18 | ||
diff --git a/Documentation/DocBook/mac80211.tmpl b/Documentation/DocBook/mac80211.tmpl deleted file mode 100644 index affb15a344a1..000000000000 --- a/Documentation/DocBook/mac80211.tmpl +++ /dev/null | |||
@@ -1,337 +0,0 @@ | |||
1 | <?xml version="1.0" encoding="UTF-8"?> | ||
2 | <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" | ||
3 | "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" []> | ||
4 | |||
5 | <book id="mac80211-developers-guide"> | ||
6 | <bookinfo> | ||
7 | <title>The mac80211 subsystem for kernel developers</title> | ||
8 | |||
9 | <authorgroup> | ||
10 | <author> | ||
11 | <firstname>Johannes</firstname> | ||
12 | <surname>Berg</surname> | ||
13 | <affiliation> | ||
14 | <address><email>johannes@sipsolutions.net</email></address> | ||
15 | </affiliation> | ||
16 | </author> | ||
17 | </authorgroup> | ||
18 | |||
19 | <copyright> | ||
20 | <year>2007-2009</year> | ||
21 | <holder>Johannes Berg</holder> | ||
22 | </copyright> | ||
23 | |||
24 | <legalnotice> | ||
25 | <para> | ||
26 | This documentation is free software; you can redistribute | ||
27 | it and/or modify it under the terms of the GNU General Public | ||
28 | License version 2 as published by the Free Software Foundation. | ||
29 | </para> | ||
30 | |||
31 | <para> | ||
32 | This documentation is distributed in the hope that it will be | ||
33 | useful, but WITHOUT ANY WARRANTY; without even the implied | ||
34 | warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. | ||
35 | See the GNU General Public License for more details. | ||
36 | </para> | ||
37 | |||
38 | <para> | ||
39 | You should have received a copy of the GNU General Public | ||
40 | License along with this documentation; if not, write to the Free | ||
41 | Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, | ||
42 | MA 02111-1307 USA | ||
43 | </para> | ||
44 | |||
45 | <para> | ||
46 | For more details see the file COPYING in the source | ||
47 | distribution of Linux. | ||
48 | </para> | ||
49 | </legalnotice> | ||
50 | |||
51 | <abstract> | ||
52 | !Pinclude/net/mac80211.h Introduction | ||
53 | !Pinclude/net/mac80211.h Warning | ||
54 | </abstract> | ||
55 | </bookinfo> | ||
56 | |||
57 | <toc></toc> | ||
58 | |||
59 | <!-- | ||
60 | Generally, this document shall be ordered by increasing complexity. | ||
61 | It is important to note that readers should be able to read only | ||
62 | the first few sections to get a working driver and only advanced | ||
63 | usage should require reading the full document. | ||
64 | --> | ||
65 | |||
66 | <part> | ||
67 | <title>The basic mac80211 driver interface</title> | ||
68 | <partintro> | ||
69 | <para> | ||
70 | You should read and understand the information contained | ||
71 | within this part of the book while implementing a driver. | ||
72 | In some chapters, advanced usage is noted, that may be | ||
73 | skipped at first. | ||
74 | </para> | ||
75 | <para> | ||
76 | This part of the book only covers station and monitor mode | ||
77 | functionality, additional information required to implement | ||
78 | the other modes is covered in the second part of the book. | ||
79 | </para> | ||
80 | </partintro> | ||
81 | |||
82 | <chapter id="basics"> | ||
83 | <title>Basic hardware handling</title> | ||
84 | <para>TBD</para> | ||
85 | <para> | ||
86 | This chapter shall contain information on getting a hw | ||
87 | struct allocated and registered with mac80211. | ||
88 | </para> | ||
89 | <para> | ||
90 | Since it is required to allocate rates/modes before registering | ||
91 | a hw struct, this chapter shall also contain information on setting | ||
92 | up the rate/mode structs. | ||
93 | </para> | ||
94 | <para> | ||
95 | Additionally, some discussion about the callbacks and | ||
96 | the general programming model should be in here, including | ||
97 | the definition of ieee80211_ops which will be referred to | ||
98 | a lot. | ||
99 | </para> | ||
100 | <para> | ||
101 | Finally, a discussion of hardware capabilities should be done | ||
102 | with references to other parts of the book. | ||
103 | </para> | ||
104 | <!-- intentionally multiple !F lines to get proper order --> | ||
105 | !Finclude/net/mac80211.h ieee80211_hw | ||
106 | !Finclude/net/mac80211.h ieee80211_hw_flags | ||
107 | !Finclude/net/mac80211.h SET_IEEE80211_DEV | ||
108 | !Finclude/net/mac80211.h SET_IEEE80211_PERM_ADDR | ||
109 | !Finclude/net/mac80211.h ieee80211_ops | ||
110 | !Finclude/net/mac80211.h ieee80211_alloc_hw | ||
111 | !Finclude/net/mac80211.h ieee80211_register_hw | ||
112 | !Finclude/net/mac80211.h ieee80211_get_tx_led_name | ||
113 | !Finclude/net/mac80211.h ieee80211_get_rx_led_name | ||
114 | !Finclude/net/mac80211.h ieee80211_get_assoc_led_name | ||
115 | !Finclude/net/mac80211.h ieee80211_get_radio_led_name | ||
116 | !Finclude/net/mac80211.h ieee80211_unregister_hw | ||
117 | !Finclude/net/mac80211.h ieee80211_free_hw | ||
118 | </chapter> | ||
119 | |||
120 | <chapter id="phy-handling"> | ||
121 | <title>PHY configuration</title> | ||
122 | <para>TBD</para> | ||
123 | <para> | ||
124 | This chapter should describe PHY handling including | ||
125 | start/stop callbacks and the various structures used. | ||
126 | </para> | ||
127 | !Finclude/net/mac80211.h ieee80211_conf | ||
128 | !Finclude/net/mac80211.h ieee80211_conf_flags | ||
129 | </chapter> | ||
130 | |||
131 | <chapter id="iface-handling"> | ||
132 | <title>Virtual interfaces</title> | ||
133 | <para>TBD</para> | ||
134 | <para> | ||
135 | This chapter should describe virtual interface basics | ||
136 | that are relevant to the driver (VLANs, MGMT etc are not.) | ||
137 | It should explain the use of the add_iface/remove_iface | ||
138 | callbacks as well as the interface configuration callbacks. | ||
139 | </para> | ||
140 | <para>Things related to AP mode should be discussed there.</para> | ||
141 | <para> | ||
142 | Things related to supporting multiple interfaces should be | ||
143 | in the appropriate chapter, a BIG FAT note should be here about | ||
144 | this though and the recommendation to allow only a single | ||
145 | interface in STA mode at first! | ||
146 | </para> | ||
147 | !Finclude/net/mac80211.h ieee80211_vif | ||
148 | </chapter> | ||
149 | |||
150 | <chapter id="rx-tx"> | ||
151 | <title>Receive and transmit processing</title> | ||
152 | <sect1> | ||
153 | <title>what should be here</title> | ||
154 | <para>TBD</para> | ||
155 | <para> | ||
156 | This should describe the receive and transmit | ||
157 | paths in mac80211/the drivers as well as | ||
158 | transmit status handling. | ||
159 | </para> | ||
160 | </sect1> | ||
161 | <sect1> | ||
162 | <title>Frame format</title> | ||
163 | !Pinclude/net/mac80211.h Frame format | ||
164 | </sect1> | ||
165 | <sect1> | ||
166 | <title>Packet alignment</title> | ||
167 | !Pnet/mac80211/rx.c Packet alignment | ||
168 | </sect1> | ||
169 | <sect1> | ||
170 | <title>Calling into mac80211 from interrupts</title> | ||
171 | !Pinclude/net/mac80211.h Calling mac80211 from interrupts | ||
172 | </sect1> | ||
173 | <sect1> | ||
174 | <title>functions/definitions</title> | ||
175 | !Finclude/net/mac80211.h ieee80211_rx_status | ||
176 | !Finclude/net/mac80211.h mac80211_rx_flags | ||
177 | !Finclude/net/mac80211.h ieee80211_tx_info | ||
178 | !Finclude/net/mac80211.h ieee80211_rx | ||
179 | !Finclude/net/mac80211.h ieee80211_rx_irqsafe | ||
180 | !Finclude/net/mac80211.h ieee80211_tx_status | ||
181 | !Finclude/net/mac80211.h ieee80211_tx_status_irqsafe | ||
182 | !Finclude/net/mac80211.h ieee80211_rts_get | ||
183 | !Finclude/net/mac80211.h ieee80211_rts_duration | ||
184 | !Finclude/net/mac80211.h ieee80211_ctstoself_get | ||
185 | !Finclude/net/mac80211.h ieee80211_ctstoself_duration | ||
186 | !Finclude/net/mac80211.h ieee80211_generic_frame_duration | ||
187 | !Finclude/net/mac80211.h ieee80211_wake_queue | ||
188 | !Finclude/net/mac80211.h ieee80211_stop_queue | ||
189 | !Finclude/net/mac80211.h ieee80211_wake_queues | ||
190 | !Finclude/net/mac80211.h ieee80211_stop_queues | ||
191 | </sect1> | ||
192 | </chapter> | ||
193 | |||
194 | <chapter id="filters"> | ||
195 | <title>Frame filtering</title> | ||
196 | !Pinclude/net/mac80211.h Frame filtering | ||
197 | !Finclude/net/mac80211.h ieee80211_filter_flags | ||
198 | </chapter> | ||
199 | </part> | ||
200 | |||
201 | <part id="advanced"> | ||
202 | <title>Advanced driver interface</title> | ||
203 | <partintro> | ||
204 | <para> | ||
205 | Information contained within this part of the book is | ||
206 | of interest only for advanced interaction of mac80211 | ||
207 | with drivers to exploit more hardware capabilities and | ||
208 | improve performance. | ||
209 | </para> | ||
210 | </partintro> | ||
211 | |||
212 | <chapter id="hardware-crypto-offload"> | ||
213 | <title>Hardware crypto acceleration</title> | ||
214 | !Pinclude/net/mac80211.h Hardware crypto acceleration | ||
215 | <!-- intentionally multiple !F lines to get proper order --> | ||
216 | !Finclude/net/mac80211.h set_key_cmd | ||
217 | !Finclude/net/mac80211.h ieee80211_key_conf | ||
218 | !Finclude/net/mac80211.h ieee80211_key_alg | ||
219 | !Finclude/net/mac80211.h ieee80211_key_flags | ||
220 | </chapter> | ||
221 | |||
222 | <chapter id="powersave"> | ||
223 | <title>Powersave support</title> | ||
224 | !Pinclude/net/mac80211.h Powersave support | ||
225 | </chapter> | ||
226 | |||
227 | <chapter id="beacon-filter"> | ||
228 | <title>Beacon filter support</title> | ||
229 | !Pinclude/net/mac80211.h Beacon filter support | ||
230 | !Finclude/net/mac80211.h ieee80211_beacon_loss | ||
231 | </chapter> | ||
232 | |||
233 | <chapter id="qos"> | ||
234 | <title>Multiple queues and QoS support</title> | ||
235 | <para>TBD</para> | ||
236 | !Finclude/net/mac80211.h ieee80211_tx_queue_params | ||
237 | </chapter> | ||
238 | |||
239 | <chapter id="AP"> | ||
240 | <title>Access point mode support</title> | ||
241 | <para>TBD</para> | ||
242 | <para>Some parts of the if_conf should be discussed here instead</para> | ||
243 | <para> | ||
244 | Insert notes about VLAN interfaces with hw crypto here or | ||
245 | in the hw crypto chapter. | ||
246 | </para> | ||
247 | !Finclude/net/mac80211.h ieee80211_get_buffered_bc | ||
248 | !Finclude/net/mac80211.h ieee80211_beacon_get | ||
249 | </chapter> | ||
250 | |||
251 | <chapter id="multi-iface"> | ||
252 | <title>Supporting multiple virtual interfaces</title> | ||
253 | <para>TBD</para> | ||
254 | <para> | ||
255 | Note: WDS with identical MAC address should almost always be OK | ||
256 | </para> | ||
257 | <para> | ||
258 | Insert notes about having multiple virtual interfaces with | ||
259 | different MAC addresses here, note which configurations are | ||
260 | supported by mac80211, add notes about supporting hw crypto | ||
261 | with it. | ||
262 | </para> | ||
263 | </chapter> | ||
264 | |||
265 | <chapter id="hardware-scan-offload"> | ||
266 | <title>Hardware scan offload</title> | ||
267 | <para>TBD</para> | ||
268 | !Finclude/net/mac80211.h ieee80211_scan_completed | ||
269 | </chapter> | ||
270 | </part> | ||
271 | |||
272 | <part id="rate-control"> | ||
273 | <title>Rate control interface</title> | ||
274 | <partintro> | ||
275 | <para>TBD</para> | ||
276 | <para> | ||
277 | This part of the book describes the rate control algorithm | ||
278 | interface and how it relates to mac80211 and drivers. | ||
279 | </para> | ||
280 | </partintro> | ||
281 | <chapter id="dummy"> | ||
282 | <title>dummy chapter</title> | ||
283 | <para>TBD</para> | ||
284 | </chapter> | ||
285 | </part> | ||
286 | |||
287 | <part id="internal"> | ||
288 | <title>Internals</title> | ||
289 | <partintro> | ||
290 | <para>TBD</para> | ||
291 | <para> | ||
292 | This part of the book describes mac80211 internals. | ||
293 | </para> | ||
294 | </partintro> | ||
295 | |||
296 | <chapter id="key-handling"> | ||
297 | <title>Key handling</title> | ||
298 | <sect1> | ||
299 | <title>Key handling basics</title> | ||
300 | !Pnet/mac80211/key.c Key handling basics | ||
301 | </sect1> | ||
302 | <sect1> | ||
303 | <title>MORE TBD</title> | ||
304 | <para>TBD</para> | ||
305 | </sect1> | ||
306 | </chapter> | ||
307 | |||
308 | <chapter id="rx-processing"> | ||
309 | <title>Receive processing</title> | ||
310 | <para>TBD</para> | ||
311 | </chapter> | ||
312 | |||
313 | <chapter id="tx-processing"> | ||
314 | <title>Transmit processing</title> | ||
315 | <para>TBD</para> | ||
316 | </chapter> | ||
317 | |||
318 | <chapter id="sta-info"> | ||
319 | <title>Station info handling</title> | ||
320 | <sect1> | ||
321 | <title>Programming information</title> | ||
322 | !Fnet/mac80211/sta_info.h sta_info | ||
323 | !Fnet/mac80211/sta_info.h ieee80211_sta_info_flags | ||
324 | </sect1> | ||
325 | <sect1> | ||
326 | <title>STA information lifetime rules</title> | ||
327 | !Pnet/mac80211/sta_info.c STA information lifetime rules | ||
328 | </sect1> | ||
329 | </chapter> | ||
330 | |||
331 | <chapter id="synchronisation"> | ||
332 | <title>Synchronisation</title> | ||
333 | <para>TBD</para> | ||
334 | <para>Locking, lots of RCU</para> | ||
335 | </chapter> | ||
336 | </part> | ||
337 | </book> | ||
diff --git a/Documentation/feature-removal-schedule.txt b/Documentation/feature-removal-schedule.txt index 5e2bc4ab897a..9961f1564d22 100644 --- a/Documentation/feature-removal-schedule.txt +++ b/Documentation/feature-removal-schedule.txt | |||
@@ -536,3 +536,12 @@ Who: FUJITA Tomonori <fujita.tomonori@lab.ntt.co.jp> | |||
536 | 536 | ||
537 | ---------------------------- | 537 | ---------------------------- |
538 | 538 | ||
539 | What: iwlwifi disable_hw_scan module parameters | ||
540 | When: 2.6.40 | ||
541 | Why: Hareware scan is the prefer method for iwlwifi devices for | ||
542 | scanning operation. Remove software scan support for all the | ||
543 | iwlwifi devices. | ||
544 | |||
545 | Who: Wey-Yi Guy <wey-yi.w.guy@intel.com> | ||
546 | |||
547 | ---------------------------- | ||
diff --git a/Documentation/networking/bonding.txt b/Documentation/networking/bonding.txt index d2b62b71b617..5dc638791d97 100644 --- a/Documentation/networking/bonding.txt +++ b/Documentation/networking/bonding.txt | |||
@@ -765,6 +765,14 @@ xmit_hash_policy | |||
765 | does not exist, and the layer2 policy is the only policy. The | 765 | does not exist, and the layer2 policy is the only policy. The |
766 | layer2+3 value was added for bonding version 3.2.2. | 766 | layer2+3 value was added for bonding version 3.2.2. |
767 | 767 | ||
768 | resend_igmp | ||
769 | |||
770 | Specifies the number of IGMP membership reports to be issued after | ||
771 | a failover event. One membership report is issued immediately after | ||
772 | the failover, subsequent packets are sent in each 200ms interval. | ||
773 | |||
774 | The valid range is 0 - 255; the default value is 1. This option | ||
775 | was added for bonding version 3.7.0. | ||
768 | 776 | ||
769 | 3. Configuring Bonding Devices | 777 | 3. Configuring Bonding Devices |
770 | ============================== | 778 | ============================== |
diff --git a/Documentation/networking/can.txt b/Documentation/networking/can.txt index cd79735013f9..5b04b67ddca2 100644 --- a/Documentation/networking/can.txt +++ b/Documentation/networking/can.txt | |||
@@ -22,6 +22,7 @@ This file contains | |||
22 | 4.1.2 RAW socket option CAN_RAW_ERR_FILTER | 22 | 4.1.2 RAW socket option CAN_RAW_ERR_FILTER |
23 | 4.1.3 RAW socket option CAN_RAW_LOOPBACK | 23 | 4.1.3 RAW socket option CAN_RAW_LOOPBACK |
24 | 4.1.4 RAW socket option CAN_RAW_RECV_OWN_MSGS | 24 | 4.1.4 RAW socket option CAN_RAW_RECV_OWN_MSGS |
25 | 4.1.5 RAW socket returned message flags | ||
25 | 4.2 Broadcast Manager protocol sockets (SOCK_DGRAM) | 26 | 4.2 Broadcast Manager protocol sockets (SOCK_DGRAM) |
26 | 4.3 connected transport protocols (SOCK_SEQPACKET) | 27 | 4.3 connected transport protocols (SOCK_SEQPACKET) |
27 | 4.4 unconnected transport protocols (SOCK_DGRAM) | 28 | 4.4 unconnected transport protocols (SOCK_DGRAM) |
@@ -471,6 +472,17 @@ solution for a couple of reasons: | |||
471 | setsockopt(s, SOL_CAN_RAW, CAN_RAW_RECV_OWN_MSGS, | 472 | setsockopt(s, SOL_CAN_RAW, CAN_RAW_RECV_OWN_MSGS, |
472 | &recv_own_msgs, sizeof(recv_own_msgs)); | 473 | &recv_own_msgs, sizeof(recv_own_msgs)); |
473 | 474 | ||
475 | 4.1.5 RAW socket returned message flags | ||
476 | |||
477 | When using recvmsg() call, the msg->msg_flags may contain following flags: | ||
478 | |||
479 | MSG_DONTROUTE: set when the received frame was created on the local host. | ||
480 | |||
481 | MSG_CONFIRM: set when the frame was sent via the socket it is received on. | ||
482 | This flag can be interpreted as a 'transmission confirmation' when the | ||
483 | CAN driver supports the echo of frames on driver level, see 3.2 and 6.2. | ||
484 | In order to receive such messages, CAN_RAW_RECV_OWN_MSGS must be set. | ||
485 | |||
474 | 4.2 Broadcast Manager protocol sockets (SOCK_DGRAM) | 486 | 4.2 Broadcast Manager protocol sockets (SOCK_DGRAM) |
475 | 4.3 connected transport protocols (SOCK_SEQPACKET) | 487 | 4.3 connected transport protocols (SOCK_SEQPACKET) |
476 | 4.4 unconnected transport protocols (SOCK_DGRAM) | 488 | 4.4 unconnected transport protocols (SOCK_DGRAM) |
diff --git a/Documentation/networking/dccp.txt b/Documentation/networking/dccp.txt index a62fdf7a6bff..271d524a4c8d 100644 --- a/Documentation/networking/dccp.txt +++ b/Documentation/networking/dccp.txt | |||
@@ -1,18 +1,20 @@ | |||
1 | DCCP protocol | 1 | DCCP protocol |
2 | ============ | 2 | ============= |
3 | 3 | ||
4 | 4 | ||
5 | Contents | 5 | Contents |
6 | ======== | 6 | ======== |
7 | |||
8 | - Introduction | 7 | - Introduction |
9 | - Missing features | 8 | - Missing features |
10 | - Socket options | 9 | - Socket options |
10 | - Sysctl variables | ||
11 | - IOCTLs | ||
12 | - Other tunables | ||
11 | - Notes | 13 | - Notes |
12 | 14 | ||
15 | |||
13 | Introduction | 16 | Introduction |
14 | ============ | 17 | ============ |
15 | |||
16 | Datagram Congestion Control Protocol (DCCP) is an unreliable, connection | 18 | Datagram Congestion Control Protocol (DCCP) is an unreliable, connection |
17 | oriented protocol designed to solve issues present in UDP and TCP, particularly | 19 | oriented protocol designed to solve issues present in UDP and TCP, particularly |
18 | for real-time and multimedia (streaming) traffic. | 20 | for real-time and multimedia (streaming) traffic. |
@@ -29,9 +31,9 @@ It has a base protocol and pluggable congestion control IDs (CCIDs). | |||
29 | DCCP is a Proposed Standard (RFC 2026), and the homepage for DCCP as a protocol | 31 | DCCP is a Proposed Standard (RFC 2026), and the homepage for DCCP as a protocol |
30 | is at http://www.ietf.org/html.charters/dccp-charter.html | 32 | is at http://www.ietf.org/html.charters/dccp-charter.html |
31 | 33 | ||
34 | |||
32 | Missing features | 35 | Missing features |
33 | ================ | 36 | ================ |
34 | |||
35 | The Linux DCCP implementation does not currently support all the features that are | 37 | The Linux DCCP implementation does not currently support all the features that are |
36 | specified in RFCs 4340...42. | 38 | specified in RFCs 4340...42. |
37 | 39 | ||
@@ -45,7 +47,6 @@ http://linux-net.osdl.org/index.php/DCCP_Testing#Experimental_DCCP_source_tree | |||
45 | 47 | ||
46 | Socket options | 48 | Socket options |
47 | ============== | 49 | ============== |
48 | |||
49 | DCCP_SOCKOPT_SERVICE sets the service. The specification mandates use of | 50 | DCCP_SOCKOPT_SERVICE sets the service. The specification mandates use of |
50 | service codes (RFC 4340, sec. 8.1.2); if this socket option is not set, | 51 | service codes (RFC 4340, sec. 8.1.2); if this socket option is not set, |
51 | the socket will fall back to 0 (which means that no meaningful service code | 52 | the socket will fall back to 0 (which means that no meaningful service code |
@@ -112,6 +113,7 @@ DCCP_SOCKOPT_CCID_TX_INFO | |||
112 | On unidirectional connections it is useful to close the unused half-connection | 113 | On unidirectional connections it is useful to close the unused half-connection |
113 | via shutdown (SHUT_WR or SHUT_RD): this will reduce per-packet processing costs. | 114 | via shutdown (SHUT_WR or SHUT_RD): this will reduce per-packet processing costs. |
114 | 115 | ||
116 | |||
115 | Sysctl variables | 117 | Sysctl variables |
116 | ================ | 118 | ================ |
117 | Several DCCP default parameters can be managed by the following sysctls | 119 | Several DCCP default parameters can be managed by the following sysctls |
@@ -155,15 +157,30 @@ sync_ratelimit = 125 ms | |||
155 | sequence-invalid packets on the same socket (RFC 4340, 7.5.4). The unit | 157 | sequence-invalid packets on the same socket (RFC 4340, 7.5.4). The unit |
156 | of this parameter is milliseconds; a value of 0 disables rate-limiting. | 158 | of this parameter is milliseconds; a value of 0 disables rate-limiting. |
157 | 159 | ||
160 | |||
158 | IOCTLS | 161 | IOCTLS |
159 | ====== | 162 | ====== |
160 | FIONREAD | 163 | FIONREAD |
161 | Works as in udp(7): returns in the `int' argument pointer the size of | 164 | Works as in udp(7): returns in the `int' argument pointer the size of |
162 | the next pending datagram in bytes, or 0 when no datagram is pending. | 165 | the next pending datagram in bytes, or 0 when no datagram is pending. |
163 | 166 | ||
167 | |||
168 | Other tunables | ||
169 | ============== | ||
170 | Per-route rto_min support | ||
171 | CCID-2 supports the RTAX_RTO_MIN per-route setting for the minimum value | ||
172 | of the RTO timer. This setting can be modified via the 'rto_min' option | ||
173 | of iproute2; for example: | ||
174 | > ip route change 10.0.0.0/24 rto_min 250j dev wlan0 | ||
175 | > ip route add 10.0.0.254/32 rto_min 800j dev wlan0 | ||
176 | > ip route show dev wlan0 | ||
177 | CCID-3 also supports the rto_min setting: it is used to define the lower | ||
178 | bound for the expiry of the nofeedback timer. This can be useful on LANs | ||
179 | with very low RTTs (e.g., loopback, Gbit ethernet). | ||
180 | |||
181 | |||
164 | Notes | 182 | Notes |
165 | ===== | 183 | ===== |
166 | |||
167 | DCCP does not travel through NAT successfully at present on many boxes. This is | 184 | DCCP does not travel through NAT successfully at present on many boxes. This is |
168 | because the checksum covers the pseudo-header as per TCP and UDP. Linux NAT | 185 | because the checksum covers the pseudo-header as per TCP and UDP. Linux NAT |
169 | support for DCCP has been added. | 186 | support for DCCP has been added. |
diff --git a/Documentation/networking/ip-sysctl.txt b/Documentation/networking/ip-sysctl.txt index f350c69b2bb4..c7165f4cb792 100644 --- a/Documentation/networking/ip-sysctl.txt +++ b/Documentation/networking/ip-sysctl.txt | |||
@@ -1014,6 +1014,12 @@ conf/interface/*: | |||
1014 | accept_ra - BOOLEAN | 1014 | accept_ra - BOOLEAN |
1015 | Accept Router Advertisements; autoconfigure using them. | 1015 | Accept Router Advertisements; autoconfigure using them. |
1016 | 1016 | ||
1017 | Possible values are: | ||
1018 | 0 Do not accept Router Advertisements. | ||
1019 | 1 Accept Router Advertisements if forwarding is disabled. | ||
1020 | 2 Overrule forwarding behaviour. Accept Router Advertisements | ||
1021 | even if forwarding is enabled. | ||
1022 | |||
1017 | Functional default: enabled if local forwarding is disabled. | 1023 | Functional default: enabled if local forwarding is disabled. |
1018 | disabled if local forwarding is enabled. | 1024 | disabled if local forwarding is enabled. |
1019 | 1025 | ||
@@ -1075,7 +1081,12 @@ forwarding - BOOLEAN | |||
1075 | Note: It is recommended to have the same setting on all | 1081 | Note: It is recommended to have the same setting on all |
1076 | interfaces; mixed router/host scenarios are rather uncommon. | 1082 | interfaces; mixed router/host scenarios are rather uncommon. |
1077 | 1083 | ||
1078 | FALSE: | 1084 | Possible values are: |
1085 | 0 Forwarding disabled | ||
1086 | 1 Forwarding enabled | ||
1087 | 2 Forwarding enabled (Hybrid Mode) | ||
1088 | |||
1089 | FALSE (0): | ||
1079 | 1090 | ||
1080 | By default, Host behaviour is assumed. This means: | 1091 | By default, Host behaviour is assumed. This means: |
1081 | 1092 | ||
@@ -1085,18 +1096,24 @@ forwarding - BOOLEAN | |||
1085 | Advertisements (and do autoconfiguration). | 1096 | Advertisements (and do autoconfiguration). |
1086 | 4. If accept_redirects is TRUE (default), accept Redirects. | 1097 | 4. If accept_redirects is TRUE (default), accept Redirects. |
1087 | 1098 | ||
1088 | TRUE: | 1099 | TRUE (1): |
1089 | 1100 | ||
1090 | If local forwarding is enabled, Router behaviour is assumed. | 1101 | If local forwarding is enabled, Router behaviour is assumed. |
1091 | This means exactly the reverse from the above: | 1102 | This means exactly the reverse from the above: |
1092 | 1103 | ||
1093 | 1. IsRouter flag is set in Neighbour Advertisements. | 1104 | 1. IsRouter flag is set in Neighbour Advertisements. |
1094 | 2. Router Solicitations are not sent. | 1105 | 2. Router Solicitations are not sent. |
1095 | 3. Router Advertisements are ignored. | 1106 | 3. Router Advertisements are ignored unless accept_ra is 2. |
1096 | 4. Redirects are ignored. | 1107 | 4. Redirects are ignored. |
1097 | 1108 | ||
1098 | Default: FALSE if global forwarding is disabled (default), | 1109 | TRUE (2): |
1099 | otherwise TRUE. | 1110 | |
1111 | Hybrid mode. Same behaviour as TRUE, except for: | ||
1112 | |||
1113 | 2. Router Solicitations are being sent when necessary. | ||
1114 | |||
1115 | Default: 0 (disabled) if global forwarding is disabled (default), | ||
1116 | otherwise 1 (enabled). | ||
1100 | 1117 | ||
1101 | hop_limit - INTEGER | 1118 | hop_limit - INTEGER |
1102 | Default Hop Limit to set. | 1119 | Default Hop Limit to set. |
diff --git a/Documentation/networking/phonet.txt b/Documentation/networking/phonet.txt index 6e8ce09f9c73..24ad2adba6e5 100644 --- a/Documentation/networking/phonet.txt +++ b/Documentation/networking/phonet.txt | |||
@@ -112,6 +112,22 @@ However, connect() and getpeername() are not supported, as they did | |||
112 | not seem useful with Phonet usages (could be added easily). | 112 | not seem useful with Phonet usages (could be added easily). |
113 | 113 | ||
114 | 114 | ||
115 | Resource subscription | ||
116 | --------------------- | ||
117 | |||
118 | A Phonet datagram socket can be subscribed to any number of 8-bits | ||
119 | Phonet resources, as follow: | ||
120 | |||
121 | uint32_t res = 0xXX; | ||
122 | ioctl(fd, SIOCPNADDRESOURCE, &res); | ||
123 | |||
124 | Subscription is similarly cancelled using the SIOCPNDELRESOURCE I/O | ||
125 | control request, or when the socket is closed. | ||
126 | |||
127 | Note that no more than one socket can be subcribed to any given | ||
128 | resource at a time. If not, ioctl() will return EBUSY. | ||
129 | |||
130 | |||
115 | Phonet Pipe protocol | 131 | Phonet Pipe protocol |
116 | -------------------- | 132 | -------------------- |
117 | 133 | ||
@@ -166,6 +182,46 @@ The pipe protocol provides two socket options at the SOL_PNPIPE level: | |||
166 | or zero if encapsulation is off. | 182 | or zero if encapsulation is off. |
167 | 183 | ||
168 | 184 | ||
185 | Phonet Pipe-controller Implementation | ||
186 | ------------------------------------- | ||
187 | |||
188 | Phonet Pipe-controller is enabled by selecting the CONFIG_PHONET_PIPECTRLR Kconfig | ||
189 | option. It is useful when communicating with those Nokia Modems which do not | ||
190 | implement Pipe controller in them e.g. Nokia Slim Modem used in ST-Ericsson | ||
191 | U8500 platform. | ||
192 | |||
193 | The implementation is based on the Data Connection Establishment Sequence | ||
194 | depicted in 'Nokia Wireless Modem API - Wireless_modem_user_guide.pdf' | ||
195 | document. | ||
196 | |||
197 | It allows a phonet sequenced socket (host-pep) to initiate a Pipe connection | ||
198 | between itself and a remote pipe-end point (e.g. modem). | ||
199 | |||
200 | The implementation adds socket options at SOL_PNPIPE level: | ||
201 | |||
202 | PNPIPE_PIPE_HANDLE | ||
203 | It accepts an integer argument for setting value of pipe handle. | ||
204 | |||
205 | PNPIPE_ENABLE accepts one integer value (int). If set to zero, the pipe | ||
206 | is disabled. If the value is non-zero, the pipe is enabled. If the pipe | ||
207 | is not (yet) connected, ENOTCONN is error is returned. | ||
208 | |||
209 | The implementation also adds socket 'connect'. On calling the 'connect', pipe | ||
210 | will be created between the source socket and the destination, and the pipe | ||
211 | state will be set to PIPE_DISABLED. | ||
212 | |||
213 | After a pipe has been created and enabled successfully, the Pipe data can be | ||
214 | exchanged between the host-pep and remote-pep (modem). | ||
215 | |||
216 | User-space would typically follow below sequence with Pipe controller:- | ||
217 | -socket | ||
218 | -bind | ||
219 | -setsockopt for PNPIPE_PIPE_HANDLE | ||
220 | -connect | ||
221 | -setsockopt for PNPIPE_ENCAP_IP | ||
222 | -setsockopt for PNPIPE_ENABLE | ||
223 | |||
224 | |||
169 | Authors | 225 | Authors |
170 | ------- | 226 | ------- |
171 | 227 | ||
diff --git a/Documentation/networking/timestamping.txt b/Documentation/networking/timestamping.txt index e8c8f4f06c67..98097d8cb910 100644 --- a/Documentation/networking/timestamping.txt +++ b/Documentation/networking/timestamping.txt | |||
@@ -172,15 +172,19 @@ struct skb_shared_hwtstamps { | |||
172 | }; | 172 | }; |
173 | 173 | ||
174 | Time stamps for outgoing packets are to be generated as follows: | 174 | Time stamps for outgoing packets are to be generated as follows: |
175 | - In hard_start_xmit(), check if skb_tx(skb)->hardware is set no-zero. | 175 | - In hard_start_xmit(), check if (skb_shinfo(skb)->tx_flags & SKBTX_HW_TSTAMP) |
176 | If yes, then the driver is expected to do hardware time stamping. | 176 | is set no-zero. If yes, then the driver is expected to do hardware time |
177 | stamping. | ||
177 | - If this is possible for the skb and requested, then declare | 178 | - If this is possible for the skb and requested, then declare |
178 | that the driver is doing the time stamping by setting the field | 179 | that the driver is doing the time stamping by setting the flag |
179 | skb_tx(skb)->in_progress non-zero. You might want to keep a pointer | 180 | SKBTX_IN_PROGRESS in skb_shinfo(skb)->tx_flags , e.g. with |
180 | to the associated skb for the next step and not free the skb. A driver | 181 | |
181 | not supporting hardware time stamping doesn't do that. A driver must | 182 | skb_shinfo(skb)->tx_flags |= SKBTX_IN_PROGRESS; |
182 | never touch sk_buff::tstamp! It is used to store software generated | 183 | |
183 | time stamps by the network subsystem. | 184 | You might want to keep a pointer to the associated skb for the next step |
185 | and not free the skb. A driver not supporting hardware time stamping doesn't | ||
186 | do that. A driver must never touch sk_buff::tstamp! It is used to store | ||
187 | software generated time stamps by the network subsystem. | ||
184 | - As soon as the driver has sent the packet and/or obtained a | 188 | - As soon as the driver has sent the packet and/or obtained a |
185 | hardware time stamp for it, it passes the time stamp back by | 189 | hardware time stamp for it, it passes the time stamp back by |
186 | calling skb_hwtstamp_tx() with the original skb, the raw | 190 | calling skb_hwtstamp_tx() with the original skb, the raw |
@@ -191,6 +195,6 @@ Time stamps for outgoing packets are to be generated as follows: | |||
191 | this would occur at a later time in the processing pipeline than other | 195 | this would occur at a later time in the processing pipeline than other |
192 | software time stamping and therefore could lead to unexpected deltas | 196 | software time stamping and therefore could lead to unexpected deltas |
193 | between time stamps. | 197 | between time stamps. |
194 | - If the driver did not call set skb_tx(skb)->in_progress, then | 198 | - If the driver did not set the SKBTX_IN_PROGRESS flag (see above), then |
195 | dev_hard_start_xmit() checks whether software time stamping | 199 | dev_hard_start_xmit() checks whether software time stamping |
196 | is wanted as fallback and potentially generates the time stamp. | 200 | is wanted as fallback and potentially generates the time stamp. |