Win32Readme.txt 3.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106
  1. $Id$
  2. This document attempts to explain how to get tcpreplay compiled and running
  3. under Windows. Please note that this document is a work in progress and
  4. Windows support in general considered EXPERIMENTAL right now.
  5. Background:
  6. Tcpreplay is not a native Win32 application right now. Hence it requires
  7. Cygwin. (http://www.cygwin.com). Cygwin creates a Linux-like environment
  8. on your Windows system which allows Linux/UNIX programs to run after a
  9. recompile.
  10. Tcpreplay supports numerous API's for sending packets depending on the
  11. operating system. Under Windows, the only supported method of sending
  12. packets is with WinPcap 4.0. (http://www.winpcap.org) Please be sure to
  13. install both the WinPcap driver AND the developer pack.
  14. Right now, I've only done testing under Windows XP. My guess is that 2000
  15. and 2003 should have no problems. Since WinPcap and Cygwin are EOL'ing
  16. support for Win98/ME, I doubt that they'll ever be supported. Not sure
  17. the story on Vista, but I assume WinPcap & Cygwin will support them sooner
  18. or later if not already. Would love to hear if anyone has any luck one
  19. way or another.
  20. What you will need:
  21. - Cygwin environment
  22. - GCC compiler and system header files
  23. - WinPcap 4.0 DLL
  24. - WinPcap 4.0 Developer Pack aka WpdPack (headers, etc)
  25. Additional requirements if building from SVN:
  26. - GNU build chain tools (Autoconf, Automake, Autoheader)
  27. - GNU Autogen (*)
  28. * NOTE: The guile package which comes with Cygwin is broken and breaks
  29. Autogen, so you'll need to compile guile from scratch to fix. Hence, I
  30. strongly suggest you build Tcpreplay from the tarball and not SVN. See
  31. below for how to "fix" this issue if you want to compile from SVN.
  32. ******************************* IMPORTANT ******************************
  33. Note 1:
  34. People have reported problems with WpdPack (the developer pack for
  35. Winpcap) being installed outside of the Cygwin root directory. Hence, I
  36. strongly recommend you install it under the Cygwin root as /WpdPack.
  37. Note 2:
  38. There's a big problem with the Cygwin Guile package which breaks
  39. GNU Autogen which Tcpreplay depends on when building from Subversion.
  40. What this means is that to build from Subversion you must do the following:
  41. - Download GNU Guile from http://www.gnu.org/software/guile/guile.html
  42. - Extract the tarball and do the following:
  43. libtoolize --copy --force
  44. ./configure
  45. make
  46. make install
  47. This will install guile in /usr/local.
  48. The other problem is that guile-config returns the linker flags in the wrong
  49. order. To fix this, rename /usr/local/bin/guile-config to
  50. /usr/local/bin/guile-config.original and create a new shell script in it's
  51. place:
  52. ---- BEGIN SHELL SCRIPT ----
  53. #!/bin/bash
  54. # Replacement /usr/local/bin/guile-config script
  55. if test -z "$1" ; then
  56. guile-config.original
  57. elif test "$1" == "link"; then
  58. echo "-L/usr/local/lib -lguile -lltdl -lgmp -lcrypt -lm -lltdl"
  59. else
  60. guile-config.original $1
  61. fi
  62. ---- END SHELL SCRIPT ----
  63. ******************************* IMPORTANT ******************************
  64. Directions:
  65. - Install all the requirements
  66. - Enter into the Cygwin environment by clicking on the Cygwin icon
  67. - If you checked out the code from SVN, see Note 2 above and then run
  68. the autogen.sh bootstrapper:
  69. ./autogen.sh
  70. - Configure tcpreplay:
  71. ./configure --enable-debug
  72. - Build tcpreplay:
  73. make
  74. - Install:
  75. make install
  76. - Try it out!