Browse Source

Imported Upstream version 0.101

tags/upstream/0.101^0
Michael Biebl 10 years ago
parent
commit
f7b73e2997
100 changed files with 5830 additions and 4048 deletions
  1. +9
    -5
      Makefile.in
  2. +47
    -0
      NEWS
  3. +823
    -334
      aclocal.m4
  4. +9
    -5
      actions/Makefile.in
  5. +2
    -0
      actions/org.freedesktop.policykit.policy
  6. +0
    -3
      config.h.in
  7. +1335
    -674
      configure
  8. +7
    -24
      configure.ac
  9. +9
    -5
      data/Makefile.in
  10. +9
    -5
      docs/Makefile.in
  11. +9
    -5
      docs/man/Makefile.in
  12. +23
    -0
      docs/man/pkcheck.xml
  13. +18
    -7
      docs/man/pkexec.xml
  14. +60
    -42
      docs/polkit/Makefile.in
  15. +24
    -4
      docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.AuthenticationAgent.xml
  16. +49
    -3
      docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml
  17. +4
    -4
      docs/polkit/html/Identities.html
  18. +56
    -71
      docs/polkit/html/PolkitActionDescription.html
  19. +47
    -69
      docs/polkit/html/PolkitAgentListener.html
  20. +48
    -64
      docs/polkit/html/PolkitAgentSession.html
  21. +15
    -18
      docs/polkit/html/PolkitAgentTextListener.html
  22. +246
    -309
      docs/polkit/html/PolkitAuthority.html
  23. +63
    -43
      docs/polkit/html/PolkitAuthorizationResult.html
  24. +0
    -316
      docs/polkit/html/PolkitBackendActionLookup.html
  25. +128
    -203
      docs/polkit/html/PolkitBackendAuthority.html
  26. +45
    -66
      docs/polkit/html/PolkitBackendInteractiveAuthority.html
  27. +19
    -20
      docs/polkit/html/PolkitBackendLocalAuthority.html
  28. +27
    -31
      docs/polkit/html/PolkitDetails.html
  29. +28
    -19
      docs/polkit/html/PolkitError.html
  30. +35
    -47
      docs/polkit/html/PolkitIdentity.html
  31. +37
    -47
      docs/polkit/html/PolkitPermission.html
  32. +55
    -75
      docs/polkit/html/PolkitSubject.html
  33. +28
    -34
      docs/polkit/html/PolkitSystemBusName.html
  34. +32
    -33
      docs/polkit/html/PolkitTemporaryAuthorization.html
  35. +26
    -33
      docs/polkit/html/PolkitUnixGroup.html
  36. +34
    -45
      docs/polkit/html/PolkitUnixProcess.html
  37. +40
    -50
      docs/polkit/html/PolkitUnixSession.html
  38. +26
    -33
      docs/polkit/html/PolkitUnixUser.html
  39. +34
    -16
      docs/polkit/html/eggdbus-interface-org.freedesktop.PolicyKit1.AuthenticationAgent.html
  40. +98
    -48
      docs/polkit/html/eggdbus-interface-org.freedesktop.PolicyKit1.Authority.html
  41. +7
    -10
      docs/polkit/html/index.html
  42. +15
    -23
      docs/polkit/html/index.sgml
  43. +4
    -4
      docs/polkit/html/license.html
  44. +4
    -4
      docs/polkit/html/manpages.html
  45. +4
    -4
      docs/polkit/html/overview.html
  46. +10
    -10
      docs/polkit/html/pkaction.1.html
  47. +27
    -12
      docs/polkit/html/pkcheck.1.html
  48. +2
    -2
      docs/polkit/html/pkexec-bash.html
  49. +2
    -2
      docs/polkit/html/pkexec-frobnicate-da.html
  50. +2
    -2
      docs/polkit/html/pkexec-frobnicate.html
  51. +56
    -22
      docs/polkit/html/pkexec.1.html
  52. +13
    -13
      docs/polkit/html/pklocalauthority.8.html
  53. +17
    -27
      docs/polkit/html/polit-index.html
  54. +10
    -16
      docs/polkit/html/polkit-1.devhelp
  55. +14
    -20
      docs/polkit/html/polkit-1.devhelp2
  56. +4
    -4
      docs/polkit/html/polkit-agents.html
  57. +5
    -5
      docs/polkit/html/polkit-apps.html
  58. +2
    -2
      docs/polkit/html/polkit-architecture.html
  59. +2
    -2
      docs/polkit/html/polkit-authentication-agent-example-wheel.html
  60. +2
    -2
      docs/polkit/html/polkit-authentication-agent-example.html
  61. +5
    -10
      docs/polkit/html/polkit-extending.html
  62. +11
    -5
      docs/polkit/html/polkit-hierarchy.html
  63. +4
    -4
      docs/polkit/html/polkit-intro.html
  64. +11
    -11
      docs/polkit/html/polkit.8.html
  65. +9
    -9
      docs/polkit/html/polkitd.8.html
  66. +5
    -5
      docs/polkit/html/ref-api.html
  67. +6
    -6
      docs/polkit/html/ref-authentication-agent-api.html
  68. +4
    -7
      docs/polkit/html/ref-backend-api.html
  69. +4
    -4
      docs/polkit/html/ref-dbus-api.html
  70. +2
    -1
      docs/polkit/html/style.css
  71. +4
    -4
      docs/polkit/html/subjects.html
  72. +0
    -9
      docs/polkit/overview.xml
  73. +0
    -1
      docs/polkit/polkit-1-docs.xml
  74. +1
    -0
      docs/polkit/polkit-1-sections.txt
  75. +1
    -1
      docs/version.xml
  76. +53
    -37
      gtk-doc.make
  77. +1648
    -757
      ltmain.sh
  78. +1
    -1
      po/POTFILES.in
  79. +31
    -59
      po/da.po
  80. +9
    -5
      src/Makefile.in
  81. +9
    -5
      src/examples/Makefile.in
  82. +1
    -1
      src/examples/cancel.c
  83. +2
    -2
      src/examples/org.freedesktop.policykit.examples.pkexec.policy
  84. +1
    -1
      src/examples/org.freedesktop.policykit.examples.pkexec.policy.in
  85. +9
    -5
      src/nullbackend/Makefile.in
  86. +0
    -4
      src/nullbackend/polkitbackendnullauthority.c
  87. +8
    -8
      src/polkit/Makefile.am
  88. +32
    -28
      src/polkit/Makefile.in
  89. +2
    -0
      src/polkit/polkitactiondescription.c
  90. +16
    -6
      src/polkit/polkitauthority.c
  91. +29
    -0
      src/polkit/polkitauthorizationresult.c
  92. +1
    -0
      src/polkit/polkitauthorizationresult.h
  93. +24
    -8
      src/polkit/polkitpermission.c
  94. +6
    -0
      src/polkit/polkittemporaryauthorization.c
  95. +9
    -8
      src/polkitagent/Makefile.am
  96. +38
    -32
      src/polkitagent/Makefile.in
  97. +0
    -3
      src/polkitagent/polkitagentsession.c
  98. +9
    -5
      src/polkitbackend/Makefile.in
  99. +3
    -0
      src/polkitbackend/polkitbackendactionlookup.c
  100. +16
    -0
      src/polkitbackend/polkitbackendactionlookup.h

