.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH MYTHTV-UPDATE-MOTD 1 "2018-12-31"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
mythtv-update-motd \- update the MOTD with a MythTV backend status
.SH SYNOPSIS
.B mythtv-update-motd
.SH DESCRIPTION
Update the system MOTD with the status of a MythTV backend. It is
typically run from cron.
.SH CONFIGURATION
The configuration file for this script is
.I /etc/default/mythtv-status
options of interest:
.TP
.B HOST
The host to check, by default this is localhost.
.TP
.B UPDATE_MOTD
Should this script run? Set to yes to enable, anything else to disable.
.TP
.B UPDATE_MOTD_ARGS
Any additional arguments you'd like to have run if the MOTD is updated by this
script.
.PP
.PD 0
You can also disable this script from running by creating a file
called 
.IR /var/lib/mythtv-status/motd_update_disabled .
If you run either:
.IP
systemctl stop mythtv-status
.PP
or
.IP
/etc/init.d/mythtv-status stop
.PP
this will be done for you, and will remove the most recent motd snippet.
.PD
.SH OPTIONS
None
.SH "EXIT STATUS"
.TP
.B 0
Updated MOTD with MythTV status
.TP
.B 1
Failed to update MOTD with MythTV status
.SH FILES
.B /etc/default/mythtv-status
Config file
.SH SEE ALSO
.BR mythtv-status (1),
.SH AUTHOR
mythtv-update-motd and this manpage were written by Andrew Ruthven
<andrew@etc.gen.nz>.