diff --git a/assets/asciicast/docs-create-create.js b/assets/asciicast/docs-create-create.js
new file mode 100755
index 0000000..9fc8612
--- /dev/null
+++ b/assets/asciicast/docs-create-create.js
@@ -0,0 +1,1406 @@
+{
+ "version": 1,
+ "title": null,
+ "stdout": [
+ [
+ 0.006375,
+ "$ "
+ ],
+ [
+ 0.75,
+ "C"
+ ],
+ [
+ 0.237001,
+ "r"
+ ],
+ [
+ 0.093119,
+ "e"
+ ],
+ [
+ 0.056858,
+ "a"
+ ],
+ [
+ 0.153321,
+ "t"
+ ],
+ [
+ 0.067795,
+ "e"
+ ],
+ [
+ 0.165098,
+ " "
+ ],
+ [
+ 0.104024,
+ "a"
+ ],
+ [
+ 0.293599,
+ " "
+ ],
+ [
+ 0.178726,
+ "n"
+ ],
+ [
+ 0.085368,
+ "e"
+ ],
+ [
+ 0.058578,
+ "w"
+ ],
+ [
+ 0.171709,
+ " "
+ ],
+ [
+ 0.307199,
+ "b"
+ ],
+ [
+ 0.16744,
+ "l"
+ ],
+ [
+ 0.178825,
+ "a"
+ ],
+ [
+ 0.174825,
+ "n"
+ ],
+ [
+ 0.209582,
+ "k"
+ ],
+ [
+ 0.092659,
+ " "
+ ],
+ [
+ 0.163021,
+ "i"
+ ],
+ [
+ 0.14599,
+ "m"
+ ],
+ [
+ 0.08163,
+ "a"
+ ],
+ [
+ 0.100177,
+ "g"
+ ],
+ [
+ 0.120572,
+ "e"
+ ],
+ [
+ 0.150055,
+ " "
+ ],
+ [
+ 0.75,
+ "^C\r\n$ "
+ ],
+ [
+ 0.75,
+ "l"
+ ],
+ [
+ 0.077617,
+ "s"
+ ],
+ [
+ 0.301959,
+ " "
+ ],
+ [
+ 0.450332,
+ "-"
+ ],
+ [
+ 0.349352,
+ "l"
+ ],
+ [
+ 0.224574,
+ "\r\n"
+ ],
+ [
+ 0.002424,
+ "total 0"
+ ],
+ [
+ 8.3e-05,
+ "\r\n"
+ ],
+ [
+ 0.000407,
+ "$ "
+ ],
+ [
+ 0.516921,
+ "s"
+ ],
+ [
+ 0.093723,
+ "i"
+ ],
+ [
+ 0.121665,
+ "n"
+ ],
+ [
+ 0.037595,
+ "g"
+ ],
+ [
+ 0.088646,
+ "ularity "
+ ],
+ [
+ 0.427994,
+ "c"
+ ],
+ [
+ 0.212552,
+ "r"
+ ],
+ [
+ 0.093408,
+ "e"
+ ],
+ [
+ 0.547136,
+ "a"
+ ],
+ [
+ 0.288736,
+ "t"
+ ],
+ [
+ 0.073197,
+ "e"
+ ],
+ [
+ 0.543654,
+ " "
+ ],
+ [
+ 0.75,
+ "c"
+ ],
+ [
+ 0.126212,
+ "o"
+ ],
+ [
+ 0.436897,
+ "n"
+ ],
+ [
+ 0.235564,
+ "t"
+ ],
+ [
+ 0.093437,
+ "a"
+ ],
+ [
+ 0.539124,
+ "i"
+ ],
+ [
+ 0.169861,
+ "n"
+ ],
+ [
+ 0.095803,
+ "e"
+ ],
+ [
+ 0.089894,
+ "r"
+ ],
+ [
+ 0.222384,
+ "."
+ ],
+ [
+ 0.168913,
+ "i"
+ ],
+ [
+ 0.149744,
+ "m"
+ ],
+ [
+ 0.091655,
+ "g"
+ ],
+ [
+ 0.75,
+ "\r\n"
+ ],
+ [
+ 0.018232,
+ "Initializing Singularity image subsystem"
+ ],
+ [
+ 7.4e-05,
+ "\r\n"
+ ],
+ [
+ 5.4e-05,
+ "Opening image file: container.img"
+ ],
+ [
+ 3.8e-05,
+ "\r\n"
+ ],
+ [
+ 0.00012,
+ "Creating 768MiB image"
+ ],
+ [
+ 5.8e-05,
+ "\r\n"
+ ],
+ [
+ 0.000589,
+ "Binding image to loop"
+ ],
+ [
+ 8.9e-05,
+ "\r\n"
+ ],
+ [
+ 0.01261,
+ "Creating file system within image"
+ ],
+ [
+ 0.000427,
+ "\r\n"
+ ],
+ [
+ 0.75,
+ "Image is done: container.img"
+ ],
+ [
+ 0.000322,
+ "\r\n$ "
+ ],
+ [
+ 0.75,
+ "l"
+ ],
+ [
+ 0.094023,
+ "s"
+ ],
+ [
+ 0.089315,
+ " "
+ ],
+ [
+ 0.75,
+ "-"
+ ],
+ [
+ 0.327085,
+ "l"
+ ],
+ [
+ 0.251377,
+ "\r\n"
+ ],
+ [
+ 0.004858,
+ "total 29096"
+ ],
+ [
+ 0.000155,
+ "\r\n"
+ ],
+ [
+ 0.000362,
+ "-rwxr-xr-x 1 david david 805306400 Apr 15 14:48 container.img"
+ ],
+ [
+ 7.8e-05,
+ "\r\n"
+ ],
+ [
+ 0.000703,
+ "$ "
+ ],
+ [
+ 0.75,
+ "C"
+ ],
+ [
+ 0.75,
+ "r"
+ ],
+ [
+ 0.054907,
+ "e"
+ ],
+ [
+ 0.115628,
+ "a"
+ ],
+ [
+ 0.171757,
+ "t"
+ ],
+ [
+ 0.048735,
+ "e"
+ ],
+ [
+ 0.205661,
+ " "
+ ],
+ [
+ 0.311575,
+ "a"
+ ],
+ [
+ 0.188929,
+ " "
+ ],
+ [
+ 0.466968,
+ "\b\u001b[K"
+ ],
+ [
+ 0.21773,
+ "n"
+ ],
+ [
+ 0.134896,
+ "o"
+ ],
+ [
+ 0.196683,
+ "t"
+ ],
+ [
+ 0.071411,
+ "h"
+ ],
+ [
+ 0.089863,
+ "e"
+ ],
+ [
+ 0.069992,
+ "r"
+ ],
+ [
+ 0.060827,
+ " "
+ ],
+ [
+ 0.212044,
+ "i"
+ ],
+ [
+ 0.349349,
+ "m"
+ ],
+ [
+ 0.142102,
+ "a"
+ ],
+ [
+ 0.07242,
+ "g"
+ ],
+ [
+ 0.105834,
+ "e"
+ ],
+ [
+ 0.106905,
+ " "
+ ],
+ [
+ 0.355848,
+ "o"
+ ],
+ [
+ 0.067701,
+ "f"
+ ],
+ [
+ 0.085838,
+ " "
+ ],
+ [
+ 0.184015,
+ "a"
+ ],
+ [
+ 0.121633,
+ " "
+ ],
+ [
+ 0.591131,
+ "d"
+ ],
+ [
+ 0.202471,
+ "i"
+ ],
+ [
+ 0.110105,
+ "f"
+ ],
+ [
+ 0.100295,
+ "f"
+ ],
+ [
+ 0.193541,
+ "e"
+ ],
+ [
+ 0.062909,
+ "r"
+ ],
+ [
+ 0.111185,
+ "e"
+ ],
+ [
+ 0.065047,
+ "n"
+ ],
+ [
+ 0.511052,
+ "t"
+ ],
+ [
+ 0.155812,
+ " "
+ ],
+ [
+ 0.197481,
+ "s"
+ ],
+ [
+ 0.087051,
+ "i"
+ ],
+ [
+ 0.115813,
+ "z"
+ ],
+ [
+ 0.15878,
+ "e"
+ ],
+ [
+ 0.75,
+ " "
+ ],
+ [
+ 0.56738,
+ "^C"
+ ],
+ [
+ 0.000184,
+ "\r\n"
+ ],
+ [
+ 4.5e-05,
+ "$ "
+ ],
+ [
+ 0.75,
+ "s"
+ ],
+ [
+ 0.097137,
+ "i"
+ ],
+ [
+ 0.125171,
+ "n"
+ ],
+ [
+ 0.097659,
+ "gularity "
+ ],
+ [
+ 0.707895,
+ "c"
+ ],
+ [
+ 0.356036,
+ "r"
+ ],
+ [
+ 0.053579,
+ "e"
+ ],
+ [
+ 0.463374,
+ "a"
+ ],
+ [
+ 0.354365,
+ "t"
+ ],
+ [
+ 0.054917,
+ "e"
+ ],
+ [
+ 0.75,
+ "\u0007"
+ ],
+ [
+ 0.453539,
+ " "
+ ],
+ [
+ 0.75,
+ "-"
+ ],
+ [
+ 0.111738,
+ "-"
+ ],
+ [
+ 0.06651,
+ "s"
+ ],
+ [
+ 0.16922,
+ "i"
+ ],
+ [
+ 0.062181,
+ "z"
+ ],
+ [
+ 0.136757,
+ "e"
+ ],
+ [
+ 0.75,
+ " "
+ ],
+ [
+ 0.75,
+ "2"
+ ],
+ [
+ 0.12942,
+ "0"
+ ],
+ [
+ 0.75,
+ "1"
+ ],
+ [
+ 0.75,
+ "\b\u001b[K"
+ ],
+ [
+ 0.75,
+ "4"
+ ],
+ [
+ 0.75,
+ "8"
+ ],
+ [
+ 0.107876,
+ " "
+ ],
+ [
+ 0.75,
+ "o"
+ ],
+ [
+ 0.449353,
+ "\b\u001b[K"
+ ],
+ [
+ 0.055978,
+ "c"
+ ],
+ [
+ 0.450814,
+ "ontainer.img "
+ ],
+ [
+ 0.75,
+ "\b"
+ ],
+ [
+ 0.126648,
+ "\b"
+ ],
+ [
+ 0.139107,
+ "\b"
+ ],
+ [
+ 0.141361,
+ "\b"
+ ],
+ [
+ 0.172022,
+ "\b"
+ ],
+ [
+ 0.75,
+ "\u001b[1@2"
+ ],
+ [
+ 0.72229,
+ "\r\n"
+ ],
+ [
+ 0.040161,
+ "Initializing Singularity image subsystem"
+ ],
+ [
+ 0.003565,
+ "\r\n"
+ ],
+ [
+ 8.8e-05,
+ "Opening image file: container2.img"
+ ],
+ [
+ 5.4e-05,
+ "\r\n"
+ ],
+ [
+ 0.000132,
+ "Creating 2048MiB image"
+ ],
+ [
+ 5.5e-05,
+ "\r\n"
+ ],
+ [
+ 0.001433,
+ "Binding image to loop"
+ ],
+ [
+ 6.2e-05,
+ "\r\n"
+ ],
+ [
+ 0.00737,
+ "Creating file system within image"
+ ],
+ [
+ 0.003173,
+ "\r\n"
+ ],
+ [
+ 0.75,
+ "Image is done: container2.img"
+ ],
+ [
+ 0.002726,
+ "\r\n"
+ ],
+ [
+ 0.023297,
+ "$ "
+ ],
+ [
+ 0.73048,
+ "l"
+ ],
+ [
+ 0.097564,
+ "s"
+ ],
+ [
+ 0.155782,
+ " "
+ ],
+ [
+ 0.75,
+ "-"
+ ],
+ [
+ 0.431724,
+ "l"
+ ],
+ [
+ 0.729244,
+ "\r\n"
+ ],
+ [
+ 0.009393,
+ "total 128336"
+ ],
+ [
+ 0.004445,
+ "\r\n"
+ ],
+ [
+ 0.000325,
+ "-rwxr-xr-x 1 david david 2147483680 Apr 15 14:49 container2.img"
+ ],
+ [
+ 0.000112,
+ "\r\n"
+ ],
+ [
+ 0.000127,
+ "-rwxr-xr-x 1 david david 805306400 Apr 15 14:48 container.img"
+ ],
+ [
+ 9.4e-05,
+ "\r\n"
+ ],
+ [
+ 0.000629,
+ "$ "
+ ],
+ [
+ 0.75,
+ "O"
+ ],
+ [
+ 0.152355,
+ "v"
+ ],
+ [
+ 0.119684,
+ "e"
+ ],
+ [
+ 0.1154,
+ "r"
+ ],
+ [
+ 0.56644,
+ "w"
+ ],
+ [
+ 0.198355,
+ "r"
+ ],
+ [
+ 0.110866,
+ "i"
+ ],
+ [
+ 0.104835,
+ "t"
+ ],
+ [
+ 0.103056,
+ "e"
+ ],
+ [
+ 0.122929,
+ " "
+ ],
+ [
+ 0.164125,
+ "t"
+ ],
+ [
+ 0.132013,
+ "e"
+ ],
+ [
+ 0.044031,
+ "h"
+ ],
+ [
+ 0.711717,
+ "\b\u001b[K"
+ ],
+ [
+ 0.116973,
+ "\b\u001b[K"
+ ],
+ [
+ 0.258457,
+ "h"
+ ],
+ [
+ 0.042116,
+ "e"
+ ],
+ [
+ 0.127611,
+ " "
+ ],
+ [
+ 0.169818,
+ "s"
+ ],
+ [
+ 0.274025,
+ "e"
+ ],
+ [
+ 0.238785,
+ "c"
+ ],
+ [
+ 0.093926,
+ "o"
+ ],
+ [
+ 0.116372,
+ "n"
+ ],
+ [
+ 0.09433,
+ "d"
+ ],
+ [
+ 0.123126,
+ " "
+ ],
+ [
+ 0.145092,
+ "c"
+ ],
+ [
+ 0.143939,
+ "o"
+ ],
+ [
+ 0.190032,
+ "n"
+ ],
+ [
+ 0.094055,
+ "t"
+ ],
+ [
+ 0.17513,
+ "a"
+ ],
+ [
+ 0.186402,
+ "i"
+ ],
+ [
+ 0.152056,
+ "n"
+ ],
+ [
+ 0.066596,
+ "e"
+ ],
+ [
+ 0.076273,
+ "r"
+ ],
+ [
+ 0.129809,
+ " "
+ ],
+ [
+ 0.151857,
+ "w"
+ ],
+ [
+ 0.065961,
+ "i"
+ ],
+ [
+ 0.09303,
+ "t"
+ ],
+ [
+ 0.138045,
+ "h"
+ ],
+ [
+ 0.104759,
+ " "
+ ],
+ [
+ 0.176367,
+ "a"
+ ],
+ [
+ 0.111035,
+ " "
+ ],
+ [
+ 0.133887,
+ "s"
+ ],
+ [
+ 0.300069,
+ "m"
+ ],
+ [
+ 0.124399,
+ "a"
+ ],
+ [
+ 0.081294,
+ "l"
+ ],
+ [
+ 0.126944,
+ "l"
+ ],
+ [
+ 0.092589,
+ "e"
+ ],
+ [
+ 0.101876,
+ "r"
+ ],
+ [
+ 0.073664,
+ " "
+ ],
+ [
+ 0.176321,
+ "o"
+ ],
+ [
+ 0.117131,
+ "n"
+ ],
+ [
+ 0.073415,
+ "e"
+ ],
+ [
+ 0.378195,
+ " "
+ ],
+ [
+ 0.75,
+ "^C"
+ ],
+ [
+ 0.000111,
+ "\r\n"
+ ],
+ [
+ 2.4e-05,
+ "$ "
+ ],
+ [
+ 0.75,
+ "s"
+ ],
+ [
+ 0.066824,
+ "i"
+ ],
+ [
+ 0.126558,
+ "n"
+ ],
+ [
+ 0.102613,
+ "gularity "
+ ],
+ [
+ 0.708009,
+ "c"
+ ],
+ [
+ 0.333599,
+ "r"
+ ],
+ [
+ 0.108932,
+ "e"
+ ],
+ [
+ 0.620661,
+ "a"
+ ],
+ [
+ 0.497218,
+ "\b\u001b[K"
+ ],
+ [
+ 0.036042,
+ "e"
+ ],
+ [
+ 0.596923,
+ "\b\u001b[K"
+ ],
+ [
+ 0.079338,
+ "e"
+ ],
+ [
+ 0.201419,
+ "a"
+ ],
+ [
+ 0.252641,
+ "t"
+ ],
+ [
+ 0.092146,
+ "e"
+ ],
+ [
+ 0.310043,
+ "\b\u001b[K"
+ ],
+ [
+ 0.155522,
+ "\b\u001b[K"
+ ],
+ [
+ 0.149519,
+ "\b\u001b[K"
+ ],
+ [
+ 0.182727,
+ "\b\u001b[K"
+ ],
+ [
+ 0.027408,
+ "a"
+ ],
+ [
+ 0.507037,
+ "t"
+ ],
+ [
+ 0.097218,
+ "e"
+ ],
+ [
+ 0.75,
+ " "
+ ],
+ [
+ 0.481318,
+ "-"
+ ],
+ [
+ 0.123577,
+ "-"
+ ],
+ [
+ 0.051832,
+ "s"
+ ],
+ [
+ 0.215375,
+ "i"
+ ],
+ [
+ 0.061598,
+ "z"
+ ],
+ [
+ 0.140151,
+ "e"
+ ],
+ [
+ 0.246941,
+ " "
+ ],
+ [
+ 0.75,
+ "5"
+ ],
+ [
+ 0.203041,
+ "1"
+ ],
+ [
+ 0.140565,
+ "2"
+ ],
+ [
+ 0.262182,
+ " "
+ ],
+ [
+ 0.44956,
+ "c"
+ ],
+ [
+ 0.162339,
+ "o"
+ ],
+ [
+ 0.155009,
+ "n"
+ ],
+ [
+ 0.163077,
+ "\u0007"
+ ],
+ [
+ 0.000138,
+ "tainer"
+ ],
+ [
+ 0.75,
+ "2"
+ ],
+ [
+ 0.457125,
+ ".img "
+ ],
+ [
+ 0.75,
+ "\b"
+ ],
+ [
+ 0.19183,
+ "\b"
+ ],
+ [
+ 0.099522,
+ "\b"
+ ],
+ [
+ 0.501479,
+ "\b"
+ ],
+ [
+ 0.030761,
+ "\b"
+ ],
+ [
+ 0.031113,
+ "\b"
+ ],
+ [
+ 0.030566,
+ "\b"
+ ],
+ [
+ 0.030514,
+ "\b"
+ ],
+ [
+ 0.029834,
+ "\b"
+ ],
+ [
+ 0.03061,
+ "\b"
+ ],
+ [
+ 0.031643,
+ "\b"
+ ],
+ [
+ 0.118067,
+ "\b"
+ ],
+ [
+ 0.151165,
+ "\b"
+ ],
+ [
+ 0.130251,
+ "\b"
+ ],
+ [
+ 0.143637,
+ "\b"
+ ],
+ [
+ 0.75,
+ "\u001b[1@-"
+ ],
+ [
+ 0.128135,
+ "\u001b[1@-"
+ ],
+ [
+ 0.045087,
+ "\u001b[1@f"
+ ],
+ [
+ 0.341065,
+ "\u001b[1@o"
+ ],
+ [
+ 0.09898,
+ "\u001b[1@r"
+ ],
+ [
+ 0.381913,
+ "\u001b[C\u001b[1@c\b"
+ ],
+ [
+ 0.188899,
+ "\u001b[1@e"
+ ],
+ [
+ 0.230778,
+ "\u001b[1@ "
+ ],
+ [
+ 0.75,
+ "\r\n"
+ ],
+ [
+ 0.074109,
+ "Initializing Singularity image subsystem"
+ ],
+ [
+ 4.8e-05,
+ "\r\n"
+ ],
+ [
+ 4.5e-05,
+ "Opening image file: container2.img"
+ ],
+ [
+ 3.1e-05,
+ "\r\n"
+ ],
+ [
+ 7.3e-05,
+ "Creating 512MiB image"
+ ],
+ [
+ 3.2e-05,
+ "\r\n"
+ ],
+ [
+ 0.000273,
+ "Binding image to loop"
+ ],
+ [
+ 3.2e-05,
+ "\r\n"
+ ],
+ [
+ 0.009835,
+ "Creating file system within image"
+ ],
+ [
+ 0.000358,
+ "\r\n"
+ ],
+ [
+ 0.75,
+ "Image is done: container2.img"
+ ],
+ [
+ 0.000336,
+ "\r\n"
+ ],
+ [
+ 0.008239,
+ "$ "
+ ],
+ [
+ 0.75,
+ "l"
+ ],
+ [
+ 0.092536,
+ "s"
+ ],
+ [
+ 0.105809,
+ " "
+ ],
+ [
+ 0.446807,
+ "-"
+ ],
+ [
+ 0.350741,
+ "l"
+ ],
+ [
+ 0.75,
+ "\r\n"
+ ],
+ [
+ 0.010297,
+ "total 53996"
+ ],
+ [
+ 0.001328,
+ "\r\n"
+ ],
+ [
+ 0.004251,
+ "-rwxr-xr-x 1 david david 536870944 Apr 15 14:49 container2.img"
+ ],
+ [
+ 0.00028,
+ "\r\n"
+ ],
+ [
+ 0.000191,
+ "-rwxr-xr-x 1 david david 805306400 Apr 15 14:48 container.img"
+ ],
+ [
+ 0.001696,
+ "\r\n"
+ ],
+ [
+ 0.000779,
+ "$ "
+ ],
+ [
+ 0.75,
+ "e"
+ ],
+ [
+ 0.243884,
+ "x"
+ ],
+ [
+ 0.75,
+ "i"
+ ],
+ [
+ 0.192939,
+ "t"
+ ],
+ [
+ 0.75,
+ "\r\nexit"
+ ],
+ [
+ 0.000618,
+ "\r\n"
+ ]
+ ],
+ "height": 25,
+ "duration": 78.082971,
+ "env": {
+ "TERM": "xterm-256color",
+ "SHELL": "/bin/bash"
+ },
+ "width": 102,
+ "command": null
+}
\ No newline at end of file
diff --git a/assets/asciicast/docs-create-expand.js b/assets/asciicast/docs-create-expand.js
new file mode 100755
index 0000000..7da4eb2
--- /dev/null
+++ b/assets/asciicast/docs-create-expand.js
@@ -0,0 +1,382 @@
+{
+ "height": 25,
+ "duration": 14.372751,
+ "command": null,
+ "width": 102,
+ "title": null,
+ "env": {
+ "TERM": "xterm-256color",
+ "SHELL": "/bin/bash"
+ },
+ "stdout": [
+ [
+ 0.006035,
+ "$ "
+ ],
+ [
+ 0.881235,
+ "l"
+ ],
+ [
+ 0.080862,
+ "s"
+ ],
+ [
+ 0.122962,
+ " "
+ ],
+ [
+ 0.573607,
+ "-"
+ ],
+ [
+ 1.0,
+ "l"
+ ],
+ [
+ 0.201022,
+ "h"
+ ],
+ [
+ 0.288708,
+ "\r\n"
+ ],
+ [
+ 0.003654,
+ "total 29M"
+ ],
+ [
+ 0.000116,
+ "\r\n"
+ ],
+ [
+ 0.000204,
+ "-rwxr-xr-x 1 david david 769M Apr 15 21:19 container.img"
+ ],
+ [
+ 0.000141,
+ "\r\n"
+ ],
+ [
+ 0.000563,
+ "$ "
+ ],
+ [
+ 1.0,
+ "s"
+ ],
+ [
+ 0.153469,
+ "i"
+ ],
+ [
+ 0.13893,
+ "n"
+ ],
+ [
+ 0.079431,
+ "gularity "
+ ],
+ [
+ 0.548247,
+ "e"
+ ],
+ [
+ 0.228775,
+ "x"
+ ],
+ [
+ 0.317032,
+ "p"
+ ],
+ [
+ 0.108178,
+ "a"
+ ],
+ [
+ 0.237078,
+ "n"
+ ],
+ [
+ 0.252492,
+ "d"
+ ],
+ [
+ 0.15185,
+ " "
+ ],
+ [
+ 1.0,
+ "c"
+ ],
+ [
+ 0.150676,
+ "o"
+ ],
+ [
+ 0.173406,
+ "n"
+ ],
+ [
+ 0.098375,
+ "tainer.img "
+ ],
+ [
+ 1.0,
+ "\r\n"
+ ],
+ [
+ 0.014368,
+ "Initializing Singularity image subsystem"
+ ],
+ [
+ 9.4e-05,
+ "\r\n"
+ ],
+ [
+ 9.3e-05,
+ "Opening image file: container.img"
+ ],
+ [
+ 0.000117,
+ "\r\n"
+ ],
+ [
+ 0.000131,
+ "Expanding image by 768MiB"
+ ],
+ [
+ 7.3e-05,
+ "\r\n"
+ ],
+ [
+ 0.001009,
+ "Binding image to loop"
+ ],
+ [
+ 6.3e-05,
+ "\r\n"
+ ],
+ [
+ 0.001748,
+ "Checking file system"
+ ],
+ [
+ 7.5e-05,
+ "\r\n"
+ ],
+ [
+ 0.009215,
+ "e2fsck 1.42.13 (17-May-2015)"
+ ],
+ [
+ 4e-05,
+ "\r\n"
+ ],
+ [
+ 0.008689,
+ "Pass 1: Checking "
+ ],
+ [
+ 0.000114,
+ "inode"
+ ],
+ [
+ 0.001125,
+ "s, "
+ ],
+ [
+ 0.003023,
+ "block"
+ ],
+ [
+ 0.000165,
+ "s, and sizes"
+ ],
+ [
+ 5.2e-05,
+ "\r\n"
+ ],
+ [
+ 0.042993,
+ "Pass 2: Checking "
+ ],
+ [
+ 0.003016,
+ "directory"
+ ],
+ [
+ 0.00058,
+ " structure"
+ ],
+ [
+ 0.004519,
+ "\r\n"
+ ],
+ [
+ 0.000196,
+ "Pass 3: Checking "
+ ],
+ [
+ 7.6e-05,
+ "directory"
+ ],
+ [
+ 0.000108,
+ " connectivity"
+ ],
+ [
+ 5.8e-05,
+ "\r\n"
+ ],
+ [
+ 9.5e-05,
+ "Pass 4: Checking reference counts"
+ ],
+ [
+ 5.8e-05,
+ "\r\n"
+ ],
+ [
+ 0.001802,
+ "Pass 5: Checking "
+ ],
+ [
+ 0.000122,
+ "group"
+ ],
+ [
+ 0.000388,
+ " summary information"
+ ],
+ [
+ 8.8e-05,
+ "\r\n"
+ ],
+ [
+ 0.034377,
+ "/dev/loop0: 11/49152 files (0.0% non-contiguous), 7387/196608 blocks"
+ ],
+ [
+ 0.000678,
+ "\r\nResizing file system"
+ ],
+ [
+ 6.6e-05,
+ "\r\n"
+ ],
+ [
+ 0.014489,
+ "resize2fs 1.42.13 (17-May-2015)"
+ ],
+ [
+ 4.6e-05,
+ "\r\n"
+ ],
+ [
+ 0.004736,
+ "Resizing the filesystem on /dev/loop0 to 393216 (4k) blocks."
+ ],
+ [
+ 4.6e-05,
+ "\r\n"
+ ],
+ [
+ 0.439508,
+ "The filesystem on /dev/loop0 is now 393216 (4k) blocks long."
+ ],
+ [
+ 4.4e-05,
+ "\r\n"
+ ],
+ [
+ 3.8e-05,
+ "\r\n"
+ ],
+ [
+ 0.00018,
+ "Image is done: container.img"
+ ],
+ [
+ 3.4e-05,
+ "\r\n"
+ ],
+ [
+ 0.01302,
+ "$ "
+ ],
+ [
+ 1.0,
+ "l"
+ ],
+ [
+ 0.070987,
+ "s"
+ ],
+ [
+ 0.504448,
+ " "
+ ],
+ [
+ 0.460983,
+ "-"
+ ],
+ [
+ 0.439961,
+ "l"
+ ],
+ [
+ 0.22302,
+ "h"
+ ],
+ [
+ 0.264137,
+ "\r\n"
+ ],
+ [
+ 0.004506,
+ "total 797M"
+ ],
+ [
+ 0.000203,
+ "\r\n"
+ ],
+ [
+ 0.000261,
+ "-rwxr-xr-x 1 david david 1.6G Apr 15 21:21 container.img"
+ ],
+ [
+ 0.000111,
+ "\r\n"
+ ],
+ [
+ 0.000742,
+ "$ "
+ ],
+ [
+ 1.0,
+ "e"
+ ],
+ [
+ 0.20565,
+ "x"
+ ],
+ [
+ 0.099279,
+ "i"
+ ],
+ [
+ 0.381688,
+ "t"
+ ],
+ [
+ 0.31724,
+ "\r\nexit"
+ ],
+ [
+ 0.000808,
+ "\r\n"
+ ]
+ ],
+ "version": 1
+}
\ No newline at end of file
diff --git a/assets/asciicast/docs-create-mount.js b/assets/asciicast/docs-create-mount.js
new file mode 100755
index 0000000..19ab426
--- /dev/null
+++ b/assets/asciicast/docs-create-mount.js
@@ -0,0 +1,534 @@
+{
+ "width": 102,
+ "duration": 33.005069,
+ "title": null,
+ "stdout": [
+ [
+ 0.005713,
+ "$ "
+ ],
+ [
+ 1.0,
+ "m"
+ ],
+ [
+ 0.132305,
+ "k"
+ ],
+ [
+ 0.162687,
+ "d"
+ ],
+ [
+ 0.150331,
+ "i"
+ ],
+ [
+ 0.115993,
+ "r"
+ ],
+ [
+ 0.077046,
+ " "
+ ],
+ [
+ 0.543839,
+ "/"
+ ],
+ [
+ 0.369431,
+ "t"
+ ],
+ [
+ 0.099983,
+ "m"
+ ],
+ [
+ 0.227581,
+ "p"
+ ],
+ [
+ 0.863209,
+ "/"
+ ],
+ [
+ 0.161938,
+ "c"
+ ],
+ [
+ 0.185194,
+ "o"
+ ],
+ [
+ 0.604897,
+ "n"
+ ],
+ [
+ 0.217801,
+ "t"
+ ],
+ [
+ 0.194857,
+ "a"
+ ],
+ [
+ 0.069519,
+ "i"
+ ],
+ [
+ 0.207666,
+ "n"
+ ],
+ [
+ 0.130852,
+ "e"
+ ],
+ [
+ 0.103931,
+ "r"
+ ],
+ [
+ 0.762765,
+ "\r\n"
+ ],
+ [
+ 0.009401,
+ "$ "
+ ],
+ [
+ 1.0,
+ "s"
+ ],
+ [
+ 0.104575,
+ "i"
+ ],
+ [
+ 0.178755,
+ "n"
+ ],
+ [
+ 0.112844,
+ "g"
+ ],
+ [
+ 0.301535,
+ "u"
+ ],
+ [
+ 0.214305,
+ "larity "
+ ],
+ [
+ 0.544574,
+ "m"
+ ],
+ [
+ 0.172449,
+ "o"
+ ],
+ [
+ 0.077279,
+ "u"
+ ],
+ [
+ 0.203892,
+ "n"
+ ],
+ [
+ 0.127517,
+ "t"
+ ],
+ [
+ 0.150007,
+ " "
+ ],
+ [
+ 0.30886,
+ "c"
+ ],
+ [
+ 0.081739,
+ "o"
+ ],
+ [
+ 0.164639,
+ "n"
+ ],
+ [
+ 0.256722,
+ "t"
+ ],
+ [
+ 0.319364,
+ "a"
+ ],
+ [
+ 0.169358,
+ "i"
+ ],
+ [
+ 0.129353,
+ "n"
+ ],
+ [
+ 0.117324,
+ "e"
+ ],
+ [
+ 0.163155,
+ "r.img "
+ ],
+ [
+ 1.0,
+ "/"
+ ],
+ [
+ 0.502959,
+ "t"
+ ],
+ [
+ 0.151764,
+ "m"
+ ],
+ [
+ 0.217402,
+ "p"
+ ],
+ [
+ 0.154464,
+ "/"
+ ],
+ [
+ 0.560268,
+ "c"
+ ],
+ [
+ 0.092203,
+ "o"
+ ],
+ [
+ 0.151358,
+ "n"
+ ],
+ [
+ 0.107903,
+ "\u0007"
+ ],
+ [
+ 0.456053,
+ "\r\n"
+ ],
+ [
+ 0.000128,
+ "config-err-i1R48C container/ "
+ ],
+ [
+ 5.5e-05,
+ "\r\n"
+ ],
+ [
+ 9.4e-05,
+ "$ singularity mount container.img /tmp/con"
+ ],
+ [
+ 0.722564,
+ "t"
+ ],
+ [
+ 0.106396,
+ "ainer/"
+ ],
+ [
+ 1.0,
+ "\b\u001b[K"
+ ],
+ [
+ 1.0,
+ "\r\n"
+ ],
+ [
+ 0.054842,
+ "container.img is mounted at: /tmp/container"
+ ],
+ [
+ 8.5e-05,
+ "\r\n"
+ ],
+ [
+ 0.000565,
+ "\r\nSpawning a new shell in this namespace, to unmount, exit shell"
+ ],
+ [
+ 4.4e-05,
+ "\r\nSingularity: \\w> "
+ ],
+ [
+ 1.0,
+ "d"
+ ],
+ [
+ 0.150651,
+ "f"
+ ],
+ [
+ 0.607879,
+ "\r\n"
+ ],
+ [
+ 0.009116,
+ "Filesystem 1K-blocks Used Available Use% Mounted on"
+ ],
+ [
+ 0.000159,
+ "\r\n"
+ ],
+ [
+ 0.000193,
+ "/dev/sda1 16381864 12136856 3389816 79% /"
+ ],
+ [
+ 0.000108,
+ "\r\n"
+ ],
+ [
+ 0.000136,
+ "udev 2003848 0 2003848 0% /dev"
+ ],
+ [
+ 0.001582,
+ "\r\n"
+ ],
+ [
+ 0.000516,
+ "tmpfs 2023336 220 2023116 1% /dev/shm"
+ ],
+ [
+ 0.001205,
+ "\r\n"
+ ],
+ [
+ 0.000521,
+ "tmpfs 404668 6480 398188 2% /run"
+ ],
+ [
+ 0.00536,
+ "\r\n"
+ ],
+ [
+ 0.000152,
+ "tmpfs 5120 4 5116 1% /run/lock"
+ ],
+ [
+ 5.7e-05,
+ "\r\n"
+ ],
+ [
+ 5.8e-05,
+ "tmpfs 404668 60 404608 1% /run/user/1000"
+ ],
+ [
+ 4.6e-05,
+ "\r\n"
+ ],
+ [
+ 5.4e-05,
+ "tmpfs 2023336 0 2023336 0% /sys/fs/cgroup"
+ ],
+ [
+ 4.6e-05,
+ "\r\n"
+ ],
+ [
+ 9.6e-05,
+ "C_DRIVE 249749844 198235560 51514284 80% /media/sf_C_DRIVE"
+ ],
+ [
+ 4.9e-05,
+ "\r\n"
+ ],
+ [
+ 5.5e-05,
+ "/dev/loop0 757680 796 717564 1% /tmp/container"
+ ],
+ [
+ 4.5e-05,
+ "\r\n"
+ ],
+ [
+ 0.000221,
+ "Singularity: \\w> "
+ ],
+ [
+ 1.0,
+ "c"
+ ],
+ [
+ 0.171127,
+ "d"
+ ],
+ [
+ 0.097005,
+ " "
+ ],
+ [
+ 0.599008,
+ "/"
+ ],
+ [
+ 0.360826,
+ "t"
+ ],
+ [
+ 0.116553,
+ "m"
+ ],
+ [
+ 0.261498,
+ "p"
+ ],
+ [
+ 0.155168,
+ "\t"
+ ],
+ [
+ 0.663224,
+ "\b\b\b\b\b\b\b\b"
+ ],
+ [
+ 0.905313,
+ "/"
+ ],
+ [
+ 0.136031,
+ "c"
+ ],
+ [
+ 0.159623,
+ "o"
+ ],
+ [
+ 0.197144,
+ "n"
+ ],
+ [
+ 0.133157,
+ "t"
+ ],
+ [
+ 0.180236,
+ "a"
+ ],
+ [
+ 0.088244,
+ "i"
+ ],
+ [
+ 0.143398,
+ "n"
+ ],
+ [
+ 0.121608,
+ "e"
+ ],
+ [
+ 0.079556,
+ "r"
+ ],
+ [
+ 0.456576,
+ "\r\nSingularity: \\w> "
+ ],
+ [
+ 1.0,
+ "l"
+ ],
+ [
+ 0.119347,
+ "s"
+ ],
+ [
+ 0.127672,
+ " "
+ ],
+ [
+ 0.604069,
+ "-"
+ ],
+ [
+ 0.989863,
+ "a"
+ ],
+ [
+ 0.188884,
+ "\r\n"
+ ],
+ [
+ 0.003197,
+ ". .. lost+found"
+ ],
+ [
+ 0.000139,
+ "\r\n"
+ ],
+ [
+ 0.000447,
+ "Singularity: \\w> "
+ ],
+ [
+ 1.0,
+ "e"
+ ],
+ [
+ 0.255728,
+ "x"
+ ],
+ [
+ 0.170871,
+ "i"
+ ],
+ [
+ 0.510787,
+ "t"
+ ],
+ [
+ 0.976281,
+ "\r\n"
+ ],
+ [
+ 0.01524,
+ "$ "
+ ],
+ [
+ 1.0,
+ "e"
+ ],
+ [
+ 0.218475,
+ "x"
+ ],
+ [
+ 0.208106,
+ "i"
+ ],
+ [
+ 0.133197,
+ "t"
+ ],
+ [
+ 0.103986,
+ "\r\nexit"
+ ],
+ [
+ 0.000753,
+ "\r\n"
+ ]
+ ],
+ "version": 1,
+ "height": 25,
+ "env": {
+ "SHELL": "/bin/bash",
+ "TERM": "xterm-256color"
+ },
+ "command": null
+}
\ No newline at end of file
diff --git a/assets/asciicast/docs-create-rootmount.js b/assets/asciicast/docs-create-rootmount.js
new file mode 100755
index 0000000..0508e20
--- /dev/null
+++ b/assets/asciicast/docs-create-rootmount.js
@@ -0,0 +1,926 @@
+{
+ "title": null,
+ "command": null,
+ "env": {
+ "TERM": "xterm-256color",
+ "SHELL": "/bin/bash"
+ },
+ "duration": 57.489548,
+ "width": 102,
+ "height": 25,
+ "version": 1,
+ "stdout": [
+ [
+ 0.005899,
+ "$ "
+ ],
+ [
+ 0.75,
+ "t"
+ ],
+ [
+ 0.416469,
+ "o"
+ ],
+ [
+ 0.117921,
+ "u"
+ ],
+ [
+ 0.170127,
+ "c"
+ ],
+ [
+ 0.121176,
+ "h"
+ ],
+ [
+ 0.163952,
+ " "
+ ],
+ [
+ 0.358313,
+ "f"
+ ],
+ [
+ 0.073711,
+ "i"
+ ],
+ [
+ 0.189574,
+ "l"
+ ],
+ [
+ 0.11697,
+ "e"
+ ],
+ [
+ 0.556916,
+ "2"
+ ],
+ [
+ 0.311332,
+ "m"
+ ],
+ [
+ 0.163321,
+ "o"
+ ],
+ [
+ 0.199574,
+ "\u0007"
+ ],
+ [
+ 0.000108,
+ "ve2"
+ ],
+ [
+ 0.75,
+ "i"
+ ],
+ [
+ 0.194257,
+ "m"
+ ],
+ [
+ 0.650861,
+ "age "
+ ],
+ [
+ 0.75,
+ "\r\n"
+ ],
+ [
+ 0.007056,
+ "$ "
+ ],
+ [
+ 0.75,
+ "s"
+ ],
+ [
+ 0.142306,
+ "u"
+ ],
+ [
+ 0.134265,
+ "d"
+ ],
+ [
+ 0.039634,
+ "o"
+ ],
+ [
+ 0.149194,
+ " "
+ ],
+ [
+ 0.75,
+ "-"
+ ],
+ [
+ 0.36184,
+ "i"
+ ],
+ [
+ 0.75,
+ "\r\n"
+ ],
+ [
+ 0.056425,
+ "# "
+ ],
+ [
+ 0.75,
+ "s"
+ ],
+ [
+ 0.075146,
+ "i"
+ ],
+ [
+ 0.141756,
+ "n"
+ ],
+ [
+ 0.141672,
+ "gularity "
+ ],
+ [
+ 0.75,
+ "m"
+ ],
+ [
+ 0.16169,
+ "o"
+ ],
+ [
+ 0.099544,
+ "u"
+ ],
+ [
+ 0.269602,
+ "n"
+ ],
+ [
+ 0.321218,
+ "t"
+ ],
+ [
+ 0.244167,
+ " "
+ ],
+ [
+ 0.75,
+ "/"
+ ],
+ [
+ 0.466689,
+ "h"
+ ],
+ [
+ 0.09631,
+ "o"
+ ],
+ [
+ 0.190341,
+ "m"
+ ],
+ [
+ 0.109407,
+ "e"
+ ],
+ [
+ 0.75,
+ "/"
+ ],
+ [
+ 0.75,
+ "c"
+ ],
+ [
+ 0.099346,
+ "o"
+ ],
+ [
+ 0.163043,
+ "n"
+ ],
+ [
+ 0.099156,
+ "\u0007"
+ ],
+ [
+ 0.75,
+ "t"
+ ],
+ [
+ 0.362193,
+ "\b\u001b[K"
+ ],
+ [
+ 0.135107,
+ "\b\u001b[K"
+ ],
+ [
+ 0.14423,
+ "\b\u001b[K"
+ ],
+ [
+ 0.091786,
+ "d"
+ ],
+ [
+ 0.12767,
+ "\b\u001b[K"
+ ],
+ [
+ 0.25005,
+ "\b\u001b[K"
+ ],
+ [
+ 0.090597,
+ "d"
+ ],
+ [
+ 0.098411,
+ "a"
+ ],
+ [
+ 0.492566,
+ "v"
+ ],
+ [
+ 0.105753,
+ "i"
+ ],
+ [
+ 0.133057,
+ "d/"
+ ],
+ [
+ 0.511367,
+ "c"
+ ],
+ [
+ 0.103026,
+ "o"
+ ],
+ [
+ 0.181264,
+ "n"
+ ],
+ [
+ 0.258406,
+ "t"
+ ],
+ [
+ 0.75,
+ "ainer.img "
+ ],
+ [
+ 0.75,
+ "/"
+ ],
+ [
+ 0.562382,
+ "t"
+ ],
+ [
+ 0.072367,
+ "m"
+ ],
+ [
+ 0.451152,
+ "p"
+ ],
+ [
+ 0.678517,
+ "/"
+ ],
+ [
+ 0.138948,
+ "c"
+ ],
+ [
+ 0.201972,
+ "o"
+ ],
+ [
+ 0.207121,
+ "n"
+ ],
+ [
+ 0.15847,
+ "\u0007"
+ ],
+ [
+ 0.75,
+ "t"
+ ],
+ [
+ 0.161852,
+ "a"
+ ],
+ [
+ 0.090336,
+ "i"
+ ],
+ [
+ 0.185799,
+ "n"
+ ],
+ [
+ 0.087882,
+ "er/"
+ ],
+ [
+ 0.75,
+ "\b"
+ ],
+ [
+ 0.499872,
+ "\b"
+ ],
+ [
+ 0.031559,
+ "\b"
+ ],
+ [
+ 0.030797,
+ "\b"
+ ],
+ [
+ 0.029918,
+ "\b"
+ ],
+ [
+ 0.030494,
+ "\b"
+ ],
+ [
+ 0.030423,
+ "\b"
+ ],
+ [
+ 0.039111,
+ "\b"
+ ],
+ [
+ 0.034806,
+ "\b"
+ ],
+ [
+ 0.035336,
+ "\b"
+ ],
+ [
+ 0.028689,
+ "\b"
+ ],
+ [
+ 0.031327,
+ "\b"
+ ],
+ [
+ 0.030684,
+ "\b"
+ ],
+ [
+ 0.030933,
+ "\b"
+ ],
+ [
+ 0.031254,
+ "\b"
+ ],
+ [
+ 0.030925,
+ "\b"
+ ],
+ [
+ 0.031773,
+ "\b"
+ ],
+ [
+ 0.030251,
+ "\b"
+ ],
+ [
+ 0.030947,
+ "\b"
+ ],
+ [
+ 0.031003,
+ "\b"
+ ],
+ [
+ 0.031052,
+ "\b"
+ ],
+ [
+ 0.030386,
+ "\b"
+ ],
+ [
+ 0.030902,
+ "\b"
+ ],
+ [
+ 0.030624,
+ "\b"
+ ],
+ [
+ 0.031571,
+ "\b"
+ ],
+ [
+ 0.030414,
+ "\b"
+ ],
+ [
+ 0.031155,
+ "\b"
+ ],
+ [
+ 0.031035,
+ "\b"
+ ],
+ [
+ 0.031493,
+ "\b"
+ ],
+ [
+ 0.030866,
+ "\b"
+ ],
+ [
+ 0.029424,
+ "\b"
+ ],
+ [
+ 0.032113,
+ "\b"
+ ],
+ [
+ 0.031257,
+ "\b"
+ ],
+ [
+ 0.030983,
+ "\b"
+ ],
+ [
+ 0.030996,
+ "\b"
+ ],
+ [
+ 0.030997,
+ "\b"
+ ],
+ [
+ 0.029697,
+ "\b"
+ ],
+ [
+ 0.029959,
+ "\b"
+ ],
+ [
+ 0.260989,
+ "\b"
+ ],
+ [
+ 0.165379,
+ "\b"
+ ],
+ [
+ 0.155203,
+ "\b"
+ ],
+ [
+ 0.75,
+ "\u001b[1@-"
+ ],
+ [
+ 0.12293,
+ "\u001b[1@-"
+ ],
+ [
+ 0.302961,
+ "\u001b[1@w"
+ ],
+ [
+ 0.296301,
+ "\u001b[1@r"
+ ],
+ [
+ 0.152629,
+ "\u001b[1@i"
+ ],
+ [
+ 0.29319,
+ "\u001b[1@t"
+ ],
+ [
+ 0.375922,
+ "\u001b[1@a"
+ ],
+ [
+ 0.326038,
+ "\u001b[1@b"
+ ],
+ [
+ 0.138376,
+ "\u001b[1@l"
+ ],
+ [
+ 0.088197,
+ "\u001b[1@e"
+ ],
+ [
+ 0.262423,
+ "\u001b[1@ "
+ ],
+ [
+ 0.75,
+ "\r\n"
+ ],
+ [
+ 0.069346,
+ "container.img is mounted at: /tmp/container/"
+ ],
+ [
+ 8.3e-05,
+ "\r\n"
+ ],
+ [
+ 7e-05,
+ "\r\n"
+ ],
+ [
+ 0.005106,
+ "# "
+ ],
+ [
+ 0.75,
+ "c"
+ ],
+ [
+ 0.183472,
+ "d"
+ ],
+ [
+ 0.052555,
+ " "
+ ],
+ [
+ 0.75,
+ "/"
+ ],
+ [
+ 0.473757,
+ "t"
+ ],
+ [
+ 0.090884,
+ "m"
+ ],
+ [
+ 0.217232,
+ "p"
+ ],
+ [
+ 0.75,
+ "/"
+ ],
+ [
+ 0.203047,
+ "c"
+ ],
+ [
+ 0.139602,
+ "o"
+ ],
+ [
+ 0.204441,
+ "n"
+ ],
+ [
+ 0.114213,
+ "a"
+ ],
+ [
+ 0.569868,
+ "\b\u001b[K"
+ ],
+ [
+ 0.094155,
+ "t"
+ ],
+ [
+ 0.144315,
+ "a"
+ ],
+ [
+ 0.327449,
+ "iner/"
+ ],
+ [
+ 0.75,
+ "\r\n# "
+ ],
+ [
+ 0.519309,
+ "l"
+ ],
+ [
+ 0.07233,
+ "s"
+ ],
+ [
+ 0.126295,
+ " "
+ ],
+ [
+ 0.681581,
+ "-"
+ ],
+ [
+ 0.75,
+ "l"
+ ],
+ [
+ 0.214937,
+ "\r\n"
+ ],
+ [
+ 0.005097,
+ "total 16"
+ ],
+ [
+ 0.00018,
+ "\r\n"
+ ],
+ [
+ 0.000489,
+ "drwx------ 2 root root 16384 Apr 15 19:52 \u001b[0m\u001b[01;34mlost+found\u001b[0m"
+ ],
+ [
+ 0.00033,
+ "\r\n"
+ ],
+ [
+ 0.000954,
+ "# "
+ ],
+ [
+ 0.75,
+ "c"
+ ],
+ [
+ 0.19014,
+ "p"
+ ],
+ [
+ 0.155547,
+ " "
+ ],
+ [
+ 0.75,
+ "/"
+ ],
+ [
+ 0.335213,
+ "h"
+ ],
+ [
+ 0.133611,
+ "o"
+ ],
+ [
+ 0.164474,
+ "m"
+ ],
+ [
+ 0.75,
+ "e"
+ ],
+ [
+ 0.26903,
+ "/"
+ ],
+ [
+ 0.418227,
+ "g"
+ ],
+ [
+ 0.111436,
+ "o"
+ ],
+ [
+ 0.081628,
+ "d"
+ ],
+ [
+ 0.1153,
+ "l"
+ ],
+ [
+ 0.128941,
+ "o"
+ ],
+ [
+ 0.153423,
+ "\u0007"
+ ],
+ [
+ 0.270402,
+ "\b\u001b[K"
+ ],
+ [
+ 0.131177,
+ "\b\u001b[K"
+ ],
+ [
+ 0.148055,
+ "\b\u001b[K"
+ ],
+ [
+ 0.153349,
+ "\b\u001b[K"
+ ],
+ [
+ 0.161721,
+ "\b\u001b[K"
+ ],
+ [
+ 0.070384,
+ "d"
+ ],
+ [
+ 0.121221,
+ "a"
+ ],
+ [
+ 0.535896,
+ "v"
+ ],
+ [
+ 0.124952,
+ "id/"
+ ],
+ [
+ 0.75,
+ "c"
+ ],
+ [
+ 0.488142,
+ "\b\u001b[K"
+ ],
+ [
+ 0.75,
+ "f"
+ ],
+ [
+ 0.125875,
+ "i"
+ ],
+ [
+ 0.148878,
+ "l"
+ ],
+ [
+ 0.141139,
+ "\u0007"
+ ],
+ [
+ 0.000145,
+ "e2move2"
+ ],
+ [
+ 0.75,
+ "i"
+ ],
+ [
+ 0.196617,
+ "mage "
+ ],
+ [
+ 0.75,
+ "."
+ ],
+ [
+ 0.75,
+ "\r\n"
+ ],
+ [
+ 0.010463,
+ "# "
+ ],
+ [
+ 0.75,
+ "l"
+ ],
+ [
+ 0.083594,
+ "s"
+ ],
+ [
+ 0.100508,
+ " "
+ ],
+ [
+ 0.642868,
+ "-"
+ ],
+ [
+ 0.539571,
+ "l"
+ ],
+ [
+ 0.412747,
+ "\r\n"
+ ],
+ [
+ 0.005076,
+ "total 16"
+ ],
+ [
+ 0.000337,
+ "\r\n"
+ ],
+ [
+ 0.000533,
+ "-rw-r--r-- 1 root root 0 Apr 15 20:02 file2move2image"
+ ],
+ [
+ 0.000136,
+ "\r\n"
+ ],
+ [
+ 0.000354,
+ "drwx------ 2 root root 16384 Apr 15 19:52 \u001b[0m\u001b[01;34mlost+found\u001b[0m"
+ ],
+ [
+ 0.000302,
+ "\r\n"
+ ],
+ [
+ 0.001067,
+ "# "
+ ],
+ [
+ 0.75,
+ "e"
+ ],
+ [
+ 0.203896,
+ "x"
+ ],
+ [
+ 0.115111,
+ "i"
+ ],
+ [
+ 0.409528,
+ "t"
+ ],
+ [
+ 0.75,
+ "\r\nlogout"
+ ],
+ [
+ 0.00243,
+ "\r\n"
+ ],
+ [
+ 0.002242,
+ "$ "
+ ],
+ [
+ 0.75,
+ "e"
+ ],
+ [
+ 0.294319,
+ "x"
+ ],
+ [
+ 0.13395,
+ "i"
+ ],
+ [
+ 0.252028,
+ "t"
+ ],
+ [
+ 0.411764,
+ "\r\nexit"
+ ],
+ [
+ 0.001172,
+ "\r\n"
+ ]
+ ]
+}
\ No newline at end of file
diff --git a/pages/docs/user-docs/docs-create-an-image.md b/pages/docs/user-docs/docs-create-an-image.md
index 50a4319..29dfaae 100644
--- a/pages/docs/user-docs/docs-create-an-image.md
+++ b/pages/docs/user-docs/docs-create-an-image.md
@@ -5,15 +5,16 @@ permalink: create-image
folder: docs
---
-Singularity images are single files which physically contain the container. Unlike Docker that puts images together from layers, abstractly shown on your computer with `docker -ps`, a Singularity image is just a file that can be sitting on your Desktop, in a folder on your cluster, or elsewhere.
+A Singularity image, which can be referred to as a "container," is a single file that contains a virtual file system. After creating an image you can install an operating system, applications, and save meta-data with it.
-The effect of all files existing virtually within a single image greatly simplifies sharing, copying, branching, and other management tasks. It also means that standard file system ACLs apply to access and permission to the container (e.g. I can give read only access to a colleague, or block access completely with a simple chmod command).
+Whereas Docker assembles images from layers that are stored on your computer (viewed with the docker -ps command), a Singularity image is just one file that can sit on your Desktop, in a folder on your cluster, or anywhere.
+Having Singularity containers housed within a single image file greatly simplifies management tasks such as sharing, copying, and branching your containers. It also means that standard Linux file system concepts like permissions, ownership, and ACLs apply to the container (e.g. I can give read only access to a colleague, or block access completely with a simple chmod command).
## Creating a new blank Singularity container image
-Singularity will create a default container image of 768MiB using the following command example:
+Singularity will create a default container image of 768MiB using the following command:
-```bash
+```
$ singularity create container.img
Initializing Singularity image subsystem
Opening image file: container.img
@@ -22,105 +23,136 @@ Binding image to loop
Creating file system within image
Image is done: container.img
```
+How big is it?
-Let's import an operating system into it.
-
-```bash
-singularity import container.img docker://ubuntu:latest
+```
+$ du -sh container.img
+29M container.img
```
-We can now use the command `ls` to look at the files and permissions of the container:
+We can now use `ls` to list details about the image.
-```bash
+```
$ ls -l container.img
--rwxr-xr-x 1 vanessa vanessa 805306400 Apr 6 19:24 container.img
+-rwxr-xr-x 1 user group 805306400 Apr 15 11:11 container.img
```
-How big is it?
+Note the permissions of the image make it executable. Singularity images [can be executed directly](/docs-run).
+
+### Creating an image of a different size
+
+You can change the maximum size of an image you create using the `--size` option. Note that `--size` is not a global option. It is an option to the `create` sub-command and must therefore follow it:
-```bash
-$ du -sh container.img
-172M container.img
```
+$ singularity create --size 2048 container2.img
+Initializing Singularity image subsystem
+Opening image file: container2.img
+Creating 2048MiB image
+Binding image to loop
+Creating file system within image
+Image is done: container2.img
-Here we created a new container image called `container.img` in the current directory.
+$ ls -lh container*.img
+-rwxr-xr-x 1 user group 2.1G Apr 15 11:34 container2.img
+-rwxr-xr-x 1 user group 769M Apr 15 11:11 container.img
+```
-Also, notice the permissions of the container image as it is executable. This is important in that Singularity images can be executed directly (as long as Singularity is installed on the host system).
+### Overwriting an image with a new one
-You can increase or change the default image size using the --size option to create (option ordering is very important with Singularity and it must follow the 'create' sub-command).
+If you have already created an image and wish to overwrite it, you can do so with the `--force` option. This option must also follow the `create` sub-command.
+```
+$ singularity create --size 512 --force container2.img
+Initializing Singularity image subsystem
+Opening image file: container2.img
+Creating 512MiB image
+Binding image to loop
+Creating file system within image
+Image is done: container2.img
-## Mounting an image
-Once the image has been created, you can mount it with the following command:
+$ ls -lh container*.img
+-rwxr-xr-x 1 user group 513M Apr 15 11:39 container2.img
+-rwxr-xr-x 1 user group 769M Apr 15 11:11 container.img
+```
-```bash
-$singularity mount container.img /mnt
+{% include asciicast.html source='docs-create-create.js' title='How to create images' author='davidgodlove@gmail.com'%}
+
+## Increasing the size of an existing image
+You can increase the size of an image after it has been instantiated by using the `expand` Singularity sub-command as follows:
-Mounting image 'container.img' into '/mnt'
```
+$ ls -lh container.img
+-rwxr-xr-x 1 user group 769M Apr 15 11:11 container.img
+
+$ singularity expand container.img
+Initializing Singularity image subsystem
+Opening image file: container.img
+Expanding image by 768MiB
+Binding image to loop
+Checking file system
+e2fsck 1.42.13 (17-May-2015)
+Pass 1: Checking inodes, blocks, and sizes
+Pass 2: Checking directory structure
+Pass 3: Checking directory connectivity
+Pass 4: Checking reference counts
+Pass 5: Checking group summary information
+/dev/loop0: 11/49152 files (0.0% non-contiguous), 7387/196608 blocks
+Resizing file system
+resize2fs 1.42.13 (17-May-2015)
+Resizing the filesystem on /dev/loop0 to 393216 (4k) blocks.
+The filesystem on /dev/loop0 is now 393216 (4k) blocks long.
-To unmount, simply exit this new shell.
+Image is done: container.img
-```bash
-Singularity: \w> df -h /mnt
-Filesystem Size Used Avail Use% Mounted on
-/dev/loop1 740M 143M 559M 21% /mnt
+$ ls -lh container.img
+-rwxr-xr-x 1 user group 1.6G Apr 15 12:21 container.img
```
-
-When mounting the image in this manner, Singularity makes use of name-spaces such that the mount is only visible and accessible from within the current shell that Singularity will spawn. When you are finished, you can simply exit the shell and the file system will be automatically unmounted.
+Similar to the create sub-command, you can override the default size increase (which is 768MiB) by using the `--size` option.
+
+{% include asciicast.html source='docs-create-expand.js' title='How to expand images' author='davidgodlove@gmail.com'%}
+
+## Mounting an image
+Once an image has been created and an OS has been added with the [`import`](/docs-import) or [`bootstrap`](/docs-bootstrap) commands, you can use the [`shell`](/docs-shell) command to start an interactive shell within the container. But this is not possible when an image does not yet contain a functional OS or shell. For debugging, development, or simply inspecting an image that lacks a functional shell you can use the `mount` command like so:
-## Increasing the size of an existing image
-You can increase the size of an image after it has been instantiated by using the 'expand' Singularity sub-command as follows:
-
-```bash
-$ sudo singularity expand container.img
-Expanding sparse image by 512MiB...
-Checking image (/sbin/mkfs.ext4)
-e2fsck 1.42.9 (28-Dec-2013)
-Growing file system
-resize2fs 1.42.9 (28-Dec-2013)
-Done. Image can be found at: container.img
-$ ls -l container.img
--rwxr-xr-x. 1 root root 1610612769 Jun 1 08:40 container.img
```
+$ mkdir /tmp/container
-Similar to the create sub-command, you can override the default size (which is 512MiB) by using the --size option.
+$ singularity mount container.img /tmp/container/
+container.img is mounted at: /tmp/container/
-## Copying, sharing, branching, and distributing your image
-Because Singularity images are single files, they are easily copied and managed. You can copy the image to create a branch, share the image and distribute the image as easily as copying any other file you control! If you want an automated builder for your image, you can use our container registry Singularity Hub that will build your "Singularity" bootstrap specification files from a Github repository each time that you push.
-
-The primary motivation of Singularity is mobility, the single file image format makes this a simple accomplishment.
+Spawning a new shell in this namespace, to unmount, exit shell
+
+Singularity: \w> df
+Filesystem 1K-blocks Used Available Use% Mounted on
+/dev/loop0 1531760 1172 1451948 1% /tmp/container
+Singularity: \w> cd /tmp/container
-### Read Only Vs. Read Write
-By default, all Singularity commands that operate within a container (e.g. 'exec', 'run', and 'shell') all enter the image by default as read only. This enables multiple processes to be able to use the image appropriately (as would be necessary with MPI). But if you want to make any changes to the image, you must have both write permission on the image file itself and use the '--writable' flag. For example:
+Singularity: \w> ls -a
+. .. lost+found
+```
+
+{% include asciicast.html source='docs-create-mount.js' title='How to mount an image' author='davidgodlove@gmail.com'%}
+At this point the image just contains a bare file system because we haven't used something like the [`bootstrap`](docs-bootstrap) or [`import`](docs-import) commands to install an OS.
+
+Singularity mounts images in private name-spaces so that the mount is only visible and accessible from within the freshly spawned shell. When you are finished, you can simply exit the shell and the file system will be automatically unmounted.
-```bash
-$ sudo singularity shell container.img
-Singularity/container.img> whoami
-root
-Singularity/container.img> touch /foo
-touch: cannot touch '/foo': Read-only file system
-Singularity/container.img> exit
+Files can be copied from the image to the host when it is mounted in this way, but they cannot be copied from the host into the image. This is because the image is mounted in read-only mode by default and the mount point is owned by the root user. To copy files into a mounted image, first become root and then mount the image with the `--writable` option to the `mount` sub-command.
-$ sudo singularity shell --writable container.img
-Singularity/container.img> touch /foo
-Singularity/container.img> exit
-$
```
+$ sudo -i
-Even though I was root in both cases, I could not touch /foo unless the shell sub-command was called with the `--writable` flag.
+# singularity mount --writable /home/user/container.img /tmp/container
+```
+{% include asciicast.html source='docs-create-rootmount.js' title='How to mount an image and copy files to it' author='davidgodlove@gmail.com'%}
-## Using Your Container Image
-Singularity offers several primary user interfaces to containers: `shell`, `exec`, `run` and `test`. Using these interfaces, you can include any application or workflow that exists inside of a container as easy as if they were on the host system. These interfaces are designed specifically such that you do not need to be root or have escalated privileges to execute them. Additionally, Singularity is designed to abstract out the container system as elegantly as possibly such that the container does not exist. All IO, pipes, sockets, and native process control is handed through the container and to the calling application and Singularity elegantly gets completely out of the way for the process to run.
+## Copying, sharing, branching, and distributing your image
+A primary goal of Singularity is mobility. The single file image format makes mobility easy.
+Because Singularity images are single files, they are easily copied and managed. You can copy the image to create a branch, share the image and distribute the image as easily as copying any other file you control!
-Generally the differences can be explained as follows
+If you want an automated solution for building and hosting your image, you can use our container registry Singularity Hub. Singulairty Hub can automatically build [bootstrap specification files](/bootstrap-image#the-bootstrap-definition-file) from a Github repository each time that you push. It provides a simple cloud solution for storing and sharing your image.
-- **shell**: The `shell` interface (or Singularity subcommand) will invoke an interactive shell within the container. By default the shell called is `/bin/sh`, but this can be overridden with the shell option `--shell /path/to/shell` or via the environment variable `SINGULARITY_SHELL`. Once the shell is exited, the namespaces all collapse, and all mounts, binds, and contained processes exit.
-- **exec**: As the name implies, the `exec` interface/subcommand offers the ability to execute a single command within a container environment. This is a simple way to run programs, scripts and workflows that exist within a container from the host system. You can run this command from within a script on the host system or from a batch scheduler or an `mpirun` command.
-- **run**: Running a container will execute a predefined script (defined in the Singularity bootstrap definition as `%runscript`). If not run script has been provided, the container will launch a shell instead.
-- **test**: If you specified a `%test` section within the Singularity bootstrap definition, you can run that test as yourself. This is a useful way to ensure that a container works properly not only when built, but when transferred to other hosts or infrastructures.