"Fossies" - the Fresh Open Source Software Archive

Member "checkinstall-1.6.2/installwatch/README" (11 Nov 2008, 3579 Bytes) of package /linux/privat/old/checkinstall-1.6.2.tar.gz:

    1 ######################################
    2 # Welcome to installwatch 0.7.0beta7 #
    3 ######################################
    4 
    5 ================
    6 The short story:
    7 
    8    Installwatch is Copyright 1998 by Pancrazio `Ezio' de Mauro
    9    <p@demauro.net>
   10 
   11    * Installwatch is no longer mantained by Pancrazio, you should now contact
   12       me with any issues relating to it:
   13 
   14       Felipe Eduardo Sanchez Diaz Duran <izto at asic-linux.com.mx>
   15       http://asic-linux.com.mx/~izto
   16 
   17    This package is distributed under the GPL license. Have a look at
   18    COPYING if you don't know what it means.
   19 
   20    To use it, just type:
   21 
   22            installwatch <command>
   23 
   24    This monitors <command> and logs using the syslog(3) facility every created
   25    or modified file.
   26 
   27            installwatch -o <filename> <command>
   28 
   29    does the same thing, but writing data in <filename>, which is truncated
   30    if it already exixts.
   31 
   32    The typical use is:
   33 
   34            installwatch -o ~/install/foobar-x.y make install
   35 
   36    Extra options are displayed by running:
   37 
   38            installwatch --help
   39 
   40 ===============
   41 The long story:
   42 
   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.
   45 
   46    It's fast and easy to use. It doesn't require a ``pre-install'' phase
   47    because it monitors processes while they run.
   48 
   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).
   52 
   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).
   56 
   57    Of course a simple `make install' does not update the package database,
   58    making your installation ``dirty'' -- well, kind of.
   59 
   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).
   62 
   63    Here's a typical installwatch use. After compiling your brand new
   64    package, just type
   65 
   66            installwatch make install
   67 
   68    instead of a simple make install. Then have a look at your logs.
   69 
   70    Installwatch logs by default using syslog(3), with a
   71    ``LOG_USER | LOG_INFO'' priority.
   72 
   73    Usually the log file is /var/log/messages, but if may vary.
   74 
   75    If you want to log on a particular file (my preferred method) just
   76    type:
   77 
   78            installwatch -o filename make install
   79 
   80    The log format may look ugly at first glance, but it is designed to
   81    be easily processed by programs.
   82 
   83    Every record ends with a newline, every field is delimited with a TAB
   84    character (it is ``^I'' when you use syslog.)
   85 
   86    The fields of a record are, in order:
   87 
   88 	   <return-value> <syscall-name> <arguments> #<comment>
   89 
   90    So made lines are really easy to process, if arguments don't contain
   91    TABs or pound signs.
   92 
   93 =====
   94 RPMS:
   95 
   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.
   98 
   99    http://asic-linux.com.mx/~izto/checkinstall
  100 
  101    The inst2rpm script that used to be distributed along with installwatch
  102    is not supported by me, it has been superseeded by CheckInstall.
  103 
  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
  107    
  108    http://asic-linux.com.mx/~izto/installwatch.html
  109 
  110 ===============
  111 $Id: README,v 0.7.0.2 2006/11/01 07:34:36 izto Exp $