X-Git-Url: https://git.ozlabs.org/?p=petitboot;a=blobdiff_plain;f=docker%2FREADME.md;fp=docker%2FREADME.md;h=7e3966da26575bf139ac8159db197d817cccb773;hp=0000000000000000000000000000000000000000;hb=0460a745e355158559c01b25f8138404f21b5d92;hpb=5e364ce7e096f4e35e4c8b2d5eec79c56ac1b32e

diff --git a/docker/README.md b/docker/README.md
new file mode 100644
index 0000000..7e3966d
--- /dev/null
+++ b/docker/README.md
@@ -0,0 +1,29 @@
+# Petitboot Build Container Support
+
+## Command Summary
+
+ - `build-builder` Builds a docker image that contains tools for building petitboot.  Default docker image tag is `pb-builder:${VERSION}${ARCH_TAG}`.
+ - `build-pb` Builds the petitboot programs using a pb-builder container.
+
+## Examples
+
+### Build the petitboot programs
+
+    ./build-builder -v
+    ./build-pb -vc
+
+### Run petitboot programs in a pb-builder container
+
+    docker run --rm -v $(pwd):/opt/pb -w /opt/pb $(./docker/build-pb -t) ./ui/ncurses/petitboot-nc --help
+
+## Debugging Build Problems
+
+### Run an interactive pb-builder container
+
+As current user:
+
+    docker run --rm -it --user $(id -u):$(id -g) -v /etc/group:/etc/group:ro -v /etc/passwd:/etc/passwd:ro -v $(pwd):/opt/pb -w /opt/pb $(./docker/build-pb -t) bash
+
+As root:
+
+    docker run --rm -it -v /etc/group:/etc/group:ro -v /etc/passwd:/etc/passwd:ro -v $(pwd):/opt/pb -w /opt/pb $(./docker/build-pb -t) bash