lxc: High level Haskell bindings to LXC (Linux containers).
Modules
[Index]
Downloads
- lxc-0.2.tar.gz [browse] (Cabal source package)
- Package description (as included in the package)
Maintainer's Corner
For package maintainers and hackage trustees
Candidates
| Versions [RSS] | 0.1, 0.1.1, 0.2, 0.3, 0.3.1, 0.3.1.1, 0.3.2 |
|---|---|
| Change log | CHANGELOG.md |
| Dependencies | base (>=4.7 && <4.8), bindings-lxc (>=0.2 && <0.3) [details] |
| License | BSD-3-Clause |
| Author | Nickolay Kudasov |
| Maintainer | nickolay.kudasov@gmail.com |
| Category | System |
| Home page | https://github.com/fizruk/lxc |
| Bug tracker | https://github.com/fizruk/lxc/issues |
| Source repo | head: git clone https://github.com/fizruk/lxc.git -b master |
| Uploaded | by NickolayKudasov at 2014-09-28T00:51:04Z |
| Distributions | NixOS:0.3.2 |
| Reverse Dependencies | 1 direct, 0 indirect [details] |
| Downloads | 4492 total (17 in the last 30 days) |
| Rating | (no votes yet) [estimated by Bayesian average] |
| Your Rating | |
| Status | Docs uploaded by user Build status unknown [no reports yet] |
Readme for lxc-0.2
[back to package description]lxc
High level Haskell bindings to LXC (Linux containers).
The library provides Haskell LXC API, wrapping <http://hackage.haskell.org/package/bindings-lxc bindings-lxc package>.
Requirements
Before installation make sure you have LXC installed on your system with header files and static library.
On Ubuntu 14.04 LTS (Trusty Tahr):
$ sudo apt-get install lxc-dev
On previous Ubuntu versions (including 12.04 LTS Precise Pangolin) standard repositories do not contain liblxc1 package.
You might want to use ppa:ubuntu-lxc/stable repository instead:
$ sudo apt-get install software-properties-common python-software-properties
$ sudo add-apt-repository ppa:ubuntu-lxc/stable
$ sudo apt-get update
$ sudo apt-get install lxc-dev
Installation
Get the latest stable version from Hackage:
$ cabal install lxc
or clone this repository:
$ git clone https://github.com/fizruk/lxc.git
$ cd lxc
$ cabal install
Documentation
Haddock documentation is available at http://fizruk.github.io/lxc/docs/
Usage
You can start using these bindings just like command line tool:
>>> trusty <- mkContainer "trusty" Nothing
>>> create trusty "download" Nothing Nothing [] ["-d", "ubuntu", "-r", "trusty", "-a", "amd64"]
Using image from local cache
Unpacking the rootfs
---
You just created an Ubuntu container (release=trusty, arch=amd64, variant=default)
The default username/password is: ubuntu / ubuntu
To gain root privileges, please use sudo.
True
>>> start trusty False []
True
>>> state trusty
ContainerRunning
>>> attachRunWait trusty defaultAttachOptions "echo" ["echo", "Hello, world!"]
Hello, world!
Just ExitSuccess
>>> stop trusty
True
>>> trustySnap <- clone trusty (Just "trusty-snap") Nothing [CloneSnapshot] Nothing Nothing Nothing []
>>> start trustySnap False []
True
>>> getInterfaces trustySnap
["eth0","lo"]
>>> getIPs trustySnap "eth0" "inet" 0
["10.0.3.135"]
>>> shutdown trustySnap (-1)
True
>>> state trustySnap
ContainerStopped
Contributing
Contributions and bug reports are welcome!
Please feel free to contact me via GitHub or on the #haskell IRC channel on irc.freenode.net.
-Nickolay Kudasov