logrotate [LSARC/2008/359 FastTrack timeout 06/10/2008]

[Dean Roehrich]

Template Version: @(#)sac_nextcase 1.66 04/17/08 SMI
This information is Copyright 2008 Sun Microsystems
1. Introduction
    1.1. Project/Component Working Name:
	 logrotate
    1.2. Name of Document Author/Supplier:
	 Author:  Colin Ngam
    1.3  Date of This Document:
	03 June, 2008
4. Technical Description
1. Background

	Logrotate rotates log files and archives them in a central location.

	Logrotate is externally maintained Free Open Source Software (FOSS).
	Sun's role with this project is to port and monitor the open source
	project.  For additional information about the project or originating
	community, see [1].  Upstream code changes are not currently needed or
	anticipated because the project already compiles and runs under
	Solaris and the version being integrated is stable.

	Logrotate is licensed under GPLv2 or later, though Sun will only
	distribute it under version 2.  See OSR #8589 [2] for more
	information.  This project will port logrotate 3.7.1.

	This project requests a minor release binding.


2. Architecture

	Logrotate reads the configuration file to determine which
	log files it should handle and what policies should be used
	for each log file.

	Based on the given rotation policy, a logfile may be renamed with a
	number added as a suffix.  The policy can be used specify the date
	instead of the number, and also can specify a file extension suffix to
	be added to the rotated log.  The policy can also specify that the
	rotated log be compressed, i.e. gzip.

	The policy can also tell logrotate to execute a command after the
	rotation; for example, to send SIGHUP to a daemon so it starts a new
	logfile.


3. Interfaces & Dependencies

   Exported Interfaces:

    Interface Name              Classification      Comments
    --------------------------- ------------------- --------------------
    SUNWlogrotate               Uncommitted         Package name
    logrotate                   Uncommitted         Commandline syntax
    logrotate.conf              Uncommitted         Configuration syntax
    /usr/sbin/logrotate         Uncommitted         Executable location
    /usr/share/man/man8/logrotate.8 Uncommitted   Man page
    /etc/logrotate.conf         Uncommitted         Config file location


   Imported Interfaces:

    Interface Name              Classification      Comments
    --------------------------- ------------------- --------------------
    libpopt(3)                  External


4. References

[1] http://www.sunfreeware.com
[2] https://opensourcereview.central.sun.com/app?action=ViewReq&traq_num=8589

6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		SFW
    6.5. ARC review type: FastTrack
    6.6. ARC Exposure: open