'\" t
.\"     Title: goid-tool
.\"    Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 03/10/2024
.\"    Manual: OpenSC Tools
.\"    Source: opensc
.\"  Language: English
.\"
.TH "GOID\-TOOL" "1" "03/10/2024" "opensc" "OpenSC Tools"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
goid-tool \- smart card utility for GoID fingerprint card
.SH "SYNOPSIS"
.HP \w'\fBgoid\-tool\fR\ 'u
\fBgoid\-tool\fR [\fIOPTIONS\fR] [\fImode\fR]
.SH "DESCRIPTION"
.PP
The
\fBgoid\-tool\fR
utility can be used from the command line to read and write data of the
\m[blue]\fBGoID fingerprint card\fR\m[]\&\s-2\u[1]\d\s+2\&.
.SH "OPTIONS"
.PP
.PP
\fB\-\-help\fR, \fB\-h\fR
.RS 4
Print help message on screen\&.
.RE
.PP
\fB\-\-version\fR, \fB\-V\fR
.RS 4
Print the OpenSC package release version\&.
.RE
.PP
\fB\-\-reader\fR \fIstring\fR, \fB\-r\fR \fIstring\fR
.RS 4
Specify the number of the reader to use\&. By default, the first reader with present card is used\&. If the argument is an ATR, the reader with a matching card will be chosen\&.
.RE
.PP
\fB\-\-verbose\fR, \fB\-v\fR
.RS 4
Cause
\fBgoid\-tool\fR
to be more verbose\&. Use it multiple times to be even more verbose\&.
.RE
.PP
\fB\-\-verify\-pin\fR, \fB\-p\fR
.RS 4
Verify PIN\&.
.RE
.PP
\fB\-\-verify\-bio\fR, \fB\-b\fR
.RS 4
Verify finger print\&.
.RE
.PP
\fB\-\-verify\-pin\-or\-bio\fR
.RS 4
Verify PIN or finger print (user\*(Aqs choice)\&.
.RE
.SH "OPTIONS FOR SOCMANAGER APPLET"
.PP
.PP
\fB\-\-new\-pin\fR
.RS 4
Change PIN
.RE
.PP
\fB\-\-new\-bio\fR
.RS 4
Use (several times) to change one or more biometric templates
.RE
.PP
\fB\-\-info\fR
.RS 4
Dump Information about the SoCManager\*(Aqs configuration
.RE
.SH "OPTIONS FOR PACCESS APPLET"
.PP
.PP
\fB\-\-certificate\fR \fIfilename\fR, \fB\-c\fR \fIfilename\fR
.RS 4
Use (several times) to pass CV certificates
.RE
.PP
\fB\-\-key\fR, \fB\-k\fR,
.RS 4
Private key for the CV certificate
.RE
.PP
\fB\-\-print\-cardid\fR
.RS 4
Print the card ID
.RE
.PP
\fB\-\-write\-cardid\fR \fIdata\fR
.RS 4
Write the specified card ID
.RE
.PP
\fB\-\-print\-paccessid\fR
.RS 4
Print the PAccess ID
.RE
.PP
\fB\-\-write\-paccessid\fR \fIdata\fR
.RS 4
Write the specified PAccess ID
.RE
.PP
\fB\-\-read\-dg\fR \fIid\fR
.RS 4
Read the specified data group; use several times to read out multiple files
.RE
.PP
\fB\-\-out\-file\fR \fIfilename\fR
.RS 4
Write output to a file instead of printing it; use once for each use of
\fB\-\-read\-dg\fR
.RE
.PP
\fB\-\-write\-dg\fR \fIid\fR
.RS 4
Write the specified data group; use several times to write multiple files
.RE
.PP
\fB\-\-in\-file\fR \fIfilename\fR
.RS 4
Read input from a file; use once for each use of
\fB\-\-write\-dg\fR
.RE
.PP
\fB\-\-delete\-dg\fR \fIid\fR
.RS 4
Delete the specified data group; use several times to delete multiple files
.RE
.PP
\fB\-\-create\-dg\fR \fIid\fR
.RS 4
Create the specified data group; use several times to create multiple files
.RE
.PP
\fB\-\-new\-size\fR \fIsize\fR
.RS 4
File size of newly created DGs
.RE
.PP
\fB\-\-new\-read\-ac\fR \fIcondition\fR
.RS 4
Access condition for reading newly created DGs
.RE
.PP
\fB\-\-new\-read\-ac\fR \fIcondition\fR
.RS 4
Access condition for reading newly created DGs
.RE
.PP
\fB\-\-new\-read\-ac\-chatbit\fR \fIindex\fR
.RS 4
Required access bit in certificate\*(Aqs CHAT for reading newly created DGs
.RE
.PP
\fB\-\-new\-write\-ac\fR \fIcondition\fR
.RS 4
Access condition for writing newly created DGs
.RE
.PP
\fB\-\-new\-write\-ac\-chatbit\fR \fIindex\fR
.RS 4
Required access bit in certificate\*(Aqs CHAT for writing newly created DGs
.RE
.SH "SEE ALSO"
.PP
\fBopensc.conf\fR(5)
.SH "AUTHORS"
.PP
\fBgoid\-tool\fR
was written by Frank Morgner
<frankmorgner@gmail\&.com>\&.
.SH "NOTES"
.IP " 1." 4
GoID fingerprint card
.RS 4
\%https://github.com/OpenSC/OpenSC/wiki/GoID-fingerprint-card
.RE