source: gnome/platform/gnome-keyring.xml@ 4e0c76b

trunk
Last change on this file since 4e0c76b was 4e0c76b, checked in by Bruce Dubbs <bdubbs@…>, 3 months ago

Update to gnome-keyring-42.0.

  • Property mode set to 100644
File size: 5.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 gnome-keyring-download-http
8 "&gnome-download-http;/gnome-keyring/&gnome-40;/gnome-keyring-&gnome-keyring-version;.tar.xz">
9 <!ENTITY gnome-keyring-download-ftp
10 "&gnome-download-ftp;/gnome-keyring/&gnome-40;/gnome-keyring-&gnome-keyring-version;.tar.xz">
11 <!ENTITY gnome-keyring-md5sum "dd3a191a2f61a14ca67ad6e2a3e6287e">
12 <!ENTITY gnome-keyring-size "1.3 MB">
13 <!ENTITY gnome-keyring-buildsize "116 MB">
14 <!ENTITY gnome-keyring-time "0.2 SBU (Using parallelism=4; add 0.3 SBU for tests)">
15]>
16
17<sect1 id="gnome-keyring" xreflabel="gnome-keyring-&gnome-keyring-version;">
18 <?dbhtml filename="gnome-keyring.html"?>
19
20 <sect1info>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>gnome-keyring-&gnome-keyring-version;</title>
25
26 <indexterm zone="gnome-keyring">
27 <primary sortas="a-gnome-keyring">gnome-keyring</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to GNOME Keyring</title>
32
33 <para>
34 The <application>GNOME Keyring</application> package contains a
35 daemon that keeps passwords and other secrets for users.
36 </para>
37
38 &lfs111_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&gnome-keyring-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&gnome-keyring-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &gnome-keyring-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &gnome-keyring-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &gnome-keyring-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &gnome-keyring-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">GNOME Keyring Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="dbus"/> and
79 <xref linkend="gcr"/>
80 </para>
81
82 <bridgehead renderas="sect4">Recommended</bridgehead>
83 <para role="recommended">
84 <xref linkend="linux-pam"/>,
85 <xref linkend="libxslt"/>, and
86 <xref linkend="openssh"/>
87 </para>
88
89 <bridgehead renderas="sect4">Optional</bridgehead>
90 <para role="optional">
91 <ulink url="http://ltp.sourceforge.net/coverage/lcov.php">LCOV</ulink>,
92 <ulink url="http://people.redhat.com/sgrubb/libcap-ng/">libcap-ng</ulink>,
93 <xref linkend="gnupg2"/>, and
94 <xref linkend="valgrind"/>
95 </para>
96
97 <para condition="html" role="usernotes">User Notes:
98 <ulink url="&blfs-wiki;/gnome-keyring"/>
99 </para>
100 </sect2>
101
102 <sect2 role="installation">
103 <title>Installation of GNOME Keyring</title>
104
105 <para>
106 First, fix a packaging error:
107 </para>
108
109<!-- This could be shortened to sed -i 's:/home.*dbus/::' daemon/dbus/*generated.c
110 but I expect a release of 42.1 soon to fix the problem. -->
111
112<screen><userinput>sed -e 's:/home/niels/jhbuild/checkout/gnome-keyring/daemon/dbus/::' \
113 -i daemon/dbus/*generated.c</userinput></screen>
114
115 <para>
116 Install <application>GNOME Keyring</application> by running the
117 following commands:
118 </para>
119
120<screen><userinput>sed -i 's:"/desktop:"/org:' schema/*.xml &amp;&amp;
121
122./configure --prefix=/usr \
123 --sysconfdir=/etc &amp;&amp;
124make</userinput></screen>
125
126 <para>
127 A session bus address is necessary to run the tests. To test the results,
128 issue: <command>make check</command>.
129 </para>
130
131 <para>
132 Now, as the <systemitem class="username">root</systemitem> user:
133 </para>
134
135<screen role="root"><userinput>make install</userinput></screen>
136
137 </sect2>
138
139 <sect2 role="commands">
140 <title>Command Explanations</title>
141
142 <para>
143 <command>sed ... schema/*.xml</command>: This command fixes a
144 deprecated entry in the schema template.
145 </para>
146
147 </sect2>
148
149 <sect2 role="content">
150 <title>Contents</title>
151
152 <segmentedlist>
153 <segtitle>Installed Programs</segtitle>
154 <segtitle>Installed Libraries</segtitle>
155 <segtitle>Installed Directory</segtitle>
156
157 <seglistitem>
158 <seg>
159 gnome-keyring (symlink), gnome-keyring-3, and gnome-keyring-daemon
160 </seg>
161 <seg>
162 gnome-keyring-pkcs11.so (PKCS#11 module) and
163 pam_gnome_keyring.so (PAM module)
164 </seg>
165 <seg>
166 /usr/lib/gnome-keyring and
167 /usr/share/xdg-desktop-portal
168 </seg>
169 </seglistitem>
170 </segmentedlist>
171
172 <variablelist>
173 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
174 <?dbfo list-presentation="list"?>
175 <?dbhtml list-presentation="table"?>
176
177 <varlistentry id="gnome-keyring-daemon">
178 <term><command>gnome-keyring-daemon</command></term>
179 <listitem>
180 <para>
181 is a session daemon that keeps passwords for users
182 </para>
183 <indexterm zone="gnome-keyring gnome-keyring-daemon">
184 <primary sortas="b-gnome-keyring-daemon">gnome-keyring-daemon</primary>
185 </indexterm>
186 </listitem>
187 </varlistentry>
188
189 </variablelist>
190
191 </sect2>
192
193</sect1>
Note: See TracBrowser for help on using the repository browser.