You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@thrift.apache.org by ro...@apache.org on 2014/05/30 14:47:30 UTC
svn commit: r1598572 - /thrift/cms-site/trunk/content/docs/install/windows.md
Author: roger
Date: Fri May 30 12:47:29 2014
New Revision: 1598572
URL: http://svn.apache.org/r1598572
Log:
use snippet
Modified:
thrift/cms-site/trunk/content/docs/install/windows.md
Modified: thrift/cms-site/trunk/content/docs/install/windows.md
URL: http://svn.apache.org/viewvc/thrift/cms-site/trunk/content/docs/install/windows.md?rev=1598572&r1=1598571&r2=1598572&view=diff
==============================================================================
--- thrift/cms-site/trunk/content/docs/install/windows.md (original)
+++ thrift/cms-site/trunk/content/docs/install/windows.md Fri May 30 12:47:29 2014
@@ -2,141 +2,4 @@
title: "Windows Install"
kind: doc
---
-## Windows Setup
-The windows compiler is available as a prebuilt exe available [here](/download)
-
----
-
-## Windows setup from source
-
-### Basic requirements for win32
-Thrift's compiler is written in C++ and designed to be portable, but there are some system requirements:
-
- * Cygwin or MinGW
- * [Apache Thrift Requirements](/docs/install)
-
-Thrift's runtime libraries are written in various languages, which are also required for the particular language interface.
-
-### Installing from source
-If you are building from the first time out of the source repository, you will need to generate the configure scripts. (This is not necessary if you downloaded a tarball.) From the top directory, do:
-
- ./bootstrap.sh
-
-Once the configure scripts are generated, thrift can be configured. From the top directory, do:
-
- export CXXFLAGS="-D PTHREAD_MUTEX_RECURSIVE_NP=PTHREAD_MUTEX_RECURSIVE"
- ./configure
-
-Setting the CXXFLAGS environmental variable works around compile errors with PTHREAD_MUTEX_RECURSIVE_NP being undeclared, by replacing it with the newer, portable PTHREAD_MUTEX_RECURSIVE. (Tested on cygwin 20100320, Thrift r760184, latest pthread.)
-
-**Optional:** You **may not** be able to make from the root Thrift directory due to errors (see below to resolve). To make the compiler only, change to the compiler directory before running make:
-
- cd compiler/cpp
-
-Now make the thrift compiler (& runtime libraries if make is run from the thrift root directory):
-
- make
- make install
-
-Some language packages must be installed manually using build tools better suited to those languages (at the time of this writing, this applies to Java, Ruby, PHP).
-
-Look for the README file in the `lib/<language>/` folder for more details on the installation of each language library package.
-
-### Possible issues with Cygwin install
-See also Possible issues with MinGW install.
-
-#### Syntax error in ./configure
-The following error occurs for some users when running ./configure:
-
- ./configure: line 21183: syntax error near unexpected token `MONO,'
- ./configure: line 21183: ` PKG_CHECK_MODULES(MONO, mono >= 1.2.6, have_mono=yes, have_mono=no)'
-
-To resolve this, you'll need to find your pkg.m4 (installed by the pkg-config package) file and copy it to the thrift/aclocal directory. From the top-level thrift directory, you can copy the file by running
-
- cp /usr/share/aclocal/pkg.m4 aclocal
-
-Finally, re-run ./bootstrap.sh and ./configure. (Note that pkg.m4 is created by the pkg-config tool. If your /usr/share/aclocal directory doesn't contain the pkg.m4 file, you may not have pkg-config installed.)
-
-#### Installing perl runtime libraries
-Sometimes, there will be an error during the install of the perl libraries with chmod.
-
-A workaround is to avoid installing the perl libraries if they are not needed.
-
-If you don't need perl, run configure with --without-perl.
-
-If you need perl, and are happy to manually install it, replace the contents of thrift/lib/perl/Makefile with the following, after building thrift:
-
- TODO
-
-#### Linking to installed C++ runtime libraries
-Sometimes, the installed libthrift.a will not link using g++, with linker errors about missing vtables and exceptions for Thrift classes.
-
-A workaround is to link the compiled object files directly from your Thrift build, corresponding to the missing classes.
-
-This can be implemented in a Makefile using the following lines:
-
- THRIFT_O=<path to>/thrift/lib/cpp
- LTHRIFT=$(THRIFT_O)/Thrift.o $(THRIFT_O)/TSocket.o $(THRIFT_O)/TBinaryProtocol.o $(THRIFT_O)/TBufferTransports.o
-
-Then linking using $(LTHRIFT) instead of -lthrift.
-
- TODO - diagnose issue further
-
-#### C++ runtime segfault with cygwin 1.7.5-1, g++-4.3.4, fork() and throw
-
-If your thrift C++ programs segfault on throw after fork()ing, compile them with g++-3.
-
-The issue and patch are described on the Cygwin mailing list at http://cygwin.com/ml/cygwin/2010-05/msg00203.html
-
-This issue should be fixed in Cygwin versions after 1.7.5-1, or g++ 4.5.0.
-
-## Installation from Source (No Cygwin dependency)
-To compile the Thrift generator & runtime libraries (untested) without the cygwin.dll dependency you need to install MinGW (www.mingw.org). In addition you need to add the following entry to your windows PATH variable.
-
- C:\MINGW\BIN
-
-Next, open compiler/cpp/Makefile.am and add the following line to thrift_CXXFLAGS
-
- -DMINGW -mno-cygwin -lfl
-
-Run bootstrap.sh:
-
- ./bootstrap.sh
-
-Make sure you have java in your $PATH variable, if not do(adjust path if necessary):
-
- export PATH=$PATH:"/cygdrive/c/program files/java/jre1.6.0_05/bin"
-
-Run configure - using CXXFLAGS to work around an issue with an old pthreads define (untested on MinGW - works on Cygwin):
-
- export CXXFLAGS="-D PTHREAD_MUTEX_RECURSIVE_NP=PTHREAD_MUTEX_RECURSIVE"
- ./configure
-
-''Optional:'' To make the compiler only, change to the compiler directory before running make:
-
- cd compiler/cpp
-
-Run make:
-
- mingw32-make.exe
-
-### Possible issues with MinGW install
-See also Possible issues with Cygwin install, including the discussion about PTHREAD_MUTEX_RECURSIVE_NP.
-
-#### yywrap is not found
-Make sure you add -lfl in your cxxflags in Makefile, also try adding -Lc:/cygwin/libs
-
-#### boost is not found
-Try and change the include dir to use the windows path from c like this: Edit compiler/cpp/Makefile, look for the declaration of BOOST_CPPFLAGS, change that line for
-
- BOOST_CPPFLAGS = -Ic:/cygwin/usr/include/boost-1_33_1
-
-#### realpath is not found
-add -DMINGW -mno-cygwin to the CXXDEFS variable in Makefile
-
-## Additional reading
-
-For more information on the requirements see: [Apache Thrift Requirements](/docs/install)
-
-For more information on building and installing Thrift see: [Building from source](/docs/BuildingFromSource)
-
+[snippet:path=doc/install/windows.md]
\ No newline at end of file