README.kernel 5.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148
  1. LINUX KERNEL REQUIREMENTS
  2. =========================
  3. The linux kernel has had various major regressions, performance
  4. issues and subtle bugs (especially in pmtu). Here is a short list
  5. of some -stable kernels that have been tested (at least briefly)
  6. and seem to be working well with Quagga/NHRP:
  7. 3.12.8 or later
  8. 3.14.54 or later
  9. 3.18.22 or later[1]
  10. 4.4.52 or later
  11. 4.9.30 or later
  12. [1] But you need to apply the following two backported commits:
  13. 3cdaa5be9e ipv4: Don't increase PMTU with Datagram Too Big message
  14. cb6ccf09d6 route: Use ipv4_mtu instead of raw rt_pmtu
  15. See below for list of known issues in various kernel versions.
  16. Kernels earlier than 3.12 need CONFIG_ARPD enabled in the configuration.
  17. Many distributions do not enable it by default, and you may need to
  18. compile your own kernel.
  19. KERNEL BUGS
  20. ===========
  21. DMVPN and mGRE support in the kernel has been brittle. There are various
  22. regressions in multiple kernel versions.
  23. This list tries to collect them to one source of information:
  24. - forward pmtu is disabled intentionally (but tunnel devices rely on it)
  25. Broken since 3.14-rc1:
  26. commit "ipv4: introduce ip_dst_mtu_maybe_forward and protect forwarding path against pmtu spoofing"
  27. Workaround:
  28. Set sysctl net.ipv4.ip_forward_use_pmtu=1
  29. (Should fix kernel to have this by default on for tunnel devices)
  30. - subtle path mtu mishandling issues
  31. Broken since (uncertain)
  32. Fixed in 4.1-rc2:
  33. commit "ipv4: Don't increase PMTU with Datagram Too Big message."
  34. commit "route: Use ipv4_mtu instead of raw rt_pmtu"
  35. - fragmentation of large packets inside tunnel not working
  36. Broken since 3.11-rc1
  37. commit "ip_tunnels: Use skb-len to PMTU check."
  38. Fixed in 3.14.54, 3.18.22, 4.1.9, 4.2-rc3
  39. commit "ip_tunnel: fix ipv4 pmtu check to honor inner ip header df"
  40. - ipsec will crash during xfrm gc
  41. Broke since 3.15-rc1
  42. commit "flowcache: Make flow cache name space aware"
  43. Fixed in 3.18.10, 4.0
  44. commit "flowcache: Fix kernel panic in flow_cache_flush_task"
  45. - TSO on GRE tunnels failed, and resulted in very slow performance
  46. Broke since 3.14.24, 3.18-rc3
  47. commit "gre: Use inner mac length when computing tunnel length"
  48. Fixed in 3.14.30, 3.18.4
  49. commit "gre: fix the inner mac header in nbma tunnel xmit path"
  50. commit "gre: Set inner mac header in gro complete"
  51. - NAPI GRO handling was broken; causing immediate crash (32-bit only?)
  52. Broken since 3.13-rc1
  53. commit "net: gro: allow to build full sized skb"
  54. Fixed 3.14.5, 3.15-rc7
  55. commit "net: gro: make sure skb->cb[] initial content has not to be zero"
  56. - ip_gre dst caching broke NBMA GRE tunnels
  57. Broken since 3.14-rc1
  58. Fixed in 3.14.5, 3.15-rc6
  59. commit "ipv4: ip_tunnels: disable cache for nbma gre tunnels"
  60. - Few packets can be lost when neighbor entry is in NUD_PROBE state,
  61. and there is continuous traffic to it.
  62. Broken since dawn of time
  63. Fixed in 3.15-rc1
  64. commit "neigh: probe application via netlink in NUD_PROBE"
  65. - GRO was implemented for GRE, but the hw capabilities were not updated
  66. correctly. In practice forwarding from non-GRE (physical) interface
  67. to GRE interface with gro/gso/tx offloads enabled (also on the target
  68. interface) does not work properly.
  69. Broken around 3.9 to 3.11, need to check details.
  70. - recvfrom() returned incorrect NBMA address, breaking NAT detection
  71. Broken since 3.10-rc1
  72. commit "GRE: Refactor GRE tunneling code."
  73. Fixed in 3.10.27, 3.12.8, 3.13-rc7
  74. commit "ip_gre: fix msg_name parsing for recvfrom/recvmsg"
  75. - sendto() was broken causing opennhrp not work at all
  76. Broken since 3.10-rc1
  77. commit "GRE: Refactor GRE tunneling code."
  78. Fixed in 3.10.12, 3.11-rc6
  79. commit "ip_gre: fix ipgre_header to return correct offset"
  80. - PMTU was broken due to GRE driver rewrite
  81. Broken since 3.10-rc1
  82. commit "GRE: Refactor GRE tunneling code."
  83. Fixed in 3.11-rc1
  84. commit "ip_tunnels: Use skb-len to PMTU check."
  85. - PMTU was broken due to routing cache removal
  86. Broken since 3.6-rc1
  87. commit "ipv4: Cache input routes in fib_info nexthops"
  88. Fixed in 3.11-rc1
  89. commit "ipv4: use next hop exceptions also for input routes"
  90. + 3 other commits
  91. Patches exist for 3.10, but they were not approved to 3.10-stable.
  92. - Race condition during bootup: changing ARP flag did not flush
  93. existing neighbor entries, causing problems if traffic was routed
  94. to gre interface before opennhrp was running.
  95. Broken since dawn of time
  96. Fixed in 3.11-rc1
  97. commit "arp: flush arp cache on IFF_NOARP change"
  98. - Crash in IPsec
  99. Broken since 3.9-rc1
  100. commit "xfrm: removes a superfluous check and add a statistic"
  101. Fixed in 3.10-rc3
  102. commit "xfrm: properly handle invalid states as an error"
  103. - An incorrect ip_gre change broke NHRP traffic over GRE
  104. Broken since 3.8-rc2
  105. commit "ip_gre: make ipgre_tunnel_xmit() not parse network header as IP unconditionally"
  106. Fixed in 3.8.5, 3.9-rc4
  107. commit "Revert "ip_gre: make ipgre_tunnel_xmit() not parse network header as IP unconditionally""
  108. - Multicast traffic over mGRE was broken.
  109. Broken since 2.6.34-rc2
  110. commit "gre: fix hard header destination address checking"
  111. Fixed in 2.6.39-rc2
  112. commit "net: gre: provide multicast mappings for ipv4 and ipv6"
  113. - Serious performance issues causing small throughput on medium to large DMVPN networks
  114. Broken since dawn of time
  115. Fixed in 2.6.35
  116. multiple commits rewriting ipsec caching
  117. - Even though around 2.6.24 is the first version where opennhrp started
  118. to work, there has been various PMTU, performance, and functionality
  119. bugs before 2.6.34. That's one of the first version I consider stable
  120. wrt. to opennhrp functionality.