.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "PAININTHEAPT" 8 "" ""
.SH NAME
painintheapt \- Pester people about available package updates by email or jabber.
.sp
\fIPain in the APT\fP pesters people about available package upgrades,
just like apticron or cron\-apt. However, it does so by SMTP and XMPP
(direct or MUC/conference room or pubsub node), but also by calling
\fBmailx\fP\&.
.SH WHAT DOES IT DO?
.INDENT 0.0
.IP 1. 3
updates the APT cache and checks for updates
.IP 2. 3
sends list of available updates to Jabber contacts or a conference
room or pubsub node immediately
.IP 3. 3
sends list of available updates and relevant changelogs (slow) to
email recipients
.IP 4. 3
downloads packages, but does not install them
.UNINDENT
.sp
Messages are only sent when there is any change in either the list of
updates or in the configuration of \fBpainintheapt\fP\&.
.SH OPTIONS
.INDENT 0.0
.TP
.B \fB\-c\fP, \fB\-\-configfile\fP \fIconfiguration file\fP
configuration file, (defaults: /etc/painintheapt.conf)
.TP
.B \fB\-d\fP, \fB\-\-debug\fP
print debug output to stderr
.TP
.B \fB\-f\fP, \fB\-\-force\fP
send message, even if updates did not change
.TP
.B \fB\-h\fP, \fB\-\-help\fP
print help
.TP
.B \fB\-s\fP, \fB\-\-stampfile\fP \fIstamp file\fP
stamp file (default: /var/lib/painintheapt/stamp)
.TP
.B \fB\-t\fP, \fB\-\-testmessage\fP
send a test message only
.TP
.B \fB\-v\fP, \fB\-\-version\fP
print version
.UNINDENT
.SH CONFIGURATION
.sp
The default configuration file is \fB/etc/painintheapt.conf\fP in
inifile format.
.sp
There are up to three sections, \fBSMTP\fP, \fBXMPP\fP, and \fBMAILX\fP\&.
The keys for \fBSMTP\fP are \fBserver\fP, \fBport\fP, \fBusername\fP,
\fBpassword_file\fP, \fBfrom\fP, \fBto\fP, \fBcc\fP, and \fBsend_changes\fP\&.
The keys for \fBXMPP\fP are \fBjid\fP, \fBpassword_file\fP, \fBto\fP, \fBroom\fP,
\fBpubsub_service\fP, \fBpubsub_node\fP, and \fBsend_changes\fP\&.
The keys for \fBMAILX\fP are \fBfrom\fP, \fBto\fP, \fBcc\fP, and
\fBsend_changes\fP\&.
See the sample configuration for their usage.
.sp
The typical cron file is \fB/etc/cron.d/painintheapt\fP\&. One may call
\fBpainintheapt\fP without arguments daily, and with the \fB\-\-force\fP
option weekly, to make sure the transport does work.
.sp
It is highly recommended to set the accompanying logo as Jabber avatar
for the respective user.
.SH RESOURCES
.INDENT 0.0
.IP \(bu 2
Homepage: \fI\%https://salsa.debian.org/debacle/painintheapt\fP
.UNINDENT
.SH LICENSE
.sp
Affero General Public License 3 or higher
.SH LOGO
.INDENT 0.0
.INDENT 3.5
.sp
.EX
 (___)
○(@ @)○
 \-\e∞/\-
/__‾__\e
.EE
.UNINDENT
.UNINDENT
.sp
Maybe a cow, a gnu, or a dragon?
.SH AUTHOR
.sp
Martin <\fI\%debacle@debian.org\fP>
.\" Generated by docutils manpage writer.
.