+ 9
- 5
Makefile.in View File

@@ -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@


+ 47
- 0
NEWS View File

@@ -1,3 +1,50 @@
--------------
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
--------------


+ 823
- 334
aclocal.m4
File diff suppressed because it is too large
View File


+ 9
- 5
actions/Makefile.in View File

@@ -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@


+ 2
- 0
actions/org.freedesktop.policykit.policy View File

@@ -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>


+ 0
- 3
config.h.in View File

@@ -1,8 +1,5 @@
/* 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



+ 1335
- 674
configure
File diff suppressed because it is too large
View File


+ 7
- 24
configure.ac View File

@@ -1,8 +1,8 @@
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}

"



+ 9
- 5
data/Makefile.in View File

@@ -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@


+ 9
- 5
docs/Makefile.in View File

@@ -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@


+ 9
- 5
docs/man/Makefile.in View File

@@ -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@


+ 23
- 0
docs/man/pkcheck.xml View File

@@ -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.


+ 18
- 7
docs/man/pkexec.xml View File

@@ -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>


+ 60
- 42
docs/polkit/Makefile.in View File

@@ -80,6 +80,7 @@ CYGPATH_W = @CYGPATH_W@
DATADIRNAME = @DATADIRNAME@
DEFS = @DEFS@
DEPDIR = @DEPDIR@
DLLTOOL = @DLLTOOL@
DSYMUTIL = @DSYMUTIL@
DUMPBIN = @DUMPBIN@
ECHO_C = @ECHO_C@
@@ -90,8 +91,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@
@@ -100,9 +99,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@
@@ -117,7 +113,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@
@@ -131,6 +133,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@
@@ -177,6 +180,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@
@@ -328,9 +332,9 @@ FIXXREF_OPTIONS =
@ENABLE_GTK_DOC_TRUE@ $(DOC_MODULE)-sections.txt \
@ENABLE_GTK_DOC_TRUE@ $(DOC_MODULE)-overrides.txt

@ENABLE_GTK_DOC_TRUE@DOC_STAMPS = scan-build.stamp sgml-build.stamp html-build.stamp pdf-build.stamp \
@ENABLE_GTK_DOC_TRUE@ $(srcdir)/sgml.stamp $(srcdir)/html.stamp \
@ENABLE_GTK_DOC_TRUE@ $(srcdir)/pdf.stamp
@ENABLE_GTK_DOC_TRUE@DOC_STAMPS = setup-build.stamp scan-build.stamp sgml-build.stamp \
@ENABLE_GTK_DOC_TRUE@ html-build.stamp pdf-build.stamp \
@ENABLE_GTK_DOC_TRUE@ setup.stamp sgml.stamp html.stamp pdf.stamp

@ENABLE_GTK_DOC_TRUE@SCANOBJ_FILES = \
@ENABLE_GTK_DOC_TRUE@ $(DOC_MODULE).args \
@@ -573,22 +577,37 @@ uninstall-am: uninstall-local

@ENABLE_GTK_DOC_TRUE@$(REPORT_FILES): sgml-build.stamp

#### setup ####

@ENABLE_GTK_DOC_TRUE@setup-build.stamp::
@ENABLE_GTK_DOC_TRUE@ -@if test "$(abs_srcdir)" != "$(abs_builddir)" ; then \
@ENABLE_GTK_DOC_TRUE@ cp -a $(abs_srcdir)/$(DOC_MAIN_SGML_FILE) $(abs_builddir)/; \
@ENABLE_GTK_DOC_TRUE@ cp -a $(abs_srcdir)/$(DOC_MODULE)* $(abs_builddir)/; \
@ENABLE_GTK_DOC_TRUE@ if test "x$(content_files)" != "x" ; then \
@ENABLE_GTK_DOC_TRUE@ for file in $(content_files) ; do \
@ENABLE_GTK_DOC_TRUE@ test -f $(abs_srcdir)/$$file || \
@ENABLE_GTK_DOC_TRUE@ cp -a $(abs_srcdir)/$$file $(abs_builddir)/; \
@ENABLE_GTK_DOC_TRUE@ done \
@ENABLE_GTK_DOC_TRUE@ fi \
@ENABLE_GTK_DOC_TRUE@ fi

@ENABLE_GTK_DOC_TRUE@setup.stamp: setup-build.stamp
@ENABLE_GTK_DOC_TRUE@ @true

#### scan ####

@ENABLE_GTK_DOC_TRUE@scan-build.stamp: $(HFILE_GLOB) $(CFILE_GLOB)
@ENABLE_GTK_DOC_TRUE@ @echo 'gtk-doc: Scanning header files'
@ENABLE_GTK_DOC_TRUE@ @-chmod -R u+w $(srcdir)
@ENABLE_GTK_DOC_TRUE@ @_source_dir='' ; for i in $(DOC_SOURCE_DIR) ; do \
@ENABLE_GTK_DOC_TRUE@ @_source_dir='' ; \
@ENABLE_GTK_DOC_TRUE@ for i in $(DOC_SOURCE_DIR) ; do \
@ENABLE_GTK_DOC_TRUE@ _source_dir="$${_source_dir} --source-dir=$$i" ; \
@ENABLE_GTK_DOC_TRUE@ done ; \
@ENABLE_GTK_DOC_TRUE@ cd $(srcdir) && \
@ENABLE_GTK_DOC_TRUE@ gtkdoc-scan --module=$(DOC_MODULE) --ignore-headers="$(IGNORE_HFILES)" $${_source_dir} $(SCAN_OPTIONS) $(EXTRA_HFILES)
@ENABLE_GTK_DOC_TRUE@ @if grep -l '^..*$$' $(srcdir)/$(DOC_MODULE).types > /dev/null 2>&1 ; then \
@ENABLE_GTK_DOC_TRUE@ CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" RUN="$(GTKDOC_RUN)" CFLAGS="$(GTKDOC_CFLAGS) $(CFLAGS)" LDFLAGS="$(GTKDOC_LIBS) $(LDFLAGS)" gtkdoc-scangobj $(SCANGOBJ_OPTIONS) --module=$(DOC_MODULE) --output-dir=$(srcdir) ; \
@ENABLE_GTK_DOC_TRUE@ done ; \
@ENABLE_GTK_DOC_TRUE@ gtkdoc-scan --module=$(DOC_MODULE) --ignore-headers="$(IGNORE_HFILES)" $${_source_dir} $(SCAN_OPTIONS) $(EXTRA_HFILES)
@ENABLE_GTK_DOC_TRUE@ @if grep -l '^..*$$' $(DOC_MODULE).types > /dev/null 2>&1 ; then \
@ENABLE_GTK_DOC_TRUE@ CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" RUN="$(GTKDOC_RUN)" CFLAGS="$(GTKDOC_CFLAGS) $(CFLAGS)" LDFLAGS="$(GTKDOC_LIBS) $(LDFLAGS)" gtkdoc-scangobj $(SCANGOBJ_OPTIONS) --module=$(DOC_MODULE) ; \
@ENABLE_GTK_DOC_TRUE@ else \
@ENABLE_GTK_DOC_TRUE@ cd $(srcdir) ; \
@ENABLE_GTK_DOC_TRUE@ for i in $(SCANOBJ_FILES) ; do \
@ENABLE_GTK_DOC_TRUE@ test -f $$i || touch $$i ; \
@ENABLE_GTK_DOC_TRUE@ test -f $$i || touch $$i ; \
@ENABLE_GTK_DOC_TRUE@ done \
@ENABLE_GTK_DOC_TRUE@ fi
@ENABLE_GTK_DOC_TRUE@ @touch scan-build.stamp
@@ -598,14 +617,13 @@ uninstall-am: uninstall-local

#### xml ####

@ENABLE_GTK_DOC_TRUE@sgml-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt $(DOC_MODULE)-overrides.txt $(expand_content_files)
@ENABLE_GTK_DOC_TRUE@sgml-build.stamp: setup-build.stamp $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt $(DOC_MODULE)-overrides.txt $(expand_content_files)
@ENABLE_GTK_DOC_TRUE@ @echo 'gtk-doc: Building XML'
@ENABLE_GTK_DOC_TRUE@ @-chmod -R u+w $(srcdir)
@ENABLE_GTK_DOC_TRUE@ @_source_dir='' ; for i in $(DOC_SOURCE_DIR) ; do \
@ENABLE_GTK_DOC_TRUE@ @_source_dir='' ; \
@ENABLE_GTK_DOC_TRUE@ for i in $(DOC_SOURCE_DIR) ; do \
@ENABLE_GTK_DOC_TRUE@ _source_dir="$${_source_dir} --source-dir=$$i" ; \
@ENABLE_GTK_DOC_TRUE@ done ; \
@ENABLE_GTK_DOC_TRUE@ cd $(srcdir) && \
@ENABLE_GTK_DOC_TRUE@ gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --expand-content-files="$(expand_content_files)" --main-sgml-file=$(DOC_MAIN_SGML_FILE) $${_source_dir} $(MKDB_OPTIONS)
@ENABLE_GTK_DOC_TRUE@ done ; \
@ENABLE_GTK_DOC_TRUE@ gtkdoc-mkdb --module=$(DOC_MODULE) --output-format=xml --expand-content-files="$(expand_content_files)" --main-sgml-file=$(DOC_MAIN_SGML_FILE) $${_source_dir} $(MKDB_OPTIONS)
@ENABLE_GTK_DOC_TRUE@ @touch sgml-build.stamp

@ENABLE_GTK_DOC_TRUE@sgml.stamp: sgml-build.stamp
@@ -615,26 +633,24 @@ uninstall-am: uninstall-local

@ENABLE_GTK_DOC_TRUE@html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files)
@ENABLE_GTK_DOC_TRUE@ @echo 'gtk-doc: Building HTML'
@ENABLE_GTK_DOC_TRUE@ @-chmod -R u+w $(srcdir)
@ENABLE_GTK_DOC_TRUE@ @rm -rf $(srcdir)/html
@ENABLE_GTK_DOC_TRUE@ @mkdir $(srcdir)/html
@ENABLE_GTK_DOC_TRUE@ @rm -rf html
@ENABLE_GTK_DOC_TRUE@ @mkdir html
@ENABLE_GTK_DOC_TRUE@ @mkhtml_options=""; \
@ENABLE_GTK_DOC_TRUE@ gtkdoc-mkhtml 2>&1 --help | grep >/dev/null "\-\-path"; \
@ENABLE_GTK_DOC_TRUE@ if test "$(?)" = "0"; then \
@ENABLE_GTK_DOC_TRUE@ mkhtml_options=--path="$(srcdir)"; \
@ENABLE_GTK_DOC_TRUE@ mkhtml_options=--path="$(abs_srcdir)"; \
@ENABLE_GTK_DOC_TRUE@ fi; \
@ENABLE_GTK_DOC_TRUE@ cd $(srcdir)/html && gtkdoc-mkhtml $$mkhtml_options $(MKHTML_OPTIONS) $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE)
@ENABLE_GTK_DOC_TRUE@ @test "x$(HTML_IMAGES)" = "x" || ( cd $(srcdir) && cp $(HTML_IMAGES) html )
@ENABLE_GTK_DOC_TRUE@ cd html && gtkdoc-mkhtml $$mkhtml_options $(MKHTML_OPTIONS) $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE)
@ENABLE_GTK_DOC_TRUE@ @test "x$(HTML_IMAGES)" = "x" || ( cd $(srcdir) && cp $(HTML_IMAGES) $(abs_builddir)/html )
@ENABLE_GTK_DOC_TRUE@ @echo 'gtk-doc: Fixing cross-references'
@ENABLE_GTK_DOC_TRUE@ @cd $(srcdir) && gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS)
@ENABLE_GTK_DOC_TRUE@ @gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS)
@ENABLE_GTK_DOC_TRUE@ @touch html-build.stamp

#### pdf ####

@ENABLE_GTK_DOC_TRUE@pdf-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files)
@ENABLE_GTK_DOC_TRUE@ @echo 'gtk-doc: Building PDF'
@ENABLE_GTK_DOC_TRUE@ @-chmod -R u+w $(srcdir)
@ENABLE_GTK_DOC_TRUE@ @rm -rf $(srcdir)/$(DOC_MODULE).pdf
@ENABLE_GTK_DOC_TRUE@ @rm -rf $(DOC_MODULE).pdf
@ENABLE_GTK_DOC_TRUE@ @mkpdf_imgdirs=""; \
@ENABLE_GTK_DOC_TRUE@ if test "x$(HTML_IMAGES)" != "x"; then \
@ENABLE_GTK_DOC_TRUE@ for img in $(HTML_IMAGES); do \
@@ -645,7 +661,7 @@ uninstall-am: uninstall-local
@ENABLE_GTK_DOC_TRUE@ fi; \
@ENABLE_GTK_DOC_TRUE@ done; \
@ENABLE_GTK_DOC_TRUE@ fi; \
@ENABLE_GTK_DOC_TRUE@ cd $(srcdir) && gtkdoc-mkpdf --path="$(abs_srcdir)" $$mkpdf_imgdirs $(DOC_MODULE) $(DOC_MAIN_SGML_FILE) $(MKPDF_OPTIONS)
@ENABLE_GTK_DOC_TRUE@ gtkdoc-mkpdf --path="$(abs_srcdir)" $$mkpdf_imgdirs $(DOC_MODULE) $(DOC_MAIN_SGML_FILE) $(MKPDF_OPTIONS)
@ENABLE_GTK_DOC_TRUE@ @touch pdf-build.stamp

##############
@@ -655,15 +671,17 @@ uninstall-am: uninstall-local
@ENABLE_GTK_DOC_TRUE@ rm -rf .libs

@ENABLE_GTK_DOC_TRUE@distclean-local:
@ENABLE_GTK_DOC_TRUE@ cd $(srcdir) && \
@ENABLE_GTK_DOC_TRUE@ rm -rf xml $(REPORT_FILES) $(DOC_MODULE).pdf \
@ENABLE_GTK_DOC_TRUE@ $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
@ENABLE_GTK_DOC_TRUE@ rm -rf xml html $(REPORT_FILES) $(DOC_MODULE).pdf \
@ENABLE_GTK_DOC_TRUE@ $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
@ENABLE_GTK_DOC_TRUE@ if test "$(abs_srcdir)" != "$(abs_builddir)" ; then \
@ENABLE_GTK_DOC_TRUE@ rm -f $(DOC_MAIN_SGML_FILE) $(DOC_MODULE)*; \
@ENABLE_GTK_DOC_TRUE@ fi

@ENABLE_GTK_DOC_TRUE@maintainer-clean-local: clean
@ENABLE_GTK_DOC_TRUE@ cd $(srcdir) && rm -rf html
@ENABLE_GTK_DOC_TRUE@ rm -rf html

@ENABLE_GTK_DOC_TRUE@install-data-local:
@ENABLE_GTK_DOC_TRUE@ @installfiles=`echo $(srcdir)/html/*`; \
@ENABLE_GTK_DOC_TRUE@ @installfiles=`echo $(builddir)/html/*`; \
@ENABLE_GTK_DOC_TRUE@ if test "$$installfiles" = '$(srcdir)/html/*'; \
@ENABLE_GTK_DOC_TRUE@ then echo '-- Nothing to install' ; \
@ENABLE_GTK_DOC_TRUE@ else \
@@ -704,10 +722,10 @@ uninstall-am: uninstall-local

@ENABLE_GTK_DOC_TRUE@dist-hook: dist-check-gtkdoc dist-hook-local
@ENABLE_GTK_DOC_TRUE@ mkdir $(distdir)/html
@ENABLE_GTK_DOC_TRUE@ cp $(srcdir)/html/* $(distdir)/html
@ENABLE_GTK_DOC_TRUE@ -cp $(srcdir)/$(DOC_MODULE).pdf $(distdir)/
@ENABLE_GTK_DOC_TRUE@ -cp $(srcdir)/$(DOC_MODULE).types $(distdir)/
@ENABLE_GTK_DOC_TRUE@ -cp $(srcdir)/$(DOC_MODULE)-sections.txt $(distdir)/
@ENABLE_GTK_DOC_TRUE@ cp $(builddir)/html/* $(distdir)/html
@ENABLE_GTK_DOC_TRUE@ -cp $(builddir)/$(DOC_MODULE).pdf $(distdir)/
@ENABLE_GTK_DOC_TRUE@ -cp $(builddir)/$(DOC_MODULE).types $(distdir)/
@ENABLE_GTK_DOC_TRUE@ -cp $(builddir)/$(DOC_MODULE)-sections.txt $(distdir)/
@ENABLE_GTK_DOC_TRUE@ cd $(distdir) && rm -f $(DISTCLEANFILES)
@ENABLE_GTK_DOC_TRUE@ $(GTKDOC_REBASE) --online --relative --html-dir=$(distdir)/html



+ 24
- 4
docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.AuthenticationAgent.xml View File

@@ -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>


+ 49
- 3
docs/polkit/docbook-interface-org.freedesktop.PolicyKit1.Authority.xml View File

@@ -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>


+ 4
- 4
docs/polkit/html/Identities.html View File

@@ -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>

+ 56
- 71
docs/polkit/html/PolkitActionDescription.html View File

@@ -3,18 +3,18 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>PolkitActionDescription</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="polkit-1-PolkitError.html" title="PolkitError">
<link rel="prev" href="PolkitError.html" title="PolkitError">
<link rel="next" href="PolkitTemporaryAuthorization.html" title="PolkitTemporaryAuthorization">
<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">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="polkit-1-PolkitError.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="p" href="PolkitError.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="ref-api.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">PolicyKit Reference Manual</th>
@@ -28,7 +28,7 @@
<a href="#PolkitActionDescription.object-hierarchy" class="shortcut">Object Hierarchy</a>
</td></tr>
</table>
<div class="refentry" title="PolkitActionDescription">
<div class="refentry">
<a name="PolkitActionDescription"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
@@ -37,10 +37,10 @@
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv" title="Synopsis">
<div class="refsynopsisdiv">
<a name="PolkitActionDescription.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis"> <a class="link" href="PolkitActionDescription.html#PolkitActionDescription-struct" title="PolkitActionDescription">PolkitActionDescription</a>;
enum <a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization" title="enum PolkitImplicitAuthorization">PolkitImplicitAuthorization</a>;
<a name="PolkitImplicitAuthorization"></a><pre class="synopsis"> <a class="link" href="PolkitActionDescription.html#PolkitActionDescription-struct" title="PolkitActionDescription">PolkitActionDescription</a>;
enum <a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization">PolkitImplicitAuthorization</a>;
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="PolkitActionDescription.html#polkit-action-description-get-action-id" title="polkit_action_description_get_action_id ()">polkit_action_description_get_action_id</a>
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="PolkitActionDescription.html#polkit-action-description-get-description" title="polkit_action_description_get_description ()">polkit_action_description_get_description</a>
@@ -53,33 +53,37 @@ const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.htm
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="PolkitActionDescription.html#polkit-action-description-get-icon-name" title="polkit_action_description_get_icon_name ()">polkit_action_description_get_icon_name</a>
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);
<a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization" title="enum PolkitImplicitAuthorization"><span class="returnvalue">PolkitImplicitAuthorization</span></a> <a class="link" href="PolkitActionDescription.html#polkit-action-description-get-implicit-any" title="polkit_action_description_get_implicit_any ()">polkit_action_description_get_implicit_any</a>
<a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization"><span class="returnvalue">PolkitImplicitAuthorization</span></a> <a class="link" href="PolkitActionDescription.html#polkit-action-description-get-implicit-any" title="polkit_action_description_get_implicit_any ()">polkit_action_description_get_implicit_any</a>
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);
<a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization" title="enum PolkitImplicitAuthorization"><span class="returnvalue">PolkitImplicitAuthorization</span></a> <a class="link" href="PolkitActionDescription.html#polkit-action-description-get-implicit-inactive" title="polkit_action_description_get_implicit_inactive ()">polkit_action_description_get_implicit_inactive</a>
<a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization"><span class="returnvalue">PolkitImplicitAuthorization</span></a> <a class="link" href="PolkitActionDescription.html#polkit-action-description-get-implicit-inactive" title="polkit_action_description_get_implicit_inactive ()">polkit_action_description_get_implicit_inactive</a>
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);
<a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization" title="enum PolkitImplicitAuthorization"><span class="returnvalue">PolkitImplicitAuthorization</span></a> <a class="link" href="PolkitActionDescription.html#polkit-action-description-get-implicit-active" title="polkit_action_description_get_implicit_active ()">polkit_action_description_get_implicit_active</a>
<a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization"><span class="returnvalue">PolkitImplicitAuthorization</span></a> <a class="link" href="PolkitActionDescription.html#polkit-action-description-get-implicit-active" title="polkit_action_description_get_implicit_active ()">polkit_action_description_get_implicit_active</a>
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * <a class="link" href="PolkitActionDescription.html#polkit-action-description-get-annotation" title="polkit_action_description_get_annotation ()">polkit_action_description_get_annotation</a>
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>,
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *key</code></em>);
</pre>
</div>
<div class="refsect1" title="Object Hierarchy">
<div class="refsect1">
<a name="PolkitActionDescription.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
+----PolkitActionDescription
</pre>
<pre class="synopsis">
GEnum
+----PolkitImplicitAuthorization
</pre>
</div>
<div class="refsect1" title="Description">
<div class="refsect1">
<a name="PolkitActionDescription.description"></a><h2>Description</h2>
<p>
Object used to encapsulate a registered action.
</p>
</div>
<div class="refsect1" title="Details">
<div class="refsect1">
<a name="PolkitActionDescription.details"></a><h2>Details</h2>
<div class="refsect2" title="PolkitActionDescription">
<div class="refsect2">
<a name="PolkitActionDescription-struct"></a><h3>PolkitActionDescription</h3>
<pre class="programlisting">typedef struct _PolkitActionDescription PolkitActionDescription;</pre>
<p>
@@ -87,7 +91,7 @@ The <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescr
</p>
</div>
<hr>
<div class="refsect2" title="enum PolkitImplicitAuthorization">
<div class="refsect2">
<a name="PolkitImplicitAuthorization"></a><h3>enum PolkitImplicitAuthorization</h3>
<pre class="programlisting">typedef enum
{
@@ -145,7 +149,7 @@ Possible implicit authorizations.
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_action_description_get_action_id ()">
<div class="refsect2">
<a name="polkit-action-description-get-action-id"></a><h3>polkit_action_description_get_action_id ()</h3>
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * polkit_action_description_get_action_id
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);</pre>
@@ -157,19 +161,17 @@ Gets the action id for <em class="parameter"><code>action_description</code></em
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>action_description</code></em> :</span></p></td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.
</td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A string owned by <em class="parameter"><code>action_description</code></em>. Do not free.
</td>
<td>A string owned by <em class="parameter"><code>action_description</code></em>. Do not free.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_action_description_get_description ()">
<div class="refsect2">
<a name="polkit-action-description-get-description"></a><h3>polkit_action_description_get_description ()</h3>
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * polkit_action_description_get_description
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);</pre>
@@ -181,19 +183,17 @@ Gets the description used for <em class="parameter"><code>action_description</co
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>action_description</code></em> :</span></p></td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.
</td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A string owned by <em class="parameter"><code>action_description</code></em>. Do not free.
</td>
<td>A string owned by <em class="parameter"><code>action_description</code></em>. Do not free.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_action_description_get_message ()">
<div class="refsect2">
<a name="polkit-action-description-get-message"></a><h3>polkit_action_description_get_message ()</h3>
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * polkit_action_description_get_message
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);</pre>
@@ -205,19 +205,17 @@ Gets the message used for <em class="parameter"><code>action_description</code><
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>action_description</code></em> :</span></p></td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.
</td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A string owned by <em class="parameter"><code>action_description</code></em>. Do not free.
</td>
<td>A string owned by <em class="parameter"><code>action_description</code></em>. Do not free.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_action_description_get_vendor_name ()">
<div class="refsect2">
<a name="polkit-action-description-get-vendor-name"></a><h3>polkit_action_description_get_vendor_name ()</h3>
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * polkit_action_description_get_vendor_name
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);</pre>
@@ -229,19 +227,17 @@ Gets the vendor name for <em class="parameter"><code>action_description</code></
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>action_description</code></em> :</span></p></td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.
</td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A string owned by <em class="parameter"><code>action_description</code></em>. Do not free.
</td>
<td>A string owned by <em class="parameter"><code>action_description</code></em>. Do not free.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_action_description_get_vendor_url ()">
<div class="refsect2">
<a name="polkit-action-description-get-vendor-url"></a><h3>polkit_action_description_get_vendor_url ()</h3>
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * polkit_action_description_get_vendor_url
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);</pre>
@@ -253,19 +249,17 @@ Gets the vendor URL for <em class="parameter"><code>action_description</code></e
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>action_description</code></em> :</span></p></td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.
</td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A string owned by <em class="parameter"><code>action_description</code></em>. Do not free.
</td>
<td>A string owned by <em class="parameter"><code>action_description</code></em>. Do not free.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_action_description_get_icon_name ()">
<div class="refsect2">
<a name="polkit-action-description-get-icon-name"></a><h3>polkit_action_description_get_icon_name ()</h3>
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * polkit_action_description_get_icon_name
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);</pre>
@@ -277,21 +271,19 @@ Gets the icon name for <em class="parameter"><code>action_description</code></em
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>action_description</code></em> :</span></p></td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.
</td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A string owned by <em class="parameter"><code>action_description</code></em>. Do not free.
</td>
<td>A string owned by <em class="parameter"><code>action_description</code></em>. Do not free.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_action_description_get_implicit_any ()">
<div class="refsect2">
<a name="polkit-action-description-get-implicit-any"></a><h3>polkit_action_description_get_implicit_any ()</h3>
<pre class="programlisting"><a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization" title="enum PolkitImplicitAuthorization"><span class="returnvalue">PolkitImplicitAuthorization</span></a> polkit_action_description_get_implicit_any
<pre class="programlisting"><a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization"><span class="returnvalue">PolkitImplicitAuthorization</span></a> polkit_action_description_get_implicit_any
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);</pre>
<p>
Gets the implicit authorization for <em class="parameter"><code>action_description</code></em> used for
@@ -302,21 +294,19 @@ any subject.
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>action_description</code></em> :</span></p></td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.
</td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A value from the <a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization" title="enum PolkitImplicitAuthorization"><span class="type">PolkitImplicitAuthorization</span></a> enumeration.
</td>
<td>A value from the <a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization"><span class="type">PolkitImplicitAuthorization</span></a> enumeration.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_action_description_get_implicit_inactive ()">
<div class="refsect2">
<a name="polkit-action-description-get-implicit-inactive"></a><h3>polkit_action_description_get_implicit_inactive ()</h3>
<pre class="programlisting"><a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization" title="enum PolkitImplicitAuthorization"><span class="returnvalue">PolkitImplicitAuthorization</span></a> polkit_action_description_get_implicit_inactive
<pre class="programlisting"><a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization"><span class="returnvalue">PolkitImplicitAuthorization</span></a> polkit_action_description_get_implicit_inactive
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);</pre>
<p>
Gets the implicit authorization for <em class="parameter"><code>action_description</code></em> used for
@@ -327,21 +317,19 @@ subjects in inactive sessions on a local console.
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>action_description</code></em> :</span></p></td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.
</td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A value from the <a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization" title="enum PolkitImplicitAuthorization"><span class="type">PolkitImplicitAuthorization</span></a> enumeration.
</td>
<td>A value from the <a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization"><span class="type">PolkitImplicitAuthorization</span></a> enumeration.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_action_description_get_implicit_active ()">
<div class="refsect2">
<a name="polkit-action-description-get-implicit-active"></a><h3>polkit_action_description_get_implicit_active ()</h3>
<pre class="programlisting"><a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization" title="enum PolkitImplicitAuthorization"><span class="returnvalue">PolkitImplicitAuthorization</span></a> polkit_action_description_get_implicit_active
<pre class="programlisting"><a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization"><span class="returnvalue">PolkitImplicitAuthorization</span></a> polkit_action_description_get_implicit_active
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>);</pre>
<p>
Gets the implicit authorization for <em class="parameter"><code>action_description</code></em> used for
@@ -352,19 +340,17 @@ subjects in active sessions on a local console.
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>action_description</code></em> :</span></p></td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.
</td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A value from the <a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization" title="enum PolkitImplicitAuthorization"><span class="type">PolkitImplicitAuthorization</span></a> enumeration.
</td>
<td>A value from the <a class="link" href="PolkitActionDescription.html#PolkitImplicitAuthorization"><span class="type">PolkitImplicitAuthorization</span></a> enumeration.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_action_description_get_annotation ()">
<div class="refsect2">
<a name="polkit-action-description-get-annotation"></a><h3>polkit_action_description_get_annotation ()</h3>
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> * polkit_action_description_get_annotation
(<em class="parameter"><code><a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a> *action_description</code></em>,
@@ -377,17 +363,16 @@ Get the value of the annotation with <em class="parameter"><code>key</code></em>
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>action_description</code></em> :</span></p></td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.
</td>
<td>A <a class="link" href="PolkitActionDescription.html" title="PolkitActionDescription"><span class="type">PolkitActionDescription</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
<td>An annotation key.
</td>
<td>An annotation key.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is no annoation with <em class="parameter"><code>key</code></em>,
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is no annoation with <em class="parameter"><code>key</code></em>,
otherwise the annotation value owned by <em class="parameter"><code>action_description</code></em>. Do not
free. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span class="acronym">allow-none</span></a>]</span>
</td>
@@ -399,6 +384,6 @@ free. <span class="annotation">[<a href="http://foldoc.org/allow-none"><span cla
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.15</div>
Generated by GTK-Doc V1.16</div>
</body>
</html>

+ 47
- 69
docs/polkit/html/PolkitAgentListener.html View File

@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>PolkitAgentListener</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="ref-authentication-agent-api.html" title="Part V. Authentication Agent API Reference">
<link rel="next" href="PolkitAgentTextListener.html" title="PolkitAgentTextListener">
<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">
@@ -28,7 +28,7 @@
<a href="#PolkitAgentListener.object-hierarchy" class="shortcut">Object Hierarchy</a>
</td></tr>
</table>
<div class="refentry" title="PolkitAgentListener">
<div class="refentry">
<a name="PolkitAgentListener"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
@@ -37,14 +37,14 @@
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1" title="Stability Level">
<div class="refsect1">
<a name="PolkitAgentListener.stability-level"></a><h2>Stability Level</h2>
Unstable, unless otherwise indicated
</div>
<div class="refsynopsisdiv" title="Synopsis">
<div class="refsynopsisdiv">
<a name="PolkitAgentListener.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis"> <a class="link" href="PolkitAgentListener.html#PolkitAgentListener-struct" title="PolkitAgentListener">PolkitAgentListener</a>;
<a class="link" href="PolkitAgentListener.html#PolkitAgentListenerClass" title="PolkitAgentListenerClass">PolkitAgentListenerClass</a>;
struct <a class="link" href="PolkitAgentListener.html#PolkitAgentListenerClass" title="struct PolkitAgentListenerClass">PolkitAgentListenerClass</a>;
<span class="returnvalue">void</span> <a class="link" href="PolkitAgentListener.html#polkit-agent-listener-initiate-authentication" title="polkit_agent_listener_initiate_authentication ()">polkit_agent_listener_initiate_authentication</a>
(<em class="parameter"><code><a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener"><span class="type">PolkitAgentListener</span></a> *listener</code></em>,
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *action_id</code></em>,
@@ -70,7 +70,7 @@ enum <a class="link" href="PolkitAgentListener.html#PolkitAgentRe
<span class="returnvalue">void</span> <a class="link" href="PolkitAgentListener.html#polkit-agent-listener-unregister" title="polkit_agent_listener_unregister ()">polkit_agent_listener_unregister</a> (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> registration_handle</code></em>);
</pre>
</div>
<div class="refsect1" title="Object Hierarchy">
<div class="refsect1">
<a name="PolkitAgentListener.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
@@ -78,7 +78,7 @@ enum <a class="link" href="PolkitAgentListener.html#PolkitAgentRe
+----<a class="link" href="PolkitAgentTextListener.html" title="PolkitAgentTextListener">PolkitAgentTextListener</a>
</pre>
</div>
<div class="refsect1" title="Description">
<div class="refsect1">
<a name="PolkitAgentListener.description"></a><h2>Description</h2>
<p>
<a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener"><span class="type">PolkitAgentListener</span></a> is an abstract base class used for implementing authentication
@@ -98,9 +98,9 @@ To register a <a class="link" href="PolkitAgentListener.html" title="PolkitAgent
<a class="link" href="PolkitAgentListener.html#polkit-agent-listener-register" title="polkit_agent_listener_register ()"><code class="function">polkit_agent_listener_register()</code></a>.
</p>
</div>
<div class="refsect1" title="Details">
<div class="refsect1">
<a name="PolkitAgentListener.details"></a><h2>Details</h2>
<div class="refsect2" title="PolkitAgentListener">
<div class="refsect2">
<a name="PolkitAgentListener-struct"></a><h3>PolkitAgentListener</h3>
<pre class="programlisting">typedef struct _PolkitAgentListener PolkitAgentListener;</pre>
<p>
@@ -108,9 +108,9 @@ The <a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener">
</p>
</div>
<hr>
<div class="refsect2" title="PolkitAgentListenerClass">
<a name="PolkitAgentListenerClass"></a><h3>PolkitAgentListenerClass</h3>
<pre class="programlisting">typedef struct {
<div class="refsect2">
<a name="PolkitAgentListenerClass"></a><h3>struct PolkitAgentListenerClass</h3>
<pre class="programlisting">struct PolkitAgentListenerClass {
GObjectClass parent_class;

/* Vtable */
@@ -128,7 +128,7 @@ The <a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener">
gboolean (*initiate_authentication_finish) (PolkitAgentListener *listener,
GAsyncResult *res,
GError **error);
} PolkitAgentListenerClass;
};
</pre>
<p>
VFuncs that authentication agents needs to implement.
@@ -138,24 +138,21 @@ VFuncs that authentication agents needs to implement.
<tbody>
<tr>
<td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObjectClass"><span class="type">GObjectClass</span></a> <em class="structfield"><code><a name="PolkitAgentListenerClass.parent-class"></a>parent_class</code></em>;</span></p></td>
<td>The parent class.
</td>
<td>The parent class.</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code><a name="PolkitAgentListenerClass.initiate-authentication"></a>initiate_authentication</code></em> ()</span></p></td>
<td>Handle an authentication request, see <a class="link" href="PolkitAgentListener.html#polkit-agent-listener-initiate-authentication" title="polkit_agent_listener_initiate_authentication ()"><code class="function">polkit_agent_listener_initiate_authentication()</code></a>.
</td>
<td>Handle an authentication request, see <a class="link" href="PolkitAgentListener.html#polkit-agent-listener-initiate-authentication" title="polkit_agent_listener_initiate_authentication ()"><code class="function">polkit_agent_listener_initiate_authentication()</code></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="structfield"><code><a name="PolkitAgentListenerClass.initiate-authentication-finish"></a>initiate_authentication_finish</code></em> ()</span></p></td>
<td>Finishes handling an authentication request, see <a class="link" href="PolkitAgentListener.html#polkit-agent-listener-initiate-authentication-finish" title="polkit_agent_listener_initiate_authentication_finish ()"><code class="function">polkit_agent_listener_initiate_authentication_finish()</code></a>.
</td>
<td>Finishes handling an authentication request, see <a class="link" href="PolkitAgentListener.html#polkit-agent-listener-initiate-authentication-finish" title="polkit_agent_listener_initiate_authentication_finish ()"><code class="function">polkit_agent_listener_initiate_authentication_finish()</code></a>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_agent_listener_initiate_authentication ()">
<div class="refsect2">
<a name="polkit-agent-listener-initiate-authentication"></a><h3>polkit_agent_listener_initiate_authentication ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span> polkit_agent_listener_initiate_authentication
(<em class="parameter"><code><a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener"><span class="type">PolkitAgentListener</span></a> *listener</code></em>,
@@ -193,59 +190,49 @@ loop</GTKDOCLINK> of the thread that this method is called from.
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>listener</code></em> :</span></p></td>
<td>A <a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener"><span class="type">PolkitAgentListener</span></a>.
</td>
<td>A <a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener"><span class="type">PolkitAgentListener</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action_id</code></em> :</span></p></td>
<td>The action to authenticate for.
</td>
<td>The action to authenticate for.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>message</code></em> :</span></p></td>
<td>The message to present to the user.
</td>
<td>The message to present to the user.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>icon_name</code></em> :</span></p></td>
<td>A themed icon name representing the action or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
</td>
<td>A themed icon name representing the action or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>details</code></em> :</span></p></td>
<td>Details describing the action.
</td>
<td>Details describing the action.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cookie</code></em> :</span></p></td>
<td>The cookie for the authentication request.
</td>
<td>The cookie for the authentication request.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>identities</code></em> :</span></p></td>
<td>A list of <a class="link" href="PolkitIdentity.html" title="PolkitIdentity"><span class="type">PolkitIdentity</span></a> objects that the user can choose to authenticate as.
</td>
<td>A list of <a class="link" href="PolkitIdentity.html" title="PolkitIdentity"><span class="type">PolkitIdentity</span></a> objects that the user can choose to authenticate as.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
<td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a>.
</td>
<td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
<td>Function to call when the user is done authenticating.
</td>
<td>Function to call when the user is done authenticating.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
<td>Data to pass to <em class="parameter"><code>callback</code></em>.
</td>
<td>Data to pass to <em class="parameter"><code>callback</code></em>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_agent_listener_initiate_authentication_finish ()">
<div class="refsect2">
<a name="polkit-agent-listener-initiate-authentication-finish"></a><h3>polkit_agent_listener_initiate_authentication_finish ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> polkit_agent_listener_initiate_authentication_finish
(<em class="parameter"><code><a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener"><span class="type">PolkitAgentListener</span></a> *listener</code></em>,
@@ -260,29 +247,26 @@ Finishes an authentication request from the PolicyKit daemon, see
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>listener</code></em> :</span></p></td>
<td>A <a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener"><span class="type">PolkitAgentListener</span></a>.
</td>
<td>A <a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener"><span class="type">PolkitAgentListener</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>res</code></em> :</span></p></td>
<td>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> function passed to <a class="link" href="PolkitAgentListener.html#polkit-agent-listener-initiate-authentication" title="polkit_agent_listener_initiate_authentication ()"><code class="function">polkit_agent_listener_initiate_authentication()</code></a>.
</td>
<td>A <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html"><span class="type">GAsyncResult</span></a> obtained from the <a href="http://library.gnome.org/devel/gio/unstable/GAsyncResult.html#GAsyncReadyCallback"><span class="type">GAsyncReadyCallback</span></a> function passed to <a class="link" href="PolkitAgentListener.html#polkit-agent-listener-initiate-authentication" title="polkit_agent_listener_initiate_authentication ()"><code class="function">polkit_agent_listener_initiate_authentication()</code></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Return location for error.
</td>
<td>Return location for error.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>error</code></em> is set.
</td>
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>error</code></em> is set.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="enum PolkitAgentRegisterFlags">
<div class="refsect2">
<a name="PolkitAgentRegisterFlags"></a><h3>enum PolkitAgentRegisterFlags</h3>
<pre class="programlisting">typedef enum
{
@@ -310,7 +294,7 @@ Flags used in <a class="link" href="PolkitAgentListener.html#polkit-agent-listen
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_agent_listener_register ()">
<div class="refsect2">
<a name="polkit-agent-listener-register"></a><h3>polkit_agent_listener_register ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> polkit_agent_listener_register (<em class="parameter"><code><a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener"><span class="type">PolkitAgentListener</span></a> *listener</code></em>,
<em class="parameter"><code><a class="link" href="PolkitAgentListener.html#PolkitAgentRegisterFlags" title="enum PolkitAgentRegisterFlags"><span class="type">PolkitAgentRegisterFlags</span></a> flags</code></em>,
@@ -344,37 +328,32 @@ Note that the calling thread is blocked until a reply is received.
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>listener</code></em> :</span></p></td>
<td>A <a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener"><span class="type">PolkitAgentListener</span></a>.
</td>
<td>A <a class="link" href="PolkitAgentListener.html" title="PolkitAgentListener"><span class="type">PolkitAgentListener</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
<td>A set of flags from the <a class="link" href="PolkitAgentListener.html#PolkitAgentRegisterFlags" title="enum PolkitAgentRegisterFlags"><span class="type">PolkitAgentRegisterFlags</span></a> enumeration.
</td>
<td>A set of flags from the <a class="link" href="PolkitAgentListener.html#PolkitAgentRegisterFlags" title="enum PolkitAgentRegisterFlags"><span class="type">PolkitAgentRegisterFlags</span></a> enumeration.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>subject</code></em> :</span></p></td>
<td>The subject to become an authentication agent for, typically a <a class="link" href="PolkitUnixSession.html" title="PolkitUnixSession"><span class="type">PolkitUnixSession</span></a> object.
</td>
<td>The subject to become an authentication agent for, typically a <a class="link" href="PolkitUnixSession.html" title="PolkitUnixSession"><span class="type">PolkitUnixSession</span></a> object.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>object_path</code></em> :</span></p></td>
<td>The D-Bus object path to use for the authentication agent or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default object path.
</td>
<td>The D-Bus object path to use for the authentication agent or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> for the default object path.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
<td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
</td>
<td>A <a href="http://library.gnome.org/devel/gio/unstable/GCancellable.html"><span class="type">GCancellable</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
<td>Return location for error.
</td>
<td>Return location for error.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set, otherwise a
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>error</code></em> is set, otherwise a
registration handle that can be used with
<a class="link" href="PolkitAgentListener.html#polkit-agent-listener-unregister" title="polkit_agent_listener_unregister ()"><code class="function">polkit_agent_listener_unregister()</code></a>. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
</td>
@@ -383,7 +362,7 @@ registration handle that can be used with
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_agent_listener_unregister ()">
<div class="refsect2">
<a name="polkit-agent-listener-unregister"></a><h3>polkit_agent_listener_unregister ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span> polkit_agent_listener_unregister (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> registration_handle</code></em>);</pre>
<p>
@@ -393,8 +372,7 @@ Unregisters <em class="parameter"><code>listener</code></em>.
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>registration_handle</code></em> :</span></p></td>
<td>A handle obtained from <a class="link" href="PolkitAgentListener.html#polkit-agent-listener-register" title="polkit_agent_listener_register ()"><code class="function">polkit_agent_listener_register()</code></a>.
</td>
<td>A handle obtained from <a class="link" href="PolkitAgentListener.html#polkit-agent-listener-register" title="polkit_agent_listener_register ()"><code class="function">polkit_agent_listener_register()</code></a>.</td>
</tr></tbody>
</table></div>
</div>
@@ -402,6 +380,6 @@ Unregisters <em class="parameter"><code>listener</code></em>.
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.15</div>
Generated by GTK-Doc V1.16</div>
</body>
</html>

+ 48
- 64
docs/polkit/html/PolkitAgentSession.html View File

@@ -3,12 +3,12 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>PolkitAgentSession</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="PolkitAgentTextListener.html" title="PolkitAgentTextListener">
<link rel="next" href="manpages.html" title="Part VI. Manual Pages">
<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">
@@ -32,7 +32,7 @@
<a href="#PolkitAgentSession.signals" class="shortcut">Signals</a>
</td></tr>
</table>
<div class="refentry" title="PolkitAgentSession">
<div class="refentry">
<a name="PolkitAgentSession"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
@@ -41,11 +41,11 @@
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1" title="Stability Level">
<div class="refsect1">
<a name="PolkitAgentSession.stability-level"></a><h2>Stability Level</h2>
Unstable, unless otherwise indicated
</div>
<div class="refsynopsisdiv" title="Synopsis">
<div class="refsynopsisdiv">
<a name="PolkitAgentSession.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis"> <a class="link" href="PolkitAgentSession.html#PolkitAgentSession-struct" title="PolkitAgentSession">PolkitAgentSession</a>;
<a class="link" href="PolkitAgentSession.html" title="PolkitAgentSession"><span class="returnvalue">PolkitAgentSession</span></a> * <a class="link" href="PolkitAgentSession.html#polkit-agent-session-new" title="polkit_agent_session_new ()">polkit_agent_session_new</a> (<em class="parameter"><code><a class="link" href="PolkitIdentity.html" title="PolkitIdentity"><span class="type">PolkitIdentity</span></a> *identity</code></em>,
@@ -56,30 +56,30 @@ Unstable, unless otherwise indicated
<span class="returnvalue">void</span> <a class="link" href="PolkitAgentSession.html#polkit-agent-session-cancel" title="polkit_agent_session_cancel ()">polkit_agent_session_cancel</a> (<em class="parameter"><code><a class="link" href="PolkitAgentSession.html" title="PolkitAgentSession"><span class="type">PolkitAgentSession</span></a> *session</code></em>);
</pre>
</div>
<div class="refsect1" title="Object Hierarchy">
<div class="refsect1">
<a name="PolkitAgentSession.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
+----PolkitAgentSession
</pre>
</div>
<div class="refsect1" title="Properties">
<div class="refsect1">
<a name="PolkitAgentSession.properties"></a><h2>Properties</h2>
<pre class="synopsis">
"<a class="link" href="PolkitAgentSession.html#PolkitAgentSession--cookie" title='The "cookie" property'>cookie</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>* : Read / Write / Construct Only
"<a class="link" href="PolkitAgentSession.html#PolkitAgentSession--identity" title='The "identity" property'>identity</a>" <a class="link" href="PolkitIdentity.html" title="PolkitIdentity"><span class="type">PolkitIdentity</span></a>* : Read / Write / Construct Only
</pre>
</div>
<div class="refsect1" title="Signals">
<div class="refsect1">
<a name="PolkitAgentSession.signals"></a><h2>Signals</h2>
<pre class="synopsis">
"<a class="link" href="PolkitAgentSession.html#PolkitAgentSession-completed" title='The "completed" signal'>completed</a>" : Run Last
"<a class="link" href="PolkitAgentSession.html#PolkitAgentSession-request" title='The "request" signal'>request</a>" : Run Last
"<a class="link" href="PolkitAgentSession.html#PolkitAgentSession-show-error" title='The "show-error" signal'>show-error</a>" : Run Last
"<a class="link" href="PolkitAgentSession.html#PolkitAgentSession-show-info" title='The "show-info" signal'>show-info</a>" : Run Last
"<a class="link" href="PolkitAgentSession.html#PolkitAgentSession-completed" title='The "completed" signal'>completed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
"<a class="link" href="PolkitAgentSession.html#PolkitAgentSession-request" title='The "request" signal'>request</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
"<a class="link" href="PolkitAgentSession.html#PolkitAgentSession-show-error" title='The "show-error" signal'>show-error</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
"<a class="link" href="PolkitAgentSession.html#PolkitAgentSession-show-info" title='The "show-info" signal'>show-info</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
</pre>
</div>
<div class="refsect1" title="Description">
<div class="refsect1">
<a name="PolkitAgentSession.description"></a><h2>Description</h2>
<p>
The <a class="link" href="PolkitAgentSession.html" title="PolkitAgentSession"><span class="type">PolkitAgentSession</span></a> class is an abstraction used for interacting with the
@@ -109,9 +109,9 @@ If the user is unable to authenticate, the <a class="link" href="PolkitAgentSess
be emitted with the <em class="parameter"><code>gained_authorization</code></em> paramter set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
</p>
</div>
<div class="refsect1" title="Details">
<div class="refsect1">
<a name="PolkitAgentSession.details"></a><h2>Details</h2>
<div class="refsect2" title="PolkitAgentSession">
<div class="refsect2">
<a name="PolkitAgentSession-struct"></a><h3>PolkitAgentSession</h3>
<pre class="programlisting">typedef struct _PolkitAgentSession PolkitAgentSession;</pre>
<p>
@@ -119,7 +119,7 @@ The <a class="link" href="PolkitAgentSession.html" title="PolkitAgentSession"><s
</p>
</div>
<hr>
<div class="refsect2" title="polkit_agent_session_new ()">
<div class="refsect2">
<a name="polkit-agent-session-new"></a><h3>polkit_agent_session_new ()</h3>
<pre class="programlisting"><a class="link" href="PolkitAgentSession.html" title="PolkitAgentSession"><span class="returnvalue">PolkitAgentSession</span></a> * polkit_agent_session_new (<em class="parameter"><code><a class="link" href="PolkitIdentity.html" title="PolkitIdentity"><span class="type">PolkitIdentity</span></a> *identity</code></em>,
<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *cookie</code></em>);</pre>
@@ -139,24 +139,21 @@ signals and then call <a class="link" href="PolkitAgentSession.html#polkit-agent
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>identity</code></em> :</span></p></td>
<td>The identity to authenticate.
</td>
<td>The identity to authenticate.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cookie</code></em> :</span></p></td>
<td>The cookie obtained from the PolicyKit daemon
</td>
<td>The cookie obtained from the PolicyKit daemon</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td> A <a class="link" href="PolkitAgentSession.html" title="PolkitAgentSession"><span class="type">PolkitAgentSession</span></a>. Free with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.
</td>
<td>A <a class="link" href="PolkitAgentSession.html" title="PolkitAgentSession"><span class="type">PolkitAgentSession</span></a>. Free with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a>.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" title="polkit_agent_session_initiate ()">
<div class="refsect2">
<a name="polkit-agent-session-initiate"></a><h3>polkit_agent_session_initiate ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span> polkit_agent_session_initiate (<em class="parameter"><code><a class="link" href="PolkitAgentSession.html" title="PolkitAgentSession"><span class="type">PolkitAgentSession</span></a> *session</code></em>);</pre>
<p>