saad/minimal
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Ivan Davidov 2018-06-03 23:21:59 +03:00 committed by GitHub
parent fa565b9fee
commit d61bdb18bb
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 19 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
README.md
View File

@ -1,12 +1,13 @@
### [Overview](#overview)
### [Current development state](#current-development-state)
### [Future improvements](#future-improvements)
### [How to build](#how-to-build)
### [Overlay bundles](#overlay-bundles)
### [GraalVM](#graalvm)
### [BIOS and UEFI](#bios-and-uefi)
### [Installation](#installation)
### [Projects based on MLL](#projects-based-on-minimal-linux-live)
* [Overview](#overview)
* [Current development state](#current-development-state)
* [Future improvements](#future-improvements)
* [How to build](#how-to-build)
* [Overlay bundles](#overlay-bundles)
* [GraalVM](#graalvm)
* [BIOS and UEFI](#bios-and-uefi)
* [Installation](#installation)
* [Projects based on MLL](#projects-based-on-minimal-linux-live)
* [Thank you!](#thank-you)
---
@ -37,7 +38,7 @@ This is a screenshot of the current development version of Minimal Linux Live:
![Minimal Linux Live](docs/www/assets/img/minimal_linux_live.jpg)
## Current development state
### Current development state
As of **03-Jun-2018**:
@ -46,11 +47,11 @@ As of **03-Jun-2018**:
* BusyBox 1.28.3 (stable)
* Stable on default Ubuntu 18.04 installation with applied system updates.
## Future improvements
### Future improvements
Take a look at the [issues](http://github.com/ivandavidov/minimal/issues) page where all future MLL improvements are tracked.
## How to build
### How to build
The section below is for Ubuntu and other Debian based distros.
@ -64,7 +65,7 @@ sudo apt install wget make gawk gcc bc bison flex xorriso libelf-dev libssl-dev
The default build process uses some custom provided ``CFLAGS``. They can be found in the ``.config`` file. Some of these additional flags were introduced in order to fix different issues which were reported during the development phase. However, there is no guarantee that the build process will run smoothly on your system with these particular flags. If you get compilation issues (please note that I'm talking about compilation issues, not about general shell script issues), you can try to disable these flags and then start the build process again. It may turn out that on your particular host system you don't need these flags.
## Overlay bundles
### Overlay bundles
**Important note!** Most of the overlay bundles come without support since the build process for almost all of them is host specific and can vary significantly between different machines. Some overlay bundles have no dependencies to the host machine, e.g. the bundles which provide the DHCP functionality and the MLL source code. These bundles are enabled by default.
@ -88,7 +89,7 @@ cd minimal_overlay
./overlay_build.sh openjdk
```
## GraalVM
### GraalVM
The current development version of MLL partially supports [GraalVM](http://graalvm.org). Note that GraalVM itself is _release candidate_, which means it's not that stable. Moreover, GraalVM has runtime dependencies on ``GCC`` and ``Bash`` and therefore some GraalVM feature are not supported in MLL, e.g. ``gu`` and almost all GVM language wrapper scripts, including the ``R`` wrappers. Nevertheless, the core GVM features work fine. Take a look:
@ -104,7 +105,7 @@ The current development version of MLL partially supports [GraalVM](http://graal
![GraalVM - JS](docs/www/assets/img/graal/graal_6.jpg)
## BIOS and UEFI
### BIOS and UEFI
Minimal Linux Live can be used on UEFI systems (as of version ``28-Jan-2018``) thanks to the [systemd-boot](https://github.com/ivandavidov/systemd-boot) project. There are three build flavors that you can choose from:
@ -116,7 +117,7 @@ The generated MLL iso image is 'hybrid' which means that if it is 'burned' on ex
Minimal Linux Live version ``20-Jan-2017`` provides experimental UEFI support and the MLL ISO image can be used on legacy BIOS based systems and on UEFI based systems with enabled UEFI shell (level support 1 or higher, see section ``3.1 - Levels Of Support`` of the [UEFI Shell specification](http://www.uefi.org/sites/default/files/resources/UEFI_Shell_2_2.pdf)).
## Installation
### Installation
The build process produces ISO image which you can use in virtual machine or you can burn it on real CD/DVD. Installing MLL on USB flash drive currently is not supported but it can be easily achieved by using ``syslinux`` or ``extlinux`` since MLL requires just two files (one kernel file and another initramfs file). This applies for legacy BIOS based systems.
@ -141,7 +142,7 @@ docker import mll_image.tgz minimal-linux-live:latest
docker run -it minimal-linux-live /bin/sh
```
## Projects based on Minimal Linux Live:
### Projects based on Minimal Linux Live:
* [Minimal Linux Script](https://github.com/ivandavidov/minimal-linux-script) - very simplified and minimalistic version of MLL. This project is recommended as a starting point for beginners.
@ -169,7 +170,7 @@ docker run -it minimal-linux-live /bin/sh
* [Runlinux](https://github.com/cirosantilli/runlinux) - environment to build and test Linux kernels.
## Thank you!
### Thank you!
Do you like this project? Yes? Well, in that case I would very much appreciate it if you give your honest opinion about MLL in [DistroWatch](http://distrowatch.com/dwres.php?resource=ratings&distro=mll). And don't forget to check the Minimal Linux Live page on [Facebook](http://facebook.com/MinimalLinuxLive).