From 4ac21b5fd307bc10594b3da4ebbfd911582a13ce Mon Sep 17 00:00:00 2001 From: Alexander Morozov Date: Mon, 22 Jun 2015 10:34:38 -0700 Subject: [PATCH] Remove nsinit from libcontainer README.md Signed-off-by: Alexander Morozov --- libcontainer/README.md | 53 ------------------------------------------ 1 file changed, 53 deletions(-) diff --git a/libcontainer/README.md b/libcontainer/README.md index 26bb82dd..6ff69c94 100644 --- a/libcontainer/README.md +++ b/libcontainer/README.md @@ -135,40 +135,6 @@ container.Resume() ``` -#### nsinit - -`nsinit` is a cli application which demonstrates the use of libcontainer. -It is able to spawn new containers or join existing containers. A root -filesystem must be provided for use along with a container configuration file. - -To build `nsinit`, run `make binary`. It will save the binary into -`bundles/nsinit`. - -To use `nsinit`, cd into a Linux rootfs and copy a `container.json` file into -the directory with your specified configuration. Environment, networking, -and different capabilities for the container are specified in this file. -The configuration is used for each process executed inside the container. - -See the `sample_configs` folder for examples of what the container configuration should look like. - -To execute `/bin/bash` in the current directory as a container just run the following **as root**: -```bash -nsinit exec --tty /bin/bash -``` - -If you wish to spawn another process inside the container while your -current bash session is running, run the same command again to -get another bash shell (or change the command). If the original -process (PID 1) dies, all other processes spawned inside the container -will be killed and the namespace will be removed. - -You can identify if a process is running in a container by -looking to see if `state.json` is in the root of the directory. - -You may also specify an alternate root place where -the `container.json` file is read and where the `state.json` file will be saved. - - #### Checkpoint & Restore libcontainer now integrates [CRIU](http://criu.org/) for checkpointing and restoring containers. @@ -180,25 +146,6 @@ If you don't already have `criu` installed, you can build it from source, follo [online instructions](http://criu.org/Installation). `criu` is also installed in the docker image generated when building libcontainer with docker. -To try an example with `nsinit`, open two terminals to the same busybox directory. -In the first terminal, run a command like this one: -```bash -nsinit exec -- sh -c 'i=0; while true; do echo $i; i=$(expr $i + 1); sleep 1; done' -``` - -You should see logs printing to the terminal every second. Now, in the second terminal, run: -```bash -nsinit checkpoint --image-path=/tmp/criu -``` - -The logs in your first terminal will stop and the process will exit. Finally, in the second -terminal, run the restore command: -```bash -nsinit restore --image-path=/tmp/criu -``` - -The process will resume counting where it left off and printing to the new terminal window. - #### Future See the [roadmap](ROADMAP.md).