mirror of
https://github.com/clearlinux/graphene.git
synced 2026-08-28 13:25:43 +00:00
Dmitrii Kuvaiskii
7108de9534
This example shows how to write manifests for multi-process applications and highlights the trick of breaking an endless loop of SGX trusted children by using symlinks. This example also stresses the FS checkpointing system of Graphene.
114 lines
4.1 KiB
Plaintext
114 lines
4.1 KiB
Plaintext
# Python3 main manifest example
|
|
#
|
|
# This manifest was prepared and tested on Ubuntu 18.04.
|
|
#
|
|
# Python must be run with the pal_loader:
|
|
#
|
|
# ./pal_loader python3.6.manifest <script>
|
|
|
|
# The executable to load in Graphene. By default, PYTHONHOME points to the
|
|
# system installation. To run Python from a local installation, specify PYTHONHOME
|
|
# when running `make` in this directory.
|
|
loader.exec = file:$(PYTHONEXEC)
|
|
|
|
# Graphene environment, including the path of the library OS and the debug
|
|
# option (inline/none).
|
|
loader.preload = file:$(GRAPHENEDIR)/Runtime/libsysdb.so
|
|
loader.debug_type = $(GRAPHENEDEBUG)
|
|
|
|
# Read application arguments directly from the command line. Don't use this on production!
|
|
loader.insecure__use_cmdline_argv = 1
|
|
|
|
# Environment variables for Python
|
|
loader.env.LD_LIBRARY_PATH = $(PYTHONHOME)/lib:/lib:$(ARCH_LIBDIR):/usr/lib:/usr/$(ARCH_LIBDIR)
|
|
loader.env.PATH = $(PYTHONHOME)/bin:/usr/bin:/bin
|
|
loader.env.PYTHONHOME = $(PYTHONHOME)
|
|
loader.env.PYTHONPATH = $(PYTHONHOME):$(PYTHONHOME)/plat-$(SYS):$(PYTHONDISTHOME):$(PYTHONHOME)/lib-dynload
|
|
loader.env.HOME = /home/user
|
|
|
|
# Mounted FSes. The following "chroot" FSes mount a part of the host FS into the
|
|
# guest. Other parts of the host FS will not be available in the guest.
|
|
|
|
# Default glibc files, mounted from the Runtime directory in GRAPHENEDIR.
|
|
fs.mount.lib.type = chroot
|
|
fs.mount.lib.path = /lib
|
|
fs.mount.lib.uri = file:$(GRAPHENEDIR)/Runtime
|
|
|
|
# Host-level libraries (e.g., /lib/x86_64-linux-gnu) required by the Python executable
|
|
fs.mount.lib2.type = chroot
|
|
fs.mount.lib2.path = $(ARCH_LIBDIR)
|
|
fs.mount.lib2.uri = file:$(ARCH_LIBDIR)
|
|
|
|
# Host-level directory (/usr) required by the Python executable
|
|
fs.mount.usr.type = chroot
|
|
fs.mount.usr.path = /usr
|
|
fs.mount.usr.uri = file:/usr
|
|
|
|
# Mount $PYTHONHOME
|
|
fs.mount.pyhome.type = chroot
|
|
fs.mount.pyhome.path = $(PYTHONHOME)
|
|
fs.mount.pyhome.uri = file:$(PYTHONHOME)
|
|
|
|
# Mount $PYTHONDISTHOME
|
|
fs.mount.pydisthome.type = chroot
|
|
fs.mount.pydisthome.path = $(PYTHONDISTHOME)
|
|
fs.mount.pydisthome.uri = file:$(PYTHONDISTHOME)
|
|
|
|
# Mount /tmp
|
|
fs.mount.tmp.type = chroot
|
|
fs.mount.tmp.path = /tmp
|
|
fs.mount.tmp.uri = file:/tmp
|
|
|
|
# Mount /etc
|
|
fs.mount.etc.type = chroot
|
|
fs.mount.etc.path = /etc
|
|
fs.mount.etc.uri = file:/etc
|
|
|
|
# Mount /bin
|
|
fs.mount.bin.type = chroot
|
|
fs.mount.bin.path = /bin
|
|
fs.mount.bin.uri = file:/bin
|
|
|
|
# SGX general options
|
|
|
|
# Set the virtual memory size of the SGX enclave. For SGX v1, the enclave
|
|
# size must be specified during signing. If Python needs more virtual memory
|
|
# than the enclave size, Graphene will not be able to allocate it.
|
|
sgx.enclave_size = 1G
|
|
|
|
# Set the maximum number of enclave threads. For SGX v1, the number of enclave
|
|
# TCSes must be specified during signing, so the application cannot use more
|
|
# threads than the number of TCSes. Note that Graphene also creates an internal
|
|
# thread for handling inter-process communication (IPC), and potentially another
|
|
# thread for asynchronous events. Therefore, the actual number of threads that
|
|
# the application can create is (sgx.thread_num - 2).
|
|
sgx.thread_num = 4
|
|
|
|
# SGX trusted libraries
|
|
|
|
# Glibc libraries
|
|
sgx.trusted_files.ld = file:$(GRAPHENEDIR)/Runtime/ld-linux-x86-64.so.2
|
|
sgx.trusted_files.libc = file:$(GRAPHENEDIR)/Runtime/libc.so.6
|
|
sgx.trusted_files.libm = file:$(GRAPHENEDIR)/Runtime/libm.so.6
|
|
sgx.trusted_files.libdl = file:$(GRAPHENEDIR)/Runtime/libdl.so.2
|
|
sgx.trusted_files.librt = file:$(GRAPHENEDIR)/Runtime/librt.so.1
|
|
sgx.trusted_files.libutil = file:$(GRAPHENEDIR)/Runtime/libutil.so.1
|
|
sgx.trusted_files.libpthread = file:$(GRAPHENEDIR)/Runtime/libpthread.so.0
|
|
|
|
# Other libraries
|
|
sgx.trusted_files.libz = file:$(ARCH_LIBDIR)/libz.so.1
|
|
sgx.trusted_files.libbz2 = file:$(ARCH_LIBDIR)/libbz2.so.1.0
|
|
sgx.trusted_files.liblzma = file:$(ARCH_LIBDIR)/liblzma.so.5
|
|
sgx.trusted_files.libexpat = file:$(ARCH_LIBDIR)/libexpat.so.1
|
|
|
|
# SGX untrusted (allowed) files/directories
|
|
sgx.allowed_files.scripts = file:scripts
|
|
sgx.allowed_files.tmp = file:/tmp
|
|
sgx.allowed_files.etc = file:/etc
|
|
sgx.allowed_files.pyhome = file:$(PYTHONHOME)
|
|
sgx.allowed_files.pydisthome = file:$(PYTHONDISTHOME)
|
|
|
|
# SGX trusted children
|
|
sgx.trusted_files.sh = file:/bin/sh
|
|
sgx.trusted_children.sh = file:sh.sig
|