source: general/genutils/pinentry.xml@ 8aeb474

10.0 10.1 11.0 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk upgradedb xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 8aeb474 was 8aeb474, checked in by Bruce Dubbs <bdubbs@…>, 9 years ago

General cleanup. Mostly removing obsolete comments.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10680 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.8 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY pinentry-download-http " ">
8 <!ENTITY pinentry-download-ftp "ftp://ftp.gnupg.org/gcrypt/pinentry/pinentry-&pinentry-version;.tar.bz2">
9 <!ENTITY pinentry-md5sum "82e6114e5e27a8ab36f314b332a6e024">
10 <!ENTITY pinentry-size "424 KB">
11 <!ENTITY pinentry-buildsize "4.7 MB">
12 <!ENTITY pinentry-time "less than 0.1 SBU">
13]>
14
15<sect1 id="pinentry" xreflabel="PIN-Entry-&pinentry-version;">
16 <?dbhtml filename="pinentry.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>PIN-Entry-&pinentry-version;</title>
24
25 <indexterm zone="pinentry">
26 <primary sortas="a-PIN-Entry">PIN-Entry</primary>
27 </indexterm>
28
29 <!--Required section-->
30 <sect2 role="package">
31 <title>Introduction to PIN-Entry</title>
32
33 <para>The <application>PIN-Entry</application> package contains a
34 collection of simple PIN or pass-phrase entry dialogs which utilize the
35 Assuan protocol as described by the
36 <ulink url="http://www.gnupg.org/aegypten/">&#xC4;gypten project</ulink>.
37 <application>PIN-Entry</application> programs are usually invoked by
38 the <command>gpg-agent</command> daemon, but can be run from the command
39 line as well. There are programs for various text-based and GUI
40 environments, including interfaces designed for
41 <application>Ncurses</application> (text-based),
42 <application>Gtk+</application>, <application>Gtk+-2</application>,
43 and <application>Qt-3</application>.</para>
44
45 &lfs72_checked;
46
47 <bridgehead renderas="sect3">Package Information</bridgehead>
48 <itemizedlist spacing="compact">
49 <listitem>
50 <para>Download (HTTP): <ulink url="&pinentry-download-http;"/></para>
51 </listitem>
52 <listitem>
53 <para>Download (FTP): <ulink url="&pinentry-download-ftp;"/></para>
54 </listitem>
55 <listitem>
56 <para>Download MD5 sum: &pinentry-md5sum;</para>
57 </listitem>
58 <listitem>
59 <para>Download size: &pinentry-size;</para>
60 </listitem>
61 <listitem>
62 <para>Estimated disk space required: &pinentry-buildsize;</para>
63 </listitem>
64 <listitem>
65 <para>Estimated build time: &pinentry-time;</para>
66 </listitem>
67 </itemizedlist>
68
69 <!-- <bridgehead renderas="sect3">Additional Downloads</bridgehead>
70 <itemizedlist spacing="compact">
71 <listitem>
72 <para>Required patch: <ulink
73 url="&patch-root;/pinentry-&pinentry-version;-fixes-1.patch"/></para>
74 </listitem>
75 </itemizedlist> -->
76
77 <bridgehead renderas="sect3">PIN-Entry Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Optional</bridgehead>
80 <para role="optional"><!-- <xref linkend="GTK"/>, -->
81 <xref linkend="gtk2"/>,
82 <xref linkend="qt"/>, and
83 <xref linkend="libcap2"/></para>
84
85 <para condition="html" role="usernotes">User Notes:
86 <ulink url="&blfs-wiki;/pinentry"/></para>
87
88 </sect2>
89
90 <sect2 role="installation">
91 <title>Installation of PIN-Entry</title>
92
93 <para>Install <application>PIN-Entry</application> by running the following
94 commands:</para>
95
96<screen><userinput>./configure --prefix=/usr \
97 --disable-pinentry-gtk \
98 --disable-pinentry-gtk2 \
99 --disable-pinentry-qt &amp;&amp;
100make &amp;&amp;
101
102makeinfo --html --no-split -o doc/pinentry_nochunks.html doc/pinentry.texi &amp;&amp;
103makeinfo --plaintext -o doc/pinentry.txt doc/pinentry.texi</userinput></screen>
104
105 <para>If you wish to build alternate formats of the documentation, you
106 must have <xref linkend="texlive"/> installed,
107 then issue the following command:</para>
108
109<screen><userinput>make -k -C doc pdf ps html</userinput></screen>
110
111 <para>This package does not come with a test suite.</para>
112
113 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
114
115<screen role="root"><userinput>make install &amp;&amp;
116
117install -v -m755 -d /usr/share/doc/pinentry-&pinentry-version;/html &amp;&amp;
118install -v -m644 README doc/pinentry{_*.html,.txt,.texi} \
119 /usr/share/doc/pinentry-&pinentry-version;</userinput></screen>
120
121 <para>If you built the additional documentation, install it by issuing the
122 following commands as the <systemitem class="username">root</systemitem>
123 user:</para>
124
125<screen role="root"><userinput>install -v -m644 doc/pinentry.html/* \
126 /usr/share/doc/pinentry-&pinentry-version;/html &amp;&amp;
127install -v -m644 doc/pinentry.{pdf,ps,dvi} \
128 /usr/share/doc/pinentry-&pinentry-version;</userinput></screen>
129
130 </sect2>
131
132 <sect2 role="commands">
133 <title>Command Explanations</title>
134
135 <para><parameter>--disable-...</parameter>: These three parameters are used
136 to fix a problem with the <command>configure</command> script if the
137 optional dependencies are not installed. If the dependencies are installed,
138 these parameters may be omitted.</para>
139
140 </sect2>
141
142 <sect2 role="content">
143 <title>Contents</title>
144
145 <segmentedlist>
146 <segtitle>Installed Programs</segtitle>
147 <segtitle>Installed Libraries</segtitle>
148 <segtitle>Installed Directory</segtitle>
149
150 <seglistitem>
151 <seg>pinentry, pinentry-curses, pinentry-gtk, pinentry-gtk-2,
152 and pinentry-qt</seg>
153 <seg>None</seg>
154 <seg>/usr/share/doc/pinentry-&pinentry-version;</seg>
155 </seglistitem>
156 </segmentedlist>
157
158 <variablelist>
159 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
160 <?dbfo list-presentation="list"?>
161 <?dbhtml list-presentation="table"?>
162
163 <varlistentry id="pinentry-prog">
164 <term><command>pinentry</command></term>
165 <listitem>
166 <para>is a symbolic link to the default
167 <application>PIN-Entry</application> program.</para>
168 <indexterm zone="pinentry pinentry-prog">
169 <primary sortas="b-pinentry">pinentry</primary>
170 </indexterm>
171 </listitem>
172 </varlistentry>
173
174 <varlistentry id="pinentry-curses">
175 <term><command>pinentry-curses</command></term>
176 <listitem>
177 <para> is an <application>Ncurses</application> text-based
178 <application>PIN-Entry</application> program.</para>
179 <indexterm zone="pinentry pinentry-curses">
180 <primary sortas="b-pinentry-curses">pinentry-curses</primary>
181 </indexterm>
182 </listitem>
183 </varlistentry>
184
185 <varlistentry id="pinentry-gtk">
186 <term><command>pinentry-gtk</command></term>
187 <listitem>
188 <para> is a <application>Gtk</application> GUI
189 <application>PIN-Entry</application> program.</para>
190 <indexterm zone="pinentry pinentry-gtk">
191 <primary sortas="b-pinentry-gtk">pinentry-gtk</primary>
192 </indexterm>
193 </listitem>
194 </varlistentry>
195
196 <varlistentry id="pinentry-gtk-2">
197 <term><command>pinentry-gtk-2</command></term>
198 <listitem>
199 <para> is a <application>Gtk-2</application> GUI
200 <application>PIN-Entry</application> program.</para>
201 <indexterm zone="pinentry pinentry-gtk-2">
202 <primary sortas="b-pinentry-gtk-2">pinentry-gtk-2</primary>
203 </indexterm>
204 </listitem>
205 </varlistentry>
206
207 <varlistentry id="pinentry-qt">
208 <term><command>pinentry-qt</command></term>
209 <listitem>
210 <para> is a <application>Qt</application> GUI
211 <application>PIN-Entry</application> program.</para>
212 <indexterm zone="pinentry pinentry-qt">
213 <primary sortas="b-pinentry-qt">pinentry-qt</primary>
214 </indexterm>
215 </listitem>
216 </varlistentry>
217
218 </variablelist>
219
220 </sect2>
221
222</sect1>
Note: See TracBrowser for help on using the repository browser.