From dd5b1ab1bdea4b648e0ca93546b926f86ddd1eb1 Mon Sep 17 00:00:00 2001 From: Ivan Davidov Date: Sat, 2 Nov 2019 22:03:31 +0200 Subject: [PATCH] README updates. --- README.md | 8 ++++---- src/README | 29 +++++++++++++++++------------ src/minimal_overlay/rootfs/README | 2 +- 3 files changed, 22 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index b2f10d374..9acf6a6df 100644 --- a/README.md +++ b/README.md @@ -39,11 +39,11 @@ Did I mention the [YouTube channel](https://youtu.be/u5KYDaCLChc?list=PLe3TW5jDb ### Current development state -As of **08-Sep-2019**: +As of **02-Nov-2019**: -* Linux kernel 5.2.12 (stable) +* Linux kernel 5.3.8 (stable) * GNU C Library 2.30 (stable) -* Busybox 1.30.1 (stable) +* Busybox 1.31.1 (stable) * Stable build on default Ubuntu 18.04.3 installation with applied system updates. Here are some screenshots of the current development version of Minimal Linux Live: @@ -98,7 +98,7 @@ cd minimal_overlay ./overlay_build.sh openjdk ``` -Take a look at the [hello_mll](src/minimal_overlay/bundles/hello_mll/bundle.sh) overlay bundle which compiles simple C program (it prints one line in the console) and installs it properly in the MLL overlay structure. +Take a look at the [mll_hello](src/minimal_overlay/bundles/mll_hello/bundle.sh) overlay bundle which compiles simple C program (it prints one line in the console) and installs it properly in the MLL overlay structure. ### Runtime software diff --git a/src/README b/src/README index 4016148fa..06b215505 100644 --- a/src/README +++ b/src/README @@ -18,11 +18,17 @@ you can change the property 'OVERLAY_BUNDLES' and build your own flavor of MLL. Currently available overlay bundles: + all - this indicates to build all available overlay bundles. This + is useful mostly for testing purposes. You are encouraged to + use only the overlay bundles that you actually want. + GLIBC - set of all core GNU C libraries packaged together. This overlay bundle is not host specific and can always be built. The libraries are useful if you plan to use more software in MLL. This overlay bundle depends on the GLIBC build process. + adopt_openjdk - JDK from AdoptOpenJDK with VM from either HotSpot or OpenJ9. + bosh_cli - BOSH command line tool. It can be used as landscape manager for virtual network and server infrastructures in cloud environments, e.g. AWS, Google Cloud, etc. Common use case @@ -71,14 +77,6 @@ Currently available overlay bundles: Java, Scala, Clojure, Kotlin, and LLVM-based languages such as C and C++. - Hello MLL - Simple educational overlay bundle with detailed comments - for each build step. - - JRE / JDK - Oracle JRE/JDK. This overlay bundle requires some manual - preparation steps. Refer to the 'JAVA_ARCHIVE' property in - the '.config' file for more information. This overlay bundle - requires GLIBC and ZLIB. - kbd - keyboard utilities and keymaps. For example, you can load German keyboard layout like this: @@ -96,7 +94,7 @@ Currently available overlay bundles: Links - text-based web browser. Use the 'links' command to activate the browser. - Open JDK - the open source JDK. No need for manual steps. This overlay + OpenJDK - the open source JDK. No need for manual steps. This overlay bundle requires GLIBC and ZLIB. Lua - the Lua Scripting Language. Use the 'lua' command to run an @@ -104,6 +102,9 @@ Currently available overlay bundles: make - GNU make utility. + MLL Hello - Simple educational overlay bundle with detailed comments + for each build step. + MLL Logo - custom MLL boot logo. MLL Utils - set of experimental shell scripts (mll-*.sh) which provide @@ -125,6 +126,10 @@ Currently available overlay bundles: '-net nic,model=e1000 -net user,hostfwd=tcp::8080-:80' to 'cmd' in the qemu.sh file. + openjdk - Free and open-source JDK from OpenJDK. + + static_get - portable binaries for Linux (http://s.minos.io). + stress - simple workload generator. Imposes a configurable amount of CPU, memory, I/O, and disk stress on the system. stress is useful for troubleshooting CPU and RAM issues. @@ -162,7 +167,7 @@ The overlay build system is independent from the main build system. However, some bundles depend on build artifacts from the main build process, so it is highly recommended to build MLL before you use the overlay build system. -Take a look at the 'hello_mll' overlay bundle for detailed explanation of the +Take a look at the 'mll_hello' overlay bundle for detailed explanation of the internal overlay system build process and the corresponding directories that are involved in the process. @@ -174,12 +179,12 @@ You can build all bundles declared in the main '.config' file like this: You can build individual overlay bundle like this: cd minimal_overlay - ./overlay_build.sh hello_mll + ./overlay_build.sh mll_hello You can build more two or more bundles if you separate them with comma: cd minimal_overlay - ./overlay_build.sh hello_mll,dhcp,mll_source + ./overlay_build.sh mll_hello,dhcp,mll_source The simplest way to add something to MLL is to put whatever you want in the following folder: diff --git a/src/minimal_overlay/rootfs/README b/src/minimal_overlay/rootfs/README index 65fdb81c9..2c780ab56 100644 --- a/src/minimal_overlay/rootfs/README +++ b/src/minimal_overlay/rootfs/README @@ -11,7 +11,7 @@ Another way to add software in 'Minimal Linux Live' is by using the overlay bundles which add the software while the OS is being built. Check the - 'hello_mll' overlay bundle in folder 'minimal/src/minimal_overlay/bundles'. + 'mll_hello' overlay bundle in folder 'minimal/src/minimal_overlay/bundles'. You can also add software in 'Minimal Linux Live' while the OS is running with the 'static_get' overlay bundle. Use 'static-get -s ' to search for