source: general/genutils/pinentry.xml@ f7a91626

11.0 11.1 11.2 lazarus plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since f7a91626 was f7a91626, checked in by Bruce Dubbs <bdubbs@…>, 16 months ago

Update to pinentry-1.2.0.

  • Property mode set to 100644
File size: 8.9 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 "&gnupg-http;/pinentry/pinentry-&pinentry-version;.tar.bz2">
8 <!ENTITY pinentry-download-ftp "&gnupg-ftp;/pinentry/pinentry-&pinentry-version;.tar.bz2">
9 <!ENTITY pinentry-download-ftp " ">
10 <!ENTITY pinentry-md5sum "32e09a982711d6e705f9d89020424c2d">
11 <!ENTITY pinentry-size "488 KB">
12 <!ENTITY pinentry-buildsize "6.3 MB">
13 <!ENTITY pinentry-time "less than 0.1 SBU">
14]>
15
16<sect1 id="pinentry" xreflabel="pinentry-&pinentry-version;">
17 <?dbhtml filename="pinentry.html"?>
18
19 <sect1info>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>pinentry-&pinentry-version;</title>
24
25 <indexterm zone="pinentry">
26 <primary sortas="a-PIN-Entry">PIN-Entry</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to PIN-Entry</title>
31
32 <para>
33 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), and for the common
42 <application>GTK</application> and <application>Qt</application>
43 toolkits.
44 </para>
45
46 &lfs110a_checked;
47
48 <bridgehead renderas="sect3">Package Information</bridgehead>
49 <itemizedlist spacing="compact">
50 <listitem>
51 <para>
52 Download (HTTP): <ulink url="&pinentry-download-http;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download (FTP): <ulink url="&pinentry-download-ftp;"/>
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download MD5 sum: &pinentry-md5sum;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Download size: &pinentry-size;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated disk space required: &pinentry-buildsize;
73 </para>
74 </listitem>
75 <listitem>
76 <para>
77 Estimated build time: &pinentry-time;
78 </para>
79 </listitem>
80 </itemizedlist>
81
82 <bridgehead renderas="sect3">PIN-Entry Dependencies</bridgehead>
83
84 <bridgehead renderas="sect4">Required</bridgehead>
85 <para role="required">
86 <xref linkend="libassuan"/> and
87 <xref linkend="libgpg-error"/>
88 </para>
89
90 <bridgehead renderas="sect4">Optional</bridgehead>
91 <para role="optional">
92 <xref linkend="emacs"/>,
93 <xref linkend="fltk"/>,
94 <xref linkend="gcr"/>,
95 <xref linkend="gtk2"/>,
96 <!-- <xref linkend="libcap-pam"/>, This is in LFS already. PAM is not
97 necessary. -->
98 <xref linkend="libsecret"/>,
99 <xref linkend="qt5"/>, and
100 <ulink url="https://www.enlightenment.org/about-efl">efl</ulink>
101 </para>
102
103 <para condition="html" role="usernotes">User Notes:
104 <ulink url="&blfs-wiki;/pinentry"/></para>
105
106 </sect2>
107
108 <sect2 role="installation">
109 <title>Installation of PIN-Entry</title>
110
111 <para>
112 Install <application>PIN-Entry</application> by running the following
113 commands:
114 </para>
115
116<screen><userinput>./configure --prefix=/usr --enable-pinentry-tty &amp;&amp;
117make</userinput></screen>
118
119 <para>
120 This package does not come with a test suite.
121 </para>
122
123 <para>
124 Now, as the <systemitem class="username">root</systemitem> user:
125 </para>
126
127<screen role="root"><userinput>make install</userinput></screen>
128
129 </sect2>
130
131 <sect2 role="commands">
132 <title>Command Explanations</title>
133
134 <para>
135 <option>--enable-inside-emacs=yes/no</option>: Default is no.
136 </para>
137
138 <para>
139 <option>--enable-pinentry-qt=yes/no</option>: Default is yes.
140 </para>
141
142 <para>
143 <option>--enable-pinentry-gtk2=yes/no</option>: Default is yes. Even if
144 other <command>pinentry-*</command> is installed,
145 <command>pinentry</command> will be a symlink to
146 <command>pinentry-gtk-2</command>.
147 </para>
148
149 <para>
150 <option>--enable-pinentry-gnome3=yes/no</option>: Default is yes.
151 Actually, it uses <application>Gcr</application> for the pinentry
152 dialog.
153 </para>
154
155 <para>
156 <parameter>--enable-pinentry-tty</parameter>: Default is 'maybe'.
157 </para>
158
159 </sect2>
160
161 <sect2 role="content">
162 <title>Contents</title>
163
164 <segmentedlist>
165 <segtitle>Installed Programs</segtitle>
166 <segtitle>Installed Libraries</segtitle>
167 <segtitle>Installed Directory</segtitle>
168
169 <seglistitem>
170 <seg>
171 pinentry (symlink), pinentry-curses, pinentry-emacs, pinentry-fltk,
172 pinentry-gnome3, pinentry-gtk-2, pinentry-qt, and pinentry-tty
173 </seg>
174 <seg>None</seg>
175 <seg>None</seg>
176 </seglistitem>
177 </segmentedlist>
178
179 <variablelist>
180 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
181 <?dbfo list-presentation="list"?>
182 <?dbhtml list-presentation="table"?>
183
184 <varlistentry id="pinentry-prog">
185 <term><command>pinentry</command></term>
186 <listitem>
187 <para>
188 is a symbolic link to the default
189 <application>PIN-Entry</application> program
190 </para>
191 <indexterm zone="pinentry pinentry-prog">
192 <primary sortas="b-pinentry">pinentry</primary>
193 </indexterm>
194 </listitem>
195 </varlistentry>
196
197 <varlistentry id="pinentry-curses">
198 <term><command>pinentry-curses</command></term>
199 <listitem>
200 <para>
201 is an <application>Ncurses</application> text-based
202 <application>PIN-Entry</application> helper program
203 </para>
204 <indexterm zone="pinentry pinentry-curses">
205 <primary sortas="b-pinentry-curses">pinentry-curses</primary>
206 </indexterm>
207 </listitem>
208 </varlistentry>
209
210 <varlistentry id="pinentry-emacs">
211 <term><command>pinentry-emacs</command></term>
212 <listitem>
213 <para>
214 is an <application>Emacs</application> version of the
215 <application>PIN-Entry</application> helper program
216 </para>
217 <indexterm zone="pinentry pinentry-emacs">
218 <primary sortas="b-pinentry-emacs">pinentry-emacs</primary>
219 </indexterm>
220 </listitem>
221 </varlistentry>
222
223 <varlistentry id="pinentry-fltk">
224 <term><command>pinentry-fltk</command></term>
225 <listitem>
226 <para>
227 is a <application>FLTK</application>
228 <application>PIN-Entry</application> helper program
229 </para>
230 <indexterm zone="pinentry pinentry-fltk">
231 <primary sortas="b-pinentry-fltk">pinentry-fltk</primary>
232 </indexterm>
233 </listitem>
234 </varlistentry>
235
236 <varlistentry id="pinentry-gnome3">
237 <term><command>pinentry-gnome3</command></term>
238 <listitem>
239 <para>
240 is a <application>GNOME-3</application>
241 <application>PIN-Entry</application> helper program
242 </para>
243 <indexterm zone="pinentry pinentry-gnome3">
244 <primary sortas="b-pinentry-gnome3">pinentry-gnome3</primary>
245 </indexterm>
246 </listitem>
247 </varlistentry>
248
249 <varlistentry id="pinentry-gtk-2">
250 <term><command>pinentry-gtk-2</command></term>
251 <listitem>
252 <para>
253 is a <application>GTK+2</application>
254 <application>PIN-Entry</application> program program
255 </para>
256 <indexterm zone="pinentry pinentry-gtk-2">
257 <primary sortas="b-pinentry-gtk-2">pinentry-gtk-2</primary>
258 </indexterm>
259 </listitem>
260 </varlistentry>
261
262 <varlistentry id="pinentry-qt">
263 <term><command>pinentry-qt</command></term>
264 <listitem>
265 <para>
266 is a <application>Qt4 or 5</application>
267 <application>PIN-Entry</application> helper program
268 </para>
269 <indexterm zone="pinentry pinentry-qt">
270 <primary sortas="b-pinentry-qt">pinentry-qt</primary>
271 </indexterm>
272 </listitem>
273 </varlistentry>
274
275 <varlistentry id="pinentry-tty">
276 <term><command>pinentry-tty</command></term>
277 <listitem>
278 <para>
279 is a <application>tty</application>
280 <application>PIN-Entry</application> helper program
281 </para>
282 <indexterm zone="pinentry pinentry-tty">
283 <primary sortas="b-pinentry-tty">pinentry-tty</primary>
284 </indexterm>
285 </listitem>
286 </varlistentry>
287
288 </variablelist>
289
290 </sect2>
291
292</sect1>
Note: See TracBrowser for help on using the repository browser.