docker: add a ./or script to run GUI from within docker image

Signed-off-by: Øyvind Harboe <[email protected]>

Author: oharboe

flow/README.md

@@ -0,0 +1,28 @@
+Building example design using Docker image
+==========================================
+
+The `or` script is used as a prefix to launch a command within the OpenROAD docker image.
+
+This script is set up to run the OpenROAD GUI from
+within the Docker image on the host platform.
+
+Also, the current working directory is mapped into the Docker image using the current user's credentials.
+
+Build docker image
+------------------
+
+First build the docker image:
+
+```
+cd OpenROAD-flow-scripts
+sudo ./setup.sh
+./build_openroad.sh
+```
+
+Build an example design and run the GUI:
+
+```
+cd flow
+./or make
+./or make gui_final
+```

flow/or

@@ -0,0 +1,35 @@
+#!/bin/bash
+set -ex
+DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
+
+WORKSPACE=$(pwd)
+
+XSOCK=/tmp/.X11-unix
+XAUTH=/tmp/.docker.xauth
+xauth nlist :0 | sed -e 's/^..../ffff/' | xauth -f $XAUTH nmerge -
+ARGUMENTS=$@
+
+if test -t 0; then
+    DOCKER_INTERACTIVE=-ti
+fi
+
+docker run -u $(id -u ${USER}):$(id -g ${USER}) \
+ -e LIBGL_ALWAYS_SOFTWARE=1 \
+ -e "QT_X11_NO_MITSHM=1" \
+ -e XDG_RUNTIME_DIR=/tmp/xdg-run \
+ -e DISPLAY=$DISPLAY \
+ -e QT_XKB_CONFIG_ROOT=/usr/share/X11/xkb \
+ -v $XSOCK:$XSOCK \
+ -v $XAUTH:$XAUTH \
+ -e XAUTHORITY=$XAUTH \
+ -e FLOW_HOME=/OpenROAD-flow-scripts/flow/ \
+ -e MAKEFILES=/OpenROAD-flow-scripts/flow/Makefile \
+ -v $WORKSPACE:`pwd` \
+ $DOCKER_INTERACTIVE \
+ openroad/flow-centos7-builder:latest \
+ bash -c "set -ex
+ mkdir /tmp/xdg-run
+ . ./env.sh
+ cd $DIR
+ $ARGUMENTS
+"