Skip to content

Commit

Permalink
(re: 6c5705e): Update docs and adjust the LOG_LEVEL (polkit-org#508)
Browse files Browse the repository at this point in the history
  • Loading branch information
vmihalko authored Oct 10, 2024
1 parent 94e2b54 commit 99f67a4
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 16 deletions.
34 changes: 19 additions & 15 deletions docs/man/polkit.xml
Original file line number Diff line number Diff line change
Expand Up @@ -477,27 +477,31 @@ System Context | |
<refsect1 id="polkit-rules"><title>AUTHORIZATION RULES</title>
<para>
<command>polkitd</command> reads
<filename class='extension'>.rules</filename> files from the
<filename class='directory'>/etc/polkit-1/rules.d</filename> and
<filename class='directory'>/usr/share/polkit-1/rules.d</filename>
directories by sorting the files in lexical order based on the
basename on each file (if there's a tie, files in
<filename class='directory'>/etc</filename>
are processed before files in
<filename class='directory'>/usr</filename>).
For example, for the following four
files, the order is
<filename class='extension'>.rules</filename> files from the following
directories in this order:
</para>
<itemizedlist mark='opencircle' spacing='compact'>
<listitem><para><filename>/etc/polkit-1/rules.d</filename></para></listitem>
<listitem><para><filename>/run/polkit-1/rules.d</filename></para></listitem>
<listitem><para><filename>/usr/local/share/polkit-1/rules.d</filename></para></listitem>
<listitem><para><filename>/usr/share/polkit-1/rules.d</filename></para></listitem>
</itemizedlist>
<para>
These directories are processed in lexical order based on the basename
of each file. If there's a tie, files in directories earlier in the
list are processed first. For example, for the following four
files, the order is:
</para>
<itemizedlist mark='opencircle' spacing='compact'>
<listitem><para><filename>/etc/polkit-1/rules.d/10-auth.rules</filename></para></listitem>
<listitem><para><filename>/run/polkit-1/rules.d/10-auth.rules</filename></para></listitem>
<listitem><para><filename>/usr/local/share/polkit-1/rules.d/10-auth.rules</filename></para></listitem>
<listitem><para><filename>/usr/share/polkit-1/rules.d/10-auth.rules</filename></para></listitem>
<listitem><para><filename>/etc/polkit-1/rules.d/15-auth.rules</filename></para></listitem>
<listitem><para><filename>/usr/share/polkit-1/rules.d/20-auth.rules</filename></para></listitem>
</itemizedlist>
<para>
Both directories are monitored so if a rules file is changed,
added or removed, existing rules are purged and all files are
read and processed again. Rules files are written in the
All of these directories are monitored, so if a rules file is changed,
added, or removed, existing rules are purged and all files are
read and processed again. Rules files are written in the
<ulink url="http://en.wikipedia.org/wiki/JavaScript">JavaScript</ulink>
programming language and interface with <command>polkitd</command>
through the global
Expand Down
2 changes: 1 addition & 1 deletion src/polkitbackend/polkitbackendduktapeauthority.c
Original file line number Diff line number Diff line change
Expand Up @@ -134,7 +134,7 @@ load_scripts (PolkitBackendJsAuthority *authority)
else
{
polkit_backend_authority_log (POLKIT_BACKEND_AUTHORITY (authority),
LOG_LEVEL_DEBUG,
LOG_LEVEL_NOTICE,
"Error opening rules directory: %s (%s, %d)",
error->message, g_quark_to_string (error->domain), error->code);
g_clear_error (&error);
Expand Down

0 comments on commit 99f67a4

Please sign in to comment.