source: general/genutils/pinentry.xml@ 5c22cb01

systemd-13485
Last change on this file since 5c22cb01 was 5c22cb01, checked in by Douglas R. Reno <renodr@…>, 6 years ago

Updated lsof URL. Merged from trunk r17090
Updated PIN-Entry dependencies. Merged from trunk r17090
Updated Valgrind dependencies. Merged from trunk r17090
Added note about OpenSSL's Test Suite not supporting parallel make jobs. Merged from trunk r17090.
Restored autoconf to libva-intel-driver. Merged from trunk r17090
Updated to Sudo-1.8.16. Merged from trunk r17127
Changed the configure script in the GCC-5.3.0 page to use the new configure switch for the libstdc++ ABI.
Updated to OpenSSH-7.2p2. Merged from trunk r17106.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@17199 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 8.6 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 "9510b2de013e818dab619e468298703a">
10 <!ENTITY pinentry-size "424 KB">
11 <!ENTITY pinentry-buildsize "10 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 <sect2 role="package">
30 <title>Introduction to PIN-Entry</title>
31
32 <para>The <application>PIN-Entry</application> package contains a
33 collection of simple PIN or pass-phrase entry dialogs which utilize the
34 Assuan protocol as described by the
35 <ulink url="http://www.gnupg.org/aegypten/">&#xC4;gypten project</ulink>.
36 <application>PIN-Entry</application> programs are usually invoked by
37 the <command>gpg-agent</command> daemon, but can be run from the command
38 line as well. There are programs for various text-based and GUI
39 environments, including interfaces designed for
40 <application>Ncurses</application> (text-based), and for the common
41 <application>GTK</application> and <application>Qt</application>
42 toolkits.</para>
43
44 &lfs78_checked;
45
46 <bridgehead renderas="sect3">Package Information</bridgehead>
47 <itemizedlist spacing="compact">
48 <listitem>
49 <para>Download (HTTP): <ulink url="&pinentry-download-http;"/></para>
50 </listitem>
51 <listitem>
52 <para>Download (FTP): <ulink url="&pinentry-download-ftp;"/></para>
53 </listitem>
54 <listitem>
55 <para>Download MD5 sum: &pinentry-md5sum;</para>
56 </listitem>
57 <listitem>
58 <para>Download size: &pinentry-size;</para>
59 </listitem>
60 <listitem>
61 <para>Estimated disk space required: &pinentry-buildsize;</para>
62 </listitem>
63 <listitem>
64 <para>Estimated build time: &pinentry-time;</para>
65 </listitem>
66 </itemizedlist>
67
68 <bridgehead renderas="sect3">PIN-Entry Dependencies</bridgehead>
69
70 <bridgehead renderas="sect4">Required</bridgehead>
71 <para role="required">
72 <xref linkend="libassuan"/> and
73 <xref linkend="libgpg-error"/>
74 </para>
75
76 <bridgehead renderas="sect4">Optional</bridgehead>
77 <para role="optional">
78 <xref linkend="gcr"/>,
79 <xref linkend="gtk2"/>,
80 <xref linkend="gtk3"/>,
81 <xref linkend="libcap-pam"/>,
82 <xref linkend="libsecret"/>,
83 <xref linkend="qt4"/>, and
84 <xref linkend="qt5"/>
85 </para>
86
87 <para condition="html" role="usernotes">User Notes:
88 <ulink url="&blfs-wiki;/pinentry"/></para>
89
90 </sect2>
91
92 <sect2 role="installation">
93 <title>Installation of PIN-Entry</title>
94
95 <para>Install <application>PIN-Entry</application> by running the following
96 commands:</para>
97
98<screen><userinput>./configure --prefix=/usr &amp;&amp;
99
100make</userinput></screen><!-- &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</userinput></screen><!-- &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>
136 <option>--disable-pinentry-qt5</option>: Default is enable. Don't use qt5
137 even if it is available. If qt4 is found, <command>pinentry-qt</command>
138 will be linked to qt4.
139 </para>
140
141 <para>
142 <option>--enable-pinentry-qt=yes/no</option>: Default is yes.
143 </para>
144
145 <para>
146 <option>--enable-pinentry-gtk2=yes/no</option>: Default is yes. Even if
147 other <command>pinentry-*</command> is installed,
148 <command>pinentry</command> will be a symlink to
149 <command>pinentry-gtk-2</command>.
150 </para>
151
152 <para>
153 <option>--enable-pinentry-gnome3=yes/no</option>: Default is yes.
154 Actually, it is the gtk3 pinentry.
155 </para>
156
157 </sect2>
158
159 <sect2 role="content">
160 <title>Contents</title>
161
162 <segmentedlist>
163 <segtitle>Installed Programs</segtitle>
164 <segtitle>Installed Libraries</segtitle>
165 <segtitle>Installed Directory</segtitle>
166
167 <seglistitem>
168 <seg>
169 pinentry (symlink), pinentry-curses, pinentry-gnome3, pinentry-gtk-2,
170 pinentry-qt, and pinentry-tty
171 </seg>
172 <seg>None</seg>
173 <seg>None</seg>
174 </seglistitem>
175 </segmentedlist>
176
177 <variablelist>
178 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
179 <?dbfo list-presentation="list"?>
180 <?dbhtml list-presentation="table"?>
181
182 <varlistentry id="pinentry-prog">
183 <term><command>pinentry</command></term>
184 <listitem>
185 <para>is a symbolic link to the default
186 <application>PIN-Entry</application> program.</para>
187 <indexterm zone="pinentry pinentry-prog">
188 <primary sortas="b-pinentry">pinentry</primary>
189 </indexterm>
190 </listitem>
191 </varlistentry>
192
193 <varlistentry id="pinentry-curses">
194 <term><command>pinentry-curses</command></term>
195 <listitem>
196 <para> is an <application>Ncurses</application> text-based
197 <application>PIN-Entry</application> helper program.</para>
198 <indexterm zone="pinentry pinentry-curses">
199 <primary sortas="b-pinentry-curses">pinentry-curses</primary>
200 </indexterm>
201 </listitem>
202 </varlistentry>
203
204 <varlistentry id="pinentry-gnome3">
205 <term><command>pinentry-gnome3</command></term>
206 <listitem>
207 <para> is a <application>GNOME-3</application>
208 <application>PIN-Entry</application> helper program.</para>
209 <indexterm zone="pinentry pinentry-gnome3">
210 <primary sortas="b-pinentry-gnome3">pinentry-gnome3</primary>
211 </indexterm>
212 </listitem>
213 </varlistentry>
214
215 <varlistentry id="pinentry-gtk-2">
216 <term><command>pinentry-gtk-2</command></term>
217 <listitem>
218 <para> is a <application>GTK+2</application>
219 <application>PIN-Entry</application> program program.</para>
220 <indexterm zone="pinentry pinentry-gtk-2">
221 <primary sortas="b-pinentry-gtk-2">pinentry-gtk-2</primary>
222 </indexterm>
223 </listitem>
224 </varlistentry>
225
226 <varlistentry id="pinentry-qt">
227 <term><command>pinentry-qt</command></term>
228 <listitem>
229 <para> is a <application>Qt4 or 5</application>
230 <application>PIN-Entry</application> helper program.</para>
231 <indexterm zone="pinentry pinentry-qt">
232 <primary sortas="b-pinentry-qt">pinentry-qt</primary>
233 </indexterm>
234 </listitem>
235 </varlistentry>
236
237 <varlistentry id="pinentry-tty">
238 <term><command>pinentry-tty</command></term>
239 <listitem>
240 <para> is a <application>tty</application>
241 <application>PIN-Entry</application> helper program.</para>
242 <indexterm zone="pinentry pinentry-tty">
243 <primary sortas="b-pinentry-tty">pinentry-tty</primary>
244 </indexterm>
245 </listitem>
246 </varlistentry>
247
248 </variablelist>
249
250 </sect2>
251
252</sect1>
Note: See TracBrowser for help on using the repository browser.