glfs/general/sysutils/bubblewrap.xml
Bruce Dubbs 66d551c5da Tag a lot of utilities and libraries
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24245 af4574ff-66df-0310-9fd7-8a98e5e911e0
2021-02-20 19:35:58 +00:00

147 lines
4.1 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 bubblewrap-download-http "https://github.com/projectatomic/bubblewrap/releases/download/v&bubblewrap-version;/bubblewrap-&bubblewrap-version;.tar.xz">
<!ENTITY bubblewrap-download-ftp " ">
<!ENTITY bubblewrap-md5sum "1104b0e43006f22076b5057c129939c8">
<!ENTITY bubblewrap-size "212 KB">
<!ENTITY bubblewrap-buildsize "2.1 MB">
<!ENTITY bubblewrap-time "less than 0.1 SBU">
]>
<sect1 id="bubblewrap" xreflabel="bubblewrap-&bubblewrap-version;">
<?dbhtml filename="bubblewrap.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<title>Bubblewrap-&bubblewrap-version;</title>
<indexterm zone="bubblewrap">
<primary sortas="a-bubblewrap">bubblewrap</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to Bubblewrap</title>
<para>
<application>Bubblewrap</application> is a setuid implementation of user
namespaces, or sandboxing, that provides access to a subset of kernel
user namespace features. Bubblewrap allows user owned processes to run in
an isolated environment with limited access to the underlying filesystem.
<!-- Thanks for the reword DJ -->
</para>
&lfs101_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>
Download (HTTP): <ulink url="&bubblewrap-download-http;"/>
</para>
</listitem>
<listitem>
<para>
Download (FTP): <ulink url="&bubblewrap-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>
Download MD5 sum: &bubblewrap-md5sum;
</para>
</listitem>
<listitem>
<para>
Download size: &bubblewrap-size;
</para>
</listitem>
<listitem>
<para>
Estimated disk space required: &bubblewrap-buildsize;
</para>
</listitem>
<listitem>
<para>
Estimated build time: &bubblewrap-time;
</para>
</listitem>
</itemizedlist>
<para condition="html" role="usernotes">
User Notes: <ulink url="&blfs-wiki;/bubblewrap"/>
</para>
</sect2>
<!-- NOTE: There is a possiblity of kernel configuration being required (see Xi's comment in #11090).
So far, I have not observed this, but that doesn't mean that it still might not be needed in practice. -->
<sect2 role="installation">
<title>Installation of Bubblewrap</title>
<para>
Install <application>Bubblewrap</application> by running the following
commands:
</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</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>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Program</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>
bwrap
</seg>
<seg>
None
</seg>
<seg>
None
</seg>
</seglistitem>
</segmentedlist>
<variablelist>
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
<?dbfo list-presentation="list"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="bwrap">
<term><command>bwrap</command></term>
<listitem>
<para>
generates a sandbox for a program to run in
</para>
<indexterm zone="bubblewrap bwrap">
<primary sortas="b-bwrap">bwrap</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>