source: BOOK/final-system/common/libcap.xml @ 52b1b25

Revision 52b1b25, 3.8 KB checked in by Chris Staub <chris@…>, 5 months ago (diff)

Added acl, attr, libcap

  • Property mode set to 100644
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
8<sect1 id="ch-system-libcap" role="wrap">
9  <?dbhtml filename="libcap.html"?>
10
11  <title>Libcap-&libcap-version;</title>
12
13  <indexterm zone="ch-system-libcap">
14    <primary sortas="a-Libcap">Libcap</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
20    <para>Libcap is a library for getting and setting POSIX.1e
21    (formerly POSIX 6) draft 15 capabilities.</para>
22
23  </sect2>
24
25  <sect2 role="installation">
26    <title>Installation of Libcap</title>
27
28    <para os="a">Compile the package:</para>
29
30<screen os="b"><userinput>make</userinput></screen>
31
32    <para os="c">This package does not come with a test suite.</para>
33
34    <para os="d">Install the package:</para>
35
36<screen os="e"><userinput>make RAISE_SETFCAP=no install
37chmod -v 755 /lib/libcap.so.&libcap-version;
38ln -sfv ../../lib/$(readlink /lib/libcap.so) /usr/lib/libcap.so
39rm -v /lib/libcap.so
40mv -v /lib/libcap.a /usr/lib</userinput></screen>
41
42    <variablelist os="f">
43      <title>The meaning of the make option:</title>
44
45      <varlistentry>
46        <term><parameter>RAISE_SETFCAP=no</parameter></term>
47        <listitem>
48          <para>This prevents <command>setcap</command> from being run on
49          itself, which will fail if the kernel or file system does not
50          support extended capabilities.</para>
51        </listitem>
52      </varlistentry>
53
54    </variablelist>
55
56  </sect2>
57
58  <sect2 id="contents-libcap" role="content">
59    <title>Contents of Libcap</title>
60
61    <segmentedlist>
62      <segtitle>Installed programs</segtitle>
63      <segtitle>Installed libraries</segtitle>
64
65      <seglistitem>
66        <seg>capsh, getcap, getpcaps, setcap</seg>
67        <seg>libcap.[a,so]</seg>
68      </seglistitem>
69    </segmentedlist>
70
71    <variablelist>
72      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
73      <?dbfo list-presentation="list"?>
74      <?dbhtml list-presentation="table"?>
75
76      <varlistentry id="capsh">
77        <term><command>capsh</command></term>
78        <listitem>
79          <para>Capability support and use can be explored and constrained
80          with this tool</para>
81          <indexterm zone="ch-system-libcap capsh">
82            <primary sortas="b-capsh">capsh</primary>
83          </indexterm>
84        </listitem>
85      </varlistentry>
86
87      <varlistentry id="getcap">
88        <term><command>getcap</command></term>
89        <listitem>
90          <para>Examines file capabilities</para>
91          <indexterm zone="ch-system-libcap getcap">
92            <primary sortas="b-getcap">getcap</primary>
93          </indexterm>
94        </listitem>
95      </varlistentry>
96
97      <varlistentry id="getpcaps">
98        <term><command>getpcaps</command></term>
99        <listitem>
100          <para>Displays the capabilities on the queried process(es)</para>
101          <indexterm zone="ch-system-libcap getpcaps">
102            <primary sortas="b-getpcaps">getpcaps</primary>
103          </indexterm>
104        </listitem>
105      </varlistentry>
106
107      <varlistentry id="setcap">
108        <term><command>setcap</command></term>
109        <listitem>
110          <para>Sets file capabilities</para>
111          <indexterm zone="ch-system-libcap setcap">
112            <primary sortas="b-setcap">setcap</primary>
113          </indexterm>
114        </listitem>
115      </varlistentry>
116
117      <varlistentry id="libcap">
118        <term><filename class="libraryfile">libcap</filename></term>
119        <listitem>
120          <para>Library for setting and clearing POSIX.1e capabilities</para>
121          <indexterm zone="ch-system-libcap libcap">
122            <primary sortas="c-libcap">libcap</primary>
123          </indexterm>
124        </listitem>
125      </varlistentry>
126
127    </variablelist>
128
129  </sect2>
130
131</sect1>
Note: See TracBrowser for help on using the repository browser.