Find a file
Benjamin Berg 59d2fbdabd Revert "device: Delete existing print in EnrollStart"
This reverts commit 5c06660215a1d1482a143bcf68029c2838608fa8.

Instead we will throw an error. The reason to not push this into an
earlier release was that this is an API incompatible change and clients
will need to be updated.
2021-07-01 13:10:41 +02:00
.tx Update Transifex configuration 2015-02-09 18:11:10 +01:00
data data: Restrict syscall usage of fprintd 2021-06-29 21:10:59 +02:00
doc build: Add some linefeeds to generated XML files 2020-08-17 15:21:27 +02:00
pam Revert "pam_fprintd: Just return a PAM_AUTH_ERROR on unknown errors" 2021-07-01 12:59:11 +02:00
po Update .po files and add .pot into git 2021-07-01 12:59:11 +02:00
scripts scripts: Add uncrustify scripts for reformatting fprintd source code 2020-12-07 18:41:45 +01:00
src Revert "device: Delete existing print in EnrollStart" 2021-07-01 13:10:41 +02:00
tests Revert "device: Delete existing print in EnrollStart" 2021-07-01 13:10:41 +02:00
utils utils/delete: Add ability to delete single user fingerprints by finger name 2021-03-03 19:51:07 +01:00
.git-blame-ignore-revs .git-blame-ignore-revs: Ignore formatting commit and add hint how to use it 2020-12-07 18:42:22 +01:00
.gitignore build: Remove autotools support 2020-02-05 16:54:54 +01:00
.gitlab-ci.yml ci: Allow failing stable build 2021-04-19 15:59:34 +00:00
AUTHORS Add myself to the authors 2008-11-02 11:16:13 +00:00
code-of-conduct.md Add code of conduct document 2019-07-25 12:07:27 +02:00
config.h.in device: Re-define polkit auto-pointer funcs if not defined 2020-11-27 18:21:29 +01:00
COPYING Fix warnings during docs build 2008-12-10 00:54:27 +00:00
meson.build Update for 1.92.0 2021-07-01 13:06:08 +02:00
meson_options.txt build: make systemd dependency optional 2020-12-11 15:01:24 +01:00
NEWS Update for 1.92.0 2021-07-01 13:06:08 +02:00
README README: Add note on how to enable debugging 2021-04-19 16:17:43 +00:00
README.transifex build: Add script to update translations 2020-02-05 15:25:35 +01:00
TODO TODO: Remove image transfer support 2018-05-31 17:28:19 +02:00
update-transifex.sh build: Add script to update translations 2020-02-05 15:25:35 +01:00

fprintd
=======

https://fprint.freedesktop.org/

Daemon to offer libfprint functionality over D-Bus
Might eat your kangaroo.

Written in C.

Licensed under the GPL version 2 or any later version (see COPYING).

A PAM login module is included in the 'pam' directory.

API use cases
=============

- User wants to use the fingerprint reader, and enroll
  his fingerprints, or remove some fingerprints from the database

- Administrator wants to enroll fingerprints for a particular user,
  or remove fingerprints for a particular user

- Laptop/desktop authentication:
  * Check for fingerprint devices
  * Check whether a particular user has any fingerprints enrolled
  * Verify a fingerprint for a particular user, or, if the device
  supports it, verify that the fingerprint matches against
  any of the fingerprints enrolled

- Point Of Sale authentication (in a bar, the fingerprint reader is
  used to see who accesses a particular point of sale/till, in place
  of PIN code authentication and/or tokens)
  * Given a list of users, verify which one has scanned their finger

Debugging
=========

To enable debug output run `systemctl edit fprintd.service` then enter:
```
[Service]
Environment=G_MESSAGES_DEBUG=all
```
Save the result and restart fprintd using `systemctl restart fprintd.service`.

After that, you can grab the logs using `journalctl -u fprintd.service`.