.\" Manpage for malcontent\-timerd.
.\" Documentation is under the same licence as the malcontent package.
.\" SPDX-License-Identifier: LGPL-2.1-or-later
.TH man 8 "23 Apr 2025" "1.0" "malcontent\-timerd man page"
.\"
.SH NAME
.IX Header "NAME"
malcontent\-timerd — Parental Controls Timer Daemon
.\"
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.\"
\fBmalcontent\-timerd [\-a \fPbus\-address\fB]
.\"
.SH DESCRIPTION
.IX Header "DESCRIPTION"
.\"
\fBmalcontent\-timerd\fP is a coordination process for storing and querying
session and app usage records. Child accounts which are under parental control
on the computer submit usage records of their time spent using a login session
or apps, and \fBmalcontent\-timerd\fP combines and stores those records for a
period of weeks to allow session and app usage limits to be imposed on the child
account, and to allow parent users to query the child’s usage of the computer.
.PP
\fBmalcontent\-timerd\fP is designed to be run by \fBsystemd\fP(1), being
D\-Bus activated. There should be no need to run \fBmalcontent\-timerd\fP
manually. Use \fBmalcontent\-client\fP(8) to submit usage entries and query
session limits and time remaining from the command line.
.\"
.SH OPTIONS
.IX Header "OPTIONS"
.\"
.IP "\fB\-a\fP, \fB\-\-bus\-address=\fP"
Address of a D\-Bus message bus to connect to. This is intended for debugging
use only. (Default: The system bus.)
.\"
.IP "\fB\-t\fP, \fB\-\-inactivity\-timeout=\fP"
Inactivity timeout (in milliseconds) to wait before exiting the service if no
requests have been made during that period. If set to \fB0\fP, the timeout is
disabled and the service will run indefinitely. (Default: 30 seconds.)
.\"
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
.\"
\fPmalcontent\-timerd\fP supports the standard GLib environment variables for
debugging. These variables are \fBnot\fP intended to be used in production:
.\"
.IP \fI$G_MESSAGES_DEBUG\fP 4
.IX Item "$G_MESSAGES_DEBUG"
This variable can contain one or more debug domain names to display debug output
for. The value \fIall\fP will enable all debug output. The default is for no
debug output to be enabled.
.\"
.SH "EXIT STATUS"
.IX Header "EXIT STATUS"
.\"
\fBmalcontent\-timerd\fP may return one of several error codes if it encounters
problems.
.\"
.IP "0" 4
.IX Item "0"
No problems occurred. The timer daemon ran, responded to zero or more requests,
and then exited due to being explicitly closed, or timing out due to finishing
all requests.
.\"
.IP "1" 4
.IX Item "1"
An invalid option was passed to \fBmalcontent\-timerd\fP on startup.
.\"
.IP "2" 4
.IX Item "2"
The D\-Bus name for \fBmalcontent\-timerd\fP was not available.
.\"
.IP "3" 4
.IX Item "3"
\fBmalcontent\-timerd\fP was run in an inappropriate environment, for example
as the root user.
.\"
.SH "FILES"
.IX Header "FILES"
.\"
.IP \fI/lib/systemd/system/malcontent\-timerd.service\fP 4
.IX Item "/lib/systemd/system/malcontent\-timerd.service"
\fBsystemd\fP(1) service file which specifies the runtime environment for
\fBmalcontent\-timerd\fP. See \fBsystemd.service\fP(5).
.\"
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.\"
\fBmalcontent\-client\fP(8),
\fBmalcontent\-timer\-extension\-agent\fP(8)
.\"
.SH BUGS
.IX Header "BUGS"
.\"
Any bugs which are found should be reported on the project website:
.br
\fIhttps://gitlab.freedesktop.org/pwithnall/malcontent/-/issues\fP
.\"
.SH AUTHOR
.IX Header "AUTHOR"
.\"
GNOME Foundation, Inc.
Philip Withnall
.\"
.SH COPYRIGHT
.IX Header "COPYRIGHT"
.\"
Copyright © 2025 GNOME Foundation, Inc.