r1519@opsdev009 (orig r80499): mcslee | 2008-01-30 17:49:16 -0800
[amiethrift.git] / lib / cpp / README
blob09a5c34d14b6a5e5e5bef48f401ff169e6052e6a
1 Thrift C++ Software Library
3 README Author: Mark Slee (mcslee@facebook.com)
4 Last Modified: 2007-Mar-05
6 Thrift is distributed under the Thrift open source software license.
7 Please see the included LICENSE file.
9 Using Thrift with C++
10 =====================
12 The Thrift C++ libraries are built using the GNU tools. Follow the instructions
13 in the top-level README, or run bootstrap.sh in this folder to generate the
14 Makefiles.
16 In case you do not want to open another README file, do this:
17   ./bootstrap.sh
18   ./configure (--with-boost=/usr/local)
19   make
20   sudo make install
22 Thrift is divided into two libraries.
24 libthrift
25   The core Thrift library contains all the core Thrift code. It requires
26   boost shared pointers, pthreads, and librt.
28 libthriftnb
29   This library contains the Thrift nonblocking server, which uses libevent.
30   To link this library you will also need to link libevent.
32 Linking Against Thrift
33 ======================
35 After you build and install Thrift the libraries are installed to
36 /usr/local/lib by default. Make sure this is in your LDPATH.
38 On Linux, the best way to do this is to ensure that /usr/local/lib is in
39 your /etc/ld.so.conf and then run /sbin/ldconfig.
41 Depending upon whether you are linking dynamically or statically and how
42 your build environment it set up, you may need to include additional
43 libraries when linking against thrift, such as librt and/or libpthread. If
44 you are using libthriftnb you will also need libevent.
46 Dependencies
47 ============
49 boost shared pointers
50 http://www.boost.org/libs/smart_ptr/smart_ptr.htm
52 libevent (for libthriftnb only)
53 http://monkey.org/~provos/libevent/