[Thinkfinger-devel] [Fingerforce-devel] Bug#464963:

[Luca Capello]

Hi Andy!

For the ThinkFinger mailing list: a small documentation bug from Debian.

The reason for my post was that the --add-user and --verify-user
options do not work with the version of tf-tool in the package. The
man page says that these are available "only when ThinkFinger has been
compiled with PAM support."

Ah, now I understand: it seems that after Christian Neumair's patchset
about $HOME/.thinkfinger.bir support was applied [1], upstream (and me
also) forgot to update the documentation about the new tf-tool behavior.

Christian provided a patch for the README file [2], but nothing is done
for the manpage yet. I'll work on this in the next days.

Thx, bye,
Gismo / Luca

Footnotes:
[1] http://thread.gmane.org/gmane.linux.drivers.thinkfinger/424/focus=491
[2] http://thread.gmane.org/gmane.linux.drivers.thinkfinger/424/focus=518

[Luca Capello]

tags 464963 + patch
tags 464963 + pending
thanks

Hi Andrew!

Post by Luca Capello
Ah, now I understand: it seems that after Christian Neumair's patchset
about $HOME/.thinkfinger.bir support was applied [1], upstream (and me
also) forgot to update the documentation about the new tf-tool behavior.
Christian provided a patch for the README file [2], but nothing is done
for the manpage yet. I'll work on this in the next days.

Attached.

Thx, bye,
Gismo / Luca

--8<---------------cut here---------------start------------->8---
--- thinkfinger.orig/docs/tf-tool.1
+++ thinkfinger/docs/tf-tool.1
@@ -2,14 +2,14 @@
.\" Copyright (C) 2007 Luca Capello <***@pca.it>
.\"

-.TH THINKFINGER 1 "Feb 1, 2007"
+.TH THINKFINGER 1 "Mar 6, 2008"

.SH NAME
tf-tool \- Utility to acquire and to verify fingerprints

.SH SYNOPSIS
.B tf-tool
-.RI [ OPTION ]
+command [options]

.SH DESCRIPTION
ThinkFinger is a driver for the UPEK/SGS Thomson Microelectronics
@@ -20,45 +20,35 @@
.B tf-tool
is the utility used to acquire and to verify the fingerprints.

-.SH OPTIONS
+.SH COMMANDS
.TP
.BI \--acquire
Acquire a fingerprint. You will be prompted to swipe your finger. It
needs three successful swipes to get a fingerprint. This fingerprint
-is stored in \fI/tmp/test.bir\fP.
+is stored in \fI~/.thinkfinger.bir\fP.
.TP
.BI \--verify
Verify a fingerprint. \fBtf-tool\fP will read a fingerprint image
-from \fI/tmp/test.bir\fP and compare that with the finger which is being
-swiped.
-.TP
-.BI \--add-user\ "login"
-Acquire a fingerprint for the user identified by login. If this user
-or the bir folder \fI/etc/pam_thinkfinger\fP do not exist, \fBtf-tool\fP
-exits with an error. If the acquiring process is successful, the fingerprint
-is stored in the bir folder as \fI/etc/pam_thinkfinger/login.bir\fP.
-This option is available only when ThinkFinger has been compiled with
-PAM support.
-.TP
-.BI \--verify-user\ "login"
-Verify a fingerprint for the user identified by login. If this user
-or the bir folder \fI/etc/pam_thinkfinger\fP do not exist, \fBtf-tool\fP exits
-with an error.
-This option is available only when ThinkFinger has been compiled with
-PAM support.
+from \fI~/.thinkfinger.bir\fP and compare that with the finger which
+is being swiped.
+
+.SH OPTIONS
.TP
.BI \--verbose
Add more output messages.
+.TP
+.BI bir_file
+The location where to store the fingerprint, default to
+\fI~/.thinkfinger.bir\fP.

.SH FILES
.PD 0
.TP
-.I /etc/pam_thinkfinger
-The default folder where the fingerprint for login users are stored
+.I ~/.thinkfinger.bir
+The default location where the fingerprint is stored
.TP
-.I /tmp/tmp.bir
-The file used when acquiring or verifying a fingerprint
-.PD
+.I /etc/pam_thinkfinger
+The system-wide folder where the fingerprints for login users are stored

.SH BUGS
Please report bugs to <thinkfinger-***@lists.sourceforge.net>.
--8<---------------cut here---------------end--------------->8---