Find a file
Marco Trevisan (Treviño) fbd56d6662 pam_fprintd: Support disabling the module timeout
This can be handled by the module loader (i.e. GDM) and in any case we
may want to have setups where fprintd is always active waiting for a
fingerprint, as modern devices support this with no problems.
2022-02-24 16:11:13 +00:00
data pam_fprintd: Support disabling the module timeout 2022-02-24 16:11:13 +00:00
doc remove pointless copying of files into build directory 2022-01-11 21:27:30 -05:00
pam pam_fprintd: Support disabling the module timeout 2022-02-24 16:11:13 +00:00
po Translated using Weblate (Portuguese (Brazil)) 2022-02-16 01:16:50 +01:00
scripts
src remove pointless copying of files into build directory 2022-01-11 21:27:30 -05:00
tests tests: Use dbusmock start_system_bus instead of GLib server 2021-09-15 15:06:06 +00:00
utils
.git-blame-ignore-revs
.gitignore
.gitlab-ci.yml ci: Reference image directly for forks 2021-09-15 17:20:14 +02:00
AUTHORS
code-of-conduct.md
config.h.in
COPYING
meson.build Release 1.94.1 2021-11-03 15:34:26 +01:00
meson_options.txt
NEWS Release 1.94.1 2021-11-03 15:34:26 +01:00
README Switch to the Fedora weblate instance for translations 2021-07-01 13:11:20 +02:00
TODO

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.

Translating
===========

fprintd and pam_fprintd are translated using weblate. Please visit
https://translate.fedoraproject.org/projects/fprintd/ to contribute
translations.

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