deprecation 1.6 KB

12345678910111213141516171819202122232425262728293031
  1. o Major features (user interface):
  2. - Tor now supports the ability to declare options deprecated, so that
  3. we can recommend that people stop using them. Previously, this was
  4. done in an ad-hoc way.
  5. Closes ticket 19820.
  6. o Minor features (user interface):
  7. - There is a new --list-deprecated-options command-line option to list
  8. all of the deprecated options. Implemented as part of ticket 19820.
  9. o Deprecated features:
  10. - A number of options are deprecated for security reasons, and may be
  11. removed in a future version of Tor. The options are: AllowDotExit,
  12. AllowInvalidNodes, AllowSingleHopCircuits, AllowSingleHopExits,
  13. ClientDNSRejectInternalAddresses,
  14. CloseHSClientCircuitsImmediatelyOnTimeout,
  15. CloseHSServiceRendCircuitsImmediatelyOnTimeout, ExcludeSingleHopRelays,
  16. FastFirstHopPK, TLSECGroup, UseNTorHandshake, and WarnUnsafeSocks.
  17. - A number of DNS-cache-related sub-options for client ports are now
  18. deprecated for security reasons, and may be removed in a future version
  19. of Tor. (We believe that client-side DNS cacheing is a bad idea for
  20. anonymity, and you should not turn it on.) The options are: CacheDNS,
  21. CacheIPv4DNS, CacheIPv6DNS, UseDNSCache, UseIPv4Cache, and
  22. UseIPv6Cache.
  23. - The *ListenAddress options are now deprecated as unnecessary: the
  24. corresponding *Port options should be used instead. These options may
  25. someday be removed. The affected options are: ControlListenAddress,
  26. DNSListenAddress, DirListenAddress, NATDListenAddress, ORListenAddress,
  27. SocksListenAddress, and TransListenAddress.