You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Petter Reinholdtsen 9eb4db7d01 Import current source version 1.3-1.1 used in Debian Woody and Sarge. 18 years ago
debian Import current source version 1.3-1.1 used in Debian Woody and Sarge. 18 years ago
README Import current source version 1.3-1.1 used in Debian Woody and Sarge. 18 years ago
README.examples Import current source version 1.3-1.1 used in Debian Woody and Sarge. 18 years ago
popanal.py Import current source version 1.3-1.1 used in Debian Woody and Sarge. 18 years ago
popcon-process.sh Import current source version 1.3-1.1 used in Debian Woody and Sarge. 18 years ago
popularity-contest Import current source version 1.3-1.1 used in Debian Woody and Sarge. 18 years ago
prepop.py Import current source version 1.3-1.1 used in Debian Woody and Sarge. 18 years ago

README


DEBIAN PACKAGE POPULARITY CONTEST - Avery Pennarun <apenwarr@debian.org>
=================================

This package contains a script, /usr/sbin/popularity-contest, which
generates a list of the packages installed on your system, in order of
most-recently-used to least-recently-used. The simplest way to use this
information is to help clean up your hard drive by removing unused packages.

For example,
popularity-contest | grep '<OLD>'
will show you a list of packages you haven't used in a while. Note that
this output isn't totally accurate: some packages appear "old" but you can't
remove them because other (non-old) packages depend on them. Shared library
packages are particularly bad this way because it's impossible to tell when
a library was last used.

The popularity-contest output looks like this:

POPULARITY-CONTEST-0 TIME:914183330 ID:b92a5fc1809d8a95a12eb3a3c84166dd
914183333 909868335 grep /bin/fgrep
914183333 909868280 findutils /usr/bin/find
914183330 909885698 dpkg-awk /usr/bin/dpkg-awk
914183330 909868577 gawk /usr/bin/gawk
[...more lines...]
END-POPULARITY-CONTEST-0 TIME:914183335

The first and last lines allow you to put more than one set of
popularity-contest results into a single file and then split them up
easily later.

The rest of the lines are package entries, one line for each package
installed on your system. They have the format:

<atime> <ctime> <packagename> <mru-program> <tag>

<packagename> is the name of the Debian package that contains <mru-program>.
<mru-program> is the most recently used program, static library, or header
(.h) file in the package.

<atime> and <ctime> are the access time and creation time of the
<mru-program> on your disk, respectively, represented as the number of
seconds since midnight GMT on January 1, 1970 (ie. in Unix time_t format).
Linux updates <atime> whenever you open the file; <ctime> was set when you
first installed the package.

<tag> is determined by popularity-contest depending on <atime>, <ctime>, and
the current date. <tag> can be RECENT-CTIME, OLD, or NOFILES.

RECENT-CTIME means that atime is very close to ctime; it's impossible to
tell whether the package was used recently or not, since <atime> is also
updated when <ctime> is set. Normally, this happens because you have
recently upgraded the package to a new version, resetting the <ctime>.

OLD means that the <atime> is more than a month ago; you haven't used the
package for more than a month.

NOFILES means that no files in the package seemed to be programs, so
<atime>, <ctime>, and <mru-program> are invalid.


PARTICIPATING IN THE PUBLIC SURVEY
==================================

You can help out the Debian Project by sending your popularity-contest
results to us anonymously. With information from enough people, we can
determine which packages are most often used, which are often installed but
not used, and which are nearly never used. That way, we can help people
make decisions about which packages should fit on the first Debian install
CD, for example, or which packages are most important for an FTP mirror site
to keep.

!!!!

SECURITY NOTE: it's impossible to make a submission completely anonymous,
since Internet servers tend to add headers and log messages along the way.
Our receiver program at debian throws away this information as soon as
possible so no one will see it, but if you're really paranoid you might not
want to participate.

!!!!

The popularity-contest package comes with a cron task to send the
information out to us each night. You can change where the submissions go
by editing /etc/popularity-contest.conf. Normally, you will send the
results to:
apenwarr-survey@debian.org

I periodically post survey results on my web page:

http://www.debian.org/~apenwarr/popcon/

You can find some sample analysis scripts in
/usr/share/doc/popularity-contest as part of this package.