← Back to branch summary

~ubuntu-branches/ubuntu/karmic/cyrus-imapd-2.2/karmic

« back to all changes in this revision

Viewing changes to man/arbitron.8

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Klose
  • Date: 2006-07-11 18:51:39 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20060711185139-gl3oe4tppp7g3euf
Tags: 2.2.13-4ubuntu1
Synchronize with Debian unstable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/arbitron.8
39
39
.\" AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
40
40
.\" OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
41
41
.\" 
42
 
.\" $Id: arbitron.8,v 1.9 2003/08/09 23:43:14 rjs3 Exp $
 
42
.\" $Id: arbitron.8,v 1.14 2006/01/13 16:47:19 murch Exp $
43
43
 
44
44
.SH NAME
45
45
arbitron \- arbitron mailboxes
51
51
] [
52
52
.B \-o
53
53
] [
54
 
.B \-d
55
 
days
 
54
.B \-u
 
55
] [
 
56
.B \-l
56
57
] [
57
58
.B \-p
58
 
months
 
59
.I months
59
60
]
60
61
.br
61
 
         \fImailbox\fR...
 
62
         [
 
63
.B \-d
 
64
.I days
 
65
|
 
66
.B \-D
 
67
\fImmddyyyy\fR[\fB:\fImmddyyyy\fR]
 
68
]
 
69
\fImailbox\fR...
62
70
.SH DESCRIPTION
63
71
.I Arbitron
64
72
collects and reports readership statistics for mailboxes on the
68
76
.I Arbitron
69
77
produces one line of output per mailbox, reporting the mailbox name
70
78
followed by a space, followed by the number of
71
 
readers, and if -o is not specified, another space and the number
72
 
of subscribers.
 
79
readers (and if -u is specified, followed by a colon and a
 
80
comma-separated list of the readers userids), and if -o is not
 
81
specified, another space and the number of subscribers (and if -u is
 
82
specified, followed by a colon and a comma-separated list of the
 
83
subscribers userids).
73
84
\fBIMPORTANT: This format is subject to change in future versions.\fR
74
85
.PP
75
86
Each "reader" is a distinct authentication identity which has
76
87
"s" rights to the mailbox and which has SELECTed the mailbox within
77
 
the past
 
88
either the past
78
89
.I days
79
 
days.
 
90
days or the specified date range.
80
91
Users are not counted as reading their own personal mailboxes.
81
92
Personal mailboxes are not reported unless there is at least one
82
93
reader other than the mailboxes owner.
93
104
.BI \-o
94
105
"old way" -- do not report subscribers.
95
106
.TP
 
107
.BI \-u
 
108
Report userids in addition to the count(s).
 
109
.TP
 
110
.BI \-l
 
111
Enable long reporting (comma delimited table consisting of mbox, userid,
 
112
r/s, start time, end time).
 
113
.TP
96
114
.BI "\-d " days
97
115
Count as a reader an authentication identity which has SELECTed the
98
116
mailbox within
99
117
.I days
100
118
days.  Default is 30.
101
119
.TP
 
120
\fB\-D\fR \fImmddyyyy\fR[\fB:\fImmddyyyy\fR]
 
121
Count as a reader an authentication identity which has SELECTed the
 
122
mailbox within the given date range.  The start date and optional end
 
123
date are specified as 2-digit month of the year, 2-digit day of the
 
124
month, and 4-digit year.  If the end date is not specified, then the
 
125
current system time is used as the end time.
 
126
.TP
102
127
.BI "\-p " months
103
128
Prune \\Seen state for users who have not SELECTed the mailbox within
104
129
.I months