aboutsummaryrefslogtreecommitdiff
path: root/README
blob: b9a75c36648e52761f981cdb7a210157e1f90188 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
=========
porticron
=========

:Author: `Benedikt Böhm <bb@xnull.de>`_
:Version: 0.2.2
:Web: http://bb.xnull.de/projects/porticron/
:Source: http://git.xnull.de/gitweb/?p=porticron.git
:Download: http://bb.xnull.de/projects/porticron/dist/

porticron is a simple shell script for portage similar to apticron for debian.
It is called from cron to sync your portage tree and send any pending upgrade
via email.

Installation
============

porticron is available via portage:
::

  emerge porticron

Configuration
=============

The configuration for porticron is located at ``/etc/porticron.conf``. You can
set the following options:

SYNC_CMD
  The command porticron should use to synchronize your portage tree. Defaults
  to ``/usr/bin/emerge --sync``. Set this to ``/bin/true`` if your portage tree
  is mounted read-only (e.g. via nfs).

UPGRADE_OPTS
  Command-line options that should be passed to emerge while scanning for
  pending upgrades. Defaults to ``--deep --update``.

RCPT
  Recipient of notification mails. Defaults to ``root@$(hostname -f)``

SENDMAIL
  Path to sendmail binary. Defaults to ``/usr/sbin/sendmail``

Example
=======

A sample of an upgrade notification looks like this:
::

  porticron report [Tue, 09 Dec 2008 05:07:06 +0100]
  ========================================================================

  porticron has detected that some packages need upgrading:

      [ebuild     U ] sys-libs/timezone-data-2008i [2008g-r1]
      [ebuild     U ] sys-apps/man-pages-3.14 [3.12]
      [ebuild     U ] sys-process/htop-0.8.1-r1 [0.8.1]
      [ebuild     U ] sys-apps/util-linux-2.14.1 [2.13.1.1]
      [ebuild     U ] app-portage/elogv-0.7.2 [0.7.1]
      [ebuild     U ] sys-apps/busybox-1.11.3 [1.11.1]
      [ebuild     U ] app-admin/eselect-1.0.11-r1 [1.0.10]

  ========================================================================

  You can perform the upgrade by issuing the command:

      emerge --deep --update world

  as root on foo.example.com

  It is recommended that you pretend the upgrade first to confirm that
  the actions that would be taken are reasonable. The upgrade may be
  pretended by issuing the command:

      emerge --deep --update --pretend world