diff options
author | Stef Walter <stefw@gnome.org> | 2012-06-13 12:22:53 +0200 |
---|---|---|
committer | Ray Strode <rstrode@redhat.com> | 2012-07-24 17:52:05 -0400 |
commit | f9299269a71d85efbec3a06f28fa6edd24f339c3 (patch) | |
tree | 75f1c4d5a0b45c090639974ef20df8cc53801df5 /data | |
parent | 3b59c08e5d3f8a14f6292a41027a596fbc655d9d (diff) |
add CacheUser() and UncacheUser() methods
This commit introduces a CacheUser() method, which explicitly
makes a user show up in the results of a ListCachedUsers call
provided the user is otherwise known to the system.
This commit also introduces an UncacheUser() method to undo
what CacheUser() does.
https://bugs.freedesktop.org/show_bug.cgi?id=50770
Diffstat (limited to 'data')
-rw-r--r-- | data/org.freedesktop.Accounts.xml | 51 |
1 files changed, 51 insertions, 0 deletions
diff --git a/data/org.freedesktop.Accounts.xml b/data/org.freedesktop.Accounts.xml index ab3a15c..692540a 100644 --- a/data/org.freedesktop.Accounts.xml +++ b/data/org.freedesktop.Accounts.xml @@ -112,6 +112,57 @@ </doc:doc> </method> + <method name="CacheUser"> + <annotation name="org.freedesktop.DBus.GLib.Async" value=""/> + <arg name="name" direction="in" type="s"> + <doc:doc><doc:summary>The username for the user</doc:summary></doc:doc> + </arg> + <arg name="user" direction="out" type="o"> + <doc:doc><doc:summary>Object path of user</doc:summary></doc:doc> + </arg> + + <doc:doc> + <doc:description> + <doc:para> + Caches a user account, so that it shows up in ListCachedUsers() output. + The user name may be a remote user, but the system must be able to lookup + the user name and resolve the user information. + </doc:para> + </doc:description> + <doc:permission> + The caller needs the org.freedesktop.accounts.user-administration PolicyKit authorization. + </doc:permission> + <doc:errors> + <doc:error name="org.freedesktop.Accounts.Error.PermissionDenied">if the caller lacks the appropriate PolicyKit authorization</doc:error> + <doc:error name="org.freedesktop.Accounts.Error.UserDoesNotExist">if the user name cannot be resolved</doc:error> + </doc:errors> + </doc:doc> + </method> + + <method name="UncacheUser"> + <annotation name="org.freedesktop.DBus.GLib.Async" value=""/> + <arg name="name" direction="in" type="s"> + <doc:doc><doc:summary>The username for the user</doc:summary></doc:doc> + </arg> + + <doc:doc> + <doc:description> + <doc:para> + Releases all metadata about a user account, including icon, language and session. If the user account is + from a remote server and the user has never logged in before, then that account will no longer show up + in ListCachedUsers() output. + </doc:para> + </doc:description> + <doc:permission> + The caller needs the org.freedesktop.accounts.user-administration PolicyKit authorization. + </doc:permission> + <doc:errors> + <doc:error name="org.freedesktop.Accounts.Error.PermissionDenied">if the caller lacks the appropriate PolicyKit authorization</doc:error> + <doc:error name="org.freedesktop.Accounts.Error.UserDoesNotExist">if the user name cannot be resolved</doc:error> + </doc:errors> + </doc:doc> + </method> + <method name="DeleteUser"> <annotation name="org.freedesktop.DBus.GLib.Async" value=""/> <arg name="id" direction="in" type="x"> |