Commit f7b73e29 authored by Michael Biebl's avatar Michael Biebl

Imported Upstream version 0.101

parent 15196227
......@@ -129,6 +129,7 @@ CYGPATH_W = @CYGPATH_W@
DATADIRNAME = @DATADIRNAME@
DEFS = @DEFS@
DEPDIR = @DEPDIR@
DLLTOOL = @DLLTOOL@
DSYMUTIL = @DSYMUTIL@
DUMPBIN = @DUMPBIN@
ECHO_C = @ECHO_C@
......@@ -139,8 +140,6 @@ EXEEXT = @EXEEXT@
EXPAT_LIBS = @EXPAT_LIBS@
FGREP = @FGREP@
GETTEXT_PACKAGE = @GETTEXT_PACKAGE@
GIRDIR = @GIRDIR@
GIRTYPELIBDIR = @GIRTYPELIBDIR@
GLIB_CFLAGS = @GLIB_CFLAGS@
GLIB_LIBS = @GLIB_LIBS@
GMOFILES = @GMOFILES@
......@@ -149,9 +148,6 @@ GREP = @GREP@
GTKDOC_CHECK = @GTKDOC_CHECK@
GTKDOC_MKPDF = @GTKDOC_MKPDF@
GTKDOC_REBASE = @GTKDOC_REBASE@
G_IR_COMPILER = @G_IR_COMPILER@
G_IR_GENERATE = @G_IR_GENERATE@
G_IR_SCANNER = @G_IR_SCANNER@
HAVE_PAM = @HAVE_PAM@
HTML_DIR = @HTML_DIR@
INSTALL = @INSTALL@
......@@ -166,7 +162,13 @@ INTLTOOL_MERGE = @INTLTOOL_MERGE@
INTLTOOL_PERL = @INTLTOOL_PERL@
INTLTOOL_UPDATE = @INTLTOOL_UPDATE@
INTROSPECTION_CFLAGS = @INTROSPECTION_CFLAGS@
INTROSPECTION_COMPILER = @INTROSPECTION_COMPILER@
INTROSPECTION_GENERATE = @INTROSPECTION_GENERATE@
INTROSPECTION_GIRDIR = @INTROSPECTION_GIRDIR@
INTROSPECTION_LIBS = @INTROSPECTION_LIBS@
INTROSPECTION_MAKEFILE = @INTROSPECTION_MAKEFILE@
INTROSPECTION_SCANNER = @INTROSPECTION_SCANNER@
INTROSPECTION_TYPELIBDIR = @INTROSPECTION_TYPELIBDIR@
LD = @LD@
LDFLAGS = @LDFLAGS@
LIBOBJS = @LIBOBJS@
......@@ -180,6 +182,7 @@ LT_CURRENT = @LT_CURRENT@
LT_REVISION = @LT_REVISION@
MAINT = @MAINT@
MAKEINFO = @MAKEINFO@
MANIFEST_TOOL = @MANIFEST_TOOL@
MKDIR_P = @MKDIR_P@
MKINSTALLDIRS = @MKINSTALLDIRS@
MSGFMT = @MSGFMT@
......@@ -226,6 +229,7 @@ abs_builddir = @abs_builddir@
abs_srcdir = @abs_srcdir@
abs_top_builddir = @abs_top_builddir@
abs_top_srcdir = @abs_top_srcdir@
ac_ct_AR = @ac_ct_AR@
ac_ct_CC = @ac_ct_CC@
ac_ct_DUMPBIN = @ac_ct_DUMPBIN@
am__include = @am__include@
......
--------------
PolicyKit 0.101
--------------
This is PolicyKit 0.101
WARNING WARNING WARNING: This is a prerelease on the road to PolicyKit
1.0. Public API might change and certain parts of the code still needs
some security review. Use at your own risk.
Build requirements
glib, gobject, gio >= 2.28
gobject-introspection >= 0.6.2 (optional)
pam (optional)
Changes since PolicyKit 0.100:
Adrian Bunk (1):
Bug 27253 – Use GOBJECT_INTROSPECTION_CHECK from gobject-introspection
David Zeuthen (16):
Post-release version bump to 0.101
Bug 30653 – No way to detect cancellation in pkexec
Bug 27081 – pkexec fails to build on non glibc systems
Bug 30438 – PolicyKit fails to build on AIX
Bug 32334 – Always set polkit.retains_authorization_after_challenge
Fix a memory leak
Be more specific about what info we want when enumerating files
Make pkcheck(1) report if the authentication dialog was dismissed
pkcheck: Make it possible to list and revoke temporary authorizations
Be a bit more careful parsing the command-line
Bug 29712 – Use monotonic for temporary authorizations
Allow overriding message shown in authentication dialog
Deprecated PolkitBackendActionLookup
Fix a couple of warnings triggered by gcc 4.6
Build examples by default and fix compiler warnings
Update NEWS for release
Michael Biebl (1):
Bug 29871 – Fix build failures with binutils-gold
Thanks to our contributors.
David Zeuthen,
March 3, 2011
--------------
PolicyKit 0.100
--------------
......
This diff is collapsed.
......@@ -98,6 +98,7 @@ CYGPATH_W = @CYGPATH_W@
DATADIRNAME = @DATADIRNAME@
DEFS = @DEFS@
DEPDIR = @DEPDIR@
DLLTOOL = @DLLTOOL@
DSYMUTIL = @DSYMUTIL@
DUMPBIN = @DUMPBIN@
ECHO_C = @ECHO_C@
......@@ -108,8 +109,6 @@ EXEEXT = @EXEEXT@
EXPAT_LIBS = @EXPAT_LIBS@
FGREP = @FGREP@
GETTEXT_PACKAGE = @GETTEXT_PACKAGE@
GIRDIR = @GIRDIR@
GIRTYPELIBDIR = @GIRTYPELIBDIR@
GLIB_CFLAGS = @GLIB_CFLAGS@
GLIB_LIBS = @GLIB_LIBS@
GMOFILES = @GMOFILES@
......@@ -118,9 +117,6 @@ GREP = @GREP@
GTKDOC_CHECK = @GTKDOC_CHECK@
GTKDOC_MKPDF = @GTKDOC_MKPDF@
GTKDOC_REBASE = @GTKDOC_REBASE@
G_IR_COMPILER = @G_IR_COMPILER@
G_IR_GENERATE = @G_IR_GENERATE@
G_IR_SCANNER = @G_IR_SCANNER@
HAVE_PAM = @HAVE_PAM@
HTML_DIR = @HTML_DIR@
INSTALL = @INSTALL@
......@@ -135,7 +131,13 @@ INTLTOOL_MERGE = @INTLTOOL_MERGE@
INTLTOOL_PERL = @INTLTOOL_PERL@
INTLTOOL_UPDATE = @INTLTOOL_UPDATE@
INTROSPECTION_CFLAGS = @INTROSPECTION_CFLAGS@
INTROSPECTION_COMPILER = @INTROSPECTION_COMPILER@
INTROSPECTION_GENERATE = @INTROSPECTION_GENERATE@
INTROSPECTION_GIRDIR = @INTROSPECTION_GIRDIR@
INTROSPECTION_LIBS = @INTROSPECTION_LIBS@
INTROSPECTION_MAKEFILE = @INTROSPECTION_MAKEFILE@
INTROSPECTION_SCANNER = @INTROSPECTION_SCANNER@
INTROSPECTION_TYPELIBDIR = @INTROSPECTION_TYPELIBDIR@
LD = @LD@
LDFLAGS = @LDFLAGS@
LIBOBJS = @LIBOBJS@
......@@ -149,6 +151,7 @@ LT_CURRENT = @LT_CURRENT@
LT_REVISION = @LT_REVISION@
MAINT = @MAINT@
MAKEINFO = @MAKEINFO@
MANIFEST_TOOL = @MANIFEST_TOOL@
MKDIR_P = @MKDIR_P@
MKINSTALLDIRS = @MKINSTALLDIRS@
MSGFMT = @MSGFMT@
......@@ -195,6 +198,7 @@ abs_builddir = @abs_builddir@
abs_srcdir = @abs_srcdir@
abs_top_builddir = @abs_top_builddir@
abs_top_srcdir = @abs_top_srcdir@
ac_ct_AR = @ac_ct_AR@
ac_ct_CC = @ac_ct_CC@
ac_ct_DUMPBIN = @ac_ct_DUMPBIN@
am__include = @am__include@
......
......@@ -20,7 +20,9 @@
<action id="org.freedesktop.policykit.lockdown">
<description>Configure lock down for an action</description>
<description xml:lang="da">Konfigurer lock down for en action</description>
<message>Authentication is required to configure lock down policy</message>
<message xml:lang="da">Autorisering er påkrævet for at konfigurer lock down</message>
<defaults>
<allow_any>no</allow_any>
<allow_inactive>no</allow_inactive>
......
/* config.h.in. Generated from configure.ac by autoheader. */
/* enable GObject introspection support */
#undef ENABLE_INTROSPECTION
/* always defined to indicate that i18n is enabled */
#undef ENABLE_NLS
......
This diff is collapsed.
dnl Process this file with autoconf to produce a configure script.
AC_PREREQ(2.59c)
AC_INIT(polkit, 0.100, http://lists.freedesktop.org/mailman/listinfo/polkit-devel)
AM_INIT_AUTOMAKE(polkit, 0.100)
AC_INIT(polkit, 0.101, http://lists.freedesktop.org/mailman/listinfo/polkit-devel)
AM_INIT_AUTOMAKE(polkit, 0.101)
AM_CONFIG_HEADER(config.h)
AM_MAINTAINER_MODE
......@@ -120,7 +120,7 @@ if test "x$GCC" = "xyes"; then
changequote([,])dnl
fi
PKG_CHECK_MODULES(GLIB, [gio-2.0 >= 2.25.12])
PKG_CHECK_MODULES(GLIB, [gio-2.0 >= 2.28.0])
AC_SUBST(GLIB_CFLAGS)
AC_SUBST(GLIB_LIBS)
......@@ -379,29 +379,11 @@ case "$host_os" in
;;
esac
# GObject introspection
#
AC_ARG_ENABLE([introspection],
AS_HELP_STRING([--enable-introspection], [enable GObject introspection]),
[], [enable_introspection=yes])
if test "x$enable_introspection" = xyes; then
PKG_CHECK_MODULES([INTROSPECTION], [gobject-introspection-1.0 >= 0.6.2])
AC_DEFINE([ENABLE_INTROSPECTION], [1], [enable GObject introspection support])
AC_SUBST([G_IR_SCANNER], [$($PKG_CONFIG --variable=g_ir_scanner gobject-introspection-1.0)])
AC_SUBST([G_IR_COMPILER], [$($PKG_CONFIG --variable=g_ir_compiler gobject-introspection-1.0)])
AC_SUBST([G_IR_GENERATE], [$($PKG_CONFIG --variable=g_ir_generate gobject-introspection-1.0)])
#AC_SUBST([GIRDIR], [$($PKG_CONFIG --variable=girdir gobject-introspection-1.0)])
#AC_SUBST([GIRTYPELIBDIR], [$($PKG_CONFIG --variable=typelibdir gobject-introspection-1.0)])
GIRDIR=${datadir}/gir-1.0
GIRTYPELIBDIR=${libdir}/girepository-1.0
AC_SUBST(GIRDIR)
AC_SUBST(GIRTYPELIBDIR)
fi
AM_CONDITIONAL([ENABLE_INTROSPECTION], [test "x$enable_introspection" = xyes])
GOBJECT_INTROSPECTION_CHECK([0.6.2])
AC_ARG_ENABLE([examples],
AS_HELP_STRING([--enable-examples], [Build the example programs]),,
[enable_examples=no])
[enable_examples=yes])
AM_CONDITIONAL(BUILD_EXAMPLES, test "x$enable_examples" = "xyes")
......@@ -458,7 +440,7 @@ echo "
cflags: ${CFLAGS}
cppflags: ${CPPFLAGS}
xsltproc: ${XSLTPROC}
introspection: ${enable_introspection}
introspection: ${found_introspection}
Distribution/OS: ${with_os_type}
authentication framework: ${POLKIT_AUTHFW}
......@@ -477,6 +459,7 @@ echo "
Building verbose mode: ${enable_verbose_mode}
Building api docs: ${enable_gtk_doc}
Building man pages: ${enable_man_pages}
Building examples: ${enable_examples}
"
......
......@@ -102,6 +102,7 @@ CYGPATH_W = @CYGPATH_W@
DATADIRNAME = @DATADIRNAME@
DEFS = @DEFS@
DEPDIR = @DEPDIR@
DLLTOOL = @DLLTOOL@
DSYMUTIL = @DSYMUTIL@
DUMPBIN = @DUMPBIN@
ECHO_C = @ECHO_C@
......@@ -112,8 +113,6 @@ EXEEXT = @EXEEXT@
EXPAT_LIBS = @EXPAT_LIBS@
FGREP = @FGREP@
GETTEXT_PACKAGE = @GETTEXT_PACKAGE@
GIRDIR = @GIRDIR@
GIRTYPELIBDIR = @GIRTYPELIBDIR@
GLIB_CFLAGS = @GLIB_CFLAGS@
GLIB_LIBS = @GLIB_LIBS@
GMOFILES = @GMOFILES@
......@@ -122,9 +121,6 @@ GREP = @GREP@
GTKDOC_CHECK = @GTKDOC_CHECK@
GTKDOC_MKPDF = @GTKDOC_MKPDF@
GTKDOC_REBASE = @GTKDOC_REBASE@
G_IR_COMPILER = @G_IR_COMPILER@
G_IR_GENERATE = @G_IR_GENERATE@
G_IR_SCANNER = @G_IR_SCANNER@
HAVE_PAM = @HAVE_PAM@
HTML_DIR = @HTML_DIR@
INSTALL = @INSTALL@
......@@ -139,7 +135,13 @@ INTLTOOL_MERGE = @INTLTOOL_MERGE@
INTLTOOL_PERL = @INTLTOOL_PERL@
INTLTOOL_UPDATE = @INTLTOOL_UPDATE@
INTROSPECTION_CFLAGS = @INTROSPECTION_CFLAGS@
INTROSPECTION_COMPILER = @INTROSPECTION_COMPILER@
INTROSPECTION_GENERATE = @INTROSPECTION_GENERATE@
INTROSPECTION_GIRDIR = @INTROSPECTION_GIRDIR@
INTROSPECTION_LIBS = @INTROSPECTION_LIBS@
INTROSPECTION_MAKEFILE = @INTROSPECTION_MAKEFILE@
INTROSPECTION_SCANNER = @INTROSPECTION_SCANNER@
INTROSPECTION_TYPELIBDIR = @INTROSPECTION_TYPELIBDIR@
LD = @LD@
LDFLAGS = @LDFLAGS@
LIBOBJS = @LIBOBJS@
......@@ -153,6 +155,7 @@ LT_CURRENT = @LT_CURRENT@
LT_REVISION = @LT_REVISION@
MAINT = @MAINT@
MAKEINFO = @MAKEINFO@
MANIFEST_TOOL = @MANIFEST_TOOL@
MKDIR_P = @MKDIR_P@
MKINSTALLDIRS = @MKINSTALLDIRS@
MSGFMT = @MSGFMT@
......@@ -199,6 +202,7 @@ abs_builddir = @abs_builddir@
abs_srcdir = @abs_srcdir@
abs_top_builddir = @abs_top_builddir@
abs_top_srcdir = @abs_top_srcdir@
ac_ct_AR = @ac_ct_AR@
ac_ct_CC = @ac_ct_CC@
ac_ct_DUMPBIN = @ac_ct_DUMPBIN@
am__include = @am__include@
......
......@@ -114,6 +114,7 @@ CYGPATH_W = @CYGPATH_W@
DATADIRNAME = @DATADIRNAME@
DEFS = @DEFS@
DEPDIR = @DEPDIR@
DLLTOOL = @DLLTOOL@
DSYMUTIL = @DSYMUTIL@
DUMPBIN = @DUMPBIN@
ECHO_C = @ECHO_C@
......@@ -124,8 +125,6 @@ EXEEXT = @EXEEXT@
EXPAT_LIBS = @EXPAT_LIBS@
FGREP = @FGREP@
GETTEXT_PACKAGE = @GETTEXT_PACKAGE@
GIRDIR = @GIRDIR@
GIRTYPELIBDIR = @GIRTYPELIBDIR@
GLIB_CFLAGS = @GLIB_CFLAGS@
GLIB_LIBS = @GLIB_LIBS@
GMOFILES = @GMOFILES@
......@@ -134,9 +133,6 @@ GREP = @GREP@
GTKDOC_CHECK = @GTKDOC_CHECK@
GTKDOC_MKPDF = @GTKDOC_MKPDF@
GTKDOC_REBASE = @GTKDOC_REBASE@
G_IR_COMPILER = @G_IR_COMPILER@
G_IR_GENERATE = @G_IR_GENERATE@
G_IR_SCANNER = @G_IR_SCANNER@
HAVE_PAM = @HAVE_PAM@
HTML_DIR = @HTML_DIR@
INSTALL = @INSTALL@
......@@ -151,7 +147,13 @@ INTLTOOL_MERGE = @INTLTOOL_MERGE@
INTLTOOL_PERL = @INTLTOOL_PERL@
INTLTOOL_UPDATE = @INTLTOOL_UPDATE@
INTROSPECTION_CFLAGS = @INTROSPECTION_CFLAGS@
INTROSPECTION_COMPILER = @INTROSPECTION_COMPILER@
INTROSPECTION_GENERATE = @INTROSPECTION_GENERATE@
INTROSPECTION_GIRDIR = @INTROSPECTION_GIRDIR@
INTROSPECTION_LIBS = @INTROSPECTION_LIBS@
INTROSPECTION_MAKEFILE = @INTROSPECTION_MAKEFILE@
INTROSPECTION_SCANNER = @INTROSPECTION_SCANNER@
INTROSPECTION_TYPELIBDIR = @INTROSPECTION_TYPELIBDIR@
LD = @LD@
LDFLAGS = @LDFLAGS@
LIBOBJS = @LIBOBJS@
......@@ -165,6 +167,7 @@ LT_CURRENT = @LT_CURRENT@
LT_REVISION = @LT_REVISION@
MAINT = @MAINT@
MAKEINFO = @MAKEINFO@
MANIFEST_TOOL = @MANIFEST_TOOL@
MKDIR_P = @MKDIR_P@
MKINSTALLDIRS = @MKINSTALLDIRS@
MSGFMT = @MSGFMT@
......@@ -211,6 +214,7 @@ abs_builddir = @abs_builddir@
abs_srcdir = @abs_srcdir@
abs_top_builddir = @abs_top_builddir@
abs_top_srcdir = @abs_top_srcdir@
ac_ct_AR = @ac_ct_AR@
ac_ct_CC = @ac_ct_CC@
ac_ct_DUMPBIN = @ac_ct_DUMPBIN@
am__include = @am__include@
......
......@@ -99,6 +99,7 @@ CYGPATH_W = @CYGPATH_W@
DATADIRNAME = @DATADIRNAME@
DEFS = @DEFS@
DEPDIR = @DEPDIR@
DLLTOOL = @DLLTOOL@
DSYMUTIL = @DSYMUTIL@
DUMPBIN = @DUMPBIN@
ECHO_C = @ECHO_C@
......@@ -109,8 +110,6 @@ EXEEXT = @EXEEXT@
EXPAT_LIBS = @EXPAT_LIBS@
FGREP = @FGREP@
GETTEXT_PACKAGE = @GETTEXT_PACKAGE@
GIRDIR = @GIRDIR@
GIRTYPELIBDIR = @GIRTYPELIBDIR@
GLIB_CFLAGS = @GLIB_CFLAGS@
GLIB_LIBS = @GLIB_LIBS@
GMOFILES = @GMOFILES@
......@@ -119,9 +118,6 @@ GREP = @GREP@
GTKDOC_CHECK = @GTKDOC_CHECK@
GTKDOC_MKPDF = @GTKDOC_MKPDF@
GTKDOC_REBASE = @GTKDOC_REBASE@
G_IR_COMPILER = @G_IR_COMPILER@
G_IR_GENERATE = @G_IR_GENERATE@
G_IR_SCANNER = @G_IR_SCANNER@
HAVE_PAM = @HAVE_PAM@
HTML_DIR = @HTML_DIR@
INSTALL = @INSTALL@
......@@ -136,7 +132,13 @@ INTLTOOL_MERGE = @INTLTOOL_MERGE@
INTLTOOL_PERL = @INTLTOOL_PERL@
INTLTOOL_UPDATE = @INTLTOOL_UPDATE@
INTROSPECTION_CFLAGS = @INTROSPECTION_CFLAGS@
INTROSPECTION_COMPILER = @INTROSPECTION_COMPILER@
INTROSPECTION_GENERATE = @INTROSPECTION_GENERATE@
INTROSPECTION_GIRDIR = @INTROSPECTION_GIRDIR@
INTROSPECTION_LIBS = @INTROSPECTION_LIBS@
INTROSPECTION_MAKEFILE = @INTROSPECTION_MAKEFILE@
INTROSPECTION_SCANNER = @INTROSPECTION_SCANNER@
INTROSPECTION_TYPELIBDIR = @INTROSPECTION_TYPELIBDIR@
LD = @LD@
LDFLAGS = @LDFLAGS@
LIBOBJS = @LIBOBJS@
......@@ -150,6 +152,7 @@ LT_CURRENT = @LT_CURRENT@
LT_REVISION = @LT_REVISION@
MAINT = @MAINT@
MAKEINFO = @MAKEINFO@
MANIFEST_TOOL = @MANIFEST_TOOL@
MKDIR_P = @MKDIR_P@
MKINSTALLDIRS = @MKINSTALLDIRS@
MSGFMT = @MSGFMT@
......@@ -196,6 +199,7 @@ abs_builddir = @abs_builddir@
abs_srcdir = @abs_srcdir@
abs_top_builddir = @abs_top_builddir@
abs_top_srcdir = @abs_top_srcdir@
ac_ct_AR = @ac_ct_AR@
ac_ct_CC = @ac_ct_CC@
ac_ct_DUMPBIN = @ac_ct_DUMPBIN@
am__include = @am__include@
......
......@@ -28,6 +28,16 @@
<arg><option>--help</option></arg>
</cmdsynopsis>
<cmdsynopsis>
<command>pkcheck</command>
<arg><option>--list-temp</option></arg>
</cmdsynopsis>
<cmdsynopsis>
<command>pkcheck</command>
<arg><option>--revoke-temp</option></arg>
</cmdsynopsis>
<cmdsynopsis>
<command>pkcheck</command>
<arg choice="plain">
......@@ -86,6 +96,12 @@
If <option>--allow-user-interaction</option> is passed, <command>pkcheck</command> blocks
while waiting for authentication.
</para>
<para>
The invocation <command>pkcheck --list-temp</command> will list
all temporary authorizations for the current session and
<command>pkcheck --revoke-temp</command> will revoke all
temporary authorizations for the current session.
</para>
<para>
This command is a simple wrapper around the PolicyKit D-Bus interface; see the
D-Bus interface documentation for details.
......@@ -124,6 +140,13 @@ KEY3=VALUE3
exits with a return value of 2 and a diagnostic message is printed on standard error.
Details are printed on standard output.
</para>
<para>
If the specificied process is not authorized because the
authentication dialog / request was dismissed by the user,
<command>pkcheck</command> exits with a return value of 3 and a
diagnostic message is printed on standard error. Details are
printed on standard output.
</para>
<para>
If an error occured while checking for authorization, <command>pkcheck</command> exits
with a return value of 127 with a diagnostic message printed on standard error.
......
......@@ -61,7 +61,10 @@
of <replaceable>PROGRAM</replaceable>. If the calling process is
not authorized or an authorization could not be obtained through
authentication or an error occured, <command>pkexec</command>
exits with a return value of 127.
exits with a return value of 127. If the authorization could not
be obtained because the user dismissed the authentication
dialog, <command>pkexec</command> exits with a return value of
126.
</para>
</refsect1>
......@@ -149,13 +152,21 @@
<programlisting>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="../../src/examples/org.freedesktop.policykit.examples.pkexec.policy"><xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback></xi:include></programlisting>
<para>
and drop it in
the <filename>/usr/share/polkit-1/actions</filename> directory
under a suitable name (e.g. matching the namespace of the
action). Note that in addition to specifying the program, the
and drop it in the
<filename>/usr/share/polkit-1/actions</filename> directory under
a suitable name (e.g. matching the namespace of the action).
Note that in addition to specifying the program, the
authentication message, description, icon and defaults can be
specified. For example, for the action defined above, the following
authentication dialog will be shown:
specified. Note that occurences of the strings
<literal>$(user)</literal>, <literal>$(program)</literal> and
<literal>$(command_line)</literal> in the message will be
replaced with respectively the user (of the form "Real Name
(username)" or just "username" if there is no real name for the
username), the binary to execute (a fully-qualified path,
e.g. "<literal>/usr/bin/pk-example-frobnicate</literal>") and
the command-line, e.g. "<literal>pk-example-frobnicate foo
bar</literal>". For example, for the action defined above, the
following authentication dialog will be shown:
</para>
<mediaobject id="pkexec-frobnicate">
<imageobject>
......
This diff is collapsed.
......@@ -40,8 +40,24 @@ BeginAuthentication (IN String action_id,
IN Array&lt;<link linkend="eggdbus-struct-Identity">Identity</link>&gt; identities)
</programlisting>
<para>
<para>Called by the PolicyKit daemon when the authentication agent needs the user to authenticate as one of the identities in <parameter>identities</parameter> for the action with the identifier <parameter>action_id</parameter>.</para><para>Upon succesful authentication, the authentication agent must invoke the <link linkend="eggdbus-method-org.freedesktop.PolicyKit1.Authority.AuthenticationAgentResponse">AuthenticationAgentResponse()</link> method on the <link linkend="eggdbus-interface-org.freedesktop.PolicyKit1.Authority">org.freedesktop.PolicyKit1.Authority</link> interface of the PolicyKit daemon before returning.</para><para>If the user dismisses the authentication dialog, the authentication agent should return an error.</para>
<para>
Called by the PolicyKit daemon when the authentication agent
needs the user to authenticate as one of the identities in
<parameter>identities</parameter> for the action with the
identifier <parameter>action_id</parameter>.</para><para>Upon
succesful authentication, the authentication agent must invoke
the <link
linkend="eggdbus-method-org.freedesktop.PolicyKit1.Authority.AuthenticationAgentResponse">AuthenticationAgentResponse()</link>
method on the <link
linkend="eggdbus-interface-org.freedesktop.PolicyKit1.Authority">org.freedesktop.PolicyKit1.Authority</link>
interface of the PolicyKit daemon before returning.
</para>
<para>
The authentication agent should not return until after authentication is complete.
If the user dismisses the authentication dialog, the authentication agent should return the <link linkend="eggdbus-constant-Error.org.freedesktop.PolicyKit1.Error.Cancelled">org.freedesktop.PolicyKit1.Error.Cancelled</link> error.
</para>
</para>
<variablelist role="params">
<varlistentry>
<term><literal>IN String <parameter>action_id</parameter></literal>:</term>
......@@ -71,9 +87,13 @@ The themed icon describing the action or the empty string if no icon is set.
<term><literal>IN Dict&lt;String,String&gt; <parameter>details</parameter></literal>:</term>
<listitem>
<para>
Details about the authentication request. This is a dictionary of key/value pairs where both key and value are strings. These strings are translated into the locale passed when registering the authentication agent using <link linkend="eggdbus-method-org.freedesktop.PolicyKit1.Authority.RegisterAuthenticationAgent">RegisterAuthenticationAgent().</link>.
Keys starting with <literal>polkit.</literal> are reserved for internal use and should never be displayed in the UI.
Known key/value-pairs include <literal>polkit.caller-pid</literal> (the process id of the mechanism making the authorization check) and <literal>polkit.subject-pid</literal> (the process id of the subject the check is for).
Details about the authentication request. This is a dictionary
of key/value pairs where both key and value are strings.
Known key/value-pairs include
<literal>polkit.caller-pid</literal> (the process id of the
mechanism making the authorization check) and
<literal>polkit.subject-pid</literal> (the process id of the
subject the check is for).
</para>
</listitem>
</varlistentry>
......
......@@ -461,7 +461,7 @@ TRUE if the given <link linkend="eggdbus-struct-Subject">Subject</link> could be
<term><literal>Dict&lt;String,String&gt; <structfield>details</structfield></literal></term>
<listitem>
<para>
Details for the result or empty if not authorized. Known key/value-pairs include <literal>polkit.temporary_authorization_id</literal> (if the authorization is temporary, this is set to the opaque temporary authorization id), <literal>polkit.retains_authorization_after_challenge</literal> (Set to a non-empty string if the authorization will be retained after authentication (if is_challenge is TRUE)).
Details for the result. Known key/value-pairs include <literal>polkit.temporary_authorization_id</literal> (if the authorization is temporary, this is set to the opaque temporary authorization id), <literal>polkit.retains_authorization_after_challenge</literal> (Set to a non-empty string if the authorization will be retained after authentication (if is_challenge is TRUE)), <literal>polkit.dismissed</literal> (Set to a non-empty string if the authentication dialog was dismissed by the user).
</para>
</listitem>
</varlistentry>
......@@ -513,6 +513,7 @@ The subject the temporary authorization is for.
<listitem>
<para>
When the temporary authorization was obtained, in seconds since the Epoch Jan 1, 1970 0:00 UTC.
Note that the PolicyKit daemon is using monotonic time internally so the returned value may change if system time changes.
</para>
</listitem>
</varlistentry>
......@@ -521,6 +522,7 @@ When the temporary authorization was obtained, in seconds since the Epoch Jan 1,
<listitem>
<para>
When the temporary authorization is set to expire, in seconds since the Epoch Jan 1, 1970 0:00 UTC.
Note that the PolicyKit daemon is using monotonic time internally so the returned value may change if system time changes.
</para>
</listitem>
</varlistentry>
......@@ -569,7 +571,26 @@ CheckAuthorization (IN <link linkend="eggdbus-struct-Subject">Subject</link>
OUT <link linkend="eggdbus-struct-AuthorizationResult">AuthorizationResult</link> result)
</programlisting>
<para>
<para>Checks if <parameter>subject</parameter> is authorized to perform the action with identifier <parameter>action_id</parameter>.</para><para>If <parameter>cancellation_id</parameter> is non-empty and already in use for the caller, the <link linkend="eggdbus-constant-Error.org.freedesktop.PolicyKit1.Error.CancellationIdNotUnique">org.freedesktop.PolicyKit1.Error.CancellationIdNotUnique</link> error is returned.</para><para>Note that <link linkend="eggdbus-constant-CheckAuthorizationFlags.AllowUserInteraction">CheckAuthorizationFlags.AllowUserInteraction</link> SHOULD be passed ONLY if the event that triggered the authorization check is stemming from an user action, e.g. the user pressing a button or attaching a device.</para>
<para>
Checks if <parameter>subject</parameter> is authorized to
perform the action with identifier
<parameter>action_id</parameter>
</para>
<para>
If <parameter>cancellation_id</parameter> is non-empty and
already in use for the caller, the <link
linkend="eggdbus-constant-Error.org.freedesktop.PolicyKit1.Error.CancellationIdNotUnique">org.freedesktop.PolicyKit1.Error.CancellationIdNotUnique</link>
error is returned.
</para>
<para>
Note that <link
linkend="eggdbus-constant-CheckAuthorizationFlags.AllowUserInteraction">CheckAuthorizationFlags.AllowUserInteraction</link>
SHOULD be passed ONLY if the event that triggered the
authorization check is stemming from an user action, e.g. the
user pressing a button or attaching a device.
</para>
<para>
</para>
</para>
<variablelist role="params">
<varlistentry>
......@@ -592,7 +613,32 @@ Identifier for the action that <parameter>subject</parameter> is attempting to d
<term><literal>IN Dict&lt;String,String&gt; <parameter>details</parameter></literal>:</term>
<listitem>
<para>
Details describing the action. Keys starting with <literal>polkit.</literal> are reserved for internal use and cannot be used.
Details describing the action. Keys starting with <literal>polkit.</literal> are can only be set if defined in this document.
</para>
<para>
Known keys include <literal>polkit.message</literal> and
<literal>polkit.gettext_domain</literal> that can be used to
override the message shown to the user. This latter is needed
because the user could be running an authentication agent in
another locale than the calling process.
</para>
<para>
The (translated version of) <literal>polkit.message</literal>
may include references to other keys that are expanded with
their respective values. For example if the key
<literal>device_file</literal> has the value
<literal>/dev/sda</literal> then the message
"<literal>Authenticate to format $(device_file)</literal>" is
expanded to "<literal>Authenticate to format
/dev/sda</literal>".
</para>
<para>
The key <literal>polkit.icon_name</literal> is used to override the icon shown in the authentication dialog.
</para>
<para>
If non-empty, then the request will fail with
<link linkend="eggdbus-constant-Error.org.freedesktop.PolicyKit1.Error.Failed">org.freedesktop.PolicyKit1.Error.Failed</link>
unless the process doing the check itsef is sufficiently authorized (e.g. running as uid 0).
</para>
</listitem>
</varlistentry>
......
......@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Identities</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="PolicyKit Reference Manual">
<link rel="up" href="ref-api.html" title="Part III. Client API Reference">
<link rel="prev" href="PolkitSystemBusName.html" title="PolkitSystemBusName">
<link rel="next" href="PolkitIdentity.html" title="PolkitIdentity">
<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
<meta name="generator" content="GTK-Doc V1.16 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
......@@ -19,7 +19,7 @@
<th width="100%" align="center">PolicyKit Reference Manual</th>
<td><a accesskey="n" href="PolkitIdentity.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="chapter" title="Identities">
<div class="chapter">
<div class="titlepage"><div><div><h2 class="title">
<a name="Identities"></a>Identities</h2></div></div></div>
<div class="toc"><dl>
......@@ -36,6 +36,6 @@
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.15</div>
Generated by GTK-Doc V1.16</div>
</body>
</html>
\ No newline at end of file
This diff is collapsed.
This diff is collapsed.
......@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>PolkitAgentTextListener</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="PolicyKit Reference Manual">
<link rel="up" href="ref-authentication-agent-api.html" title="Part V. Authentication Agent API Reference">
<link rel="prev" href="PolkitAgentListener.html" title="PolkitAgentListener">
<link rel="next" href="PolkitAgentSession.html" title="PolkitAgentSession">
<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
<meta name="generator" content="GTK-Doc V1.16 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
......@@ -30,7 +30,7 @@
<a href="#PolkitAgentTextListener.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
</td></tr>
</table>
<div class="refentry" title="PolkitAgentTextListener">
<div class="refentry">
<a name="PolkitAgentTextListener"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
......@@ -39,18 +39,18 @@
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1" title="Stability Level">
<div class="refsect1">
<a name="PolkitAgentTextListener.stability-level"></a><h2>Stability Level</h2>
Unstable, unless otherwise indicated
</div>
<div class="refsynopsisdiv" title="Synopsis">
<div class="refsynopsisdiv">
<a name="PolkitAgentTextListener.synopsis"></a><h2>Synopsis</h2>