File: INSTALL-Windows.markdown

package info (click to toggle)
tcpcrypt 0.3~rc1-3
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 1,292 kB
  • ctags: 1,285
  • sloc: ansic: 11,305; asm: 482; sh: 192; objc: 149; makefile: 98
file content (78 lines) | stat: -rw-r--r-- 2,650 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
Installing tcpcrypt on Windows
==============================

Compiling
=========

Only cross-compiling for Windows on Linux (using mingw) is supported right now. You can almost certainly compile the Windows version on Windows itself, but we haven't done that yet (if you have, contact us).

Using mingw, run the following commands to cross-compile tcpcrypt for Windows
on a Linux host.

    cd tcpcrypt
    ./bootstrap.sh
    ./configure CFLAGS="-mwin32 -D__WIN32__ -I/home/sqs/src/mingw/OpenSSL-Win32/include" LDFLAGS=" -L/home/sqs/src/mingw/OpenSSL-Win32/ " --host=i586-mingw32msvc
    make

Replace `<path-to-mingw-openssl>` with the path to OpenSSL compiled for
Windows. You can download binaries from
[http://www.slproweb.com/products/Win32OpenSSL.html](http://www.slproweb.com/products/Win32OpenSSL.html)
(use the 'Win32 OpenSSL v1.0.0a' link) and run the installer with Wine. Then
rename `libeay32.dll` to `libcrypto.dll` in the root OpenSSL folder (that you
just installed into). There's almost certainly a cleaner way to do this, but
this is the quickest way.

tcpcrypt depends on WinDivert:
	
	http://reqrypt.org/windivert.html

You'll have to supply paths to header files and WinDivert.dll when compiling
(modify CFLAGS and LDFLAGS as above).

Optional: running `make install` will install `libtcpcrypt` and tcpcrypt
headers, for building apps that use tcpcrypt's session ID.


Installing
==========

The Windows implementation of tcpcrypt has two components: the third-party kernel divert
socket driver and the userland daemon.

Installing the kernel divert socket driver
------------------------------------------

http://reqrypt.org/windivert.html

Just place WinDivert32.sys and WinDirver64.sys in the directory of tcpcrypt.

Getting the userland daemon
---------------------------

If you followed the compilation steps above, you're done. Otherwise, download
the pre-compiled tcpcryptd binary for Windows at
[http://tcpcrypt.org/](http://tcpcrypt.org/). If you will use the launch script
(below), move this file to tcpcrypt/user/tcpcrypt/tcpcryptd.exe, which is where
the launch script expects it.

Or you can just download the precompiled Windows GUI version at the link above.

Running
=======

After installing the divert socket driver, run the tcpcryptd daemon with the
following command:

    ./launch_tcpcryptd.sh

By default, this script tells tcpcryptd to use the first network interface
listed in `ipconfig /all`. If you want to use a different interface, run
tcpcryptd manually:

    tcpcrypt/tcpcryptd -x 0a:1b:2c:3d:4f:6a


Test drive
==========

Once tcpcryptd is running, see README.markdown for ways to try it out.