From bdc840a52005a11ccb6e75e54d28cee7f2f7cad4 Mon Sep 17 00:00:00 2001
From: Jakub Jelen <jjelen@redhat.com>
Date: Wed, 27 Apr 2016 17:12:15 +0200
Subject: [PATCH] Manual page for gids-tool

Related to https://github.com/OpenSC/OpenSC/pull/651
---
 doc/tools/gids-tool.1.xml | 117 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 117 insertions(+)
 create mode 100644 doc/tools/gids-tool.1.xml

diff --git a/doc/tools/gids-tool.1.xml b/doc/tools/gids-tool.1.xml
new file mode 100644
index 00000000..33d89898
--- /dev/null
+++ b/doc/tools/gids-tool.1.xml
@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<refentry id="gids-tool">
+	<refmeta>
+		<refentrytitle>gids-tool</refentrytitle>
+		<manvolnum>1</manvolnum>
+		<refmiscinfo class="productname">OpenSC</refmiscinfo>
+		<refmiscinfo class="manual">OpenSC Tools</refmiscinfo>
+		<refmiscinfo class="source">opensc</refmiscinfo>
+	</refmeta>
+
+	<refnamediv>
+		<refname>gids-tool</refname>
+		<refpurpose>smart card utility for GIDS cards</refpurpose>
+	</refnamediv>
+
+	<refsynopsisdiv>
+		<cmdsynopsis>
+			<command>gids-tool</command>
+			<arg choice="opt"><replaceable class="option">OPTIONS</replaceable></arg>
+		</cmdsynopsis>
+	</refsynopsisdiv>
+
+	<refsect1>
+		<para>
+			The <command>gids-tool</command> utility can be used from the command line to perform
+			miscellaneous smart card operations on a GIDS smart card.
+		</para>
+	</refsect1>
+
+	<refsect1>
+		<title>Options</title>
+		<para>
+			<variablelist>
+				<varlistentry>
+					<term>
+						<option>-X</option>,
+						<option>--initialize</option>
+					</term>
+					<listitem><para>Initialize token.</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--admin-key</option> <replaceable>argument</replaceable>
+					</term>
+					<listitem><para>Define the administrator key</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--pin</option> <replaceable>argument</replaceable>
+					</term>
+					<listitem><para>Define user PIN.</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--serial-number</option> <replaceable>argument</replaceable>
+					</term>
+					<listitem><para>Define serial number.</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>-U</option>,
+						<option>--unblock</option>
+					</term>
+					<listitem><para>Unblock the user PIN after an administrator
+					authentication.</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>-C</option>,
+						<option>--change-admin-key</option>
+					</term>
+					<listitem><para>Change the administrator key.</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--new-admin-key</option> <replaceable>argument</replaceable>
+					</term>
+					<listitem><para>Define the new adminastrator key.</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>--reader</option> <replaceable>argument</replaceable>,
+						<option>-r</option> <replaceable>argument</replaceable>
+					</term>
+					<listitem><para>Uses reader number
+					<replaceable>argument</replaceable>.</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>-w</option>,
+						<option>--wait</option>
+					</term>
+					<listitem><para>Wait for a card to be inserted.</para></listitem>
+				</varlistentry>
+				<varlistentry>
+					<term>
+						<option>-v</option>,
+						<option>--verbose</option>
+					</term>
+					<listitem><para>Verbose operation. Use several times to
+					enable debug output.</para></listitem>
+				</varlistentry>
+			</variablelist>
+		</para>
+	</refsect1>
+
+	<refsect1>
+		<title>See also</title>
+		<para>
+			<citerefentry>
+				<refentrytitle>opensc-tool</refentrytitle>
+				<manvolnum>1</manvolnum>
+			</citerefentry>
+		</para>
+	</refsect1>
+
+</refentry>