README 5.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150
  1. ifmetric 0.3
  2. Copyright 2003,2004 Lennart Poettering <mzvszrgevp (at) 0pointer (dot)
  3. de>
  4. * [1]License
  5. * [2]News
  6. * [3]Overview
  7. * [4]Status
  8. * [5]Documentation
  9. * [6]Requirements
  10. * [7]Installation
  11. * [8]Acknowledgements
  12. * [9]Download
  13. License
  14. This program is free software; you can redistribute it and/or modify it
  15. under the terms of the GNU General Public License as published by the
  16. Free Software Foundation; either version 2 of the License, or (at your
  17. option) any later version.
  18. This program is distributed in the hope that it will be useful, but
  19. WITHOUT ANY WARRANTY; without even the implied warranty of
  20. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  21. General Public License for more details.
  22. You should have received a copy of the GNU General Public License along
  23. with this program; if not, write to the Free Software Foundation, Inc.,
  24. 675 Mass Ave, Cambridge, MA 02139, USA.
  25. News
  26. Sat Jan 24 2004:
  27. [10]Version 0.3 release; fix compatibility with Linux 2.6
  28. Sat Aug 23 2003:
  29. [11]Version 0.2b release; URL fix
  30. Sat Aug 23 2003:
  31. [12]Version 0.2 released; changes include updated documentation, build
  32. system, contact information
  33. Mon Aug 4 2003:
  34. [13]Version 0.1 released
  35. Overview
  36. ifmetric is a Linux tool for setting the metrics of all IPv4 routes
  37. attached to a given network interface at once. This may be used to
  38. change the priority of routing IPv4 traffic over the interface. Lower
  39. metrics correlate with higher priorities.
  40. Status
  41. Version 0.3 is stable and feature complete.
  42. Documentation
  43. ifmetric's purpose
  44. Sometimes two network interfaces of different speeds with equal routes
  45. are available at the same time. (e.g. a laptop with both a wireless and
  46. a copper LAN card) The one with the greater througput should be
  47. preferred over the other. To achieve this, you may use the route's
  48. metric field. Routes with lower metrics are preferred over those with
  49. higher. Unfortunately many network configurators (like DHCP clients) do
  50. not support to set the metric for a route. ifmetric may be used to
  51. manipulate the metrics of routes a posteriori. The default metric for a
  52. route in the Linux kernel is 0, meaning the highest priority.
  53. ifmetric makes use of the NETLINK interface of the Linux kernel for
  54. manipulating the routes. Thus, ifmetric is compatible with complex
  55. routes created with iproute2.
  56. ifmetric doesn't modify the routes atomically. The is due to the
  57. NETLINK API. However, this should not hurt since ifmetric makes sure
  58. that not routes are ever lost while modifying them.
  59. Usage
  60. Have a look on the manual page [14]ifmetric(8).
  61. To give all other interfaces a higher priority than wlan0 simply run:
  62. ifmetric wlan0 1
  63. To reset the metrics of the routes attached to wlan0 simply run:
  64. ifmetric wlan0 0
  65. Requirements
  66. A newer Linux Kernel supporting the NETLINK API. (I think 2.2 is good
  67. enough).
  68. ifmetric was developed and tested on Debian GNU/Linux "testing" from
  69. August 2003, it should work on most other Linux distributions since it
  70. uses GNU autoconf for source code configuration.
  71. Installation
  72. As this package is made with the GNU autotools you should run
  73. ./configure inside the distribution directory for configuring the
  74. source tree. After that you should run make for compilation and make
  75. install (as root) for installation of ifmetric.
  76. The Linux kernel headers have to be available during compilation.
  77. Acknowledgements
  78. For the developers of iproute2 and zebra, since I looked on their
  79. source codes for learning how to use NETLINK.
  80. Download
  81. The newest release is always available from
  82. [15]http://0pointer.de/lennart/projects/ifmetric/
  83. The current release is [16]0.3
  84. If you want to be notified whenever I release a new version of this
  85. software use the subscription feature of [17]Freshmeat.
  86. __________________________________________________________________
  87. Lennart Poettering <mzvszrgevp (at) 0pointer (dot) de>, January 2004
  88. $Id: README.html.in 16 2004-01-23 23:20:25Z lennart $
  89. References
  90. 1. file:///opt/ti-processor-sdk-linux-am335x-evm-04.02.00.09/EVSE/GPL/ifmetric-0.3/doc/README.html#license
  91. 2. file:///opt/ti-processor-sdk-linux-am335x-evm-04.02.00.09/EVSE/GPL/ifmetric-0.3/doc/README.html#news
  92. 3. file:///opt/ti-processor-sdk-linux-am335x-evm-04.02.00.09/EVSE/GPL/ifmetric-0.3/doc/README.html#overview
  93. 4. file:///opt/ti-processor-sdk-linux-am335x-evm-04.02.00.09/EVSE/GPL/ifmetric-0.3/doc/README.html#status
  94. 5. file:///opt/ti-processor-sdk-linux-am335x-evm-04.02.00.09/EVSE/GPL/ifmetric-0.3/doc/README.html#documentation
  95. 6. file:///opt/ti-processor-sdk-linux-am335x-evm-04.02.00.09/EVSE/GPL/ifmetric-0.3/doc/README.html#requirements
  96. 7. file:///opt/ti-processor-sdk-linux-am335x-evm-04.02.00.09/EVSE/GPL/ifmetric-0.3/doc/README.html#installation
  97. 8. file:///opt/ti-processor-sdk-linux-am335x-evm-04.02.00.09/EVSE/GPL/ifmetric-0.3/doc/README.html#acks
  98. 9. file:///opt/ti-processor-sdk-linux-am335x-evm-04.02.00.09/EVSE/GPL/ifmetric-0.3/doc/README.html#download
  99. 10. http://0pointer.de/lennart/projects/ifmetric/ifmetric-0.3.tar.gz
  100. 11. http://0pointer.de/lennart/projects/ifmetric/ifmetric-0.2b.tar.gz
  101. 12. http://0pointer.de/lennart/projects/ifmetric/ifmetric-0.2.tar.gz
  102. 13. http://0pointer.de/lennart/projects/ifmetric/ifmetric-0.1.tar.gz
  103. 14. http://0pointer.de/lennart/projects/ifmetric/ifmetric.8.xml
  104. 15. http://0pointer.de/lennart/projects/ifmetric/
  105. 16. http://0pointer.de/lennart/projects/ifmetric/ifmetric-0.3.tar.gz
  106. 17. http://freshmeat.net/projects/ifmetric/