1man(8) malcontent-client man page man(8)
2
6 malcontent-client - Parental Controls Access Utility
7
9 malcontent-client get-app-filter [-q] [-n] [USER]
10 malcontent-client check-app-filter [-q] [-n] [USER] ARG
12 malcontent-client set-app-filter [-q] [-n] [USER] ARG
14 malcontent-client oars-section [-q] [-n] [USER] SECTION
16 malcontent-client get-session-limits [-q] [-n] [USER]
18 malcontent-client monitor [-q] [USER]
20
22 malcontent-client is a utility for querying and updating the parental
23 controls settings for users on the system. It will typically require
24 administrator access to do anything more than query the current user’s
25 parental controls.
26 It communicates with accounts-service, which stores parental controls
28 data.
29 Its first argument is a command to run. The supported commands are doc‐
31 umented below.
32 The command line API and output format are unstable and likely to
34 change in future versions of malcontent-client.
35
37 Get the app filter for a user. For example:
38 # malcontent-client get-app-filter timmy
39 USER Username or ID of the user to get the app filter for. If not
41 specified, the current user will be used by default.
42 -q, --quiet
44 Only output error messages, and no informational messages, as
45 the operation progresses. (Default: Output informational mes‐
46 sages.)
47 -n, --no-interactive
49 Do not allow interactive authorization with polkit. If this is
50 needed to complete the operation, the operation will fail. (De‐
51 fault: Allow interactive authorization.)
52
54 Check if a given program, content type or flatpak ref is permitted to
55 be used by a user, according to their current app filter. For example:
56 # malcontent-client check-app-filter timmy $(which gnome-calcu‐
57 lator)
58 # malcontent-client check-app-filter timmy x-scheme-handler/http
60 # malcontent-client check-app-filter timmy
62 app/com.realm667.WolfenDoom_Blade_of_Agony/x86_64/stable
63 USER Username or ID of the user to get the app filter for. If not
65 specified, the current user will be used by default.
66 ARG Path to a program, content type or flatpak ref to check against
68 the app filter, to see if it is allowed for the specified user.
69 -q, --quiet
71 Only output error messages, and no informational messages, as
72 the operation progresses. (Default: Output informational mes‐
73 sages.)
74 -n, --no-interactive
76 Do not allow interactive authorization with polkit. If this is
77 needed to complete the operation, the operation will fail. (De‐
78 fault: Allow interactive authorization.)
79
81 Set the app filter for a user, replacing all previous values in it. For
82 example:
83 # malcontent-client set-app-filter timmy \
84 --disallow-user-installation \
85 $(which gnome-calculator) \
86 x-scheme-handler/http \
87 app/com.realm667.WolfenDoom_Blade_of_Agony/x86_64/stable
88 USER Username or ID of the user to set the app filter for. If not
90 specified, the current user will be used by default.
91 ARG Item to filter in the user’s app filter. This could either be an
93 absolute path or flatpak ref of a program to block; a content
94 type to block all programs handling that type; or an OARS sec‐
95 tion=value pair to block installation of apps with a more ex‐
96 treme rating for that OARS section. Multiple items may be speci‐
97 fied, and they will replace the user’s current app filter in en‐
98 tirety. If zero items are specified, the app filter is cleared.
99 --allow-user-installation
101 Allow the user to install flatpaks to their user repository.
102 --disallow-user-installation
104 Disallow the user from installing flatpaks to their user reposi‐
105 tory.
106 --allow-system-installation
108 Allow the user to install flatpaks to the system repository.
109 --disallow-system-installation
111 Disallow the user from installing flatpaks to the system reposi‐
112 tory.
113 -q, --quiet
115 Only output error messages, and no informational messages, as
116 the operation progresses. (Default: Output informational mes‐
117 sages.)
118 -n, --no-interactive
120 Do not allow interactive authorization with polkit. If this is
121 needed to complete the operation, the operation will fail. (De‐
122 fault: Allow interactive authorization.)
123
125 Get the value set for a specific OARS section from the app filter of
126 the given user. For example:
127 # malcontent-client oars-section timmy language-profanity
128 USER Username or ID of the user to get the OARS filter for. If not
130 specified, the current user will be used by default.
131 SECTION
133 OARS section to get the restriction level of the given user for.
134 For example, language-profanity.
135 -q, --quiet
137 Only output error messages, and no informational messages, as
138 the operation progresses. (Default: Output informational mes‐
139 sages.)
140 -n, --no-interactive
142 Do not allow interactive authorization with polkit. If this is
143 needed to complete the operation, the operation will fail. (De‐
144 fault: Allow interactive authorization.)
145
147 Get the session limits set for a user. For example:
148 # malcontent-client get-session-limits timmy
149 USER Username or ID of the user to get the session limits for. If not
151 specified, the current user will be used by default.
152 -q, --quiet
154 Only output error messages, and no informational messages, as
155 the operation progresses. (Default: Output informational mes‐
156 sages.)
157 -n, --no-interactive
159 Do not allow interactive authorization with polkit. If this is
160 needed to complete the operation, the operation will fail. (De‐
161 fault: Allow interactive authorization.)
162 --now yyyy-mm-ddThh:mm:ssZ
164 Check session limits (in particular, session expiry time)
165 against the given date/time, provided in ISO 8601 format. (De‐
166 fault: Current date/time.)
167
169 Monitor changes to the parental controls settings for a specific user.
170 For example:
171 # malcontent-client monitor timmy
172 USER Username or ID of the user to monitor the parental controls for.
174 If not specified, the current user will be used by default.
175 -q, --quiet
177 Only output error messages, and no informational messages, as
178 the operation progresses. (Default: Output informational mes‐
179 sages.)
180
182 malcontent-client supports the standard GLib environment variables for
183 debugging. These variables are not intended to be used in production:
184 $G_MESSAGES_DEBUG
186 This variable can contain one or more debug domain names to display
187 debug output for. The value all will enable all debug output. The
188 default is for no debug output to be enabled.
189
191 malcontent-client may return one of several error codes if it encoun‐
192 ters problems.
193 0 No problems occurred. The utility ran and successfully queried the
195 app filter. If running the check-app-filter command, the given
196 path, content type or flatpak ref was allowed for the given user.
197 1 An invalid option was passed to malcontent-client on startup.
199 2 The current user was not authorized to query the app filter for the
201 given user.
202 3 If running the check-app-filter command, the given path, content
204 type or flatpak ref was not allowed for the given user.
205 4 Malcontent is disabled at the system level, and hence parental con‐
207 trols are not enabled or enforced.
208 5 An operation failed and no more specific error information is
210 available.
211
213 Any bugs which are found should be reported on the project website:
214 https://gitlab.freedesktop.org/pwithnall/malcontent/-/issues
215
217 Endless Mobile, Inc.
218
220 Copyright © 2018 Endless Mobile, Inc.
2211.2 27 Oct 2020 man(8)