diff --git a/README.adoc b/README.adoc index 2e97664..60cb824 100644 --- a/README.adoc +++ b/README.adoc @@ -18,7 +18,27 @@ https://zenodo.org/badge/latestdoi/64534859[image:https://zenodo.org/badge/64534 https://twitter.com/dakami/status/1344853681749934080[Dan Kaminski-approved]™ https://en.wikipedia.org/wiki/Dan_Kaminsky[RIP]. -TL;DR: xref:qemu-buildroot-setup-getting-started[xrefstyle=full] +TL;DR: xref:qemu-buildroot-setup-getting-started[xrefstyle=full] tested on Ubuntu 24.04: + +.... +git clone https://github.com/cirosantilli/linux-kernel-module-cheat +cd linux-kernel-module-cheat +sudo apt install docker +python3 -m venv .venv +. .venv/bin/activate +./setup +./run-docker create +./run-docker sh +.... + +This leaves you inside a Docker shell. Then inside Docker: + +.... +./build --download-dependencies qemu-buildroot +./run +.... + +and you are now in a Linux userland shell running on QEMU with everything built fully from source. The source code for this page is located at: https://github.com/cirosantilli/linux-kernel-module-cheat[]. Due to https://github.com/isaacs/github/issues/1610[a GitHub limitation], this README is too long and not fully rendered on github.com, so either use: diff --git a/requirements.txt b/requirements.txt index acb446a..e24951b 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,3 +1,4 @@ Cython==0.29.15 china-dictatorship @ https://github.com/cirosantilli/china-dictatorship/releases/download/0.0.74/china_dictatorship-0.0.74-py3-none-any.whl pexpect==4.6.0 +setuptools==75.1.0 diff --git a/setup b/setup index 8fe75fb..7338fca 100755 --- a/setup +++ b/setup @@ -6,14 +6,15 @@ if [ $# -eq 1 ]; then else y= fi -if [ -f /.dockerenv ]; then +indocker="$(set +e; grep -q docker /proc/1/cgroup; echo $?)" +if [ "$indocker" -eq 0 ]; then sudo= export DEBIAN_FRONTEND=noninteractive else sudo=sudo fi -$sudo apt-get update -if [ -f /.dockerenv ]; then +if [ "$indocker" -eq 0 ]; then + $sudo apt update apt install -y software-properties-common add-apt-repository -y ppa:git-core/ppa $sudo apt update @@ -25,6 +26,5 @@ $sudo apt-get install $y \ $git \ python3 \ python3-pip \ - python3-distutils \ ; python3 -m pip install -r requirements.txt