arbitron(8) Mac OS X Server Manual Page

Mac Dev Center Mac OS X Reference Library General Mac OS X Man Pages

This manual page is for Mac OS X Server version 10.6.3

If you are running Mac OS X (client), this command is not available.

If you are running a different version of Mac OS X Server, view the documentation locally:

In Xcode
In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

For more information about the manual page format, see the manual page for manpages(5).
For more information about this technology, look for other documentation in the Apple Reference Library.
For general information about writing shell scripts, read Shell Scripting Primer.


ARBITRON(8)                                                                                      ARBITRON(8)



NAME
       arbitron - arbitron mailboxes

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

DESCRIPTION
       Arbitron  collects and reports readership statistics for mailboxes on the server.  It also optionally
       prunes the mailboxes of \Seen state for dormant users.

       Arbitron produces one line of output per mailbox, reporting the mailbox name  followed  by  a  space,
       followed  by the number of readers (and if -u is specified, followed by a colon and a comma-separated
       list of the readers userids), and if -o is not specified, another space and the number of subscribers
       (and  if -u is specified, followed by a colon and a comma-separated list of the subscribers userids).
       IMPORTANT: This format is subject to change in future versions.

       Each "reader" is a distinct authentication identity which has "s" rights to the mailbox and which has
       SELECTed  the  mailbox  within  either the past days days or the specified date range.  Users are not
       counted as reading their own personal mailboxes.  Personal mailboxes are not reported unless there is
       at least one reader other than the mailboxes owner.

       Arbitron  reads its configuration options out of the imapd.conf(5) file unless specified otherwise by
       -C.

OPTIONS
       -C config-file
              Read configuration options from config-file.

       -o     "old way" -- do not report subscribers.

       -u     Report userids in addition to the count(s).

       -l     Enable long reporting (comma delimited table consisting of mbox, userid, r/s, start time,  end
              time).

       -d days
              Count  as a reader an authentication identity which has SELECTed the mailbox within days days.
              Default is 30.

       -D mmddyyyy[:mmddyyyy]
              Count as a reader an authentication identity which has SELECTed the mailbox within  the  given
              date  range.  The start date and optional end date are specified as 2-digit month of the year,
              2-digit day of the month, and 4-digit year.  If the end date is not specified, then  the  cur-rent current
              rent system time is used as the end time.

       -p months
              Prune  \Seen  state for users who have not SELECTed the mailbox within months months.  Default
              is infinity.

FILES
       /etc/imapd.conf



CMU                                             Project Cyrus                                    ARBITRON(8)

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors: Report errors in the content of this documentation with the feedback links below.
Bug reports: Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems: Report formatting mistakes in the online version of these pages with the feedback links below.

Did this document help you?