From e97f78d7899372238c04bc6de019996ed9968f5d Mon Sep 17 00:00:00 2001
From: Sebastian Hahn <sebastian@torproject.org>
Date: Sun, 27 Mar 2011 05:29:00 +0200
Subject: Small fixes for the 2702 implementation

Improve the INSTALL documentation for static builds, remove a few
unnecessary lines from configure.in and tweak the changelog message
slightly.
---
 INSTALL | 38 +++++++++++++-------------------------
 1 file changed, 13 insertions(+), 25 deletions(-)

(limited to 'INSTALL')

diff --git a/INSTALL b/INSTALL
index 1007b431f..ddb790b0b 100644
--- a/INSTALL
+++ b/INSTALL
@@ -23,12 +23,20 @@ If it doesn't build for you:
   Lastly, check out
   https://www.torproject.org/docs/faq#DoesntWork
 
-An example of how to build a mostly static Tor:
+How to do static builds of tor:
 
-Libevent should be built with:
-% ./configure --disable-shared --enable-static --with-pic
+Tor supports linking each of the libraries it needs statically. Use the
+--enable-static-X ./configure option in conjunction with the --with-X-dir
+option for libevent, zlib, and openssl. For this to work sanely, libevent
+should be built with --disable-shared --enable-static --with-pic, and
+OpenSSL should be built with no-shared no-dso.
 
-An example of how to build a mostly static Tor:
+If you need to build tor so that system libraries are also statically linked,
+use the --enable-static-tor ./configure option. This won't work on OS X
+unless you build the required crt0.o yourself. It is also incompatible with
+the --enable-gcc-hardening option.
+
+An example of how to build a mostly static tor:
 ./configure --enable-static-libevent \
             --enable-static-openssl  \
             --enable-static-zlib     \
@@ -36,29 +44,9 @@ An example of how to build a mostly static Tor:
             --with-openssl-dir=/tmp/static-tor/openssl-0.9.8r/ \
             --with-zlib-dir=/tmp/static-tor/zlib-1.2.5
 
-An example of how to build an entirely static Tor (no Mac OS X support, sorry):
+An example of how to build an entirely static tor:
 ./configure --enable-static-tor \
-            --enable-static-libevent \
-            --enable-static-openssl  \
-            --enable-static-zlib     \
             --with-libevent-dir=/tmp/static-tor/libevent-1.4.14b-stable \
             --with-openssl-dir=/tmp/static-tor/openssl-0.9.8r/ \
             --with-zlib-dir=/tmp/static-tor/zlib-1.2.5
 
-This currently does not work with --enable-gcc-hardening because of libevent issues:
-
-configure:6176: gcc -o conftest  -D_FORTIFY_SOURCE=2 -fstack-protector-all -fwrapv -fPIE -Wstack-protector
---param ssp-buffer-size=1 -I/tmp/static-tor/libevent-1.4.14b-stable  -I${top_srcdir}/src/common -
-L/tmp/static-tor/libevent-1.4.14b-stable  -pie conftest.c -lpthread -ldl  -levent -lrt  >&5
-/usr/bin/ld: /tmp/static-tor/libevent-1.4.14b-stable/libevent.a(event.o): relocation R_X86_64_32 against `.rodata.str1.1' can not be used when making a shared object; recompile with -fPIC
-/tmp/static-tor/libevent-1.4.14b-stable/libevent.a: could not read symbols: Bad value
-    collect2: ld returned 1 exit status
-    configure:6176: $? = 1
-
-This produces the following Tor binaries on Gnu/Linux x86-64:
-
-% file src/or/tor
-src/or/tor: ELF 64-bit LSB executable, x86-64, version 1 (GNU/Linux), statically linked, for GNU/Linux 2.6.15, not stripped
-
-% ldd src/or/tor
-    not a dynamic executable
-- 
cgit v1.2.3