lfs/chapter08/acl.xml
2024-01-18 20:53:23 +01:00

133 lines
3.9 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!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;
]>
<sect1 id="ch-system-acl" role="wrap">
<?dbhtml filename="acl.html"?>
<sect1info condition="script">
<productname>acl</productname>
<productnumber>&acl-version;</productnumber>
<address>&acl-url;</address>
</sect1info>
<title>Acl-&acl-version;</title>
<indexterm zone="ch-system-acl">
<primary sortas="a-Acl">Acl</primary>
</indexterm>
<sect2 role="package">
<title/>
<para>The Acl package contains utilities to administer Access Control Lists,
which are used to define fine-grained discretionary access rights for
files and directories.</para>
<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem>
<seg>&acl-fin-sbu;</seg>
<seg>&acl-fin-du;</seg>
</seglistitem>
</segmentedlist>
</sect2>
<sect2 role="installation">
<title>Installation of Acl</title>
<para>Prepare Acl for compilation:</para>
<screen><userinput remap="configure">./configure --prefix=/usr \
--disable-static \
--docdir=/usr/share/doc/acl-&acl-version;</userinput></screen>
<para>Compile the package:</para>
<screen><userinput remap="make">make</userinput></screen>
<para>The Acl tests must be run on a filesystem that supports access
controls, but not until the <application>Coreutils</application> package has been built,
using the <application>Acl</application> libraries. If desired, return to this package
and run <command>make check</command> after the <application>Coreutils</application>
package has been built.</para>
<para>Install the package:</para>
<screen><userinput remap="install">make install</userinput></screen>
</sect2>
<sect2 id="contents-acl" role="content">
<title>Contents of Acl</title>
<segmentedlist>
<segtitle>Installed programs</segtitle>
<segtitle>Installed library</segtitle>
<segtitle>Installed directories</segtitle>
<seglistitem>
<seg>chacl, getfacl, and setfacl</seg>
<seg>libacl.so</seg>
<seg>/usr/include/acl and /usr/share/doc/acl-&acl-version;</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="chacl">
<term><command>chacl</command></term>
<listitem>
<para>Changes the access control list of a file
or directory</para>
<indexterm zone="ch-system-acl chacl">
<primary sortas="b-chacl">chacl</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="getfacl">
<term><command>getfacl</command></term>
<listitem>
<para>Gets file access control lists</para>
<indexterm zone="ch-system-acl getfacl">
<primary sortas="b-getfacl">getfacl</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="setfacl">
<term><command>setfacl</command></term>
<listitem>
<para>Sets file access control lists</para>
<indexterm zone="ch-system-acl setfacl">
<primary sortas="b-setfacl">setfacl</primary>
</indexterm>
</listitem>
</varlistentry>
<varlistentry id="libacl">
<term><filename class="libraryfile">libacl</filename></term>
<listitem>
<para>Contains the library functions for manipulating Access Control Lists</para>
<indexterm zone="ch-system-acl libacl">
<primary sortas="c-libacl">libacl</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>