[lttv.git] / trunk / ltt-control / 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
3d7a0555	1	ltt-control package README
	2	--------------------------
	3	Mathieu Desnoyers
	4	Last update: 2007/05/14
	5
f1f05d47	6
4a89deea	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.
f1f05d47	10
	11	* Compiling
	12
	13	gcc 3.2 or better
f1f05d47	14	glib 2.4 or better development libraries
	15	(Debian : libglib2.0-0, libglib2.0-dev)
	16	(Fedora : glib2, glib2-devel)
f1f05d47	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
3d7a0555	34	See the LTTV package QUICKSTART file.
3d7a0555	35
f1f05d47	36
	37	* Source Tree Structure
	38
3d7a0555	39	Here is the tree structure of the ltt-control package.
f1f05d47	40
3d7a0555	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.
f1f05d47	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
3d7a0555	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/)
f1f05d47	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.