.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "ACTIVE.TIMES 5"
.TH ACTIVE.TIMES 5 2024-04-01 "INN 2.7.2" "InterNetNews Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
active.times \- List of local creation times of newsgroups
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The file \fIpathdb\fR/active.times provides a chronological record of when
newsgroups were created on the local server.  This file is normally
updated by \fBmod-active\fR and \fBinnd\fR whenever a newgroup control message
is processed or a \f(CW\*(C`ctlinnd newgroup\*(C'\fR command is issued, and is used
by \fBnnrpd\fR to answer NEWGROUPS requests.
.PP
Each line consists of three fields:
.PP
.Vb 1
\&    <name> <time> <creator>
.Ve
.PP
The first field is the name of the newsgroup.  The second field is the
time it was created, expressed as the number of seconds since the epoch.
The third field is plain text intended to describe the entity that created
the newsgroup.  This field is encoded in UTF\-8 and is usually the e\-mail
address of the person who created the group, as specified in the control
message or on the \fBctlinnd\fR command line, or the newsmaster specified
at configure time if no creator argument was given to \fBctlinnd\fR (by
default, it is \f(CW\*(C`usenet\*(C'\fR).
.PP
You can get the \fIactive.times\fR file of another NNTP server with getlist(1).
.SH EXAMPLE
.IX Header "EXAMPLE"
The line:
.PP
.Vb 1
\&   news.admin.moderation 1175716803 <group\-admin@isc.org>
.Ve
.PP
shows that the newsgroup news.admin.moderation was created on April 4th, 2007,
at 20:00:03 UTC.  This date can be obtained for instance with
\&\f(CW\*(C`convdate \-dc 1175716803\*(C'\fR (convdate(1) is shipped with INN) or
\&\f(CW\*(C`date \-u \-d "Jan 1, 1970 00:00:00 +0000 + 1175716803 seconds"\*(C'\fR.  It is
when the newsgroup was locally created; in this example, it is when a
control message sent by \f(CW\*(C`group\-admin@isc.org\*(C'\fR was received and processed
by the news server (see control.ctl(5) for more details).  Therefore,
the time is not necessarily the same on every news server.
.SH HISTORY
.IX Header "HISTORY"
Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.  Converted to
POD by Russ Allbery <eagle@eyrie.org>.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
active(5), convdate(1), ctlinnd(8), getlist(1), inn.conf(5), innd(8),
mod\-active(8), nnrpd(8).