Find a file
Eli Schwartz f4256533d1
use more idiomatic/correct embedded shell scripting
Formatting arguments into code is fragile, and meson natively knows how
to pass files as arguments via argv. So pass them as arguments to the
shell.
2022-01-11 21:23:16 -05:00
data data: Fix udev event delivery for systemd service 2021-11-03 10:46:03 +00:00
doc use more idiomatic/correct embedded shell scripting 2022-01-11 21:23:16 -05:00
pam pam: Immediately return verify-match/verify-no-match 2021-08-02 13:00:43 +02:00
po Translated using Weblate (Indonesian) 2021-12-08 13:16:24 +01:00
scripts scripts: Add uncrustify scripts for reformatting fprintd source code 2020-12-07 18:41:45 +01:00
src device: Always report selected finger if there is only one 2021-09-15 15:00:14 +00:00
tests tests: Use dbusmock start_system_bus instead of GLib server 2021-09-15 15:06:06 +00: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: Reference image directly for forks 2021-09-15 17:20:14 +02: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 Release 1.94.1 2021-11-03 15:34:26 +01:00
meson_options.txt build: make systemd dependency optional 2020-12-11 15:01:24 +01:00
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 TODO: Remove image transfer support 2018-05-31 17:28:19 +02: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.

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