diff --git a/sheets/ch-build b/sheets/ch-build index 4ab702c..7537e2b 100644 --- a/sheets/ch-build +++ b/sheets/ch-build @@ -1,6 +1,8 @@ # ch-build -# Utility to build a Charliecloud image and place it in the builder’s back-end storage. More information: . +# Utility to build a Charliecloud image and place it in the builder’s back-end +# storage. More information: . -# Create an image tagged foo and specified by the file /bar/Dockerfile. Use /bar as the Docker context directory. Use the default builder. +# Create an image tagged foo and specified by the file /bar/Dockerfile. +# Use /bar as the Docker context directory. Use the default builder. ch-build -t foo --file=/bar/Dockerfile /bar diff --git a/sheets/ch-build2dir b/sheets/ch-build2dir index 5b85679..b5959b1 100644 --- a/sheets/ch-build2dir +++ b/sheets/ch-build2dir @@ -1,6 +1,8 @@ # ch-build2dir -# Utility to build a Charliecloud image from Dockerfile and unpack it into a directory. More information: . +# Utility to build a Charliecloud image from Dockerfile and unpack it into a +# directory. More information: . -# Build a Charliecloud image using ./Dockerfile.foo and create image directory /var/tmp/foo +# Build a Charliecloud image using ./Dockerfile.foo and create image +# directory /var/tmp/foo ch-build2dir -t foo -f ./Dockerfile.foo . /var/tmp diff --git a/sheets/ch-builder2squash b/sheets/ch-builder2squash index 1fdb225..21da863 100644 --- a/sheets/ch-builder2squash +++ b/sheets/ch-builder2squash @@ -1,6 +1,8 @@ # ch-builder2squash -# Utility to flatten a builder image into a Charliecloud SquashFS file. More information: . +# Utility to flatten a builder image into a Charliecloud SquashFS file. +# More information: . -# Flattens the builder image tagged "debian" into a SquashFS file named debian.sqfs in /var/tmp. +# Flattens the builder image tagged "debian" into a SquashFS file named +# debian.sqfs in /var/tmp. ch-builder2squash debian /var/tmp diff --git a/sheets/ch-builder2tar b/sheets/ch-builder2tar index 8de09d5..69d9cee 100644 --- a/sheets/ch-builder2tar +++ b/sheets/ch-builder2tar @@ -1,6 +1,8 @@ # ch-builder2tar -# Utility to flatten a builder image into a Charliecloud image tarball. More information: . +# Utility to flatten a builder image into a Charliecloud image tarball. +# More information: . -# Flatten the builder image tagged "hello" into a Charliecloud tarball in directory /var/tmp +# Flatten the builder image tagged "hello" into a Charliecloud tarball in +# directory /var/tmp ch-builder2tar hello /var/tmp diff --git a/sheets/ch-dir2squash b/sheets/ch-dir2squash index cab622c..1f55100 100644 --- a/sheets/ch-dir2squash +++ b/sheets/ch-dir2squash @@ -1,6 +1,8 @@ # ch-dir2squash -# Utility to create a SquashFS file from a Charliecloud image directory. More information: . +# Utility to create a SquashFS file from a Charliecloud image directory. +# More information: . -# Create a Charliecloud SquashFS file debian.sqfs from the image directory /var/tmp/debian under the directory /var/tmp. +# Create a Charliecloud SquashFS file debian.sqfs under the directory /var/tmp +# from the image directory /var/tmp/debian. ch-dir2squash /var/tmp/debian /var/tmp diff --git a/sheets/ch-grow b/sheets/ch-grow index 110b857..160e610 100644 --- a/sheets/ch-grow +++ b/sheets/ch-grow @@ -1,7 +1,10 @@ # ch-grow -# Utility to build and manage Charliecloud images but not running them. It is completely unprivileged, with no setuid/setgid/setcap helpers. More information: . +# Utility to build and manage Charliecloud images but not running them. +# It is completely unprivileged, with no setuid/setgid/setcap helpers. +# More information: . -# Build the image "bar" using ./foo/bar/Dockerfile and context directory ./foo/bar +# Build the image "bar" using ./foo/bar/Dockerfile and context directory +# ./foo/bar ch-grow build -t bar -f ./foo/bar/Dockerfile ./foo/bar # Download the Debian Buster image and place it in /tmp/buster. diff --git a/sheets/ch-mount b/sheets/ch-mount index 87602d4..9fce14e 100644 --- a/sheets/ch-mount +++ b/sheets/ch-mount @@ -1,7 +1,8 @@ # ch-mount -# Utility to mount a SquashFS image file using FUSE. More information: . +# Utility to mount a SquashFS image file using FUSE. +# More information: . - -# Create a new empty directory named debian, then mount it on /var/tmp directory. The /var/tmp directory must not already exist. +# Create a new empty directory named debian, then mount it on /var/tmp +# directory. The /var/tmp directory must not already exist. ch-mount /var/tmp/debian.sqfs /var/tmp diff --git a/sheets/ch-pull2dir b/sheets/ch-pull2dir index adeaa4d..6b78f80 100644 --- a/sheets/ch-pull2dir +++ b/sheets/ch-pull2dir @@ -1,6 +1,8 @@ # ch-pull2dir -# Utility to pull an image from the Docker Hub and unpack it into a directory. More information: . +# Utility to pull an image from the Docker Hub and unpack it into a directory. +# More information: . -# Pull Docker image named alpine:latest from Docker Hub and extract it into a subdirectory of /var/tmp. A temporary tarball will be stored in /var/tmp. +# Pull Docker image named alpine:latest from Docker Hub and extract it into +# a subdirectory of /var/tmp. A temporary tarball will be stored in /var/tmp. ch-pull2dir alpine:latest /var/tmp diff --git a/sheets/ch-pull2tar b/sheets/ch-pull2tar index 9d13dd9..e9d8731 100644 --- a/sheets/ch-pull2tar +++ b/sheets/ch-pull2tar @@ -1,7 +1,8 @@ # ch-pull2tar -# Utility to pull an image from the Docker Hub and flatten it into a tarball. More information: . +# Utility to pull an image from the Docker Hub and flatten it into a tarball. +# More information: . - -# Pull a Docker image named alpine:latest from Docker Hub and flatten it into a Charliecloud tarball in the directory /var/tmp. +# Pull a Docker image named alpine:latest from Docker Hub and flatten it into +# a Charliecloud tarball in the directory /var/tmp. ch-pull2tar alpine:latest /var/tmp diff --git a/sheets/ch-run b/sheets/ch-run index 5cadb7f..f4e5f11 100644 --- a/sheets/ch-run +++ b/sheets/ch-run @@ -1,6 +1,8 @@ # ch-run -# Utility to run a command in a Charliecloud container. More information: . +# Utility to run a command in a Charliecloud container. +# More information: . -# Run the command echo hello inside a Charliecloud container using the unpacked image at /data/foo. +# Run the command echo hello inside a Charliecloud container using +# the unpacked image at /data/foo. ch-run /data/foo -- echo hello diff --git a/sheets/ch-tar2dir b/sheets/ch-tar2dir index ec5569e..8d93801 100644 --- a/sheets/ch-tar2dir +++ b/sheets/ch-tar2dir @@ -1,6 +1,9 @@ # ch-tar2dir -# Utility to unpack a Charliecloud image tarball into a directory. More information: . +# Utility to unpack a Charliecloud image tarball into a directory. +# More information: . -# Extract the tarball /var/tmp/hello.tar.gz into a subdirectory of /var/tmp. hello.tar.gz must contain a Linux filesystem image, e.g. as created by ch-builder2tar. +# Extract the tarball /var/tmp/hello.tar.gz into a subdirectory of /var/tmp. +# hello.tar.gz must contain a Linux filesystem image, e.g. as created +# by ch-builder2tar. ch-tar2dir /var/tmp/hello.tar.gz /var/tmp