.\" Manpage for malcontent\-timer\-extension\-agent.
.\" Documentation is under the same licence as the malcontent package.
.\" SPDX-License-Identifier: LGPL-2.1-or-later
.TH man 8 "21 Oct 2025" "1.0" "malcontent\-timer\-extension\-agent man page"
.\"
.SH NAME
.IX Header "NAME"
malcontent\-timer\-extension\-agent — Parental Controls Timer Extension Agent
.\"
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.\"
\fBmalcontent\-timer\-extension\-agent [\-a \fPbus\-address\fB]
.\"
.SH DESCRIPTION
.IX Header "DESCRIPTION"
.\"
\fBmalcontent\-timer\-extension\-agent\fP is an agent process for deciding
whether to grant extension requests from child accounts which have screen time
limits set as part of parental controls.
.PP
This implementation of the agent process raises a polkit action to allow a
parent to authorize (or reject) the screen time limit extension request using a
polkit dialog on the local machine.
.PP
Other agent implementations may do more complex checks in future. For example,
by messaging the parent’s phone to allow them to authorize/reject requests
remotely.
.PP
\fBmalcontent\-timer\-extension\-agent\fP is designed to be run by
\fBsystemd\fP(1), being D\-Bus activated. There should be no need to run
\fBmalcontent\-timer\-extension\-agent\fP manually. Use
\fBmalcontent\-client\fP(8) to request screen time limit extensions 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\-timer\-extension\-agent\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\-timer\-extension\-agent\fP may return one of several error codes
if it encounters problems.
.\"
.IP "0" 4
.IX Item "0"
No problems occurred. The agent 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\-timer\-extension\-agent\fP on
startup.
.\"
.IP "2" 4
.IX Item "2"
The D\-Bus name for \fBmalcontent\-timer\-extension\-agent\fP was not available.
.\"
.IP "3" 4
.IX Item "3"
\fBmalcontent\-timer\-extension\-agent\fP was run in an inappropriate
environment, for example as the root user.
.\"
.SH "FILES"
.IX Header "FILES"
.\"
.IP \fI/lib/systemd/system/malcontent\-timer\-extension\-agent.service\fP 4
.IX Item "/lib/systemd/system/malcontent\-timer\-extension\-agent.service"
\fBsystemd\fP(1) service file which specifies the runtime environment for
\fBmalcontent\-timer\-extension\-agent\fP. See \fBsystemd.service\fP(5).
.\"
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.\"
\fBmalcontent\-client\fP(8),
\fBmalcontent\-timerd\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.