You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by wr...@apache.org on 2001/10/11 15:42:58 UTC
cvs commit: httpd-2.0/docs/man rotatelogs.8
wrowe 01/10/11 06:42:58
Modified: docs/man rotatelogs.8
Log:
Ok, this formats a whole lot cleaner, and (I believe) makes a bit more
sense. Also provides a rundown of C89 common date format strings, for
those users who don't have man strftime [It still points out that add'l
format options may b available, see strftime.]
Also, I believe _most_ installations require the TransferLog "|bin/
path to rotatelogs, no? Other question - how to reformat to html?
Which utility does so?
Revision Changes Path
1.6 +54 -5 httpd-2.0/docs/man/rotatelogs.8
Index: rotatelogs.8
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/man/rotatelogs.8,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- rotatelogs.8 2001/03/13 21:25:26 1.5
+++ rotatelogs.8 2001/10/11 13:42:58 1.6
@@ -61,13 +61,13 @@
.SH DESCRIPTION
.B rotatelogs
is a simple program for use in conjunction with Apache's piped logfile
-feature which can be used like this:
+feature, which can be used like this:
.fi
- TransferLog "| rotatelogs /path/to/logs/access_log 86400"
+TransferLog "|bin/rotatelogs /path/to/logs/logfile 86400"
.mf
-This creates the files /path/to/logs/access_log.nnnn where nnnn is the system
+This creates the files /path/to/logs/logfile.nnnn where nnnn is the system
time at which the log nominally starts (this time will always be a multiple of
the rotation time, so you can synchronize cron scripts with it). At the end
of each rotation time (here after 24 hours) a new log is started.
@@ -75,14 +75,63 @@
.IP \fB\fIlogfile\fP
The path plus basename of the logfile. If \fBlogfile\fP includes any
'%' characters, it is treated as a format string for \fIstrftime(3)\fP.
-Otherwise, the suffix .nnnn is automatically added and is the time at which
-the logfile was created.
+Otherwise, the suffix .nnnnnnnnnn is automatically added and is the time
+in seconds. Both formats compute the start time from the beginning of the
+current period.
.IP \fB\fIrotationtime\fP
The rotation time in seconds.
.IP \fB\fIoffset\fP
The number of minutes offset from UTC. If omitted, zero is assumed and
UTC is used. For example, to use local time in the zone UTC -5 hours,
specify a value of \fI-300\fP for this argument.
+.SH PORTABILITY
+The following logfile format string substitutions should be supported by
+all \fIstrftime(3)\fP implementations, see the \fIstrftime(3)\fP man page
+for library-specific extensions.
+.IP %A
+full weekday name (localized)
+.IP %a
+3-character weekday name (localized)
+.IP %B
+full month name (localized)
+.IP %b
+3-character month name (localized)
+.IP %c
+date and time (localized)
+.IP %d
+2-digit day of month
+.IP %H
+2-digit hour (24 hour clock)
+.IP %I
+2-digit hour (12 hour clock)
+.IP %j
+3-digit day of year
+.IP %M
+2-digit minute
+.IP %m
+2-digit month
+.IP %p
+am/pm of 12 hour clock (localized)
+.IP %S
+2-digit second
+.IP %U
+2-digit week of year (Sunday first day of week)
+.IP %W
+2-digit week of year (Monday first day of week)
+.IP %w
+1-digit weekday (Sunday first day of week)
+.IP %X
+time (localized)
+.IP %x
+date (localized)
+.IP %Y
+4-digit year
+.IP %y
+2-digit year
+.IP %Z
+time zone name
+.IP %%
+literal `%'
.PD
.SH SEE ALSO
.BR httpd(8)
Re: cvs commit: httpd-2.0/docs/man rotatelogs.8
Posted by jo...@slive.ca.
On Thu, 11 Oct 2001, William A. Rowe, Jr. wrote:
>
> Better yet, httpd-2.0/docs/docco/
Well, I committed it to site-tools/man2html/man2html.c for the moment.
If people prefer httpd-2.0/docs/docco/, I am fine with that.
The usage is:
nroff -man httpd.8 | man2html httpd > httpd.html
and then you must still hand edit the httpd.html file to remove the page
breaks and other nroff garbage.
This is not a very nice solution, but I did a moderately thorough search
of the net for similar tools, and I couldn't find any that looked better.
Probably a perl hacker could start with one of the perl ones and make
something useful.
Joshua.
---------------------------------------------------------------------
To unsubscribe, e-mail: apache-docs-unsubscribe@apache.org
For additional commands, e-mail: apache-docs-help@apache.org
Re: cvs commit: httpd-2.0/docs/man rotatelogs.8
Posted by "William A. Rowe, Jr." <wr...@covalent.net>.
From: "William A. Rowe, Jr." <wr...@rowe-clan.net>
Sent: Thursday, October 11, 2001 9:12 AM
> From: "Joshua Slive" <jo...@slive.ca>
> Sent: Thursday, October 11, 2001 9:09 AM
>
> > > From: wrowe@apache.org [mailto:wrowe@apache.org]
> >
> > > Other question - how to reformat to html?
> > > Which utility does so?
> >
> > I have a very nasty hack of a c program that converts nroff *output* to
> > html. I would like to upload it somewhere so that others can use it, but I
> > don't know where. Any suggestions?
>
> Grump... no good ideas, other than perhaps create a docs/build directory for
> all the expand.pl-style cruft. That would make a good home for all of these.
Better yet, httpd-2.0/docs/docco/
this could contain any docco-documentation (how to document, examples, etc),
docco helper scripts, and docco status.
Any objections?
---------------------------------------------------------------------
To unsubscribe, e-mail: apache-docs-unsubscribe@apache.org
For additional commands, e-mail: apache-docs-help@apache.org
Re: cvs commit: httpd-2.0/docs/man rotatelogs.8
Posted by Rodent of Unusual Size <Ke...@Golux.Com>.
"William A. Rowe, Jr." wrote:
>
> From: "Joshua Slive" <jo...@slive.ca>
> Sent: Thursday, October 11, 2001 9:09 AM
>
> > > From: wrowe@apache.org [mailto:wrowe@apache.org]
> >
> > > Other question - how to reformat to html?
> > > Which utility does so?
> >
> > I have a very nasty hack of a c program that converts
> > nroff *output* to html. I would like to upload it
> > somewhere so that others can use it, but I
> > don't know where. Any suggestions?
>
> Grump... no good ideas, other than perhaps create a
> docs/build directory for all the expand.pl-style cruft.
We already have the site-tools repository for this sort
of stuff.
--
#ken P-)}
Ken Coar, Sanagendamgagwedweinini http://Golux.Com/coar/
Author, developer, opinionist http://Apache-Server.Com/
"All right everyone! Step away from the glowing hamburger!"
---------------------------------------------------------------------
To unsubscribe, e-mail: apache-docs-unsubscribe@apache.org
For additional commands, e-mail: apache-docs-help@apache.org
Re: cvs commit: httpd-2.0/docs/man rotatelogs.8
Posted by "William A. Rowe, Jr." <wr...@rowe-clan.net>.
From: "Joshua Slive" <jo...@slive.ca>
Sent: Thursday, October 11, 2001 9:09 AM
> > From: wrowe@apache.org [mailto:wrowe@apache.org]
>
> > Other question - how to reformat to html?
> > Which utility does so?
>
> I have a very nasty hack of a c program that converts nroff *output* to
> html. I would like to upload it somewhere so that others can use it, but I
> don't know where. Any suggestions?
Grump... no good ideas, other than perhaps create a docs/build directory for
all the expand.pl-style cruft. That would make a good home for all of these.
> Meanwhile, I did the conversion.
Cool, thanks. I noticed that it was already out of date when I got there, you
might want to run through the entire docs/man/ set just for kicks.
Bill
---------------------------------------------------------------------
To unsubscribe, e-mail: apache-docs-unsubscribe@apache.org
For additional commands, e-mail: apache-docs-help@apache.org
RE: cvs commit: httpd-2.0/docs/man rotatelogs.8
Posted by Joshua Slive <jo...@slive.ca>.
> -----Original Message-----
> From: wrowe@apache.org [mailto:wrowe@apache.org]
> Other question - how to reformat to html?
> Which utility does so?
>
I have a very nasty hack of a c program that converts nroff *output* to
html. I would like to upload it somewhere so that others can use it, but I
don't know where. Any suggestions?
Meanwhile, I did the conversion.
Joshua.
---------------------------------------------------------------------
To unsubscribe, e-mail: apache-docs-unsubscribe@apache.org
For additional commands, e-mail: apache-docs-help@apache.org