[ltt-control.git] / README

ltt-control package README
--------------------------
Mathieu Desnoyers 
Last update: 2007/05/14


This package contains the lttd, lttctl and liblttctl programs which are
necessary to obtain a trace. It also contains the facilities directory, where
sits the trace metainformation.

* Compiling

gcc 3.2 or better
glib 2.4 or better development libraries
  (Debian : libglib2.0-0, libglib2.0-dev)
  (Fedora : glib2, glib2-devel)
libc6 development librairies 
  (Debian : libc6, libc6-dev)
  (Fedora : glibc, glibc)


To compile the source tree from a tarball, simply follow these steps :

- ./configure
- make
- make install

After running ./configure, you can also go in specific subdirectories and
use make, make install.


* Quick Start

See the LTTV package QUICKSTART file.


* Source Tree Structure

Here is the tree structure of the ltt-control package.

ltt/		New trace format reading library.
liblttctl/	Library to communicate with the kernel tracer control module.
lttctl/		Command line program to use the liblttctl library.
lttd/		Linux Trace Toolkit daemon.
README		This file.


* For Developers

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 subversion repository tree :

- GNU autotools (automake >=1.7, autoconf >=2.50, autoheader >=2.50)
  (make sure your system wide "automake" points to a recent version!)
- GNU Libtool
  (for more information, go to http://www.gnu.org/software/autoconf/)

If you get the tree from the repository, you will need to use the autogen.sh
script. It calls all the GNU tools needed to prepare the tree configuration.
Commit	Line	Data
d5f1b581	1	ltt-control package README
	2	--------------------------
	3	Mathieu Desnoyers
	4	Last update: 2007/05/14
	5
2727692a	6
bd717393	7	This package contains the lttd, lttctl and liblttctl programs which are
	8	necessary to obtain a trace. It also contains the facilities directory, where
	9	sits the trace metainformation.
2727692a	10
	11	* Compiling
	12
	13	gcc 3.2 or better
2727692a	14	glib 2.4 or better development libraries
	15	(Debian : libglib2.0-0, libglib2.0-dev)
	16	(Fedora : glib2, glib2-devel)
2727692a	17	libc6 development librairies
	18	(Debian : libc6, libc6-dev)
	19	(Fedora : glibc, glibc)
	20
	21
	22	To compile the source tree from a tarball, simply follow these steps :
	23
	24	- ./configure
	25	- make
	26	- make install
	27
	28	After running ./configure, you can also go in specific subdirectories and
	29	use make, make install.
	30
	31
	32	* Quick Start
	33
d5f1b581	34	See the LTTV package QUICKSTART file.
d5f1b581	35
2727692a	36
	37	* Source Tree Structure
	38
d5f1b581	39	Here is the tree structure of the ltt-control package.
2727692a	40
d5f1b581	41	ltt/ New trace format reading library.
	42	liblttctl/ Library to communicate with the kernel tracer control module.
	43	lttctl/ Command line program to use the liblttctl library.
	44	lttd/ Linux Trace Toolkit daemon.
	45	README This file.
2727692a	46
	47
	48	* For Developers
	49
	50	This source tree is based on the autotools suite from GNU to simplify
	51	portability. Here are some things you should have on your system in order to
	52	compile the subversion repository tree :
	53
d5f1b581	54	- GNU autotools (automake >=1.7, autoconf >=2.50, autoheader >=2.50)
	55	(make sure your system wide "automake" points to a recent version!)
	56	- GNU Libtool
	57	(for more information, go to http://www.gnu.org/software/autoconf/)
2727692a	58
	59	If you get the tree from the repository, you will need to use the autogen.sh
	60	script. It calls all the GNU tools needed to prepare the tree configuration.