1ARBITRON(8)                 System Manager's Manual                ARBITRON(8)
2
3
4
5 *
6

NAME

8       arbitron - arbitron mailboxes
9

SYNOPSIS

11       arbitron [ -C config-file ] [ -o ] [ -u ] [ -l ] [ -p months ]
12                [ -d days | -D mmddyyyy[:mmddyyyy] ] mailbox...
13

DESCRIPTION

15       Arbitron  collects  and  reports readership statistics for mailboxes on
16       the server.  It also optionally prunes the mailboxes of \Seen state for
17       dormant users.
18
19       Arbitron produces one line of output per mailbox, reporting the mailbox
20       name followed by a space, followed by the number of readers (and if  -u
21       is  specified,  followed  by  a colon and a comma-separated list of the
22       readers userids), and if -o is not specified,  another  space  and  the
23       number  of subscribers (and if -u is specified, followed by a colon and
24       a comma-separated list of the subscribers  userids).   IMPORTANT:  This
25       format is subject to change in future versions.
26
27       Each  "reader"  is  a  distinct  authentication  identity which has "s"
28       rights to the mailbox and which has SELECTed the mailbox within  either
29       the  past days days or the specified date range.  Users are not counted
30       as reading their own personal mailboxes.  Personal  mailboxes  are  not
31       reported  unless  there is at least one reader other than the mailboxes
32       owner.
33
34       Arbitron reads its configuration options out of the imapd.conf(5)  file
35       unless specified otherwise by -C.
36

OPTIONS

38       -C config-file
39              Read configuration options from config-file.
40
41       -o     "old way" -- do not report subscribers.
42
43       -u     Report userids in addition to the count(s).
44
45       -l     Enable long reporting (comma delimited table consisting of mbox,
46              userid, r/s, start time, end time).
47
48       -d days
49              Count as a reader an authentication identity which has  SELECTed
50              the mailbox within days days.  Default is 30.
51
52       -D mmddyyyy[:mmddyyyy]
53              Count  as a reader an authentication identity which has SELECTed
54              the mailbox within the given date range.   The  start  date  and
55              optional  end  date  are specified as 2-digit month of the year,
56              2-digit day of the month, and 4-digit year.  If the end date  is
57              not  specified,  then the current system time is used as the end
58              time.
59
60       -p months
61              Prune \Seen state for users who have not  SELECTed  the  mailbox
62              within months months.  Default is infinity.
63

FILES

65       /etc/imapd.conf
66
67
68
69CMU                              Project Cyrus                     ARBITRON(8)
Impressum