source: archive/attr.xml

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

more SVN prop clean up

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

  • Property mode set to 100644
File size: 6.0 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 attr-download-http "http://download.savannah.gnu.org/releases/attr/attr-&attr-version;.src.tar.gz">
8 <!ENTITY attr-download-ftp " ">
9 <!ENTITY attr-md5sum "84f58dec00b60f2dc8fd1c9709291cc7">
10 <!ENTITY attr-size "336 KB">
11 <!ENTITY attr-buildsize "3.5 MB">
12 <!ENTITY attr-time "0.1 SBU">
13]>
14
15<sect1 id="attr" xreflabel="attr-&attr-version;">
16 <?dbhtml filename="attr.html"?>
17
18 <sect1info>
19 <date>$Date$</date>
20 </sect1info>
21
22 <title>attr-&attr-version;</title>
23
24 <indexterm zone="attr">
25 <primary sortas="a-attr">attr</primary>
26 </indexterm>
27
28 <sect2 role="package">
29 <title>Introduction to attr</title>
30
31 <para>The <application>attr</application> package contains utilities to
32 administer the extended attributes on filesystem objects.</para>
33
34 &lfs75_checked;
35
36 <bridgehead renderas="sect3">Package Information</bridgehead>
37 <itemizedlist spacing="compact">
38 <listitem>
39 <para>Download (HTTP): <ulink url="&attr-download-http;"/></para>
40 </listitem>
41 <listitem>
42 <para>Download (FTP): <ulink url="&attr-download-ftp;"/></para>
43 </listitem>
44 <listitem>
45 <para>Download MD5 sum: &attr-md5sum;</para>
46 </listitem>
47 <listitem>
48 <para>Download size: &attr-size;</para>
49 </listitem>
50 <listitem>
51 <para>Estimated disk space required: &attr-buildsize;</para>
52 </listitem>
53 <listitem>
54 <para>Estimated build time: &attr-time;</para>
55 </listitem>
56 </itemizedlist>
57
58 <para condition="html" role="usernotes">User Notes:
59 <ulink url="&blfs-wiki;/attr"/></para>
60
61 </sect2>
62
63 <sect2 role="installation">
64 <title>Installation of attr</title>
65
66 <para>Install <application>attr</application> by running the following
67 commands:</para>
68
69<screen><userinput>sed -i -e 's|/@pkg_name@|&amp;-@pkg_version@|' include/builddefs.in &amp;&amp;
70
71INSTALL_USER=root \
72INSTALL_GROUP=root \
73./configure --prefix=/usr --disable-static &amp;&amp;
74make</userinput></screen>
75
76 <para>There are three sets of tests that come with this package. Issue the
77 following to execute all three:
78 <command>make tests root-tests ext-tests</command>. For meaningful results,
79 the tests need to be carried out on a file system that supports extended
80 attributes.</para>
81
82 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
83
84<!-- Package uses DIST_ROOT instead of DESTDIR -->
85<screen role="root"><userinput>make install install-dev install-lib &amp;&amp;
86chmod -v 755 /usr/lib/libattr.so &amp;&amp;
87mv -v /usr/lib/libattr.so.* /lib &amp;&amp;
88ln -sfv ../../lib/libattr.so.1 /usr/lib/libattr.so</userinput></screen>
89
90 </sect2>
91
92 <sect2 role="commands">
93 <title>Command Explanations</title>
94
95 <para><command>sed ... include/builddefs.in</command>: This command
96 modifies the documentation directory so that it is a versioned
97 directory.</para>
98
99 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
100 href="../../xincludes/static-libraries.xml"/>
101
102 </sect2>
103
104 <sect2 role="configuration">
105 <title>Configuring attr</title>
106 <sect3><title>Configuration Information</title>
107
108 <para>There is no configuration to <application>attr</application> itself,
109 but to get any use out of <application>attr</application>, a filesystem
110 needs to support extended attributes.</para>
111
112 <para>One way to achieve this is to add the user_xattr option to an ext3
113 filesystem in the <filename>/etc/fstab</filename> file as shown
114 below:</para>
115
116<screen># file system mount-point type options dump fsck
117# order
118
119/dev/sda1 / ext3 defaults,acl,user_xattr 0 2</screen>
120
121 </sect3>
122
123 </sect2>
124
125 <sect2 role="content">
126 <title>Contents</title>
127
128 <segmentedlist>
129 <segtitle>Installed Programs</segtitle>
130 <segtitle>Installed Library</segtitle>
131 <segtitle>Installed Directories</segtitle>
132
133 <seglistitem>
134 <seg>attr, getfattr, and setfattr</seg>
135 <seg>libattr.so</seg>
136 <seg>/usr/{include/attr,share/doc/attr-&attr-version;}</seg>
137 </seglistitem>
138 </segmentedlist>
139
140 <variablelist>
141 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
142 <?dbfo list-presentation="list"?>
143 <?dbhtml list-presentation="table"?>
144
145 <varlistentry id="attr-prog">
146 <term><command>attr</command></term>
147 <listitem>
148 <para>extends attributes on filesystem objects.</para>
149 <indexterm zone="attr attr">
150 <primary sortas="b-attr">attr</primary>
151 </indexterm>
152 </listitem>
153 </varlistentry>
154
155 <varlistentry id="getfattr">
156 <term><command>getfattr</command></term>
157 <listitem>
158 <para>gets the extended attributes of filesystem objects.</para>
159 <indexterm zone="attr getfattr">
160 <primary sortas="b-getfattr">getfattr</primary>
161 </indexterm>
162 </listitem>
163 </varlistentry>
164
165 <varlistentry id="setfattr">
166 <term><command>setfattr</command></term>
167 <listitem>
168 <para>sets the extended attributes of filesystem objects.</para>
169 <indexterm zone="attr setfattr">
170 <primary sortas="b-setfattr">setfattr</primary>
171 </indexterm>
172 </listitem>
173 </varlistentry>
174
175 <varlistentry id="libattr">
176 <term><filename class='libraryfile'>libattr.so</filename></term>
177 <listitem>
178 <para>contains the <application>attr</application> API functions.</para>
179 <indexterm zone="attr libattr">
180 <primary sortas="c-libattr">libattr.so</primary>
181 </indexterm>
182 </listitem>
183 </varlistentry>
184
185 </variablelist>
186
187 </sect2>
188
189</sect1>
Note: See TracBrowser for help on using the repository browser.