FINDMODS(1M-SysV)   RISC/os Reference Manual    FINDMODS(1M-SysV)



NAME
     findmods - generate a list of locally modified files in a
     software package

SYNTAX
     findmods package version

DESCRIPTION
     findmods is used to create a list of files which have been
     locally modified in a software package. The list is usually
     used as input to the preserve command when update releases
     of a software package are installed (see preserve(1M)).
     findmods relies on the fact that every release has a unique
     time stamp, which is borne (as the modification time) by all
     files included in the release.  A list of the releases
     installed on a system, and their associated time stamps, is
     maintained in the file /etc/installlog.

     findmods takes as input the software bill of materials files
     (``bomfile''s; see bom(4)) for the   software package.

     For each file named in the bomfiles, findmods examines the
     modification time of the file on the target system.  The
     modification time is compared the list of modification times
     associated with prior releases installed on the system.  If
     the modification time of the file is found to match one of
     these release timestamps, it is assumed that the file came
     from that release, and hence is not a locally modified file.
     If the modification time of the file does not match any of
     the time stamps in the list, it is assumed that the file did
     not come from a release, and hence was created or modified
     locally. In this case, findmods emits the pathname of the
     file on its standard output, which is typically part of
     preserve's standard input. When preserve sees this pathname,
     it will take action to preserve the file.

     For findmods to work, the file /etc/installlog must be
     present on the target system.  It is created or updated
     automatically when a software package is installed. This
     file contains time stamps for the releases of software pack-
     ages installed on the system.  For details on the format of
     this file, see installlog(4).

     For findmods to work correctly, the clock on the the target
     system should be kept accurate, to insure that the modifica-
     tion time stamps of the files in the software package on the
     target system will be valid.

FILES
     /etc/installlog
     /usr/pkg/bin/findmods




                         Printed 1/15/91                   Page 1

FINDMODS(1M-SysV)   RISC/os Reference Manual    FINDMODS(1M-SysV)



SEE ALSO
     preserve(1M).
     bom(4), installlog(4) in the Programmer's Reference Manual.




















































 Page 2                  Printed 1/15/91