← Back to branch summary

~serge-hallyn/ubuntu/quantal/lxc/lxc-fixapi

« back to all changes in this revision

Viewing changes to debian/README.Debian

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Baumann
  • Date: 2011-07-13 01:36:32 UTC
  • mto: This revision was merged to the branch mainline in revision 24.
  • Revision ID: james.westby@ubuntu.com-20110713013632-qg3vm7owezabdiaz
Tags: 0.7.4.2-1
http://bugs.debian.org/618928
* Taking over lxc together with Jonas, Guido is MIA.
* Removing useless whitespaces at EOL and EOF.
* Removing vcs field.
* Removing git-buildpackage conffile.
* Removing watch file.
* Updating to standards version 3.9.2.
* Moving from cdbs to debhelper version 8.
* Removing pre-squeeze version from libcap-dev build-depends.
* Sorting depends field.
* Adding debootstrap to recommends.
* Rewrite copyright file in machine-interpretable format.
* Prefixing debhelper files with package name.
* Removing lxc.docs, currently the references files do not contain
  useful information.
* Adding options file for dpkg source format.
* Rediffing libdir patch.
* Adding lxc wrapper script.
* Adding lxc-list script.
* Simplyfing manpages debhelper file.
* Adding patch to avoid FTBFS when building twice in a row (Closes:
  #615485).
* Rewriting README.Debian (Closes: #618928).
* Sorting debhelper dirs file.
* Including examples from upstream documentation.
* Adding patch for debian template to also disable module-init-tools
  initscript.
* Removing superfluous section field.
* Adding todo file.

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/README.Debian
1
 
lxc for Debian
2
 
--------------
3
 
 
4
 
You need to be running at least Linux 2.6.29 or above to fully avail of this
5
 
package. Previous versions of Linux have some but not all the needed features,
6
 
and even when applying patches won't allow using sysfs and network namespaces
7
 
at the same time, thus providing a very limited experience. You can use the
8
 
provided lxc-checkconfig to check for missing kernel features in a kernel
9
 
config file.
10
 
 
11
 
If you want to experiment with containers either wait for Debian to provide the
12
 
correct kernel version or build your own kernel.
13
 
 
14
 
If you want to make container usable by non-root users, run lxc-setcap as root,
15
 
and some capabilities will be set so that normal users will be able to use the
16
 
container utils. This is not done by default, though, and you have to
17
 
explicitly allow it.
18
 
 
19
 
lxc uses the control groups file system to control the various container
20
 
features. In order for this to work the cgroup filesystem must be mounted
21
 
somewhere. The exact location doesn't matter, as lxc will scan the mounted
22
 
filesystems list to find it automatically. For example you can create the
23
 
/var/local/cgroup directory and then add this entry to fstab to mount the
24
 
control groups filesystem there:
25
 
 
26
 
        cgroup  /var/local/cgroup  cgroup  defaults  0  0
27
 
 
28
 
 
29
 
Autostart containers on boot
30
 
----------------------------
31
 
 
32
 
If you want to start lxc containers on boot you have to create a symlink from
33
 
the /etc/lxc/auto directory to your lxc configuration.
34
 
 
35
 
        ln -s /etc/lxc/bar.conf /etc/lxc/auto/bar.conf
36
 
 
37
 
 -- Guido Trotter <ultrotter@debian.org>  Fri, 12 Jun 2009 15:13:55 +0100