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.

117 lines
4.7 KiB

18 years ago
Popularity-contest Frequently Asked Questions.
Q) What information is reported by popularity-contest ?
A) popularity-contest reports the system architecture you use, the version of
popularity-contest you use and the list of packages installed on your
system. For each package, popularity-contest looks at the most recently used
(based on atime) files, and reports the filename, its last access time
(atime) and last change time (ctime). However, some files are not
considered, because they have unreliable atime.
Q) What is considered a 'vote' for a package ?
A) A computer 'vote' for a package if according to the data provided in the
report, a program provided or depending on the package was used less than
thirty days ago. This computation is performed by the popcon server.
Q) What are the privacy considerations for popularity-contest ?
A) Each popularity-contest host is identified by a random 128bit uuid
(MY_HOSTID in /etc/popularity-contest.conf). This uuid is used to
track submissions issued by the same host. It should be kept secret.
The reports are sent by email or HTTP to the popcon server. The
server automatically extracts the report from the email or HTTP and
stores it in a database for a maximum of 20 days or until the host
sends a new report. This database is readable only by Debian
Developers. The emails are readable only by the server admins.
Every day, the server computes a summary and post it on
<http://popcon.debian.org/all-popcon-results.txt.gz>. This summary
is a merge of all the submissions and does not include uuids.
Known weaknesses of the system:
1) Your submission might be eavesdropped. We evaluate the possibility
to use public-key cryptography to protect the submission while in
transit.
2) Someone who knows that you are very likely to use a particular package
reported by only one person (e.g. you are the maintainer) might infer you
are not at home when the package is not reported anymore. However this is
only a problem if you are gone for more than two weeks if the computer is
shut-down and 23 days if it is let idle.
3) Unofficial and local packages are reported. This can be an issue
due to 2) above, especially for custom-build kernel packages.
We are evaluating how far we can alleviate this problem.
18 years ago
Q) /usr is mounted with 'noatime'.
A) popularity-contest relies on atime to know what packages were used during
the last month. This means you will only report the list of packages
installed without usage information.
Q) When does popularity-contest run ?
A) popularity-contest is run by the daily cron job
"/etc/cron.daily/popularity-contest", but only one day in the week,
14 years ago
which is specified in the configuration file. This day is chosen randomly
to spread the load on the server.
Under the default configuration of cron, this happens at 6:47 in the morning.
This can be changed by editing /etc/crontab but if your computer is not always
turned on, we really recommend you install the anacron package.
If /etc/cron.daily/popularity-contest has not run for more than a week, it will
accept to run any day.
Q) I don't want popcon email to be sent by root! How can I change that ?
A) To send as user 'myuser', edit the function 'do_sendmail' in
14 years ago
/etc/cron.daily/popularity-contest to
do_sendmail()
{
su myuser -s /bin/sh -c "/usr/sbin/sendmail -oi \"$MAILTO\""
}
Q) How can I pass extra options to sendmail ?
A) Add a line in /etc/popularity-contest.conf as follow
MTAOPS="-opt1 -opt2 -opt3"
Q) How can I prevent popularity-contest from sending reports via email?
A) This is not recommended. Reports are sent by email only when the HTTP
submission fails, which is generally caused by a temporary lack of internet
connectivity. By contrast, reports sent by email are stored in the mail server
queue until the internet connectivity is back.
Nevertheless, you can prevent popularity-contest from sending reports via email
by adding
MAILTO=
to /etc/popularity-contest.conf
Q) How can I specify a HTTP proxy server for the HTTP submission ?
Popularity-contest honors the environment variable http_proxy that you can
set in /etc/environment. Alternatively you can specify a proxy server
specifically for popularity-contest by adding a line
HTTP_PROXY="http://<proxy hostname>:<port>"
to /etc/popularity-contest.conf.
Q) How can I convert the timestamps in the popcon report to human-readable
dates ?
A) The timestamps are just the number of seconds since the epoch, namely
1970-01-01 00:00:00 UTC. You can convert e.g. 1139229934 to a human-readable
date with
date -d '1970-01-01 UTC 1139229934 seconds'
or on Etch and later systems, the following is shorter:
date -d '@1139229934'