Files
borysp c24bddd5aa [LibOS] Rework signal handling and syscall emulation
Change log (most important only):
- unify CPU context structures - now we have only one version -
  `PAL_CONTEXT` - which is shared between LibOS and PALs and it should
  depend only on the host architecture (not OS),
- syscalls emulation changed:
  - dedicated LibOS stack is now used for syscalls emulation,
  - removed one indirection level in syscalls table - now it stores
    `shim_do_*` functions directly,
- signal handling - completely rewritten:
  - all signal queues use proper locking schemes now,
  - signals are handled *only* when returning to the user app from LibOS
    or PAL,
  - nested signals are now possible,
  - the app is allowed to jump out of signal handler with the same
    sematics as on normal Linux,
  - signal altstack is now fully supported,
  - syscall restarting is now supported,
  - doing a backtrace from the signal handler works properly,
- disallow injecting host-level signals, with one exception, see
  `sys.enable_sigterm_injection` manifest option for more details.
2021-02-05 14:11:21 +01:00
..
2021-01-20 17:27:29 +01:00
2020-12-05 01:46:03 +01:00
2020-12-05 01:46:03 +01:00

Python example

This directory contains an example for running Python 3 in Graphene, including the Makefile and a template for generating the manifest. The application is tested on Ubuntu 16.04 and Ubuntu 18.04, with both normal Linux and SGX platforms. The tested versions of Python are 3.5 and 3.6.

Generating the manifest

Installing prerequisites

For generating the manifest and running the test scripts, please run the following command to install the required utility packages (Ubuntu-specific):

sudo apt-get install libnss-mdns

Building for Linux

Run make (non-debug) or make DEBUG=1 (debug) in the directory.

Building for SGX

Run make SGX=1 (non-debug) or make SGX=1 DEBUG=1 (debug) in the directory.

Building with a local Python installation

By default, the make command creates the manifest for the Python binary from the system installation. If you have a local installation, you may create the manifest with the PYTHONPATH variable set accordingly. You can also specify a particular version of Python. For example:

make PYTHONPATH=<python install path> PYTHONVERSION=python3.6 SGX=1

By default, PYTHONPATH=/usr and PYTHONVERSION=python3.5.

Run Python with Graphene

Here's an example of running Python scripts under Graphene:

Without SGX:

./pal_loader ./python scripts/helloworld.py
./pal_loader ./python scripts/fibonacci.py

With SGX:

SGX=1 ./pal_loader ./python scripts/helloworld.py
SGX=1 ./pal_loader ./python scripts/fibonacci.py

You can also manually run included tests:

SGX=1 ./run-tests.sh