Welcome to installwatch 0.5.5

The short story:

   Installwatch is Copyright 1998 by Pancrazio `Ezio' de Mauro
   <pdm@demauro.net>

   This package is distributed under the GPL license. Have a look at
   COPYING if you don't know what it means.

   To use it, just type:

           installwatch <command>

   This monitors <command> and logs using the syslog(3) facility every created
   or modified file.

           installwatch -o <filename> <command>

   does the same thing, but writing data in <filename>, which is truncated
   if it already exixts.

   The typical use is:

           installwatch -o ~/install/foobar-x.y make install

The long story:

   Installwatch is an extremely simple utility I wrote to keep track of
   created and modified files during the installation of a new program.

   It's fast and easy to use. It doesn't require a ``pre-install'' phase
   because it monitors processes while they run.

   Installwatch works with every dynamically linked ELF program,
   overriding system calls that cause file system alterations. Some of
   such system calls are open(2) and unlink(2).

   Installwatch is especially useful on RedHat, Debian and similar
   distributions, where you can use a package system to keep track
   of installed software.  (See specific package details below).

   Of course a simple `make install' does not update the package database,
   making your installation ``dirty'' -- well, kind of.

   If your room is a mess but you make RPMS even for your home directory,
   then installwatch is for you.  (See RPMS below).

   Here's a typical installwatch use. After compiling your brand new
   package, just type

           installwatch make install

   instead of a simple make install. Then have a look at your logs.

   Installwatch logs by default using syslog(3), with a
   ``LOG_USER | LOG_INFO'' priority.

   Usually the log file is /var/log/messages, but if may vary.

   If you want to log on a particular file (my preferred method) just
   type:

           installwatch -o filename make install

   The log format may look ugly at first glance, but it is designed to
   be easily processed by programs.

   Every record ends with a newline, every field is delimited with a TAB
   character (it is ``^I'' when you use syslog.)

   The fields of a record are, in order:

	   <return-value> <syscall-name> <arguments> #<comment>

   So made lines are really easy to process, if arguments don't contain
   TABs or pound signs.

RPMS:

   Ok, so you've done a "installwatch -o logfile make install", but how do
   you tell the RPM database about this?  This is where inst2rpm comes in.
   This is a script contributed by Jon Christopher <jac8792@tamu.edu>
   which parses an installwatch log file, logfile,creates a binary RPMof
   the installed files, and "installs" the RPM.  Removing the installed
   package is as simple as "rpm -e packagename".  Even better, you can
   distribute the binary RPM!  No more nasty spec files.

   You run inst2rpm as follows "inst2rpm logfile" where logfile is the log
   file created by installwatch.  You will then be prompted for some
   information the RPM file needs, like the package name, version number,
   and so on.  After this inst2rpm analyzes the installwatch log file,
   generates a list of files which were installed, and creates a binary
   rpm containing the installed files.  Unfortunately, no SOURCE rpm is
   created, but I suppose that  could be done as well with a bit of extra
   work. 

   inst2rpm is not perfect, but handles most cases well.  Suggestions and
   patches are welcome.

