X-Git-Url: https://git.lttng.org/?p=lttng-tools.git;a=blobdiff_plain;f=README;h=6c5da7959743fb708a14bde40e9fdf690957cad8;hp=d8d38d884b42cb2e95c11ca962e039d42f6fcf73;hb=cf65966e6932b5de2e4e8895dee674e16b09f574;hpb=8bf332b9ad2aa7094c3f713399c2a3746f04a10b diff --git a/README b/README index d8d38d884..6c5da7959 100644 --- a/README +++ b/README @@ -10,6 +10,10 @@ Latest development can be found at: REQUIREMENTS: + - Linux kernel >= 2.6.27 + pipe2(), epoll_create1() and SOCK_CLOEXEC are needed to run the session + daemon. There were introduce in the Linux 2.6.27 + - liburcu Userspace RCU library, by Mathieu Desnoyers and Paul E. McKenney @@ -19,11 +23,29 @@ REQUIREMENTS: * Git : git://git.lttng.org/userspace-rcu.git * Website: http://lttng.org/urcu - - libpopt + - libpopt >= 1.13 Library for parsing command line parameters * Debian/Ubuntu package: libpopt-dev +For developers using the git tree: + +This source tree is based on the autotools suite from GNU to simplify +portability. Here are some things you should have on your system in order to +compile the git repository tree : + +- GNU autotools (automake >=1.10, autoconf >=2.50, autoheader >=2.50) + (make sure your system wide "automake" points to a recent version!) +- GNU Libtool >=2.2 + (for more information, go to http://www.gnu.org/software/autoconf/) +- GNU Gold >= 2.22 + (Before this version we hit a known bug documented at: + http://sourceware.org/bugzilla/show_bug.cgi?id=11317) + +If you get the tree from the repository, you will need to use the "bootstrap" +script in the root of the tree. It calls all the GNU tools needed to prepare the +tree configuration. + INSTALLATION INSTRUCTIONS: - Download, compile and install the prerequisites. @@ -49,18 +71,27 @@ PACKAGE CONTENTS: - liblttngctl The LTTng tracing control library. - - liblttng-sessiond-comm - The lttng-sessiond communication library. In order to talk with lttng-sessiond, - this library must be used. + - libsessiond-comm (internal) + The lttng-sessiond communication library. In order to talk with + lttng-sessiond, this library must be used. - - libkernelctl + - libkernel-ctl (internal) Kernel tracer control and ioctl definitions. - - liblttng-consumer + - libconsumer (internal) Library for Kernel and (optionally) UST trace consumer. + - libkernel-consumer (internal) + Library for Kernel consumer control + + - libust-consumer (internal) + Library for UST consumer control + + - libhashtable (internal) + Library wrapper over URCU hashtables. + - lttng-consumerd - The consumer daemon which uses liblttng-consumer. + The consumer daemon which uses libconsumer. - lttng-sessiond The LTTng session daemon binary. @@ -73,3 +104,6 @@ PACKAGE CONTENTS: - tests Various test programs. + + - doc + Various documentations and quickstart guide.