source: general/sysutils/accountsservice.xml@ e7d893b

elogind
Last change on this file since e7d893b was e7d893b, checked in by DJ Lucas <dj@…>, 3 years ago

Merge to HEAD 21602.

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

  • Property mode set to 100644
File size: 7.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 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>
184 To start the <command>accounts-daemon</command> daemon at boot,
185 <phrase revision="systemd">enable the previously installed systemd
186 unit</phrase>
187 <phrase revision="sysv">install the
188 <filename>/etc/rc.d/init.d/accounts-daemon</filename> init script from
189 the <xref linkend="bootscripts"/> package</phrase>
190 by running the following command as the
191 <systemitem class="username">root</systemitem> user:
192 </para>
193
194 <indexterm zone="accountsservice accountsservice-init">
195 <primary sortas="f-accounts-daemon">accounts-daemon</primary>
196 </indexterm>
197
198<screen role="root" revision="sysv"><userinput>make install-accounts-daemon</userinput></screen>
199
200<screen role="root" revision="systemd"><userinput>systemctl enable accounts-daemon</userinput></screen>
201
202 </sect3>
203
204 </sect2>
205
206 <sect2 role="content">
207 <title>Contents</title>
208
209 <segmentedlist>
210 <segtitle>Installed Programs</segtitle>
211 <segtitle>Installed Libraries</segtitle>
212 <segtitle>Installed Directories</segtitle>
213
214 <seglistitem>
215 <seg>
216 accounts-daemon (library executable)
217 </seg>
218 <seg>
219 libaccountsservice.so
220 </seg>
221 <seg>
222 /usr/include/accountsservice-1.0,
223 /usr/share/doc/accountsservice,
224 /usr/share/gtk-doc/html/libaccountsservice, and
225 /var/lib/AccountsService
226 </seg>
227 </seglistitem>
228 </segmentedlist>
229
230 <variablelist>
231 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
232 <?dbfo list-presentation="list"?>
233 <?dbhtml list-presentation="table"?>
234
235 <varlistentry id="accounts-daemon">
236 <term><command>accounts-daemon</command></term>
237 <listitem>
238 <para>
239 is the <application>AccountsService</application> daemon.
240 </para>
241 <indexterm zone="accountsservice accounts-daemon">
242 <primary sortas="b-accounts-daemon">accounts-daemon</primary>
243 </indexterm>
244 </listitem>
245 </varlistentry>
246
247 <varlistentry id="libaccountsservice">
248 <term><filename class="libraryfile">libaccountsservice.so</filename></term>
249 <listitem>
250 <para>
251 contains the <application>AccountsService</application> API functions.
252 </para>
253 <indexterm zone="accountsservice libaccountsservice">
254 <primary sortas="c-libaccountsservice">libaccountsservice.so</primary>
255 </indexterm>
256 </listitem>
257 </varlistentry>
258
259 </variablelist>
260
261 </sect2>
262
263</sect1>
Note: See TracBrowser for help on using the repository browser.