{"id":3247,"date":"2022-12-20T16:43:57","date_gmt":"2022-12-20T19:43:57","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/man-man8\/"},"modified":"2022-12-20T16:43:57","modified_gmt":"2022-12-20T19:43:57","slug":"man-man8","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/man-man8\/","title":{"rendered":"man (man8)"},"content":{"rendered":"

man<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
get\u2212app\u2212filter OPTIONS<\/a>
check\u2212app\u2212filter OPTIONS<\/a>
set\u2212app\u2212filter OPTIONS<\/a>
oars\u2212section OPTIONS<\/a>
get\u2212session\u2212limits OPTIONS<\/a>
monitor OPTIONS<\/a>
ENVIRONMENT<\/a>
EXIT STATUS<\/a>
BUGS<\/a>
AUTHOR<\/a>
COPYRIGHT<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

malcontent\u2212client \u2212 Parental Controls Access Utility<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

malcontent\u2212client get\u2212app\u2212filter [\u2212q] [\u2212n] [<\/b>USER]<\/b><\/p>\n

malcontent\u2212client check\u2212app\u2212filter [\u2212q] [\u2212n] [<\/b>USER]<\/b> ARG<\/p>\n

malcontent\u2212client set\u2212app\u2212filter [\u2212q] [\u2212n] [<\/b>USER]<\/b> ARG<\/p>\n

malcontent\u2212client oars\u2212section [\u2212q] [\u2212n] [<\/b>USER]<\/b> SECTION<\/p>\n

malcontent\u2212client get\u2212session\u2212limits [\u2212q] [\u2212n] [<\/b>USER]<\/b><\/p>\n

malcontent\u2212client monitor [\u2212q] [<\/b>USER]<\/b><\/p>\n

DESCRIPTION <\/a> <\/h2>\n

malcontent\u2212client<\/b> 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\u00e2s parental controls.<\/p>\n

It communicates with accounts-service, which stores parental controls data.<\/p>\n

Its first argument is a command to run. The supported commands are documented below.<\/p>\n

The command line API and output format are unstable and likely to change in future versions of malcontent\u2212client<\/b>.<\/p>\n

get\u2212app\u2212filter OPTIONS <\/a> <\/h2>\n

Get the app filter for a user. For example:<\/p>\n

# malcontent\u2212client get\u2212app\u2212filter timmy<\/p>\n\n\n
<\/td>\n\n

USER<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Username or ID of the user to get the app filter for. If not specified, the current user will be used by default.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

\u2212q<\/b>, \u2212\u2212quiet<\/b><\/p>\n

Only output error messages, and no informational messages, as the operation progresses. (Default: Output informational messages.)<\/p>\n

\u2212n<\/b>, \u2212\u2212no\u2212interactive<\/b><\/p>\n

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

check\u2212app\u2212filter OPTIONS <\/a> <\/h2>\n

Check if a given program, content type or flatpak ref is permitted to be used by a user, according to their current app filter. For example:<\/p>\n

# malcontent\u2212client check\u2212app\u2212filter timmy $(which gnome\u2212calculator)<\/p>\n

# malcontent\u2212client check\u2212app\u2212filter timmy x\u2212scheme\u2212handler\/http<\/p>\n

# malcontent\u2212client check\u2212app\u2212filter timmy app\/com.realm667.WolfenDoom_Blade_of_Agony\/x86_64\/stable<\/p>\n\n\n\n
<\/td>\n\n

USER<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Username or ID of the user to get the app filter for. If not specified, the current user will be used by default.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

ARG<\/b><\/p>\n<\/td>\n

<\/td>\n\n

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.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

\u2212q<\/b>, \u2212\u2212quiet<\/b><\/p>\n

Only output error messages, and no informational messages, as the operation progresses. (Default: Output informational messages.)<\/p>\n

\u2212n<\/b>, \u2212\u2212no\u2212interactive<\/b><\/p>\n

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

set\u2212app\u2212filter OPTIONS <\/a> <\/h2>\n

Set the app filter for a user, replacing all previous values in it. For example:<\/p>\n

# malcontent\u2212client set\u2212app\u2212filter timmy
\u2212\u2212disallow\u2212user\u2212installation
$(which gnome\u2212calculator)
x\u2212scheme\u2212handler\/http
app\/com.realm667.WolfenDoom_Blade_of_Agony\/x86_64\/stable<\/p>\n\n\n\n
<\/td>\n\n

USER<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Username or ID of the user to set the app filter for. If not specified, the current user will be used by default.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

ARG<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Item to filter in the user\u00e2s app filter. This could either be an absolute path or flatpak ref of a program to block; a content type to block all programs handling that type; or an OARS section=value<\/b> pair to block installation of apps with a more extreme rating for that OARS section. Multiple items may be specified, and they will replace the user\u00e2s current app filter in entirety. If zero items are specified, the app filter is cleared.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

\u2212\u2212allow\u2212user\u2212installation<\/b><\/p>\n

Allow the user to install flatpaks to their user repository.<\/p>\n

\u2212\u2212disallow\u2212user\u2212installation<\/b><\/p>\n

Disallow the user from installing flatpaks to their user repository.<\/p>\n

\u2212\u2212allow\u2212system\u2212installation<\/b><\/p>\n

Allow the user to install flatpaks to the system repository.<\/p>\n

\u2212\u2212disallow\u2212system\u2212installation<\/b><\/p>\n

Disallow the user from installing flatpaks to the system repository.<\/p>\n

\u2212q<\/b>, \u2212\u2212quiet<\/b><\/p>\n

Only output error messages, and no informational messages, as the operation progresses. (Default: Output informational messages.)<\/p>\n

\u2212n<\/b>, \u2212\u2212no\u2212interactive<\/b><\/p>\n

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

oars\u2212section OPTIONS <\/a> <\/h2>\n

Get the value set for a specific OARS section from the app filter of the given user. For example:<\/p>\n

# malcontent\u2212client oars\u2212section timmy language\u2212profanity<\/p>\n\n\n
<\/td>\n\n

USER<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Username or ID of the user to get the OARS filter for. If not specified, the current user will be used by default.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

SECTION<\/b><\/p>\n

OARS section to get the restriction level of the given user for. For example, language\u2212profanity<\/b>.<\/p>\n

\u2212q<\/b>, \u2212\u2212quiet<\/b><\/p>\n

Only output error messages, and no informational messages, as the operation progresses. (Default: Output informational messages.)<\/p>\n

\u2212n<\/b>, \u2212\u2212no\u2212interactive<\/b><\/p>\n

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

get\u2212session\u2212limits OPTIONS <\/a> <\/h2>\n

Get the session limits set for a user. For example:<\/p>\n

# malcontent\u2212client get\u2212session\u2212limits timmy<\/p>\n\n\n
<\/td>\n\n

USER<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Username or ID of the user to get the session limits for. If not specified, the current user will be used by default.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

\u2212q<\/b>, \u2212\u2212quiet<\/b><\/p>\n

Only output error messages, and no informational messages, as the operation progresses. (Default: Output informational messages.)<\/p>\n

\u2212n<\/b>, \u2212\u2212no\u2212interactive<\/b><\/p>\n

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

\u2212\u2212now yyyy\u2212mm\u2212ddThh:mm:ssZ<\/b><\/p>\n

Check session limits (in particular, session expiry time) against the given date\/time, provided in ISO 8601 format. (Default: Current date\/time.)<\/p>\n

monitor OPTIONS <\/a> <\/h2>\n

Monitor changes to the parental controls settings for a specific user. For example:<\/p>\n

# malcontent\u2212client monitor timmy<\/p>\n\n\n
<\/td>\n\n

USER<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Username or ID of the user to monitor the parental controls for. If not specified, the current user will be used by default.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

\u2212q<\/b>, \u2212\u2212quiet<\/b><\/p>\n

Only output error messages, and no informational messages, as the operation progresses. (Default: Output informational messages.)<\/p>\n

ENVIRONMENT <\/a> <\/h2>\n

malcontent\u2212client<\/b> supports the standard GLib environment variables for debugging. These variables are not<\/b> intended to be used in production:
$G_MESSAGES_DEBUG<\/i><\/p>\n

This variable can contain one or more debug domain names to display debug output for. The value all<\/i> will enable all debug output. The default is for no debug output to be enabled.<\/p>\n

EXIT STATUS <\/a> <\/h2>\n

malcontent\u2212client<\/b> may return one of several error codes if it encounters problems.<\/p>\n\n\n\n\n\n\n\n
<\/td>\n\n

0<\/p>\n<\/td>\n

<\/td>\n\n

No problems occurred. The utility ran and successfully queried the app filter. If running the check\u2212app\u2212filter<\/b> command, the given path, content type or flatpak ref was allowed for the given user.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

1<\/p>\n<\/td>\n

<\/td>\n\n

An invalid option was passed to malcontent\u2212client<\/b> on startup.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

2<\/p>\n<\/td>\n

<\/td>\n\n

The current user was not authorized to query the app filter for the given user.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

3<\/p>\n<\/td>\n

<\/td>\n\n

If running the check\u2212app\u2212filter<\/b> command, the given path, content type or flatpak ref was not<\/i> allowed for the given user.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

4<\/p>\n<\/td>\n

<\/td>\n\n

Malcontent is disabled at the system level, and hence parental controls are not enabled or enforced.<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

5<\/p>\n<\/td>\n

<\/td>\n\n

An operation failed and no more specific error information is available.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

BUGS <\/a> <\/h2>\n

Any bugs which are found should be reported on the project website:
https:\/\/gitlab.freedesktop.org\/pwithnall\/malcontent\/-\/issues<\/i><\/p>\n

AUTHOR <\/a> <\/h2>\n

Endless Mobile, Inc.<\/p>\n

COPYRIGHT <\/a> <\/h2>\n

Copyright \u00c2\u00a9 2018 Endless Mobile, Inc.<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

malcontent\u2212client \u2212 Parental Controls Access Utility <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[5,52,384,4],"class_list":["post-3247","post","type-post","status-publish","format-standard","hentry","category-8-administracion-del-sistema","tag-5","tag-administracion","tag-malcontent-client","tag-man8"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3247","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=3247"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3247\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=3247"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=3247"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=3247"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}