summaryrefslogtreecommitdiff
path: root/README
blob: 5cfe7a3a6a980a1b32f44162fd6baa85edf69926 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
Hi all,

[PLEASE READ THE FILE ``README.LATEST'' FOR LATEST NEWS]

this is the latest alpha version of libgtop, a library that fetches
information about the running system such as cpu and memory usage,
active processes etc. On Linux systems, these information are taken
directly from the /proc filesystem. For other systems such as Solaris,
where such programs need to be suid root (or only setgid kmem/mem on
some systems), it provides a suid/setgid server that fetches those
information and a client-side library that talks to this server.

Main idea was to have the same interface for all operating systems,
thus all system dependent details are hidden in the implementation
of that server.

Currently, it only works for Linux, documentation on how to port it
to other systems is on the way. I'm planning to keep this site an
up-to-date mirror of my local machine (which is connected to the
internet over some expensive dialup connection, so I'll upload it about
once every day I made significant changes) so that you can always find
the latest version of the software here.

I've written a simple guile interface for the library to show which
information it can already fetch. See examples/third for details.

Source Code:
===========

   libgtop-current-cvs.cpio.gz     is a cpio archive from the CVS repository
   libgtop-current.cpio.gz         contains the lates checked out sources
   libgtop-stable.cpio.gz          if present, it contains the last stable release

Documentation:
=============

   libgtop.sgml                    is the SGML source of the (DocBook) documentation

The next three files are only provided until they get too big to upload.

   libgtop.tex                     TEX file of the documentation
   libgtop.dvi                     DVI file of the documentation
   libgtop.ps                      Postscript file of the documentation

HTML-Documentation:
==================

   libgtop.shtml                   Start here to browse the HTML documentation

Other stuff:
===========

   README, NEWS, ChangeLog         copied from the sources

Enjoy it!

Martin (martin@home-of-linux.org - baulig@merkur.uni-trier.de)