source: general/sysutils/accountsservice.xml@ 4742744f

elogind
Last change on this file since 4742744f was 4742744f, checked in by Pierre Labastie <pieere@…>, 3 years ago

jhalfs does not support having <xref linkend="bootscripts"/> in <phrase>:
it must be the child of the <para> preceding "make install-xxx".

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

  • Property mode set to 100644
File size: 8.1 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 accountsservice-download-http
8 "https://www.freedesktop.org/software/accountsservice/accountsservice-&accountsservice-version;.tar.xz">
9 <!ENTITY accountsservice-download-ftp " ">
10 <!ENTITY accountsservice-md5sum "6e4c6fbd490260cfe17de2e76f5d803a">
11 <!ENTITY accountsservice-size "96 KB">
12 <!ENTITY accountsservice-buildsize "10 MB">
13 <!ENTITY accountsservice-time "0.1 SBU">
14]>
15
16<sect1 id="accountsservice" xreflabel="AccountsService-&accountsservice-version;">
17 <?dbhtml filename="accountsservice.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>AccountsService-&accountsservice-version;</title>
25
26 <indexterm zone="accountsservice">
27 <primary sortas="a-AccountsService">AccountsService</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to AccountsService</title>
32
33 <para>
34 The <application>AccountsService</application> package provides a
35 set of <application>D-Bus</application> interfaces for querying
36 and manipulating user account information and an implementation
37 of those interfaces based on the usermod(8), useradd(8) and
38 userdel(8) commands.
39 </para>
40
41 &lfs84_checked;
42
43 <bridgehead renderas="sect3">Package Information</bridgehead>
44 <itemizedlist spacing="compact">
45 <listitem>
46 <para>
47 Download (HTTP): <ulink url="&accountsservice-download-http;"/>
48 </para>
49 </listitem>
50 <listitem>
51 <para>
52 Download (FTP): <ulink url="&accountsservice-download-ftp;"/>
53 </para>
54 </listitem>
55 <listitem>
56 <para>
57 Download MD5 sum: &accountsservice-md5sum;
58 </para>
59 </listitem>
60 <listitem>
61 <para>
62 Download size: &accountsservice-size;
63 </para>
64 </listitem>
65 <listitem>
66 <para>
67 Estimated disk space required: &accountsservice-buildsize;
68 </para>
69 </listitem>
70 <listitem>
71 <para>
72 Estimated build time: &accountsservice-time;
73 </para>
74 </listitem>
75 </itemizedlist>
76
77 <bridgehead renderas="sect3">AccountsService Dependencies</bridgehead>
78
79 <bridgehead renderas="sect4">Required</bridgehead>
80 <para role="required">
81 <xref linkend="libgcrypt"/> and
82 <xref linkend="polkit"/>
83 </para>
84
85 <bridgehead renderas="sect4">Recommended</bridgehead>
86 <para role="recommended">
87 <xref linkend="gobject-introspection"/> and
88 <phrase revision="sysv"><xref linkend="elogind"/></phrase>
89 <phrase revision="systemd"><xref linkend="systemd"/></phrase>
90 </para>
91
92 <bridgehead renderas="sect4">Optional</bridgehead>
93 <para role="optional">
94 <xref linkend="gtk-doc"/> and
95 <xref linkend="xmlto"/>
96 <!-- I did not have gtk-doc installed this time, and it worked fine. -->
97 </para>
98
99 <para condition="html" role="usernotes">User Notes:
100 <ulink url="&blfs-wiki;/accountsservice"/>
101 </para>
102 </sect2>
103
104 <sect2 role="installation">
105 <title>Installation of AccountsService</title>
106
107 <para>
108 Install <application>AccountsService</application> by running the following
109 commands:
110 </para>
111
112<screen revision="sysv"><userinput>mkdir build &amp;&amp;
113cd build &amp;&amp;
114
115meson --prefix=/usr \
116 -Dadmin_group=adm \
117 -Delogind=true \
118 -Dsystemdsystemunitdir=no \
119 .. &amp;&amp;
120ninja</userinput></screen>
121
122<screen revision="systemd"><userinput>mkdir build &amp;&amp;
123cd build &amp;&amp;
124
125meson --prefix=/usr \
126 -Dadmin_group=adm \
127 -Dsystemd=true \
128 .. &amp;&amp;
129ninja</userinput></screen>
130
131 <para>
132 This package does not come with a test suite.
133 </para>
134
135 <para>
136 Now, as the <systemitem class="username">root</systemitem> user:
137 </para>
138
139<screen role="root"><userinput>ninja install</userinput></screen>
140
141 </sect2>
142
143 <sect2 role="commands">
144 <title>Command Explanations</title>
145
146 <para>
147 <parameter>-Dadmin_group=adm</parameter>: This switch sets
148 the group for administrator accounts.
149 </para>
150
151 <para>
152 <option>-Ddocbook=true</option>: This switch enables building
153 the D-Bus interface API documentation.
154 </para>
155<!--
156 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
157 href="../../xincludes/static-libraries.xml"/>
158
159 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
160 href="../../xincludes/gtk-doc-rebuild.xml"/>
161-->
162 </sect2>
163
164 <sect2 role="configuration">
165 <title>Configuring AccountsService</title>
166
167 <para>
168 To allow users in the adm group to be listed as Administrators,
169 execute the following commands as the
170 <systemitem class="username">root</systemitem> user:
171 </para>
172
173<screen role="root"><userinput>cat &gt; /etc/polkit-1/rules.d/40-adm.rules &lt;&lt; "EOF"
174<literal>polkit.addAdminRule(function(action, subject) {
175 return ["unix-group:adm"];
176 });</literal>
177EOF</userinput></screen>
178
179 <sect3 id="accountsservice-init">
180 <title><phrase revision="sysv">Boot Script</phrase>
181 <phrase revision="systemd">Systemd Units</phrase></title>
182
183 <para revision="sysv">
184 To start the <command>accounts-daemon</command> daemon at boot,
185 install the
186 <filename>/etc/rc.d/init.d/accounts-daemon</filename> init script from
187 the <xref linkend="bootscripts"/> package
188 by running the following command as the
189 <systemitem class="username">root</systemitem> user:
190 </para>
191
192 <para revision="systemd">
193 To start the <command>accounts-daemon</command> daemon at boot,
194 enable the previously installed systemd unit
195 by running the following command as the
196 <systemitem class="username">root</systemitem> user:
197 </para>
198
199 <indexterm zone="accountsservice accountsservice-init">
200 <primary sortas="f-accounts-daemon">accounts-daemon</primary>
201 </indexterm>
202
203<screen role="root" revision="sysv"><userinput>make install-accounts-daemon</userinput></screen>
204
205<screen role="root" revision="systemd"><userinput>systemctl enable accounts-daemon</userinput></screen>
206
207 </sect3>
208
209 </sect2>
210
211 <sect2 role="content">
212 <title>Contents</title>
213
214 <segmentedlist>
215 <segtitle>Installed Programs</segtitle>
216 <segtitle>Installed Libraries</segtitle>
217 <segtitle>Installed Directories</segtitle>
218
219 <seglistitem>
220 <seg>
221 accounts-daemon (library executable)
222 </seg>
223 <seg>
224 libaccountsservice.so
225 </seg>
226 <seg>
227 /usr/include/accountsservice-1.0,
228 /usr/share/doc/accountsservice,
229 /usr/share/gtk-doc/html/libaccountsservice, and
230 /var/lib/AccountsService
231 </seg>
232 </seglistitem>
233 </segmentedlist>
234
235 <variablelist>
236 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
237 <?dbfo list-presentation="list"?>
238 <?dbhtml list-presentation="table"?>
239
240 <varlistentry id="accounts-daemon">
241 <term><command>accounts-daemon</command></term>
242 <listitem>
243 <para>
244 is the <application>AccountsService</application> daemon.
245 </para>
246 <indexterm zone="accountsservice accounts-daemon">
247 <primary sortas="b-accounts-daemon">accounts-daemon</primary>
248 </indexterm>
249 </listitem>
250 </varlistentry>
251
252 <varlistentry id="libaccountsservice">
253 <term><filename class="libraryfile">libaccountsservice.so</filename></term>
254 <listitem>
255 <para>
256 contains the <application>AccountsService</application> API functions.
257 </para>
258 <indexterm zone="accountsservice libaccountsservice">
259 <primary sortas="c-libaccountsservice">libaccountsservice.so</primary>
260 </indexterm>
261 </listitem>
262 </varlistentry>
263
264 </variablelist>
265
266 </sect2>
267
268</sect1>
Note: See TracBrowser for help on using the repository browser.