source: archive/acl.xml@ 45ab6c7

11.0 qt5new trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 5 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

  • Property mode set to 100644
File size: 7.8 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 acl-download-http "http://download.savannah.gnu.org/releases/acl/acl-&acl-version;.src.tar.gz">
8 <!ENTITY acl-download-ftp " ">
9 <!ENTITY acl-md5sum "a61415312426e9c2212bd7dc7929abda">
10 <!ENTITY acl-size "384 KB">
11 <!ENTITY acl-buildsize "9.1 MB">
12 <!ENTITY acl-time "0.1 SBU">
13]>
14
15<sect1 id="acl" xreflabel="acl-&acl-version;">
16 <?dbhtml filename="acl.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>acl-&acl-version;</title>
23
24 <indexterm zone="acl">
25 <primary sortas="a-acl">acl</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to acl</title>
30
31 <para>The <application>acl</application> package contains utilities to
32 administer Access Control Lists, which are used to define more fine-grained
33 discretionary access rights for files and directories.</para>
34
35 &lfs75_checked;
36
37 <bridgehead renderas="sect3">Package Information</bridgehead>
38 <itemizedlist spacing="compact">
39 <listitem>
40 <para>Download (HTTP): <ulink url="&acl-download-http;"/></para>
41 </listitem>
42 <listitem>
43 <para>Download (FTP): <ulink url="&acl-download-ftp;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download MD5 sum: &acl-md5sum;</para>
47 </listitem>
48 <listitem>
49 <para>Download size: &acl-size;</para>
50 </listitem>
51 <listitem>
52 <para>Estimated disk space required: &acl-buildsize;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated build time: &acl-time;</para>
56 </listitem>
57 </itemizedlist>
58
59 <bridgehead renderas="sect3">acl Dependencies</bridgehead>
60
61 <bridgehead renderas="sect4">Required</bridgehead>
62 <para role="required"><xref linkend="attr"/></para>
63
64 <para condition="html" role="usernotes">User Notes:
65 <ulink url="&blfs-wiki;/acl"/></para>
66
67 </sect2>
68
69 <sect2 role="installation">
70 <title>Installation of acl</title>
71
72 <para>Install <application>acl</application> by running the following
73 commands:</para>
74
75<screen><userinput>sed -i -e 's|/@pkg_name@|&amp;-@pkg_version@|' \
76 include/builddefs.in &amp;&amp;
77
78INSTALL_USER=root \
79INSTALL_GROUP=root \
80./configure --prefix=/usr --libexecdir=/usr/lib --disable-static &amp;&amp;
81make</userinput></screen>
82
83 <para>For meaningful results, the tests need to be carried out on a file
84 system that supports extended attributes. It is also required that
85 <application>Coreutils</application> is re-installed after
86 <application>acl</application> is installed so that the extra acl bit
87 displays correctly on a <command>ls</command> command.</para>
88
89 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
90
91<!-- Package uses DIST_ROOT instead of DESTDIR -->
92<screen role="root"><userinput>make install install-dev install-lib &amp;&amp;
93chmod -v 755 /usr/lib/libacl.so &amp;&amp;
94mv -v /usr/lib/libacl.so.* /lib &amp;&amp;
95ln -sfv ../../lib/libacl.so.1 /usr/lib/libacl.so &amp;&amp;
96install -v -m644 doc/*.txt /usr/share/doc/acl-&acl-version;</userinput></screen>
97
98 <para>You should now re-install <application><ulink
99 url="&lfs-root;/chapter06/coreutils.html">Coreutils</ulink>
100 </application> and proceed to run the test suite.</para>
101
102 <para>There are three sets of tests that come with this package. The local
103 partition where the tests are run must be mounted with acl configured as
104 described below. Additionally, the users <systemitem
105 class="username">bin</systemitem> and <systemitem
106 class="username">daemon</systemitem> must be created or modified to have a
107 proper shell and home directory and the group <systemitem
108 class="groupname">daemon</systemitem> must be a member of the <systemitem
109 class="groupname">bin</systemitem> group. The kernel must also be
110 configured with the appropriate ACL options (there are nine different
111 options).</para>
112
113 <para>To run the standard tests run <command>make tests </command>. As
114 <systemitem class="username">root</systemitem> user, run <command>make
115 root-tests</command>.</para>
116
117 <para>The third set of tests are Network File System (NFS) specific. See
118 the contents of the test files in the test/nfs/ directory for the setup
119 requirements.</para>
120
121 </sect2>
122
123 <sect2 role="commands">
124 <title>Command Explanations</title>
125
126 <para><command>sed -i ... include/builddefs.in</command>: This command
127 modifies the documentation directory so that it is a versioned
128 directory.</para>
129
130 <para><command>--libexecdir=/usr/lib</command>: This switch ensures that
131 <filename class="libraryfile">libacl.la</filename> is installed in the correct
132 directory, and that a spurious
133 <filename class="libraryfile">libacl.so</filename> symlink is not created in
134 <filename class="directory">/usr/libexec/</filename>.</para>
135
136 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
137 href="../../xincludes/static-libraries.xml"/>
138
139 </sect2>
140
141 <sect2 role="configuration">
142 <title>Configuring acl</title>
143 <sect3><title>Configuration Information</title>
144
145 <para>There is no configuration to <application>acl</application> itself,
146 but to get any use out of <application>acl</application>, a filesystem
147 needs to support access control lists.</para>
148
149 <para>One way to achieve this is to add the acl option to an ext3
150 filesystem in the <filename>/etc/fstab</filename> file as shown
151 below:</para>
152
153<screen># file system mount-point type options dump fsck
154# order
155
156/dev/sda1 / ext3 defaults,acl,user_xattr 0 2</screen>
157
158 </sect3>
159
160 </sect2>
161
162 <sect2 role="content">
163 <title>Contents</title>
164
165 <segmentedlist>
166 <segtitle>Installed Programs</segtitle>
167 <segtitle>Installed Library</segtitle>
168 <segtitle>Installed Directories</segtitle>
169
170 <seglistitem>
171 <seg>chacl, getfacl, and setfacl</seg>
172 <seg>libacl.{so,a}</seg>
173 <seg>/usr/{include/acl,share/doc/acl-&acl-version;}</seg>
174 </seglistitem>
175 </segmentedlist>
176
177 <variablelist>
178 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
179 <?dbfo list-presentation="list"?>
180 <?dbhtml list-presentation="table"?>
181
182 <varlistentry id="chacl">
183 <term><command>chacl</command></term>
184 <listitem>
185 <para>changes the access control list of a file or directory.</para>
186 <indexterm zone="acl chacl">
187 <primary sortas="b-chacl">chacl</primary>
188 </indexterm>
189 </listitem>
190 </varlistentry>
191
192 <varlistentry id="getfacl">
193 <term><command>getfacl</command></term>
194 <listitem>
195 <para>gets file access control lists.</para>
196 <indexterm zone="acl getfacl">
197 <primary sortas="b-getfacl">getfacl</primary>
198 </indexterm>
199 </listitem>
200 </varlistentry>
201
202 <varlistentry id="setfacl">
203 <term><command>setfacl</command></term>
204 <listitem>
205 <para>sets file access control lists.</para>
206 <indexterm zone="acl setfacl">
207 <primary sortas="b-setfacl">setfacl</primary>
208 </indexterm>
209 </listitem>
210 </varlistentry>
211
212 <varlistentry id="libacl">
213 <term><filename class='libraryfile'>libacl.{so,a}</filename></term>
214 <listitem>
215 <para>contains the <application>acl</application> API functions.</para>
216 <indexterm zone="acl libacl">
217 <primary sortas="c-libacl">libacl.{so,a}</primary>
218 </indexterm>
219 </listitem>
220 </varlistentry>
221
222 </variablelist>
223
224 </sect2>
225
226</sect1>
Note: See TracBrowser for help on using the repository browser.