media/mtransport/third_party/nICEr/README@97036ab72558 (annotated)
media/mtransport/third_party/nICEr/README
Tue, 06 Jan 2015 21:39:09 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Tue, 06 Jan 2015 21:39:09 +0100
- branch
- TOR_BUG_9701
- changeset 8
- 97036ab72558
- permissions
- -rw-r--r--
Conditionally force memory storage according to privacy.thirdparty.isolate;
This solves Tor bug #9701, complying with disk avoidance documented in
https://www.torproject.org/projects/torbrowser/design/#disk-avoidance.
| michael@0 | 1 | nICEr 1.0 |
| michael@0 | 2 | |
| michael@0 | 3 | PREREQUISITES: |
| michael@0 | 4 | ------------- |
| michael@0 | 5 | You must first obtain and build the following packages: |
| michael@0 | 6 | |
| michael@0 | 7 | * nrappkit |
| michael@0 | 8 | - http://nrappkit.sourceforge.net/ |
| michael@0 | 9 | |
| michael@0 | 10 | * OpenSSL-0.9.8g |
| michael@0 | 11 | - http://www.openssl.org/source/openssl-0.9.8g.tar.gz |
| michael@0 | 12 | |
| michael@0 | 13 | |
| michael@0 | 14 | For best results, the "ice-<version>" directory should be at |
| michael@0 | 15 | the same level as the "nrappkit" and "openssl-0.9.8g" |
| michael@0 | 16 | directories. I.e., the directory structure should look like: |
| michael@0 | 17 | |
| michael@0 | 18 | nrappkit/ |
| michael@0 | 19 | ice-<version>/ |
| michael@0 | 20 | openssl/ |
| michael@0 | 21 | include/ |
| michael@0 | 22 | lib/VC/ |
| michael@0 | 23 | |
| michael@0 | 24 | |
| michael@0 | 25 | BUILDING ON UNIX: |
| michael@0 | 26 | ---------------- |
| michael@0 | 27 | Once the prerequisite packages are built, 'cd' to the |
| michael@0 | 28 | relevant build directory, one of: |
| michael@0 | 29 | |
| michael@0 | 30 | ice-<version>/make/darwin |
| michael@0 | 31 | ice-<version>/make/linux-fedora |
| michael@0 | 32 | ice-<version>/make/ubuntu |
| michael@0 | 33 | |
| michael@0 | 34 | and simply do a "make". |
| michael@0 | 35 | |
| michael@0 | 36 | |
| michael@0 | 37 | BUILDING ON WINDOWS: |
| michael@0 | 38 | ------------------- |
| michael@0 | 39 | The Visual C++ project files are configured to expect the |
| michael@0 | 40 | directory structure described above. |
| michael@0 | 41 | |
| michael@0 | 42 | Note: Binary Windows builds of OpenSSL can be found at: |
| michael@0 | 43 | http://www.slproweb.com/products/Win32OpenSSL.html |
| michael@0 | 44 | |
| michael@0 | 45 | Once the prerequisite packages are built, open the VC++ 9.0 |
| michael@0 | 46 | solution file: ICE/make/win32/ice.sln and build the solution. |
| michael@0 | 47 | Note: Since the VC++ project/solution files are version 9.0, |
| michael@0 | 48 | Visual Studio 2008 is required. |
| michael@0 | 49 | |
| michael@0 | 50 | |
| michael@0 | 51 | STATUS: |
| michael@0 | 52 | ------ |
| michael@0 | 53 | The ICE code has been tested on the following platforms: |
| michael@0 | 54 | -- Fedora Core 4 (Intel 32-bit) |
| michael@0 | 55 | -- Fedora Core 6 (Intel 32-bit) |
| michael@0 | 56 | -- Ubuntu 6.10 |
| michael@0 | 57 | -- MacOSX 10.4.9 |
| michael@0 | 58 | -- Windows Vista (Home Premium) |
| michael@0 | 59 | -- Windows XP Pro |
| michael@0 | 60 | -- Windows 2000 SP4 |
| michael@0 | 61 | |
| michael@0 | 62 | |
| michael@0 | 63 | KNOWN ISSUES: |
| michael@0 | 64 | ------------ |
| michael@0 | 65 | -- TURN SET-ACTIVE-DESTINATION mode not yet supported. |
| michael@0 | 66 | |
| michael@0 | 67 | -- Problems may exist with the TURN client implementation; the TURN code |
| michael@0 | 68 | has received minimal testing due to the unavailability of a real |
| michael@0 | 69 | TURN server to test against. |
| michael@0 | 70 | |
| michael@0 | 71 | -- The ICE-Lite implementation is not complete. |
| michael@0 | 72 | |
| michael@0 | 73 | -- The new "impatient" timeout has not yet been thoroughly tested. |
| michael@0 | 74 |
