
 README

 FR -- File Rotator -- Instructions

 Copyright (c) 2000 Edward V. POPKOV
 Distributed under GPL, see COPYING for details

 "Edward V. POPKOV" <evpopkov@carry.netnet.lv>

 $Id: README,v 0.2 2000/04/13 23:50:36 root Exp root $

 $Log: README,v $
 Revision 0.2  2000/04/13 23:50:36  root
 Added unlimited dirs on command line

 Revision 0.1  2000/04/10 16:37:03  root
 Additional fallback features

 Revision 0.0  2000/04/07 14:54:19  root
 Initial check-in


 Contents

 1. What is FR?
 2. Requirements
 3. Installation
 4. Distribution
 5. Acknowledgements
 6. How to contribute

 1. What is FR?

 FR is a DFC add-on. It expects DFC to share a file of a special format, which
it tries to read from shared memory and find an entry that corresponds to
the directories passed to FR via command line. When the entry is found, FR
picks a random filename from dirtab and pumps the file to stdout. If the
directory is missing from dirtab, FR skips it and tries the next one given
on command line, if any. Count of dirs on FR command line is limited only
by the OS.
 If anything goes wrong, FR just silently quits with EXIT_SUCCESS.

 2. Requirements

 Development and testing platform is PC under Linux 2.0.38, libc5. You need to
have IPC support compiled into your kernel.

 3. Installation

 # configure
 # make
 # make -n install
 # make install

 Makefile also has uninstall and upgrade targets. Format of fr.conf:

:<dirname>
<filecount>
<file0>
...
<filen>

 No blanks, no empty lines, no comments. utils/conf.pl should help.

 4. Distribution

 FR is GPL'ed, see COPYING for details.

 5. Acknowledgements

 FR project sponsor is "Kevin M. Liang" <kevinml@idig.net>.

 In my work I'm using:

  Linux, bash, vim, autoconf, make, sed, gcc, ld

 Thanks to developers of these and numerous other free and open source tools.

 6. Contributions

 Get in touch with me if you want to add to FR.

 Thx and take care

Edward V. POPKOV
Independent Developer

-----BEGIN GEEK CODE BLOCK-----
Version: 3.1
GCS/CC d-(+) s:- a C$ UL+++>$ P+ L++(+++)>$ E--- W--(+) N
o? K? w$ !O M? V PS+ PE Y PGP t? 5? X? R !tv b++@ DI D+ G++
e h* r++ y+++
-----END GEEK CODE BLOCK-----

End of README
