NEWSYSLOG -- A portable and enhanced version of this old standard

This file:  Copyright (C) 1997,1998,1999 Planix, Inc.
	    see COPYING for details

This is an updated version of a package put together by Theodore Ts'o ,
of MIT Project Athena (which is included in NetBSD, FreeBSD, OpenBSD,
and probably other OS' too).

What does this version of newsyslog have to offer over others?

	- It is more portable (using GNU Autoconf) and it can be
	  compiled and installed on most any modern Unix or Unix-like
	  system.

	- It has support for fixed time-of-day daily archiving with a
	  command-line option to identify the daily roll-over invocation
	  (which may be at midnight, or at any other regular daily time).

	- It supports the FreeBSD feature that allows specification of
	  the log roll-over time as a daily, weekly, or monthly interval
	  (with optional time-of-day specification for the last two).
	  [The other overly flexible, ISO 8601 interpretation of the
	  interval "@" option is not supported -- it is too generic and
	  not meaningful enough in the context of log file management.]

	- It supports optional PID files so that non-standard daemons
	  can be told to re-open their logfiles after archiving has
	  taken place.  (Including /dev/null which disables signalling
	  of any daemon when the specified log file is rolled over.)

	- It can send a signal other than SIGHUP to the daemon
	  associated with a given log file.

	- It can leave the most recently archived log file uncompressed,
	  which is necessary for daemons like httpd and smail because
	  they continue to write to the current log file until their
	  current jobs have completed.  (This also makes it much easier
	  to review recent log data with normal Unix tools.)  [NetBSD
	  now has this feature.]

	- It supports the FreeBSD feature of being able to restrict
	  processing to just those log files specified on the command
	  line.

	- Unlike the NetBSD version it first parses the config file
	  before taking any action, meaning that if any errors are
	  encountered it will report them and quit without doing
	  anything.

	- Unlike the FreeBSD version, it will roll a log file if
	  *either* the interval or size limits have been reached
	  (FreeBSD's version makes it too easy to have a rapidly growing
	  log file overflow the filesystem).

	- Unlike the NetBSD version it always creates any missing log
	  file (though this can be disabled on a per-file basis).

	- It uses an advisory lock on the current configuration file to
	  prevent multiple invocations from tripping over each other.

	- The documentation is far better!

(For more specific details and recent changes see the NEWS file.)


TO BUILD NEWSYSLOG

If you are building newsyslog on a BSD-based system you can also use
"Makfile.BSD".  This is in fact necessary if your system requires
installation of pre-formatted manual pages (otherwise you'll have to
install them by hand).  The simplest way to do this is to run the
"newsyslog2netbsd.sh" script, then go into the "import.d" directory
created by the script, check the Makefile and possibly update the
default options in it, and finaly then simply run "make".  Note that if
you want to change the location of the install, or other pathnames then
you should change them in the "newsyslog2netbsd.sh" script *before* you
run it:

	# inspect and/or edit newsyslog2netbsd.sh
	sh newsyslog2netbsd.sh
	cd import.d
	make
	make istall

Newsyslog can also be built using the GNU Autoconf based build system
and a ``normal'' (i.e. Unix compatible) "make".

Please see the file "INSTALL" for overall instructions on how to
configure and build this package using the GNU Autoconf generated
"configure" script.

In general you need only run "./configure && make && make install"

You may choose to use GNU Zip in preference to the default compress
program as the archive compression too with:

	./configure --with-gzip

WARNING:  If you have previously configured newsyslog without the above
option and now wish to add it you will have to remove ./config.cache
first to prevent the wrong program pathname from being used.

Beware that you may need to specify exactly where your syslogd keeps
it's pid-file.  This can be done either by specifying an alternate
directory prefix to ./configure in this way ("/run/syslog.pid" will be
appended to the directory name given):

	./configure --localstatedir=/var

or by specifying an explicit pathname to ./configure in this way:

	./configure --with-syslog_pid=/var/run/mysyslog.pid

The default configuration file location can be modified by specifying an
alternate directory to ./configure in this way ("/newsyslog.conf will be
appended to the directory name given):

	./configure --sysconfdir=/etc

or by specifying an explicit pathname to ./configure in this way:

	./configure --with-newsyslog_conf=/etc/newsyslog.conf

Try './configure --help' for more options.


FOR MORE INFORMATION

If you have any troubles, questions, or feature requests, please send
mail to <bugs@robohack.planix.com>.  The lastest version of this
software is available at:

	<URL:ftp://ftp.planix.com/pub/Planix/newsyslog.tar.gz>

-- 
						Greg A. Woods
						<woods@planix.com>


#ident	"@(#)newsyslog:newsyslog-1_0_99:README,v 1.6 2000/12/01 19:58:45 woods Exp"
