mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-01-24 15:12:11 +08:00
269 lines
8.2 KiB
XML
269 lines
8.2 KiB
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../../general.ent">
|
|
%general-entities;
|
|
|
|
<!ENTITY accountsservice-download-http
|
|
"https://www.freedesktop.org/software/accountsservice/accountsservice-&accountsservice-version;.tar.xz">
|
|
<!ENTITY accountsservice-download-ftp " ">
|
|
<!ENTITY accountsservice-md5sum "6e4c6fbd490260cfe17de2e76f5d803a">
|
|
<!ENTITY accountsservice-size "96 KB">
|
|
<!ENTITY accountsservice-buildsize "10 MB">
|
|
<!ENTITY accountsservice-time "0.1 SBU">
|
|
]>
|
|
|
|
<sect1 id="accountsservice" xreflabel="AccountsService-&accountsservice-version;">
|
|
<?dbhtml filename="accountsservice.html"?>
|
|
|
|
<sect1info>
|
|
<date>$Date$</date>
|
|
</sect1info>
|
|
|
|
<title>AccountsService-&accountsservice-version;</title>
|
|
|
|
<indexterm zone="accountsservice">
|
|
<primary sortas="a-AccountsService">AccountsService</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title>Introduction to AccountsService</title>
|
|
|
|
<para>
|
|
The <application>AccountsService</application> package provides a
|
|
set of <application>D-Bus</application> interfaces for querying
|
|
and manipulating user account information and an implementation
|
|
of those interfaces based on the usermod(8), useradd(8) and
|
|
userdel(8) commands.
|
|
</para>
|
|
|
|
&lfs101_checked;
|
|
|
|
<bridgehead renderas="sect3">Package Information</bridgehead>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>
|
|
Download (HTTP): <ulink url="&accountsservice-download-http;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download (FTP): <ulink url="&accountsservice-download-ftp;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download MD5 sum: &accountsservice-md5sum;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download size: &accountsservice-size;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated disk space required: &accountsservice-buildsize;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated build time: &accountsservice-time;
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<bridgehead renderas="sect3">AccountsService Dependencies</bridgehead>
|
|
|
|
<bridgehead renderas="sect4">Required</bridgehead>
|
|
<para role="required">
|
|
<xref linkend="libgcrypt"/> and
|
|
<xref linkend="polkit"/>
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Recommended</bridgehead>
|
|
<para role="recommended">
|
|
<xref linkend="gobject-introspection"/> and
|
|
<phrase revision="sysv"><xref linkend="elogind"/></phrase>
|
|
<phrase revision="systemd"><xref linkend="systemd"/></phrase>
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Optional</bridgehead>
|
|
<para role="optional">
|
|
<xref linkend="gtk-doc"/> and
|
|
<xref linkend="xmlto"/>
|
|
<!-- I did not have gtk-doc installed this time, and it worked fine. -->
|
|
</para>
|
|
|
|
<para condition="html" role="usernotes">User Notes:
|
|
<ulink url="&blfs-wiki;/accountsservice"/>
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of AccountsService</title>
|
|
|
|
<para>
|
|
Install <application>AccountsService</application> by running the following
|
|
commands:
|
|
</para>
|
|
|
|
<screen revision="sysv"><userinput>mkdir build &&
|
|
cd build &&
|
|
|
|
meson --prefix=/usr \
|
|
-Dadmin_group=adm \
|
|
-Delogind=true \
|
|
-Dsystemdsystemunitdir=no \
|
|
.. &&
|
|
ninja</userinput></screen>
|
|
|
|
<screen revision="systemd"><userinput>mkdir build &&
|
|
cd build &&
|
|
|
|
meson --prefix=/usr \
|
|
-Dadmin_group=adm \
|
|
-Dsystemd=true \
|
|
.. &&
|
|
ninja</userinput></screen>
|
|
|
|
<para>
|
|
This package does not come with a test suite.
|
|
</para>
|
|
|
|
<para>
|
|
Now, as the <systemitem class="username">root</systemitem> user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>ninja install</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="commands">
|
|
<title>Command Explanations</title>
|
|
|
|
<para>
|
|
<parameter>-Dadmin_group=adm</parameter>: This switch sets
|
|
the group for administrator accounts.
|
|
</para>
|
|
|
|
<para>
|
|
<option>-Ddocbook=true</option>: This switch enables building
|
|
the D-Bus interface API documentation.
|
|
</para>
|
|
<!--
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
href="../../xincludes/static-libraries.xml"/>
|
|
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
href="../../xincludes/gtk-doc-rebuild.xml"/>
|
|
-->
|
|
</sect2>
|
|
|
|
<sect2 role="configuration">
|
|
<title>Configuring AccountsService</title>
|
|
|
|
<para>
|
|
To allow users in the adm group to be listed as Administrators,
|
|
execute the following commands as the
|
|
<systemitem class="username">root</systemitem> user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>cat > /etc/polkit-1/rules.d/40-adm.rules << "EOF"
|
|
<literal>polkit.addAdminRule(function(action, subject) {
|
|
return ["unix-group:adm"];
|
|
});</literal>
|
|
EOF</userinput></screen>
|
|
|
|
<sect3 id="accountsservice-init" revision="systemd">
|
|
<!-- <title><phrase revision="sysv">Boot Script</phrase>
|
|
<phrase revision="systemd">Systemd Units</phrase></title> -->
|
|
<title>Systemd Unit</title>
|
|
<!-- Autmatically started by D-Bus when needed
|
|
<para revision="sysv">
|
|
To start the <command>accounts-daemon</command> daemon at boot,
|
|
install the
|
|
<filename>/etc/rc.d/init.d/accounts-daemon</filename> init script from
|
|
the <xref linkend="bootscripts"/> package
|
|
by running the following command as the
|
|
<systemitem class="username">root</systemitem> user:
|
|
</para>
|
|
-->
|
|
<para revision="systemd">
|
|
To start the <command>accounts-daemon</command> daemon at boot,
|
|
enable the previously installed systemd unit
|
|
by running the following command as the
|
|
<systemitem class="username">root</systemitem> user:
|
|
</para>
|
|
|
|
<indexterm zone="accountsservice accountsservice-init">
|
|
<primary sortas="f-accounts-daemon">accounts-daemon</primary>
|
|
</indexterm>
|
|
|
|
<screen role="root" revision="sysv"><userinput>make install-accounts-daemon</userinput></screen>
|
|
|
|
<screen role="root" revision="systemd"><userinput>systemctl enable accounts-daemon</userinput></screen>
|
|
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="content">
|
|
<title>Contents</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed Programs</segtitle>
|
|
<segtitle>Installed Libraries</segtitle>
|
|
<segtitle>Installed Directories</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>
|
|
accounts-daemon (library executable)
|
|
</seg>
|
|
<seg>
|
|
libaccountsservice.so
|
|
</seg>
|
|
<seg>
|
|
/usr/include/accountsservice-1.0,
|
|
/usr/share/doc/accountsservice,
|
|
/usr/share/gtk-doc/html/libaccountsservice, and
|
|
/var/lib/AccountsService
|
|
</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="accounts-daemon">
|
|
<term><command>accounts-daemon</command></term>
|
|
<listitem>
|
|
<para>
|
|
is the <application>AccountsService</application> daemon
|
|
</para>
|
|
<indexterm zone="accountsservice accounts-daemon">
|
|
<primary sortas="b-accounts-daemon">accounts-daemon</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libaccountsservice">
|
|
<term><filename class="libraryfile">libaccountsservice.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains the <application>AccountsService</application> API functions
|
|
</para>
|
|
<indexterm zone="accountsservice libaccountsservice">
|
|
<primary sortas="c-libaccountsservice">libaccountsservice.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|