1
######################################
2
# Welcome to installwatch 0.7.0beta1 #
3
######################################
8
Installwatch is Copyright 1998 by Pancrazio `Ezio' de Mauro
11
* Installwatch is no longer mantained by Pancrazio, you should now contact
12
me with any issues relating to it:
14
Felipe Eduardo Sanchez Diaz Duran <izto at asic-linux.com.mx>
15
http://asic-linux.com.mx/~izto
17
This package is distributed under the GPL license. Have a look at
18
COPYING if you don't know what it means.
22
installwatch <command>
24
This monitors <command> and logs using the syslog(3) facility every created
27
installwatch -o <filename> <command>
29
does the same thing, but writing data in <filename>, which is truncated
34
installwatch -o ~/install/foobar-x.y make install
36
Extra options are displayed by running:
43
Installwatch is an extremely simple utility I wrote to keep track of
44
created and modified files during the installation of a new program.
46
It's fast and easy to use. It doesn't require a ``pre-install'' phase
47
because it monitors processes while they run.
49
Installwatch works with every dynamically linked ELF program,
50
overriding system calls that cause file system alterations. Some of
51
such system calls are open(2) and unlink(2).
53
Installwatch is especially useful on RedHat, Debian and similar
54
distributions, where you can use a package system to keep track
55
of installed software. (See specific package details below).
57
Of course a simple `make install' does not update the package database,
58
making your installation ``dirty'' -- well, kind of.
60
If your room is a mess but you make RPMS even for your home directory,
61
then installwatch is for you. (See RPMS below).
63
Here's a typical installwatch use. After compiling your brand new
66
installwatch make install
68
instead of a simple make install. Then have a look at your logs.
70
Installwatch logs by default using syslog(3), with a
71
``LOG_USER | LOG_INFO'' priority.
73
Usually the log file is /var/log/messages, but if may vary.
75
If you want to log on a particular file (my preferred method) just
78
installwatch -o filename make install
80
The log format may look ugly at first glance, but it is designed to
81
be easily processed by programs.
83
Every record ends with a newline, every field is delimited with a TAB
84
character (it is ``^I'' when you use syslog.)
86
The fields of a record are, in order:
88
<return-value> <syscall-name> <arguments> #<comment>
90
So made lines are really easy to process, if arguments don't contain
96
Ok, so you've done a "installwatch -o logfile make install", but how do
97
you tell the RPM database about this? You use CheckInstall.
99
http://asic-linux.com.mx/~izto/checkinstall
101
The inst2rpm script that used to be distributed along with installwatch
102
is not supported by me, it has been superseeded by CheckInstall.
104
If you still want it, you can get an older version of installwatch (0.5.6),
105
where you will find it inside the contrib directory. Installwatch's versions
106
starting from 0.5.5 are available at
108
http://asic-linux.com.mx/~izto/installwatch.html
111
$Id: README,v 0.7.0.1 2003/12/14 07:13:52 izto Exp $