malcontent-client - Man Page

Parental Controls Access Utility

Synopsis

malcontent-client get-app-filter [-q] [-n] [USER]

malcontent-client check-app-filter [-q] [-n] [USER] ARG

Description

malcontent-client is a utility for querying and updating the parental controls settings for users on the system. It will typically require administrator access to do anything more than query the current user’s parental controls.

It communicates with accounts-service, which stores parental controls data.

Its first argument is a command to run. Currently, the only supported commands are get-app-filter and check-app-filter.

The command line API and output format are unstable and likely to change in future versions of malcontent-client.

get-app-filter OPTIONS

USER

Username or ID of the user to get the app filter for. If not specified, the current user will be used by default.

-q, --quiet

Only output error messages, and no informational messages, as the operation progresses. (Default: Output informational messages.)

-n, --no-interactive

Do not allow interactive authorization with polkit. If this is needed to complete the operation, the operation will fail. (Default: Allow interactive authorization.)

check-app-filter OPTIONS

USER

Username or ID of the user to get the app filter for. If not specified, the current user will be used by default.

ARG

Path to a program, content type or flatpak ref to check against the app filter, to see if it is allowed for the specified user.

-q, --quiet

Only output error messages, and no informational messages, as the operation progresses. (Default: Output informational messages.)

-n, --no-interactive

Do not allow interactive authorization with polkit. If this is needed to complete the operation, the operation will fail. (Default: Allow interactive authorization.)

Environment

malcontent-client supports the standard GLib environment variables for debugging. These variables are not intended to be used in production:

$G_MESSAGES_DEBUG

This variable can contain one or more debug domain names to display debug output for. The value all will enable all debug output. The default is for no debug output to be enabled.

Exit Status

malcontent-client may return one of several error codes if it encounters problems.

0

No problems occurred. The utility ran and successfully queried the app filter. If running the check-app-filter command, the given path, content type or flatpak ref was allowed for the given user.

1

An invalid option was passed to malcontent-client on startup.

2

The current user was not authorized to query the app filter for the given user.

3

If running the check-app-filter command, the given path, content type or flatpak ref was not allowed for the given user.

4

Malcontent is disabled at the system level, and hence parental controls are not enabled or enforced.

5

An operation failed and no more specific error information is available.

Bugs

Any bugs which are found should be reported on the project website:
https://support.endlessm.com/

Author

Endless Mobile, Inc.

Info

13 Jun 2019 1.1 malcontent-client man page