|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
"-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
|
|
Packit Service |
f1aff6 |
"http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd" [
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
]>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">
|
|
Packit Service |
f1aff6 |
<interface name="net.reactivated.Fprint.Device">
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:title id="polkit-integration">
|
|
Packit Service |
f1aff6 |
PolicyKit integration
|
|
Packit Service |
f1aff6 |
</doc:title>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
fprintd uses PolicyKit to check whether users are allowed to access fingerprint data, or the
|
|
Packit Service |
f1aff6 |
fingerprint readers itself.
|
|
Packit Service |
f1aff6 |
<doc:list>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>net.reactivated.fprint.device.verify</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Whether the user is allowed to verify fingers against saved fingerprints.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>net.reactivated.fprint.device.enroll</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Whether the user is allowed to enroll new fingerprints.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>net.reactivated.fprint.device.setusername</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Whether the user is allowed to query, verify, or enroll fingerprints for users other than itself.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
</doc:list>
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:title id="usernames">
|
|
Packit Service |
f1aff6 |
Usernames
|
|
Packit Service |
f1aff6 |
</doc:title>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
When a username argument is used for a method, a PolicyKit check is done on the
|
|
Packit Service |
f1aff6 |
<doc:tt>net.reactivated.fprint.device.setusername</doc:tt> PolicyKit
|
|
Packit Service |
f1aff6 |
action to see whether the user the client is running as is allowed to access data from other users.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
By default, only root is allowed to access fingerprint data for users other than itself. For a normal user,
|
|
Packit Service |
f1aff6 |
it is recommended that you use an empty string for the username, which will mean "the client the user is
|
|
Packit Service |
f1aff6 |
running as".
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
See <doc:ref type="description" to="polkit-integration">PolicyKit integration</doc:ref>.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:title id="fingerprint-names">
|
|
Packit Service |
f1aff6 |
Fingerprint names
|
|
Packit Service |
f1aff6 |
</doc:title>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
When a finger name argument is used for a method, it refers to either a single finger, or
|
|
Packit Service |
f1aff6 |
"any" finger. See the list of possible values below:
|
|
Packit Service |
f1aff6 |
<doc:list>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>left-thumb</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Left thumb
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>left-index-finger</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Left index finger
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>left-middle-finger</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Left middle finger
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>left-ring-finger</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Left ring finger
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>left-little-finger</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Left little finger
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>right-thumb</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Right thumb
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>right-index-finger</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Right index finger
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>right-middle-finger</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Right middle finger
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>right-ring-finger</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Right ring finger
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>right-little-finger</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Right little finger
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>any</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
Any finger. This is only used for <doc:ref type="method" to="Device.VerifyStart">Device.VerifyStart</doc:ref>
|
|
Packit Service |
f1aff6 |
(select the first finger with a fingerprint associated, or all the fingerprints available for the user when
|
|
Packit Service |
f1aff6 |
the device supports it) and <doc:ref type="signal" to="Device::VerifyFingerSelected">Device::VerifyFingerSelected</doc:ref>
|
|
Packit Service |
f1aff6 |
(any finger with an associated fingerprint can be used).
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
</doc:list>
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:title id="verify-statuses">
|
|
Packit Service |
f1aff6 |
Verify Statuses
|
|
Packit Service |
f1aff6 |
</doc:title>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
<doc:list>
|
|
Packit Service |
f1aff6 |
Possible values for the result passed through <doc:ref type="signal" to="Device::VerifyResult">Device::VerifyResult</doc:ref> are:
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>verify-no-match</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The verification did not match, <doc:ref type="method" to="Device.VerifyStop">Device.VerifyStop</doc:ref> should now be called.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>verify-match</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The verification succeeded, <doc:ref type="method" to="Device.VerifyStop">Device.VerifyStop</doc:ref> should now be called.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>verify-retry-scan</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The user should retry scanning their finger, the verification is still ongoing.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>verify-swipe-too-short</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The user's swipe was too short. The user should retry scanning their finger, the verification is still ongoing.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>verify-finger-not-centered</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The user's finger was not centered on the reader. The user should retry scanning their finger, the verification is still ongoing.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>verify-remove-and-retry</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The user should remove their finger from the reader and retry scanning their finger, the verification is still ongoing.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>verify-disconnected</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The device was disconnected during the verification, no other actions should be taken, and you shouldn't use the device any more.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>verify-unknown-error</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
An unknown error occurred (usually a driver problem), <doc:ref type="method" to="Device.VerifyStop">Device.VerifyStop</doc:ref> should now be called.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
</doc:list>
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:title id="enroll-statuses">
|
|
Packit Service |
f1aff6 |
Enroll Statuses
|
|
Packit Service |
f1aff6 |
</doc:title>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
<doc:list>
|
|
Packit Service |
f1aff6 |
Possible values for the result passed through <doc:ref type="signal" to="Device::EnrollResult">Device::EnrollResult</doc:ref> are:
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>enroll-completed</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The enrollment successfully completed, <doc:ref type="method" to="Device.EnrollStop">Device.EnrollStop</doc:ref> should now be called.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>enroll-failed</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The enrollment failed, <doc:ref type="method" to="Device.EnrollStop">Device.EnrollStop</doc:ref> should now be called.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>enroll-stage-passed</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
One stage of the enrollment passed, the enrollment is still ongoing.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>enroll-retry-scan</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The user should retry scanning their finger, the enrollment is still ongoing.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>enroll-swipe-too-short</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The user's swipe was too short. The user should retry scanning their finger, the enrollment is still ongoing.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>enroll-finger-not-centered</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The user's finger was not centered on the reader. The user should retry scanning their finger, the enrollment is still ongoing.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>enroll-remove-and-retry</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The user should remove their finger from the reader and retry scanning their finger, the enrollment is still ongoing.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>enroll-data-full</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
No further prints can be enrolled on this device, <doc:ref type="method" to="Device.EnrollStop">Device.EnrollStop</doc:ref> should now be called.
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
8ebd8e |
<doc:ref type="method" to="DeleteEnrolledFingers2">Delete other prints</doc:ref> from the device first to continue
|
|
Packit Service |
8ebd8e |
(e.g. from other users). Note that old prints or prints from other operating systems may be deleted automatically
|
|
Packit Service |
8ebd8e |
to resolve this error without any notification.
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>enroll-disconnected</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
The device was disconnected during the enrollment, no other actions should be taken, and you shouldn't use the device any more.
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
<doc:item>
|
|
Packit Service |
f1aff6 |
<doc:term>enroll-unknown-error</doc:term>
|
|
Packit Service |
f1aff6 |
<doc:definition>
|
|
Packit Service |
f1aff6 |
An unknown error occurred (usually a driver problem), <doc:ref type="method" to="Device.EnrollStop">Device.EnrollStop</doc:ref> should now be called.
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
</doc:definition>
|
|
Packit Service |
f1aff6 |
</doc:item>
|
|
Packit Service |
f1aff6 |
</doc:list>
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<method name="ListEnrolledFingers">
|
|
Packit Service |
f1aff6 |
<arg type="s" name="username" direction="in">
|
|
Packit Service |
f1aff6 |
<doc:doc><doc:summary>The username for whom to list the enrolled fingerprints. See <doc:ref type="description" to="usernames">Usernames</doc:ref>.</doc:summary></doc:doc>
|
|
Packit Service |
f1aff6 |
</arg>
|
|
Packit Service |
f1aff6 |
<arg type="as" name="enrolled_fingers" direction="out">
|
|
Packit Service |
f1aff6 |
<doc:doc><doc:summary>An array of strings representing the enrolled fingerprints. See <doc:ref type="description" to="fingerprint-names">Fingerprint names</doc:ref>.</doc:summary></doc:doc>
|
|
Packit Service |
f1aff6 |
</arg>
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:description>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
List all the enrolled fingerprints for the chosen user.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
</doc:description>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:errors>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_PERMISSION_DENIED;">if the caller lacks the appropriate PolicyKit authorization</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_NO_ENROLLED_PRINTS;">if the chosen user doesn't have any fingerprints enrolled</doc:error>
|
|
Packit Service |
f1aff6 |
</doc:errors>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</method>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<method name="DeleteEnrolledFingers">
|
|
Packit Service |
f1aff6 |
<arg type="s" name="username" direction="in">
|
|
Packit Service |
f1aff6 |
<doc:doc><doc:summary>The username for whom to delete the enrolled fingerprints. See <doc:ref type="description" to="usernames">Usernames</doc:ref>.</doc:summary></doc:doc>
|
|
Packit Service |
f1aff6 |
</arg>
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:description>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
Delete all the enrolled fingerprints for the chosen user.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
8ebd8e |
This call only exists for compatibility reasons, you should instead claim the device using
|
|
Packit Service |
8ebd8e |
<doc:ref type="method" to="Device.Claim">Device.Claim</doc:ref> and then call
|
|
Packit Service |
8ebd8e |
<doc:ref type="method" to="DeleteEnrolledFingers2">DeleteEnrolledFingers2</doc:ref>.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
</doc:description>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:errors>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_PERMISSION_DENIED;">if the caller lacks the appropriate PolicyKit authorization</doc:error>
|
|
Packit Service |
f1aff6 |
</doc:errors>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</method>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<method name="DeleteEnrolledFingers2">
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:description>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
8ebd8e |
Delete all the enrolled fingerprints for the user currently claiming the device with <doc:ref type="method" to="Device.Claim">Device.Claim</doc:ref>.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
</doc:description>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:errors>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_PERMISSION_DENIED;">if the caller lacks the appropriate PolicyKit authorization</doc:error>
|
|
Packit Service |
f1aff6 |
</doc:errors>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</method>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<method name="Claim">
|
|
Packit Service |
f1aff6 |
<arg type="s" name="username" direction="in">
|
|
Packit Service |
f1aff6 |
<doc:doc><doc:summary>The username for whom to claim the device. See <doc:ref type="description" to="usernames">Usernames</doc:ref>.</doc:summary></doc:doc>
|
|
Packit Service |
f1aff6 |
</arg>
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:description>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
Claim the device for the chosen user.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
</doc:description>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:errors>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_PERMISSION_DENIED;">if the caller lacks the appropriate PolicyKit authorization</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_ALREADY_IN_USE;">if the device is already claimed</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_INTERNAL;">if the device couldn't be claimed</doc:error>
|
|
Packit Service |
f1aff6 |
</doc:errors>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</method>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<method name="Release">
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:description>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
Release a device claimed with <doc:ref type="method" to="Device.Claim">Device.Claim</doc:ref>.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
</doc:description>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:errors>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_PERMISSION_DENIED;">if the caller lacks the appropriate PolicyKit authorization</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_CLAIM_DEVICE;">if the device was not claimed</doc:error>
|
|
Packit Service |
f1aff6 |
</doc:errors>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</method>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<method name="VerifyStart">
|
|
Packit Service |
f1aff6 |
<arg type="s" name="finger_name" direction="in">
|
|
Packit Service |
f1aff6 |
<doc:doc><doc:summary>A string representing the finger to verify. See <doc:ref type="description" to="fingerprint-names">Fingerprint names</doc:ref>.</doc:summary></doc:doc>
|
|
Packit Service |
f1aff6 |
</arg>
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:description>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
Check the chosen finger against a saved fingerprint. You need to have claimed the device using
|
|
Packit Service |
f1aff6 |
<doc:ref type="method" to="Device.Claim">Device.Claim</doc:ref>. The finger selected is sent to the front-end
|
|
Packit Service |
f1aff6 |
using <doc:ref type="signal" to="Device::VerifyFingerSelected">Device::VerifyFingerSelected</doc:ref> and
|
|
Packit Service |
f1aff6 |
verification status through <doc:ref type="signal" to="Device::VerifyStatus">Device::VerifyStatus</doc:ref>.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
</doc:description>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:errors>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_PERMISSION_DENIED;">if the caller lacks the appropriate PolicyKit authorization</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_CLAIM_DEVICE;">if the device was not claimed</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_ALREADY_IN_USE;">if the device was already being used</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_NO_ENROLLED_PRINTS;">if there are no enrolled prints for the chosen user</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_INTERNAL;">if there was an internal error</doc:error>
|
|
Packit Service |
f1aff6 |
</doc:errors>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</method>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<method name="VerifyStop">
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:description>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
Stop an on-going fingerprint verification started with <doc:ref type="method" to="Device.VerifyStart">Device.VerifyStart</doc:ref>.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
</doc:description>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:errors>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_PERMISSION_DENIED;">if the caller lacks the appropriate PolicyKit authorization</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_CLAIM_DEVICE;">if the device was not claimed</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_NO_ACTION_IN_PROGRESS;">if there was no ongoing verification</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_INTERNAL;">if there was an internal error</doc:error>
|
|
Packit Service |
f1aff6 |
</doc:errors>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</method>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<signal name="VerifyFingerSelected">
|
|
Packit Service |
f1aff6 |
<arg type="s" name="finger_name">
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:summary>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
A string representing the finger select to be verified.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
</doc:summary>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</arg>
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:seealso>
|
|
Packit Service |
f1aff6 |
<doc:ref type="description" to="fingerprint-names">Fingerprint names</doc:ref>.
|
|
Packit Service |
f1aff6 |
</doc:seealso>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</signal>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<signal name="VerifyStatus">
|
|
Packit Service |
f1aff6 |
<arg type="s" name="result">
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:summary>
|
|
Packit Service |
f1aff6 |
A string representing the status of the verification.
|
|
Packit Service |
f1aff6 |
</doc:summary>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</arg>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<arg type="b" name="done">
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:summary>
|
|
Packit Service |
f1aff6 |
Whether the verification finished and can be stopped.
|
|
Packit Service |
f1aff6 |
</doc:summary>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</arg>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:seealso>
|
|
Packit Service |
f1aff6 |
<doc:ref type="description" to="verify-statuses">Verify Statuses</doc:ref> and <doc:ref type="method" to="Device.VerifyStop">Device.VerifyStop</doc:ref>.
|
|
Packit Service |
f1aff6 |
</doc:seealso>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</signal>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<method name="EnrollStart">
|
|
Packit Service |
f1aff6 |
<arg type="s" name="finger_name" direction="in">
|
|
Packit Service |
f1aff6 |
<doc:doc><doc:summary>A string representing the finger to enroll. See
|
|
Packit Service |
f1aff6 |
<doc:ref type="description" to="fingerprint-names">Fingerprint names</doc:ref>.
|
|
Packit Service |
f1aff6 |
Note that "any" is not a valid finger name for this method.</doc:summary></doc:doc>
|
|
Packit Service |
f1aff6 |
</arg>
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:description>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
8ebd8e |
Start enrollment for the selected finger. You need to have claimed the device using
|
|
Packit Service |
f1aff6 |
<doc:ref type="method" to="Device.Claim">Device.Claim</doc:ref> before calling
|
|
Packit Service |
f1aff6 |
this method. Enrollment status is sent through <doc:ref type="signal" to="Device::EnrollStatus">Device::EnrollStatus</doc:ref>.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
</doc:description>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:errors>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_PERMISSION_DENIED;">if the caller lacks the appropriate PolicyKit authorization</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_CLAIM_DEVICE;">if the device was not claimed</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_ALREADY_IN_USE;">if the device was already being used</doc:error>
|
|
Packit Service |
8ebd8e |
<doc:error name="&ERROR_INVALID_FINGERNAME;">if the finger name passed is invalid</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_INTERNAL;">if there was an internal error</doc:error>
|
|
Packit Service |
f1aff6 |
</doc:errors>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</method>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<method name="EnrollStop">
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:description>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
Stop an on-going fingerprint enrollment started with <doc:ref type="method" to="Device.EnrollStart">Device.EnrollStart</doc:ref>.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
</doc:description>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:errors>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_PERMISSION_DENIED;">if the caller lacks the appropriate PolicyKit authorization</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_CLAIM_DEVICE;">if the device was not claimed</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_NO_ACTION_IN_PROGRESS;">if there was no ongoing verification</doc:error>
|
|
Packit Service |
f1aff6 |
<doc:error name="&ERROR_INTERNAL;">if there was an internal error</doc:error>
|
|
Packit Service |
f1aff6 |
</doc:errors>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</method>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<signal name="EnrollStatus">
|
|
Packit Service |
f1aff6 |
<arg type="s" name="result">
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:summary>
|
|
Packit Service |
f1aff6 |
A string representing the status of the enrollment.
|
|
Packit Service |
f1aff6 |
</doc:summary>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</arg>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<arg type="b" name="done">
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:summary>
|
|
Packit Service |
f1aff6 |
Whether the enrollment finished and can be stopped.
|
|
Packit Service |
f1aff6 |
</doc:summary>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</arg>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:seealso>
|
|
Packit Service |
f1aff6 |
<doc:ref type="description" to="enroll-statuses">Enrollment Statuses</doc:ref> and <doc:ref type="method" to="Device.EnrollStop">Device.EnrollStop</doc:ref>.
|
|
Packit Service |
f1aff6 |
</doc:seealso>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</signal>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<property name="name" type="s" access="read">
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:description>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
The product name of the device.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
</doc:description>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</property>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<property name="num-enroll-stages" type="i" access="read">
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:description>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
The number of enrollment stages for the device. This is only available when the device has been claimed, otherwise it will be undefined (-1).
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
<doc:seealso>
|
|
Packit Service |
f1aff6 |
<doc:ref type="method" to="Device.Claim">Device.Claim</doc:ref> and <doc:ref type="method" to="Device.EnrollStart">Device.EnrollStart</doc:ref>.
|
|
Packit Service |
f1aff6 |
</doc:seealso>
|
|
Packit Service |
f1aff6 |
</doc:description>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</property>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
<property name="scan-type" type="s" access="read">
|
|
Packit Service |
f1aff6 |
<doc:doc>
|
|
Packit Service |
f1aff6 |
<doc:description>
|
|
Packit Service |
f1aff6 |
<doc:para>
|
|
Packit Service |
f1aff6 |
The scan type of the device, either "press" if you place your finger on the device, or "swipe" if you have to swipe your finger.
|
|
Packit Service |
f1aff6 |
</doc:para>
|
|
Packit Service |
f1aff6 |
</doc:description>
|
|
Packit Service |
f1aff6 |
</doc:doc>
|
|
Packit Service |
f1aff6 |
</property>
|
|
Packit Service |
f1aff6 |
|
|
Packit Service |
f1aff6 |
</interface>
|
|
Packit Service |
f1aff6 |
</node>
|
|
Packit Service |
f1aff6 |
|